更新时间:2025-09-04 GMT+08:00
分享

查询应用的容量数据

功能介绍

云运维中心支持查看应用、子应用、组件或分组下已关联的资源容量详情,按照资源类型展示资源核心数据。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v1/capacity

请求参数

表1 请求Body参数

参数

是否必选

参数类型

描述

group_id

String

参数解释:

用户选择当前分组对应的id值。

约束限制:

应用、组件和分组ID,有且仅有1个有值。

取值范围:

字符串,长度24个字符。

默认取值:

不涉及。

component_id

String

参数解释:

用户选择当前组件对应的id值。

约束限制:

应用、组件和分组ID,有且仅有1个有值。

取值范围:

字符串,长度24个字符。

默认取值:

不涉及。

application_id

String

参数解释:

用户选择当前应用对应的id值。

约束限制:

应用、组件和分组ID,有且仅有1个有值。

取值范围:

字符串,长度24个字符。

默认取值:

不涉及。

domain_id

String

参数解释:

用户登录租户对应的账号ID即租户id。

约束限制:

不涉及。

取值范围:

不涉及。

默认取值:

不涉及。

provider_obj

Array of provider_obj objects

参数解释:

资源对象。

约束限制:

不涉及。

取值范围:

字符串,可选ecs,cce,rds等服务资源。

默认取值:

不涉及。

表2 provider_obj

参数

是否必选

参数类型

描述

provider

String

参数解释:

云服务名称。

约束限制:

不涉及。

取值范围:

字符串,可选ecs,cce,rds等服务资源,长度1到64个字符。

默认取值:

不涉及。

type

String

参数解释:

资源类型。

约束限制:

不涉及。

取值范围:

资源类型较多,根据实际业务选择资源类型、常用资源类型如下:

  • cloudservers:弹性云服务器。

  • servers:裸金属服务器。

  • clusters:云容器引擎。

  • instances:云数据库。

默认取值:

不涉及。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

data

Array of data objects

参数解释:

容量数据列表。

取值范围:

查询已选应用下的云服务容量数据组成列表,大小在0到500之间。

表4 data

参数

参数类型

描述

sum_size

String

参数解释:

硬盘大小总量。

取值范围:

云服务对应的总内存。

sum_cpu

String

参数解释:

CPU分配量总量。

取值范围:

不涉及。

sum_mem

String

参数解释:

内存分配量总量。

取值范围:

不涉及。

provider

String

参数解释:

云服务类型。

取值范围:

字符串,可选ecs,cce,rds等服务资源。

type

String

参数解释:

资源类型。

取值范围:

资源类型较多,根据实际业务选择资源类型、常用资源类型如下:

  • cloudservers:弹性云服务器。

  • servers:裸金属服务器。

  • clusters:云容器引擎。

  • instances:云数据库。

请求示例

查询应用的容量数据。

POST https://{Endpoint}/v1/capacity

{
  "application_id" : "660557b2dc48844adc49eaa5",
  "provider_obj" : [ {
    "provider" : "ecs",
    "type" : "cloudservers"
  }, {
    "provider" : "bms",
    "type" : "servers"
  }, {
    "provider" : "evs",
    "type" : "volumes"
  }, {
    "provider" : "rds",
    "type" : "instances"
  }, {
    "provider" : "dcs",
    "type" : "redis"
  }, {
    "provider" : "dds",
    "type" : "instances"
  }, {
    "provider" : "cci",
    "type" : "pods"
  } ]
}

响应示例

状态码:200

查询应用容量信息成功。

{
  "data" : [ {
    "sum_mem" : "39936",
    "sum_cpu" : "17",
    "provider" : "ecs",
    "type" : "cloudservers"
  }, {
    "sum_mem" : "0",
    "sum_cpu" : "0",
    "provider" : "bms",
    "type" : "servers"
  }, {
    "sum_size" : "1670",
    "provider" : "evs",
    "type" : "volumes"
  }, {
    "sum_mem" : "32",
    "sum_cpu" : "16",
    "sum_size" : "370",
    "provider" : "rds",
    "type" : "instances"
  } ]
}

状态码

状态码

描述

200

查询应用容量信息成功。

错误码

请参见错误码

相关文档