# 查询应用的容量数据 - ListCapacityView
#### 功能介绍
云运维中心支持查看应用、子应用、组件或分组下已关联的资源容量详情，按照资源类型展示资源核心数据。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ListCapacityView)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                         | 访问级别 | 资源类型（\*为必须）    | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | coc:application:getCapacity | List | application \* | -   | -  | -      |
     
  
 
#### 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等服务资源。 **默认取值：** 不涉及。                |
   
 表2provider_obj 
| 参数       | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| provider | 否    | String | **参数解释：** 云服务名称。 **约束限制：** 不涉及。 **取值范围：** 字符串，可选ecs，cce，rds等服务资源，长度1到64个字符。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| type     | 否    | String | **参数解释：** 资源类型。 **约束限制：** 不涉及。 **取值范围：** 资源类型较多，根据实际业务选择资源类型、常用资源类型如下： - cloudservers：弹性云服务器。   - servers：裸金属服务器。   - clusters：云容器引擎。   - instances：云数据库。    **默认取值：** 不涉及。 |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数   | 参数类型                                                                                   | 描述                                                                                                                                                                                                                                                             |
|:---|:---|:---|
| data | Array of [data] objects | **参数解释：** 容量数据列表。 **取值范围：** 查询已选应用下的云服务容量数据组成列表，大小在0到500之间。 |
   
 表4data 
| 参数       | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|
| 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 | 查询应用容量信息成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。