# 查询应用、组件、分组容量数据的排名 - ListCapacityOrder
#### 功能介绍
查询应用、组件、分组容量数据的排名，其中应用、组件和分组ID，有且仅有1个有值。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/COC/doc?api=ListCapacityOrder)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-coc/coc_api_06.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                               | 访问级别 | 资源类型（\*为必须）    | 条件键 | 别名 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | coc:application:getSortedCapacity | List | application \* | -   | -  | -      |
     
  
 
#### URI
GET /v1/capacity/order
表1Query参数 
| 参数             | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| application_id | 否    | String | **参数解释：** 应用id。 **约束限制：** 不涉及。 **取值范围：** 需要查询容量数据排名的应用id。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| component_id   | 否    | String | **参数解释：** 组件id。 **约束限制：** 不涉及。 **取值范围：** 需要查询容量数据排名的组件id。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| group_id       | 否    | String | **参数解释：** 分组id。 **约束限制：** 不涉及。 **取值范围：** 需要查询容量数据排名的分组id。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| provider       | 是    | String | **参数解释：** 云服务名称。 **约束限制：** 不涉及。 **取值范围：** 字符串，可选ecs，cce，rds等服务资源。 **默认取值：** 不涉及。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| type           | 是    | String | **参数解释：** 资源类型。 **约束限制：** 不涉及。 **取值范围：** 资源类型较多，根据实际业务选择资源类型、常用资源类型如下： - cloudservers：弹性云服务器。   - servers：裸金属服务器。   - clusters：云容器引擎。   - instances：云数据库。    **默认取值：** 不涉及。 |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数   | 参数类型                                                                                    | 描述                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| data | Array of [data] objects | **参数解释：** 容量排名数据。 **取值范围：** 应用或者组件或者分组容量数据的排名。 |
   
 表3data 
| 参数        | 参数类型                                                                                    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
|:---|:---|:---|
| type      | String                                                                                  | **参数解释：** 容量的种类。 **取值范围：** 根据云服务容量数据显示具体容量类型，一般种类 - cpu：CPU核数。   - mem：内存。   - size：云盘大小。    |
| rank_list | [rank_list] object | **参数解释：** TOP5排名对象列表。 **取值范围：** 容量种类排名前五的应用或组件或分组的容量信息组成的列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   
 表4rank_list 
| 参数    | 参数类型   | 描述                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| id    | String | **参数解释：** 应用或组件或者分组id。 **取值范围：** 容量种类排名在前五个的应用或者组件或分组对应的id。    |
| name  | String | **参数解释：** 应用或组件或者分组的名称。 **取值范围：** 容量种类排名在前五个的应用或者组件或分组对应的名称。   |
| value | String | **参数解释：** 应用或组件或者分组的容量值。 **取值范围：** 容量种类排名在前五个的应用或者组件或分组对应的容量值。 |
   
#### 请求示例
查询应用、组件、分组容量数据的排名。
```
GET https://{Endpoint}/v1/capacity/order?component_id=673c04d5f77f2c62d81a3b59&type=cloudservers&provider=ecs
```
#### 响应示例
**状态码：200**
```
{
  "data" : [ {
    "type" : "cpu",
    "rank_list" : [ {
      "id" : "67dccc6bcc8db1018650ce26",
      "name" : "test_cmdb_智能关联",
      "value" : "1187.0"
    }, {
      "id" : "6784d2cf796f946ff344708a",
      "name" : "vvvvvvvvvv",
      "value" : "1075.0"
    }, {
      "id" : "6788bdadbc066c540614692a",
      "name" : "dddddddd",
      "value" : "525.0"
    }, {
      "id" : "67dccc20cc8db10186500689",
      "name" : "cadacca",
      "value" : "4.0"
    }, {
      "id" : "687204a28e3d61245b9d54fb",
      "name" : "group071201",
      "value" : "1.0"
    } ]
  }, {
    "type" : "mem",
    "rank_list" : [ {
      "id" : "67dccc6bcc8db1018650ce26",
      "name" : "test_cmdb_智能关联",
      "value" : "2914304.0"
    }, {
      "id" : "6784d2cf796f946ff344708a",
      "name" : "vvvvvvvvvv",
      "value" : "2335744.0"
    }, {
      "id" : "6788bdadbc066c540614692a",
      "name" : "dddddddd",
      "value" : "1069056.0"
    }, {
      "id" : "67dccc20cc8db10186500689",
      "name" : "cadacca",
      "value" : "16384.0"
    }, {
      "id" : "687204a28e3d61245b9d54fb",
      "name" : "group071201",
      "value" : "1024.0"
    } ]
  } ]
}
```
#### 状态码
| 状态码 | 描述        |
|:---|:---|
| 200 | 查询容量排名成功。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-coc/ErrorCode.html)。