调用ListClusterHost接口查询集群主机列表，包括磁盘和CPU内存配置等信息。

调试

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

请求参数

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

系统规定参数。对于您自行拼凑HTTP或HTTPS URL发起的API请求，该参数为必选参数。取值：ListClusterHost。
ClusterId String 是 C-D7CA98AAA96A****

集群ID。您可以调用ListClusters接口查看集群的ID。

RegionId String 是 cn-hangzhou

地域ID。您可以通过DescribeRegions接口查看最新的阿里云地域列表。

HostInstanceId String 否 i-bp11vdyh3l6xvmnl****

ECS实例ID。
HostGroupId String 否 G-A5EA210E15FC****

机器组ID。
HostName String 否 emr-header-1

主机名。
PrivateIp String 否 192.***.***.***

主机内网IP。
PublicIp String 否 47.***.***.***

主机公网IP。
GroupType String 否 MASTER

机器组类型：

  • MASTER：主实例节点
  • CORE：核心实例节点
  • TASK：计算实例节点
ComponentName String 否 HiveServer2

安装了指定组件名称的主机。
StatusList.N RepeatList 否 ["NORMAL"]

主机状态列表：

  • NORMAL：正常
  • ABNORMAL：异常
  • RESIZING：配置中
  • INITIALIZING：初始化中
  • RELEASED：已释放
PageNumber Integer 否 1

分页页数，从1开始。
PageSize Integer 否 10

分页大小。

返回数据

名称 类型 示例值 描述
HostList Array of Host

主机列表。
Host
ChargeType String PostPaid

付费类型：

  • PostPaid：按量付费集群
  • PrePaid：包年包月集群
Cpu Integer 4

CPU核心数。
CreateTime String 1599635156000

创建时间。
DiskList Array of Disk

磁盘列表。
Disk
BlockMountPoint String 无

保留字段。
Device String /dev/xvde

磁盘名称。
DiskId String d-bp1aq78lhbig6iel****

磁盘ID。
DiskMountPoint String 无

保留字段。
DiskSize Integer 80

磁盘容量。
DiskType String CLOUD_ESSD

磁盘类型：

  • CLOUD_ESSD：ESSD云盘
  • CLOUD_SSD：SSD云盘
  • CLOUD：云盘
  • CLOUD_EFFCIENCY：高效云盘
Event String 因系统维护隔离受损本地盘

磁盘运维事件名称。
Type String data

磁盘对应的角色类型。
EmrExpiredTime String 无

E-MapReduce超时时间。保留字段。
ExpiredTime Long 32493801600000

主机过期时间。
HostGroupId String G-A5EA210E15FC****

机器组ID。
HostInstanceId String i-bp1cfwf2cwgji7ds****

主机ECS实例ID。
HostName String emr-header-1

主机名。
InstanceStatus String NORMAL

主机状态。
InstanceType String ecs.mn4.xlarge

主机的型号。
Memory Integer 16

主机的内存（G）。
PrivateIp String 192.***.****.***

主机内网IP。
PublicIp String 47.***.***.***

主机公网IP。
Role String MASTER

主机在集群中的角色：

  • MASTER：主实例节点
  • CORE：核心实例节点
  • TASK：计算实例节点
SerialNumber String 3c2a5078-778d-4c18-87e4-1a38fbcb****

主机序列号。
Status String NORMAL

主机状态：

  • NORMAL：正常
  • ABNORMAL：异常
  • RESIZING：配置中
  • INITIALIZING：初始化中
  • RELEASED：已释放
SupportIpV6 Boolean false

是否支持IPv6。
Type String VM

主机类型。
ZoneId String cn-hangzhou-i

区域ID。
PageNumber Integer 1

分页页数。
PageSize Integer 10

分页大小。
RequestId String 50F7151C-915D-4576-A291-833E8D193853

请求ID。
Total Integer 12

查询总数。

示例

请求示例

http(s)://[Endpoint]/?Action=ListClusterHost
&ClusterId=C-D7CA98AAA96A****
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML 格式 

<PageSize>10</PageSize>
<RequestId>50F7151C-915D-4576-A291-833E8D193853</RequestId>
<PageNumber>1</PageNumber>
<Total>12</Total>
<HostList>
    <Host>
        <Status>NORMAL</Status>
        <ZoneId>cn-hangzhou-i</ZoneId>
        <PublicIp>47.***.***.***</PublicIp>
        <Memory>16</Memory>
        <CreateTime>1599635156000</CreateTime>
        <Cpu>4</Cpu>
        <HostInstanceId>i-bp1cfwf2cwgji7ds****</HostInstanceId>
        <Role>MASTER</Role>
        <Type>VM</Type>
        <HostGroupId>G-A5EA210E15FC****</HostGroupId>
        <SerialNumber>3c2a5078-778d-4c18-87e4-1a38fbcb****</SerialNumber>
        <PrivateIp>192.***.****.***</PrivateIp>
        <ChargeType>PostPaid</ChargeType>
        <InstanceStatus>NORMAL</InstanceStatus>
        <ExpiredTime>32493801600000</ExpiredTime>
        <SupportIpV6>false</SupportIpV6>
        <EmrExpiredTime>无</EmrExpiredTime>
        <InstanceType>ecs.mn4.xlarge</InstanceType>
        <HostName>emr-header-1</HostName>
    </Host>
    <Host>
        <DiskList>
            <Disk>
                <DiskType>CLOUD_ESSD</DiskType>
                <Type>data</Type>
                <DiskMountPoint>无</DiskMountPoint>
                <Device>/dev/xvde</Device>
                <BlockMountPoint>无</BlockMountPoint>
                <DiskSize>80</DiskSize>
                <Event/>
                <DiskId>d-bp1aq78lhbig6iel****</DiskId>
            </Disk>
        </DiskList>
    </Host>
</HostList>

JSON 格式 

{
    "PageSize": 10,
    "RequestId": "50F7151C-915D-4576-A291-833E8D193853",
    "PageNumber": 1,
    "Total": 12,
    "HostList": {
        "Host": [
            {
                "Status": "NORMAL",
                "ZoneId": "cn-hangzhou-i",
                "PublicIp": "47.***.***.***",
                "Memory": 16,
                "CreateTime": 1599635156000,
                "Cpu": 4,
                "HostInstanceId": "i-bp1cfwf2cwgji7ds****",
                "Role": "MASTER",
                "Type": "VM",
                "HostGroupId": "G-A5EA210E15FC****",
                "SerialNumber": "3c2a5078-778d-4c18-87e4-1a38fbcb****",
                "PrivateIp": "192.***.****.***",
                "ChargeType": "PostPaid",
                "InstanceStatus": "NORMAL",
                "ExpiredTime": 32493801600000,
                "SupportIpV6": false,
                "EmrExpiredTime": "无",
                "InstanceType": "ecs.mn4.xlarge",
                "HostName": "emr-header-1"
            },
            {
                "DiskList": {
                    "Disk": {
                        "DiskType": "CLOUD_ESSD",
                        "Type": "data",
                        "DiskMountPoint": "无",
                        "Device": "/dev/xvde",
                        "BlockMountPoint": "无",
                        "DiskSize": 80,
                        "Event": "",
                        "DiskId": "d-bp1aq78lhbig6iel****"
                    }
                }
            }
        ]
    }
}