获取CPU和内存容量

GET/zstack/v1/hosts/capacities/cpu-memory

操作 ID

GetCpuMemoryCapacity

起始版本

0.6

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

查询参数

zoneUuids
List
区域的UUID
clusterUuids
List
集群的UUID。用于挂载网络、存储等
hostUuids
List
物理机的UUID。用于添加、删除host等
all
boolean
all默认为false，此时区域UUID，集群UUID,物理机UUID必须有一个不为空，或者全部都填写 all设置为true时，区域UUID、集群UUID、物理机UUID均可不填
hypervisorType
String
可选hypervisor类型。

响应状态

200 OK

该 API 成功时返回以下响应结构。

totalCpu
long必填
cpu总数
availableCpu
long必填
可用cpu数量
totalMemory
long必填
内存总量
availableMemory
long必填
可用内存
managedCpuNum
long必填
受管理的物理CPU数量
resourceType
String必填
所查资源的类型（物理机、集群、区域）
success
boolean必填
成功
error
ErrorCode必填
详情参考error
- code
  String必填
  错误码号，错误的全局唯一标识，例如SYS.1000, HOST.1001
- description
  String必填
  错误的概要描述
- details
  String必填
  错误的详细信息
- elaboration
  String必填
  保留字段，默认为null
- opaque
  LinkedHashMap必填
  保留字段，默认为null
- cause
  ErrorCode必填
  根错误，引发当前错误的源错误，若无原错误，该字段为null
capacityData
List必填
详情参考capacityData
- resourceUuid
  String必填
  资源UUID
- totalCpu
  long必填
  CPU总数
- availableCpu
  long必填
  可用CPU数量
- totalMemory
  long必填
  内存总量
- availableMemory
  long必填
  可用内存
- managedCpuNum
  long必填
  受管理的物理CPU数量
error
ErrorCode必填
详情参考error
- code
  String必填
  错误码号，错误的全局唯一标识，例如SYS.1000, HOST.1001
- description
  String必填
  错误的概要描述
- details
  String必填
  错误的详细信息
- elaboration
  String必填
  保留字段，默认为null
- opaque
  LinkedHashMap必填
  保留字段，默认为null
- cause
  ErrorCode必填
  根错误，引发当前错误的源错误，若无原错误，该字段为null

请求示例

转换警告

python: found "variable_assignment" AST node, only "command", "pipeline" or "redirected_statement" are supported -X GET http://localhost:8080/zstack/v1/hosts/capacities/cpu-memory?zoneUuids=6510dcd4e77939d695b035ecbcfb217c&zoneUuids=33a39cd9391538a4a4d45666e8505dda&clusterUuids=b7c233dd9c573f63b5bb97f50028fa7f&clusterUuids=08d332af6fdb351da456aea3b6b5d029&hostUuids=ba1bfc20682136c4b2f76920af8f010e&hostUuids=b09cd47a6fa93302ae55918ef8da2af4&hypervisorType=KVM&all=true ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
javascript: found "variable_assignment" AST node, only "command", "pipeline" or "redirected_statement" are supported -X GET http://localhost:8080/zstack/v1/hosts/capacities/cpu-memory?zoneUuids=6510dcd4e77939d695b035ecbcfb217c&zoneUuids=33a39cd9391538a4a4d45666e8505dda&clusterUuids=b7c233dd9c573f63b5bb97f50028fa7f&clusterUuids=08d332af6fdb351da456aea3b6b5d029&hostUuids=ba1bfc20682136c4b2f76920af8f010e&hostUuids=b09cd47a6fa93302ae55918ef8da2af4&hypervisorType=KVM&all=true ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
java: found "variable_assignment" AST node, only "command", "pipeline" or "redirected_statement" are supported -X GET http://localhost:8080/zstack/v1/hosts/capacities/cpu-memory?zoneUuids=6510dcd4e77939d695b035ecbcfb217c&zoneUuids=33a39cd9391538a4a4d45666e8505dda&clusterUuids=b7c233dd9c573f63b5bb97f50028fa7f&clusterUuids=08d332af6fdb351da456aea3b6b5d029&hostUuids=ba1bfc20682136c4b2f76920af8f010e&hostUuids=b09cd47a6fa93302ae55918ef8da2af4&hypervisorType=KVM&all=true ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
go: found "variable_assignment" AST node, only "command", "pipeline" or "redirected_statement" are supported -X GET http://localhost:8080/zstack/v1/hosts/capacities/cpu-memory?zoneUuids=6510dcd4e77939d695b035ecbcfb217c&zoneUuids=33a39cd9391538a4a4d45666e8505dda&clusterUuids=b7c233dd9c573f63b5bb97f50028fa7f&clusterUuids=08d332af6fdb351da456aea3b6b5d029&hostUuids=ba1bfc20682136c4b2f76920af8f010e&hostUuids=b09cd47a6fa93302ae55918ef8da2af4&hypervisorType=KVM&all=true ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

