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

调试

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

请求参数

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

系统规定参数。取值:ListClusterHost。

ClusterId String C-D7CA98AAA96A****

集群ID。

RegionId String cn-hangzhou

地域ID。

AccessKeyId String LTAI8ljWyu7y****

阿里云AccessKey ID信息,用于标识访问者身份。

ComponentName String HiveServer2

安装了指定组件名称的主机。

GroupType String MASTER

机器组类型。

HostGroupId String G-A5EA210E15FCFF8E

机器组ID。

HostInstanceId String i-bp11vdyh3l6xvmnl****

ECS实例ID。

HostName String emr-header-1

主机名。

PageNumber Integer 1

分页页数,从1开始。

PageSize Integer 10

分页大小。

PrivateIp String 192.***.***.***

主机内网IP。

PublicIp String 47.***.***.***

主机公网IP。

StatusList.N RepeatList ["NORMAL"]

主机状态列表。

返回数据

名称 类型 示例值 描述
HostList

主机列表。

Host

主机列表。

ChargeType String PostPaid

付费类型。

Cpu Integer 4

CPU核心数。

CreateTime String 11

创建时间。

DiskList

磁盘列表。

Disk

磁盘列表。

Device String 11

磁盘名称。

DiskId String d-bp1aq78lhbig6ielbur8

磁盘ID。

DiskSize Integer 80

磁盘容量。

DiskType String CLOUD_EFFICIENCY

磁盘类型。

Type String data

磁盘对应的角色类型。

EmrExpiredTime String 11

E-MapReduce超时时间。

ExpiredTime Long 32493801600000

主机过期时间。

HostGroupId String G-A5EA210E15FCFF8E

机器组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.168.25.220

主机内网IP。

PublicIp String 47.110.77.16

主机公网IP。

Role String MASTER

主机在集群中的角色。

SerialNumber String 3c2a5078-778d-4c18-87e4-1a38fbcbc306

主机序列号。

Status String NORMAL

主机状态。

SupportIpV6 Boolean false

是否支持IPv6。

Type String VM

主机类型。

ZoneId String 11

区域ID。

PageNumber Integer 1

分页页数。

PageSize Integer 10

分页大小。

RequestId String 0A46EB54-0D98-4BFA-B712-1A474925E9D4

请求ID。

Total Integer 12

查询总数。

示例

请求示例


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

正常返回示例

XML 格式

<ListClusterHostResponse>
	  <hostList>
		    <chargeType>PostPaid</chargeType>
		    <cpu>4</cpu>
		    <diskList>
			      <diskId>d-bp1d2duao4slg805dmg8</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp1974rijbh940n5ih4q</diskId>
			      <diskSize>120</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>system</type>
		    </diskList>
		    <expiredTime>32493801600000</expiredTime>
		    <hostInstanceId>i-bp1cfwf2cwgji7ds****</hostInstanceId>
		    <hostName>emr-header-1</hostName>
		    <instanceType>ecs.mn4.xlarge</instanceType>
		    <memory>16</memory>
		    <privateIp>192.***.***.***</privateIp>
		    <publicIp>47.***.***.***</publicIp>
		    <role>MASTER</role>
		    <serialNumber>3c2a5078-778d-4c18-87e4-1a38fbcbc306</serialNumber>
		    <status>NORMAL</status>
	  </hostList>
	  <hostList>
		    <chargeType>PostPaid</chargeType>
		    <cpu>4</cpu>
		    <diskList>
			      <diskId>d-bp1aq78lhbig6ielbur8</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp1iply35zhdge3nbqxf</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp19gcyyon6nx2lahx9x</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp1974rijbh940n5ih4r</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp1558hztv9c3q3gl7nn</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>system</type>
		    </diskList>
		    <expiredTime>32493801600000</expiredTime>
		    <hostInstanceId>i-bp18sb2w8oj9p6yf****</hostInstanceId>
		    <hostName>emr-worker-1</hostName>
		    <instanceType>ecs.n4.xlarge</instanceType>
		    <memory>8</memory>
		    <privateIp>192.***.***.***</privateIp>
		    <publicIp></publicIp>
		    <role>CORE</role>
		    <serialNumber>d4dbd488-8684-4742-b178-5565ef38c6f9</serialNumber>
		    <status>NORMAL</status>
	  </hostList>
	  <hostList>
		    <chargeType>PostPaid</chargeType>
		    <cpu>4</cpu>
		    <diskList>
			      <diskId>d-bp19gcyyon6nx2lahx9y</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp1314ka4c7qmhpadwhf</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp1558hztv9c3q3gl7no</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp1e82xlhob2n2e7q5rd</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>data</type>
		    </diskList>
		    <diskList>
			      <diskId>d-bp1gpdc9x4o051udcmd3</diskId>
			      <diskSize>80</diskSize>
			      <diskType>CLOUD_EFFICIENCY</diskType>
			      <type>system</type>
		    </diskList>
		    <expiredTime>32493801600000</expiredTime>
		    <hostInstanceId>i-bp14rtl1gqupopgm****</hostInstanceId>
		    <hostName>emr-worker-2</hostName>
		    <instanceType>ecs.n4.xlarge</instanceType>
		    <memory>8</memory>
		    <privateIp>192.***.***.***</privateIp>
		    <publicIp></publicIp>
		    <role>CORE</role>
		    <serialNumber>e8d25d43-2df6-4054-9861-53d1c12d08cb</serialNumber>
		    <status>NORMAL</status>
	  </hostList>
	  <pageNumber>1</pageNumber>
	  <pageSize>10</pageSize>
	  <requestId>0A46EB54-0D98-4BFA-B712-1A474925E9D4</requestId>
	  <total>3</total>
