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

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

cddc:DescribeDedicatedHostDisks

get

*全部资源

*

无

请求参数

名称	类型	必填	描述	示例值
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.	无效参数

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

变更历史

更多信息，参考变更详情。