查询快照个数
功能介绍
查询快照个数。标准快照当前只在部分区域支持,具体的区域列表请参见"功能总览"中快照页签下的区域信息。
调用方法
请参见如何调用API。
URI
GET /v5/{project_id}/snapshots/count
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
参数解释 项目ID。 约束限制 不涉及。 取值范围 获取方法请参见"获取项目ID"。 默认取值 不涉及。 |
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
volume_id |
否 |
String |
参数解释 快照对应的云硬盘ID。 可通过EVS控制台的云硬盘列表页面获取云硬盘ID。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
availability_zone |
否 |
String |
参数解释 快照对应的云硬盘所在的可用区。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
name |
否 |
String |
参数解释 快照名称。 约束限制 不涉及。 取值范围 最大支持255个字符。 默认取值 不涉及。 |
status |
否 |
String |
参数解释 快照状态。 约束限制 最大支持255个字符。 取值范围 具体请参见云硬盘快照状态。 默认取值 不涉及。 |
id |
否 |
String |
参数解释 快照ID。 可通过EVS控制台的云硬盘快照列表页面获取云硬盘快照ID。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
snapshot_type |
否 |
String |
参数解释 快照来源。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
enterprise_project_id |
否 |
String |
参数解释 快照的企业项目ID。 关于企业项目ID的获取及企业项目特性的详细信息,请参考:"企业管理用户指南"。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
tag_key |
否 |
String |
参数解释 快照标签的key。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
tags |
否 |
String |
参数解释 快照标签的key/value对,例如{"key1":"value1"}。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
snapshot_chain_id |
否 |
String |
参数解释 快照链ID。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
count |
Integer |
参数解释 资源的数量。 取值范围 不涉及。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
error |
Error object |
参数解释 出现错误时,返回的错误信息。 取值范围 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
参数解释 出现错误时,返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 |
message |
String |
参数解释 出现错误时,返回的错误消息。 取值范围 不涉及。 |
请求示例
GET https://{endpoint}/v5/{project_id}/snapshots/count
响应示例
状态码:200
OK
{ "count" : 100 }
状态码:400
Bad Request
{ "error" : { "message" : "XXXX", "code" : "EVS.XXX" } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
错误码
请参见错误码。