</ListClusterHostResponse>

JSON 格式

{
	"total":3,
	"requestId":"0A46EB54-0D98-4BFA-B712-1A474925E9D4",
	"pageSize":10,
	"pageNumber":1,
	"hostList":[
		{
			"diskList":[
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp1d2duao4slg805dmg8"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"system",
					"diskSize":120,
					"diskId":"d-bp1974rijbh940n5ih4q"
				}
			],
			"status":"NORMAL",
			"cpu":4,
			"serialNumber":"3c2a5078-778d-4c18-87e4-1a38fbcbc306",
			"hostInstanceId":"i-bp1cfwf2cwgji7ds****",
			"publicIp":"47.***.***.***",
			"memory":16,
			"instanceType":"ecs.mn4.xlarge",
			"privateIp":"192.***.***.***",
			"expiredTime":32493801600000,
			"hostName":"emr-header-1",
			"role":"MASTER",
			"chargeType":"PostPaid"
		},
		{
			"diskList":[
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp1aq78lhbig6ielbur8"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp1iply35zhdge3nbqxf"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp19gcyyon6nx2lahx9x"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp1974rijbh940n5ih4r"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"system",
					"diskSize":80,
					"diskId":"d-bp1558hztv9c3q3gl7nn"
				}
			],
			"status":"NORMAL",
			"cpu":4,
			"serialNumber":"d4dbd488-8684-4742-b178-5565ef38c6f9",
			"hostInstanceId":"i-bp18sb2w8oj9p6yf****",
			"publicIp":"",
			"memory":8,
			"instanceType":"ecs.n4.xlarge",
			"privateIp":"192.***.***.***",
			"expiredTime":32493801600000,
			"hostName":"emr-worker-1",
			"role":"CORE",
			"chargeType":"PostPaid"
		},
		{
			"diskList":[
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp19gcyyon6nx2lahx9y"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp1314ka4c7qmhpadwhf"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp1558hztv9c3q3gl7no"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"data",
					"diskSize":80,
					"diskId":"d-bp1e82xlhob2n2e7q5rd"
				},
				{
					"diskType":"CLOUD_EFFICIENCY",
					"type":"system",
					"diskSize":80,
					"diskId":"d-bp1gpdc9x4o051udcmd3"
				}
			],
			"status":"NORMAL",
			"cpu":4,
			"serialNumber":"e8d25d43-2df6-4054-9861-53d1c12d08cb",
			"hostInstanceId":"i-bp14rtl1gqupopgm****",
			"publicIp":"",
			"memory":8,
			"instanceType":"ecs.n4.xlarge",
			"privateIp":"192.***.***.***",
			"expiredTime":32493801600000,
			"hostName":"emr-worker-2",
			"role":"CORE",
			"chargeType":"PostPaid"
		}
	]
}

错误码

HttpCode 错误码 错误信息 描述
403 Params.Illegal The specified parameters are wrongly formed.. 指定参数格式错误
403 User.OtherUserResource.NotAllow It is not allowed to operate other user's resource 不能操作其它用户的资源
403 Invalid.Cluster.Status Invalid cluster status %s in status list 指定集群状态不合法
403 Invalid.Cluster.Type Invalid cluster type %s in cluster type list 指定集群类型不合法
500 InternalError The request processing has failed due to some unknown error. 内部错误,请提工单

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