查询回收站中单个云硬盘详情
功能介绍
查询回收站中单个云硬盘的详细信息。
调用方法
请参见如何调用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 |
错误码
请参见错误码。