接口功能介绍

基于磁盘ID查询云硬盘详情。

接口约束

无。

URI

GET /v4/ebs/info-ebs

路径参数 无

Query参数

参数	是否必填	参数类型	说明	示例	下级对象
diskID	是	String	云硬盘ID。	0ae97ef5-6ee2-44af-9d05-1a509b0a1be6
regionID	否	String	资源池ID。如本地语境支持保存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：普通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	Boolean	云硬盘是否已冻结。	true
provisionedIops	Integer	XSSD类型盘的预配置iops，未配置返回0，其他类型盘不返回。	1
snapshotPolicyID	String	云硬盘绑定的快照策略ID，若没有绑定则返回null。	0ae97ef5-6ee2-44af-9d05-1a509b0a1be6
labels	Array of Objects	标签信息。资源池支持标签功能才返回。		labels
decPoolID	String	专属云存储池ID，只有磁盘为专属云盘时才返回。	342319ae-d623-4e9e-9dce-2d8ce3ed2681
decPoolName	String	专属云存储池名称，只有磁盘为专属云盘时才返回。	test-pool
deleteSnapWithEbs	String	是否随云硬盘释放快照。只有支持快照的资源池会返回。	true
iops	Integer	云硬盘iops。只有资源池支持展示iops才会返回。	1800
throughput	Float	云硬盘吞吐量，单位为MB/s。只有资源池支持展示吞吐量才会返回。	131
volumeSourceType	String	云硬盘创建源类型。只有单独订购的盘在有数据源场景下返回，取值为：image/snapshot/backup。	backup
volumeSourceID	String	云硬盘创建源ID。只有单独订购的盘在有数据源场景下返回。	0ae97ef5-6ee2-44af-9d05-1a509b0a1be6
表 labels

参数	参数类型	说明	示例
key	String	标签键。	group
value	String	标签值。	2-3
labelId	String	标签ID。	0129ec38c07b4b3c8815e23c853ea909
表 attachment

参数	参数类型	说明	示例
instanceID	String	绑定的云主机ID。	24690060-c475-ed64-fd2c-7e96f9a1df37
attachmentID	String	挂载ID。	24690060-c475-ed64-fd2c-7e96f9a1df37
device	String	挂载设备名，例如/dev/sda。	/dev/sda

枚举参数

无

请求示例

请求url

.../v4/ebs/info-ebs?regionID=81f7728662dd11ec810800155d307d5b&diskID=0ae97ef5-6ee2-44af-9d05-1a509b0a1be6

请求头header

{}

请求体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,
                "labels": [
                    {
                        "key": "group",
                        "value": "2-3",
                        "labelId": "0129ec38c07b4b3c8815e23c853ea909"
                    }
                ]
	},
	"details": "",
	"message": "SUCCESS",
	"description": "成功",
	"statusCode": 800
}

状态码

请参考状态码

错误码

请参考错误码

智算服务

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

云硬盘

云硬盘

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码

活动

智算服务

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

云硬盘

云硬盘

接口功能介绍

接口约束

URI

请求参数

响应参数

枚举参数

请求示例

响应示例

状态码

错误码