DescribeDedicatedHostDisks - 查询主机上的磁盘信息_云数据库专属集群(MyBase)-阿里云帮助中心

调用DescribeDedicatedHostDisks接口查询主机上的磁盘信息。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
DedicatedHostId	string	是	主机 ID。您可以登录云数据库专属集群控制台，在主机列表查看并获取主机 ID。	ch-bp183v72jr033****
RegionId	string	是	主机所在的地域 ID。您可以登录云数据库专属集群控制台，查看主机所在地域信息。	cn-hangzhou

返回参数

名称	类型	描述	示例值
	object
DedicatedHostId	string	主机 ID。	ch-bp183v72jr033****
RequestId	string	请求 ID。	C6C6CF41-F284-4F63-AB4D-44FACE3BASQW
Disks	array<object>	磁盘信息。
	object
Type	string	云盘或本地盘磁盘类型，取值： system：系统盘 data：数据盘	data
Status	string	云盘状态，取值： In_use Available Attaching Detaching Creating ReIniting	In_use
PerformanceLevel	string	磁盘性能。说明 MyBase 提供了 ESSD 云盘、ESSD PL2 云盘、ESSD PL3 云盘三个性能级别的云盘规格，PL 级别越高，云盘性能越好。	PL1
DiskId	string	云盘或本地盘 ID。	d-bp1dffpog8r2eowd****
MaxThroughput	integer	磁盘最大吞吐量，单位为 MB/S。	284
MaxIOPS	integer	磁盘最大 IOPS，单位为万。	18250
HasDBInstance	boolean	是否有实例运行在该磁盘上，取值： true：有运行的实例 false：无运行的实例	true
Device	string	云盘或本地盘挂载实例的设备名。	/dev/xvdb
Size	integer	云盘或本地盘大小，单位为 GB。	329
ZoneId	string	云盘或本地盘所属的可用区 ID。	cn-hangzhou-h
Category	string	主机存储类型，取值： cloud_ssd：本地 SSD 盘 cloud_essd：ESSD 云盘	cloud_essd
DBInstanceId	string	该磁盘上运行的实例 ID。	rm-bp121zcqr5h8m****

示例

正常返回示例

JSON格式

{
  "DedicatedHostId": "ch-bp183v72jr033****",
  "RequestId": "C6C6CF41-F284-4F63-AB4D-44FACE3BASQW",
  "Disks": [
    {
      "Type": "data",
      "Status": "In_use",
      "PerformanceLevel": "PL1",
      "DiskId": "d-bp1dffpog8r2eowd****",
      "MaxThroughput": 284,
      "MaxIOPS": 18250,
      "HasDBInstance": true,
      "Device": "/dev/xvdb",
      "Size": 329,
      "ZoneId": "cn-hangzhou-h",
      "Category": "cloud_essd",
      "DBInstanceId": "rm-bp121zcqr5h8m****"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidUserId.NotSupport	The user ID has no permission.	当前用户没有操作权限
404	HostInfo.NotFound	The specified host info is not found.	找不到指定的主机信息
404	InvalidDedicatedHostGroup.NotFound	The specified DedicatedHostGroup does not exist.	集群不存在
404	InvalidParameter	The parameter is invalid.	无效参数

访问错误中心查看更多错误码。

变更历史

变更时间	变更内容概要	操作

暂无变更历史