查询回收站中单个云硬盘详情
功能介绍
查询回收站中单个云硬盘的详细信息。
调用方法
请参见如何调用API。
URI
GET /v3/{project_id}/recycle-bin-volumes/{volume_id}
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
X-Auth-Token |
是 |
String |
参数解释 用户Token。 通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。 约束限制 不涉及。 取值范围 不涉及。 默认取值 不涉及。 |
响应参数
状态码:200
参数 |
参数类型 |
描述 |
---|---|---|
volume |
recycleBinVolume object |
参数解释 云硬盘详情。 取值范围 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
id |
String |
参数解释 云硬盘ID。 取值范围 不涉及。 |
name |
String |
参数解释 云硬盘名称。 取值范围 不涉及。 |
description |
String |
参数解释 云硬盘描述。 取值范围 不涉及。 |
status |
String |
参数解释 云硬盘状态,具体请参见云硬盘状态。 取值范围 不涉及。 |
attachments |
Array of Attachment objects |
参数解释 云硬盘的挂载信息。 取值范围 不涉及。 |
multiattach |
String |
参数解释 云硬盘是否共享。 取值范围
|
size |
Integer |
参数解释 云硬盘大小,单位为GiB。 取值范围 不涉及。 |
metadata |
Map<String,Object> |
参数解释 云硬盘的metadata信息 ,调用方可以添加或删除metadata信息。 取值范围 当前部分key在EVS服务中有业务场景含义,这部分key的描述如下:
|
bootable |
String |
参数解释 云硬盘是否为启动盘。 取值范围
|
tags |
Map<String,String> |
参数解释 云硬盘标签。 取值范围 不涉及。 |
availability_zone |
String |
参数解释 云硬盘所属可用区。 取值范围 不涉及。 |
created_at |
String |
参数解释 云硬盘创建时间。 取值范围 时间格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX |
service_type |
String |
参数解释 云硬盘所属的服务类型。 取值范围
|
updated_at |
String |
参数解释 云硬盘信息被更新的时间。 取值范围 时间格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX |
volume_type |
String |
参数解释 云硬盘类型。 取值范围 目前支持"SATA","SAS","GPSSD","SSD","ESSD","GPSSD2","ESSD2"七种。
|
enterprise_project_id |
String |
参数解释 企业项目ID。 取值范围 不涉及。 |
plan_delete_at |
String |
参数解释 预计到期清理的时间。 取值范围 时间格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX |
pre_deleted_at |
String |
参数解释 放入回收站的时间。 取值范围 时间格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX |
dedicated_storage_id |
String |
参数解释 云硬盘所属的专属存储池ID。 取值范围 不涉及。 |
dedicated_storage_name |
String |
参数解释 云硬盘所属的专属存储池的名称。 取值范围 不涉及。 |
volume_image_metadata |
String |
参数解释 云硬盘镜像的元数据。 关于“volume_image_metadata”字段的详细说明,具体请参见:"查询镜像详情"。 取值范围 不涉及。 |
wwn |
String |
参数解释 云硬盘的唯一标识。 取值范围 不涉及。 |
参数 |
参数类型 |
描述 |
---|---|---|
attached_at |
String |
参数解释 挂载的时间信息。 取值范围 时间格式:UTC YYYY-MM-DDTHH:MM:SS.XXXXXX |
attachment_id |
String |
参数解释 挂载信息对应的ID。 取值范围 不涉及。 |
device |
String |
参数解释 挂载点。 取值范围 不涉及。 |
host_name |
String |
参数解释 云硬盘挂载到的云服务器对应的物理主机的名称。 取值范围 不涉及。 |
id |
String |
参数解释 挂载的资源ID。 取值范围 不涉及。 |
server_id |
String |
参数解释 云硬盘挂载到的云服务器的ID。 取值范围 不涉及。 |
volume_id |
String |
参数解释 云硬盘ID。 取值范围 不涉及。 |
状态码:400
参数 |
参数类型 |
描述 |
---|---|---|
code |
String |
参数解释 出现错误时,返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 |
message |
String |
参数解释 出现错误时,返回的错误消息。 取值范围 不涉及。 |
请求示例
GET https://evs.cn-north-1.myhuaweicloud.com/v3/490e121341fc481d95f946ef844cb06a/recycle-bin-volumes/55b4c5a7-a82e-4881-9463-f8fbf8730d4f
响应示例
状态码:200
OK
{ "volume" : { "id" : "552f3de0-5a22-49a6-9e99-18b1e9cd6b71", "name" : "IaaS_Universal_Tenant_Basic_Computing_BMS_503_0", "status" : "restorable", "size" : 10, "metadata" : { "hw:passthrough" : "true", "readonly" : "False" }, "bootable" : "false", "tags" : { }, "wwn" : "6888603000026e18fa16988434130925", "availability_zone" : "AZ2", "created_at" : "2019-01-15T01:48:07.432000", "volume_type" : "SATA", "multiattach" : false, "updated_at" : "2019-01-15T01:54:35.369000", "service_type" : "EVS", "volume_image_metadata" : { }, "enterprise_project_id" : "0", "plan_delete_at" : "2019-01-22T01:54:30.255000", "pre_deleted_at" : "2019-01-15T01:54:30.255000" } }
状态码:400
Bad Request
{ "error" : { "message" : "XXXX", "code" : "XXX" } }
状态码
状态码 |
描述 |
---|---|
200 |
OK |
400 |
Bad Request |
错误码
请参见错误码。