接口功能介绍
基于磁盘ID查询云硬盘详情。
接口约束
无
接口是否审批
否
URI
GET /v4/ebs/info-ebs
Content-Type
application/json
路径参数
无
Query参数
表query参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
diskID | 是 | String | 磁盘ID。 | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 |
regionID | 否 | String | 如本地语境支持保存regionID,那么建议传递。 | 81f7728662dd11ec810800155d307d5b |
请求参数
请求头header参数
无
请求体body参数
无
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
statusCode | Integer | 返回状态码(800为成功,900为失败) | 800 | |
message | String | 失败时的错误描述,一般为英文描述 | region info empty | |
description | String | 失败时的错误描述,一般为中文描述 | 资源池信息为空 | |
returnObj | Object | 磁盘详情对象 | returnObj | |
errorCode | String | 业务细分码,为product.module.code三段式码.请参考错误码 | ebs.regionInfo.empty | |
error | String | 业务细分码,为product.module.code三段式大驼峰码. 请参考错误码 | Ebs.RegionInfo.Empty |
表 returnObj
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
diskName | String | 磁盘名 | ebs-newspec-test0211v7 | |
diskID | String | 磁盘ID | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 | |
diskSize | Integer | 磁盘大小(GB) | 1024 | |
diskType | String | 磁盘规格类型 SATA/SAS/SSD-genric/SSD/FAST-SSD/XSSD-1/XSSD-2 | SSD | |
diskMode | String | 磁盘模式。VBD/ISCSI/FCSAN | ISCSI | |
diskStatus | String | 云硬盘使用状态 deleting/creating/detaching,具体请参考云硬盘使用状态 | available | |
createTime | Integer | 创建时刻,epoch时戳,精度毫秒 | 1676081845000 | |
updateTime | Integer | 更新时刻,epoch时戳,精度毫秒 | 1676081845000 | |
expireTime | Integer | 过期时刻,epoch时戳,精度毫秒 | 1676081845000 | |
isSystemVolume | Boolean | 是否系统盘,只有为系统盘时才返回该字段 | true | |
isPackaged | Boolean | 是否是云主机成套资源 | true | |
instanceName | String | 绑定的云主机名,有挂载时才返回 | ins-jwe8 | |
instanceID | String | 绑定云主机resourceUUID,有挂载时才返回 | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 | |
instanceStatus | String | 云主机状态starting/restarting/stopping,具体参考云主机状态,有挂载时才返回 | running | |
multiAttach | Boolean | 是否共享云硬盘 | false | |
attachments | ObjectArray | 挂载信息。如果是共享挂载云硬盘,有多项 | attachment | |
projectID | String | 资源所属企业项目ID | 0 | |
isEncrypt | Boolean | 是否加密盘 | true | |
kmsUUID | String | 加密盘密钥UUID,是加密盘时才返回 | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 | |
onDemand | Boolean | 是否按需订购,按需时才返回该字段 | true | |
cycleType | String | month/year,非按需时返回 | month | |
cycleCount | Integer | 包周期数,非按需时返回 | 1 | |
regionID | String | 资源池ID | 81f7728662dd11ec810800155d307d5b | |
azName | String | 多可用区下的可用区名字 | az2 | |
diskFreeze | String | 是否冻结 | true | |
provisionedIops | Integer | XSSD类型盘的预配置iops,未配置返回0,其他类型盘不返回 | 1 | |
volumeSource | String | 云硬盘源快照ID,若不是从快照创建的则返回null | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 | |
snapshotPolicyID | String | 云硬盘绑定快照策略ID,若没有绑定则返回null | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 |
表 attachment
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
instanceID | 是 | String | 绑定云主机实例UUID | 24690060-c475-ed64-fd2c-7e96f9a1df37 | |
attachmentID | 是 | String | 挂载ID | 24690060-c475-ed64-fd2c-7e96f9a1df37 | |
device | 是 | String | 挂载设备名,比如/dev/sda | /dev/sda |
请求示例
请求头header示例
{
}
请求url示例
.../v4/ebs/info-ebs?regionID=81f7728662dd11ec810800155d307d5b&diskID=0ae97ef5-6ee2-44af-9d05-1a509b0a1be6
请求体body示例
无
响应示例
{
"returnObj":{
"diskName":"ebs-newspec-test0211v7",
"diskFreeze":false,
"isPackaged":false,
"diskMode":"VBD",
"multiAttach":false,
"projectID":"0",
"regionID":"81f7728662dd11ec810800155d307d5b",
"updateTime":1676081845000,
"diskType":"SATA",
"expireTime":1678501018000,
"isEncrypt":false,
"cycleType":"month",
"diskSize":10,
"azName":"az2",
"diskStatus":"available",
"createTime":1676081790000,
"diskID":"0ae97ef5-6ee2-44af-9d05-1a509b0a1be6",
"cycleCount":1,
"volumeSource":null,
"snapshotPolicyID":null
},
"details":"",
"message":"SUCCESS",
"description":"成功",
"statusCode":800
}
状态码
请参考状态码