# 查询容量统计 - ShowStorageUsage
#### 功能介绍
查询容量统计
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v3/{project_id}/storage_usage
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID，获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html) **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
表2Query参数 
| 参数            | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                 |
|:---|:---|:---|:---|
| limit         | 否    | Integer | **参数解释：** 查询条数 **约束限制：** 不涉及 **取值范围：** 正整数 **默认取值：** 不涉及               |
| offset        | 否    | Integer | **参数解释：** 偏移值 **约束限制：** 不涉及 **取值范围：** 大于等于0的正整数 **默认取值：** 不涉及          |
| resource_id   | 否    | String  | **参数解释：** 资源id **约束限制：** 不涉及 **取值范围：** UUID，形式为32个十六进制数字 **默认取值：** 不涉及 |
| resource_type | 否    | String  | 支持按照备份对象类型过滤，支持的参数OS::Nova::Server, OS::Ironic::BareMetalServer OS::Nova::Server：云服务器 OS::Ironic::BareMetalServer：裸金属服务器                                                                                                                                   |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数             | 参数类型                                                                      | 描述            |
|:---|:---|:---|
| resource_count | Integer                                                                   | 满足过滤条件的资源总条数。 |
| storage_usage  | Array of [StorageUsage] objects | 容量统计。         |
   
 表4StorageUsage 
| 参数                  | 参数类型    | 描述                                                                                                                                                        |
|:---|:---|:---|
| backup_count        | Integer | 备份数量                                                                                                                                                      |
| backup_size         | Integer | 备份容量                                                                                                                                                      |
| resource_id         | String  | **参数解释：** 资源ID **取值范围：** 格式为UUID，形式为32个十六进制数字 |
| resource_name       | String  | **参数解释：** 待备份资源名称 **取值范围：** 长度限制：0-255字符      |
| resource_type       | String  | 待备份资源的类型: OS::Nova::Server：云服务器； OS::Cinder::Volume：云硬盘；OS::Ironic::BareMetalServer：裸金属服务器；OS::Sfs::Turbo：SFS Turbo文件系统；OS::Workspace::DesktopV2：云桌面。     |
| backup_size_multiaz | Integer | **参数解释：** 多AZ备份大小，单位MB **取值范围：** 不涉及          |
   
#### 请求示例
无
#### 响应示例
**状态码：200**
```
{
  "storage_usage" : [ {
    "resource_name" : "ECS_name",
    "resource_id" : "89d466e5-b7f9-4e45-807a-d5f17f44fc84",
    "backup_size" : 0,
    "backup_count" : 1,
    "resource_type" : "OS::Nova::Server",
    "backup_size_multiaz" : 0
  } ],
  "resource_count" : 1
}
```
#### 状态码
| 状态码 | 描述 |
|:---|:---|
| 200 | OK |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。