ZStack AIOS

获取容器使用量 (GetContainerUsage)

面向开发者的 API 使用规范、SDK 调用方式和 AIOS 相关接口说明。

API请求

URLs

GET zstack/v1/container/usage

Headers

Authorization: OAuth the-session-uuid

Curl示例

curl -H "Content-Type: application/json;charset=UTF-8" \
-H "Authorization: OAuth b86c9016b4f24953a9edefb53ca0678c" \
-X GET http://localhost:8080/zstack/v1/container/usage

参数列表


名字	类型	位置	描述	可选值	起始版本
systemTags (可选)	List	query	系统标签		5.2.1
userTags (可选)	List	query	用户标签		5.2.1

API返回

返回示例

{
  "usages": [
    {
      "name": "container.requested.cpu.num",
      "value": 10
    }
  ]
}


名字	类型	描述	起始版本
success	boolean		5.2.1
error	ErrorCode	错误码，若不为null，则表示操作失败, 操作成功时该字段为null。详情参考error	5.2.1
usages	List	详情参考usages	5.2.1

#error


名字	类型	描述	起始版本
code	String	错误码号，错误的全局唯一标识，例如SYS.1000, HOST.1001	5.2.1
description	String	错误的概要描述	5.2.1
details	String	错误的详细信息	5.2.1
elaboration	String	保留字段，默认为null	5.2.1
opaque	LinkedHashMap	保留字段，默认为null	5.2.1
cause	ErrorCode	根错误，引发当前错误的源错误，若无原错误，该字段为null	5.2.1

#usages


名字	类型	描述	起始版本
name	String	资源名称	5.2.1
value	Long		5.2.1

SDK示例

Java SDK

GetContainerUsageAction action = new GetContainerUsageAction();
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c";
GetContainerUsageAction.Result res = action.call();

Python SDK

GetContainerUsageAction action = GetContainerUsageAction()
action.sessionId = "b86c9016b4f24953a9edefb53ca0678c"
GetContainerUsageAction.Result res = action.call()