调用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****"
                    }
                }
            }
        ]
    }
}