curl -X GET '{host}/zstack/v1/hosts/capacities/cpu-memory?zoneUuids={zoneUuids}&clusterUuids={clusterUuids}&hostUuids={hostUuids}&all={all}&hypervisorType={hypervisorType}&systemTags={systemTags}&userTags={userTags}' \
  -H 'Authorization: Bearer {token}'

响应示例

{
  "totalCpu": 4,
  "availableCpu": 2,
  "totalMemory": 8,
  "availableMemory": 4,
  "managedCpuNum": 4,
  "capacityData": [
    {
      "resourceUuid": "db558260b0b53e36aa8ebf7e40c7c9c6",
      "totalCpu": 4,
      "availableCpu": 2,
      "totalMemory": 8,
      "availableMemory": 4,
      "managedCpuNum": 4
    }
  ],
  "resourceType": "HostVO"
}

云主机相关接口

云盘相关接口

镜像相关接口

亲和组相关接口

云主机调度策略相关接口

计算规格相关接口

云盘规格相关接口

弹性伸缩组相关接口

快照组相关接口

SSH密钥相关接口

区域相关接口

集群相关接口

物理机相关接口

GPU设备相关接口

主存储相关接口

镜像服务器相关接口

SAN存储相关接口

物理网络相关接口

PCI设备相关接口

USB重定向相关接口

USB透传相关接口

SR-IOV相关接口

龙芯SE模块相关接口

海光SE模块相关接口

本地存储相关接口

NFS主存储相关接口

Shared Mount Point主存储相关接口

Ceph主存储相关接口

Shared Block主存储相关接口

XStor Block主存储相关接口

镜像仓库服务器相关接口

Ceph镜像服务器相关接口

iSCSI服务器相关接口

FC存储相关接口

NVMe存储相关接口

SDN设备相关接口

二层网络资源相关接口

三层网络相关接口

路由资源相关接口

VPC相关接口

OSPF相关接口

组播路由相关接口

策略路由相关接口

路由器路由表相关接口

网络服务相关接口

防火墙相关接口

安全组相关接口

虚拟IP相关接口

弹性IP相关接口

端口转发相关接口

负载均衡相关接口

IPsec相关接口

Netflow相关接口

端口镜像相关接口

共享带宽相关接口

安全策略定时计划相关接口

资源编排相关接口

裸金属管理相关接口

安装服务相关接口

弹性裸金属管理(Plus)

vCenter相关接口

容量管理相关接口

管理节点相关接口

通知服务相关接口

时序数据（Metric）

事件（Event）

报警器（Alarm）

事件订阅（Event Subscription）

报警文本模板（Text Template）

审计

CBT相关接口

灾备服务相关接口

持续数据保护(CDP)相关接口

脚本库相关接口

XML Hook相关接口

定时运维相关接口

标签管理相关接口

迁移服务相关接口

组织架构相关接口

项目管理相关接口