文档

DescribeDedicatedHostDisks - 查询主机上的磁盘信息

更新时间:

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

调试

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

授权信息

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

请求参数

名称类型必填描述示例值
DedicatedHostIdstring

主机 ID。您可以登录云数据库专属集群控制台,在主机列表查看并获取主机 ID。

ch-bp183v72jr033****
RegionIdstring

主机所在的地域 ID。您可以登录云数据库专属集群控制台,查看主机所在地域信息

cn-hangzhou

返回参数

名称类型描述示例值
object
DedicatedHostIdstring

主机 ID。

ch-bp183v72jr033****
RequestIdstring

请求 ID。

C6C6CF41-F284-4F63-AB4D-44FACE3BASQW
Disksobject []

磁盘信息。

Typestring

云盘或本地盘磁盘类型 ,取值:

  • system:系统盘

  • data: 数据盘

data
Statusstring

云盘状态,取值:

  • In_use

  • Available

  • Attaching

  • Detaching

  • Creating

  • ReIniting

In_use
PerformanceLevelstring

磁盘性能。

说明 MyBase 提供了 ESSD 云盘ESSD PL2 云盘ESSD PL3 云盘三个性能级别的云盘规格,PL 级别越高,云盘性能越好。
PL1
DiskIdstring

云盘或本地盘 ID。

d-bp1dffpog8r2eowd****
MaxThroughputinteger

磁盘最大吞吐量,单位为 MB/S。

284
MaxIOPSinteger

磁盘最大 IOPS,单位为万。

18250
HasDBInstanceboolean

是否有实例运行在该磁盘上,取值:

  • true:有运行的实例
  • false:无运行的实例
true
Devicestring

云盘或本地盘挂载实例的设备名。

/dev/xvdb
Sizeinteger

云盘或本地盘大小,单位为 GB。

329
ZoneIdstring

云盘或本地盘所属的可用区 ID。

cn-hangzhou-h
Categorystring

主机存储类型,取值:

  • cloud_ssd:本地 SSD 盘
  • cloud_essd:ESSD 云盘
cloud_essd
DBInstanceIdstring

该磁盘上运行的实例 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错误码错误信息描述
400InvalidUserId.NotSupportThe user ID has no permission.当前用户没有操作权限
404HostInfo.NotFoundThe specified host info is not found.找不到指定的主机信息
404InvalidDedicatedHostGroup.NotFoundThe specified DedicatedHostGroup does not exist.集群不存在
404InvalidParameterThe parameter is invalid.无效参数

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

变更历史

变更时间变更内容概要操作
暂无变更历史
  • 本页导读 (1)
文档反馈