查询容量统计 - ShowStorageUsage
功能介绍
查询容量统计
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v3/{project_id}/storage_usage
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
limit | 否 | Integer | 查询条数 |
offset | 否 | Integer | 偏移值 |
resource_id | 否 | String | 支持按照备份对象资源ID过滤 |
resource_type | 否 | String | 支持按照备份对象类型过滤，支持的参数OS::Nova::Server, OS::Ironic::BareMetalServer OS::Nova::Server：云服务器 OS::Ironic::BareMetalServer：裸金属服务器 |
请求参数
无
响应参数
状态码：200
参数 | 参数类型 | 描述 |
|---|---|---|
resource_count | Integer | 满足过滤条件的资源总条数。 |
storage_usage | Array of StorageUsage objects | 容量统计。 |
参数 | 参数类型 | 描述 |
|---|---|---|
backup_count | Integer | 备份数量 |
backup_size | Integer | 备份容量 |
resource_id | String | 资源ID，格式为UUID。可根据待备份的资源类型查询对应的资源情况。默认取值不涉及。 |
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备份大小 |
请求示例
无
响应示例
状态码：200
OK
{
"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 |
错误码
请参见错误码。
