接口功能介绍
基于资源池ID和云硬盘名称查询云硬盘详情。
接口约束
无
接口是否审批
否
URI
GET /v4/ebs/info-by-name-ebs
Content-Type
application/json
路径参数
无
Query参数
表query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 资源池ID。 | 81f7728662dd11ec810800155d307d5b |
| diskName | 是 | String | 云硬盘名称。 | ebs-newspec-test0211v7 |
请求参数
请求头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：普通IO。 ●SAS：高IO。 ●SSD：超高IO。 ●FAST-SSD：极速型SSD。 ●XSSD-0、XSSD-1、XSSD-2：X系列云硬盘。 | SSD | |
| diskMode | String | 云硬盘磁盘模式，取值为： ●VBD（Virtual Block Device）：虚拟块存储设备。 ●ISCSI （Internet Small Computer System Interface）：小型计算机系统接口。 ●FCSAN（Fibre Channel SAN）：光纤通道协议的SAN网络。 | ISCSI | |
| diskStatus | String | 参考云硬盘使用状态 | available | |
| createTime | Long | 创建时刻，epoch时戳，精度毫秒。 | 1676081845000 | |
| updateTime | Long | 更新时刻，epoch时戳，精度毫秒。 | 1676081845000 | |
| expireTime | Long | 过期时刻，epoch时戳，精度毫秒。 | 1676081845000 | |
| isSystemVolume | Boolean | 只有为系统盘时才返回该字段。 | true | |
| isPackaged | Boolean | 是否随云主机一起订购。 | true | |
| instanceName | String | 绑定的云主机名称，有挂载时才返回 | ins-jwe8 | |
| instanceID | String | 绑定的云主机ID，有挂载时才返回。 | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 | |
| instanceStatus | String | 云主机状态，参考云主机使用状态 | running | |
| multiAttach | Boolean | 是否是共享云硬盘。 | false | |
| attachments | Array of Objects | 挂载信息。如果是共享挂载云硬盘，则返回多项；无挂载时不返回该字段。 | attachment | |
| projectID | String | 云硬盘所属的企业项目ID。 | 0 | |
| isEncrypt | Boolean | 是否是加密盘。 | true | |
| kmsUUID | String | 加密盘密钥UUID，是加密盘时才返回。 | 0ae97ef5-6ee2-44af-9d05-1a509b0a1be6 | |
| onDemand | Boolean | 是否按需订购，按需时才返回该字段。 | true | |
| cycleType | String | 包周期类型，year：年，month：月。非按需时才返回。 | 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 | 绑定的云主机ID。 | 24690060-c475-ed64-fd2c-7e96f9a1df37 | |
| attachmentID | String | 挂载ID。 | 24690060-c475-ed64-fd2c-7e96f9a1df37 | |
| device | String | 挂载的设备名，比如/dev/sda。 | /dev/sda |
请求示例
请求头header示例
{
}请求url示例
.../v4/ebs/info-by-name-ebs?regionID=81f7728662dd11ec810800155d307d5b&diskName=ebs-newspec-test0211v7请求体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
}状态码
请参考状态码
错误码
请参考错误码
