调用DescribeDedicatedHostAttribute接口查询RDS某个主机的参数信息。

主机组功能以集群形式批量管理实例,一个地域创建多个主机组,一个主机组包含多个主机,一个主机包含多个实例。详情请参见主机组简介

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDedicatedHostAttribute

系统规定参数。取值:DescribeDedicatedHostAttribute

DedicatedHostGroupId String dhg-7a9xxxxxxxx

主机组ID。

DedicatedHostId String i-bpxxxxxxx

主机ID。

RegionId String cn-hangzhou

地域ID。可以通过接口DescribeRegions查看地域ID。

AccessKeyId String LTAIfCxxxxxxxxxx

阿里云颁发给用户的访问服务所用的密钥ID。

返回数据

名称 类型 示例值 描述
AllocationStatus String Evenly

主机组资源调度的分配策略。取值:

  • Evenly:均衡分配
  • Intensively:紧凑分配
AutoRenew String ture

主机是否自动续费。取值:true | false

CPUAllocationRatio String 200

主机组的CPU超配比。

CpuUsed String 10

CPU使用量。

CreatedTime String 2019-10-15 15:44:30.0

主机创建时间。

DedicatedHostGroupId String dhg-7a9xxxxxxxx

主机所属主机组ID。

DedicatedHostId String i-bpxxxxxxx

主机ID。

DiskAllocationRatio String 200

主机组的空间超配比。

ExpiredTime String 2019-11-16 00:00:00.0

主机过期时间。

HostCPU Integer 64

主机CPU数。

HostClass String ecs.i2.16xlarge

主机规格。

HostMem Integer 524288

主机内存大小。单位:MB。

HostName String testHost1

主机名称。

HostStatus String 1

主机状态。取值:

  • 0:创建中
  • 1:使用中
  • 2:宕机
  • 3:宕机下线(替换主机中)
  • 4:下线
  • 5:删除
  • 6:重启中
HostStorage Integer 14694400

主机存储空间大小。单位:MB。

IPAddress String 192.xx.xx.xx

主机内网IP地址。

InstanceNumber Integer 4

主机上的实例总数。

InstanceNumberMaster Integer 1

主机上的主实例总数。

InstanceNumberROMaster Integer 0

主机上只读实例的主实例总数。

InstanceNumberROSlave Integer 0

主机上只读实例的备实例总数。

InstanceNumberSlave Integer 3

主机上的备实例总数。

MemAllocationRatio String 90

主机组中每台主机的内存最大使用率。

MemoryUsed String 100000

内存使用量。

RegionId String cn-hangzhou

地域ID。

RequestId String 8E58EF95-AB95-4246-997A-9F34CD1366B3

请求ID。

StorageUsed String 1000000

存储空间使用量。

VPCId String vpc-bpxxxxxxx

主机所属专有网络VPC ID。

VSwitchId String vsw-bpxxxxxxx

主机所属虚拟交换机ID。

ZoneId String cn-hangzhou-i

主机所在可用区ID。

示例

请求示例


http(s)://rds.aliyuncs.com/?Action=DescribeDedicatedHostAttribute
&DedicatedHostGroupId=dhg-7a9xxxxxxxx
&DedicatedHostId=i-bpxxxxxxx
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDedicatedHostAttributeResponse>
  <HostClass>ecs.i2.16xlarge</HostClass>
  <DedicatedHostGroupId>dhg-7a9xxxxxxxx</DedicatedHostGroupId>
  <ZoneId>cn-hangzhou-i</ZoneId>
  <InstanceNumberSlave>3</InstanceNumberSlave>
  <VSwitchId>vsw-bpxxxxxxx</VSwitchId>
  <InstanceNumberROSlave>0</InstanceNumberROSlave>
  <InstanceNumberMaster>1</InstanceNumberMaster>
  <VPCId>vpc-bpxxxxxxx</VPCId>
  <HostMem>524288</HostMem>
  <InstanceNumberROMaster>0</InstanceNumberROMaster>
  <DedicatedHostId>i-bpxxxxxxx</DedicatedHostId>
  <CreatedTime>2019-10-15 15:44:30.0</CreatedTime>
  <InstanceNumber>4</InstanceNumber>
  <HostName>testHost1</HostName>
  <HostStatus>1</HostStatus>
  <IPAddress>192.xx.xx.xx</IPAddress>
  <HostCPU>64</HostCPU>
  <RequestId>8E58EF95-AB95-4246-997A-9F34CD1366B3</RequestId>
  <RegionId>cn-hangzhou</RegionId>
  <HostStorage>14694400</HostStorage>
  <AllocationStatus>1</AllocationStatus>
  <ExpiredTime>2019-11-16 00:00:00.0</ExpiredTime>
</DescribeDedicatedHostAttributeResponse>

JSON 格式

{
	"DedicatedHostId":"i-bpxxxxxxx",
	"CreatedTime":"2019-10-15 15:44:30.0",
	"HostClass":"ecs.i2.16xlarge",
	"DedicatedHostGroupId":"dhg-7a9xxxxxxxx",
	"InstanceNumber":4,
	"ZoneId":"cn-hangzhou-i",
	"InstanceNumberSlave":3,
	"VSwitchId":"vsw-bpxxxxxxx",
	"HostName":"testHost1",
	"InstanceNumberROSlave":0,
	"HostStatus":"1",
	"InstanceNumberMaster":1,
	"VPCId":"vpc-bpxxxxxxx",
	"IPAddress":"192.xx.xx.xx",
	"HostCPU":64,
	"HostMem":524288,
	"RegionId":"cn-hangzhou",
	"RequestId":"8E58EF95-AB95-4246-997A-9F34CD1366B3",
	"InstanceNumberROMaster":0,
	"HostStorage":14694400,
	"ExpiredTime":"2019-11-16 00:00:00.0",
	"AllocationStatus":"1"
}

错误码

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