この操作を呼び出して、ディスク、CPU、メモリの設定を含む、E-MapReduce (EMR) クラスター内のホストの情報を照会できます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この API は、OpenAPI Explorerで呼び出すことを推奨します。 OpenAPI Explorer は、各種 SDK に用意されている API のサンプルコードを動的に生成します。

リクエストパラメーター

パラメーター データ型 必須／任意 例 説明
Action String 必須 ListClusterHost

実行する操作。 値を ListClusterHost に設定します。
ClusterId String 必須 C-D7CA98AAA96A****

クラスターの ID。
RegionId String 必須 cn-hangzhou-d

クラスターの存在するリージョンの ID。
AccessKeyId String 任意 LTAI8ljWyu7y****

Alibaba Cloud によって提供された AccessKey ID。ユーザー ID を識別します。
ComponentName String 任意 HiveServer2

コンポーネントの名前。
GroupType String 任意 MASTER

ホストグループのタイプ。
HostGroupId String 任意 G-A5EA210E15FCFF8E

ホストグループの ID。
HostInstanceId String 任意 i-bp11vdyh3l6xvmnl****

ECS (Elastic Compute Service) インスタンスの 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

EMR クラスターの有効期限。
ExpiredTime Long 32493801600000

ホストの有効期限。
HostGroupId String G-A5EA210E15FCFF8E

ホストグループの ID。
HostInstanceId String i-bp1cfwf2cwgji7ds****

ECS インスタンスの ID。
HostName String emr-header-1

ホストの名前。
InstanceStatus String NORMAL

ECS インスタンスのステータス。
InstanceType String ecs.mn4.xlarge

ホストのインスタンスタイプ。
Memory Integer 16

ホストのメモリサイズ。 単位 : GB。
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

1 ページ当たりの返されるエントリの数。
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"
		}
	]
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明
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. 内部エラーが発生した場合に返されるエラーメッセージ。 チケットを起票しサポートセンターにお問い合わせください。

エラーコードについては、「API エラーセンター」をご参照ください。