この操作では、クラスターのすべてのホストにインストールされているコンポーネントを照会します。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 OpenAPI Explorer を使用すると、API を簡単に設定できます。 OpenAPI Explorer を使用して、API の検索、API のコール、SDK サンプルコードの動的生成を行うことができます。

リクエストパラメーター

パラメーター データ型 必須/任意 説明
Action String 必須 ListClusterHostComponent

実行する操作。 値を ListClusterHostComponent に設定します。

ClusterId String 必須 C-F32FB31D82954C64

クラスターの ID。

RegionId String 必須 cn-hangzhou

クラスターが属するリージョンの ID。

ServiceName String 任意 TEZ

サービスの名前。

ComponentName String 任意 TezInit

照会するコンポーネントの名前。

ComponentStatus String 任意 STARTED

照会するコンポーネントのステータス。

HostInstanceId String 任意 i-xxx

ECS インスタンスの ID

HostName String 任意 emr-worker-1

ホスト名。

HostRole String 任意 CORE

ホストのロール。

PageNumber Integer 任意 1

返されるページ数。

PageSize Integer 任意 100

返される各ページのエントリ数。

AccessKeyId String 任意 LTAI8ljWyu7y****

Alibaba Cloud から提供された AccessKey ID。 このパラメーターはユーザーを識別します。

レスポンスパラメーター

パラメーター データ型 説明
ComponentList

ホストにインストールされているコンポーネント。

Component

コンポーネントの情報。

ComponentDisplayName String Tez Client

ユーザーの表示名。

ComponentName String TezInit

コンポーネントの名前。

Cpu Integer 4

ホストの vCPU の数。

HostId String 111

ホストの ID 。

HostInstanceId String i-xxx

ECS インスタンスの ID

HostName String emr-worker-1

ホストの名前。

InstanceType String ecs.sn1.xlarge

ECS インスタンスの種類。

Memory Integer 8

ECS インスタンスのメモリ。

NeedRestart Boolean true

コンポーネントの再起動の要否。

PrivateIp String 192.168.1.1

ホストのプライベート IP アドレス。

PublicIp String 48.20.119.10

ホストのパブリック IP アドレス。

Role String CORE

ホストのロールです。

SerialNumber String x11-05e5-4d36-b773-8ae4106babd4

ホストのシリアル番号

ServerStatus String active

コンポーネントのサービスステータス。 例:高可用性クラスターの一部のコンポーネントの有効な値は、active 、 standby 。

ServiceDisplayName String Tez

サービスの表示名。

ServiceName String TEZ

サービスの名前。

Status String STARTED

コンポーネントのステータス。

PageNumber Integer 100

返されたページの数。

PageSize Integer 1

1 ページあたりの返されたエントリ数。

RequestId String DF202AC2-5D5D-4288-B608-B7B1595B5C7C

リクエストの ID。

Total Integer 4

返されたエントリの総数。

リクエストの例


http(s)://[Endpoint]/? Action=ListClusterHostComponent
&ClusterId=C-F32FB31D82954C64
&RegionId=cn-hangzhou
&<共通リクエストパラメーター>

通常のレスポンス例

XML 形式

<ListClusterHostComponentResponse>
	  <PageSize>10</PageSize>
	  <RequestId>DF202AC2-5D5D-4288-B608-B7B1595B5C7C</RequestId>
	  <PageNumber>1</PageNumber>
	  <Total>4</Total>
	  <ComponentList>
		    <Component>
			      <Status>STARTED</Status>
			      <ComponentDisplayName>Tez Client</ComponentDisplayName>
			      <PublicIp>47.97.106.27</PublicIp>
			      <HostInstanceId>i-xxx1</HostInstanceId>
			      <HostId>124903</HostId>
			      <ServiceDisplayName>Tez</ServiceDisplayName>
			      <Role>MASTER</Role>
			      <SerialNumber>x11-05e5-4d36-b773-8ae4106babd4</SerialNumber>
			      <PrivateIp>192.168.143.231</PrivateIp>
			      <ServiceName>TEZ</ServiceName>
			      <NeedRestart>false</NeedRestart>
			      <ComponentName>TezInit</ComponentName>
			      <InstanceType>ecs.n4.xlarge</InstanceType>
			      <HostName>emr-header-1</HostName>
		    </Component>
		    <Component>
			      <Status>STARTED</Status>
			      <ComponentDisplayName>Tomcat</ComponentDisplayName>
			      <PublicIp>47.97.106.27</PublicIp>
			      <HostInstanceId>i-xxx2</HostInstanceId>
			      <HostId>124903</HostId>
			      <ServiceDisplayName>Tez</ServiceDisplayName>
			      <Role>MASTER</Role>
			      <SerialNumber>1xx1-05e5-x-b773-xxx</SerialNumber>
			      <PrivateIp>192.168.143.231</PrivateIp>
			      <ServiceName>TEZ</ServiceName>
			      <NeedRestart>false</NeedRestart>
			      <ComponentName>Tomcat</ComponentName>
			      <InstanceType>ecs.n4.xlarge</InstanceType>
			      <HostName>emr-header-1</HostName>
		    </Component>
		    <Component>
			      <Status>STARTED</Status>
			      <ComponentDisplayName>Tez Client</ComponentDisplayName>
			      <PublicIp></PublicIp>
			      <HostInstanceId>i-xxx3</HostInstanceId>
			      <HostId>124902</HostId>
			      <ServiceDisplayName>Tez</ServiceDisplayName>
			      <Role>CORE</Role>
			      <SerialNumber>asd1x1-af39-1c-32b27d83d4c3</SerialNumber>
			      <PrivateIp>192.168.143.232</PrivateIp>
			      <ServiceName>TEZ</ServiceName>
			      <NeedRestart>false</NeedRestart>
			      <ComponentName>TezInit</ComponentName>
			      <InstanceType>ecs.n4.xlarge</InstanceType>
			      <HostName>emr-worker-1</HostName>
		    </Component>
		    <Component>
			      <Status>STARTED</Status>
			      <ComponentDisplayName>Tez Client</ComponentDisplayName>
			      <PublicIp></PublicIp>
			      <HostInstanceId>i-xxx4</HostInstanceId>
			      <HostId>124901</HostId>
			      <ServiceDisplayName>Tez</ServiceDisplayName>
			      <Role>CORE</Role>
			      <SerialNumber>1cc-2762-4d84-a430-xxx</SerialNumber>
			      <PrivateIp>192.168.143.233</PrivateIp>
			      <ServiceName>TEZ</ServiceName>
			      <NeedRestart>false</NeedRestart>
			      <ComponentName>TezInit</ComponentName>
			      <InstanceType>ecs.n4.xlarge</InstanceType>
			      <HostName>emr-worker-2</HostName>
		    </Component>
	  </ComponentList>
</ListClusterHostComponentResponse>

JSON 形式

{
	"PageNumber":1,
	"PageSize":10,
	"RequestId":"DF202AC2-5D5D-4288-B608-B7B1595B5C7C",
	"Total":4,
	"ComponentList":{
		"Component":[
			{
				"NeedRestart":false,
				"HostInstanceId":"i-xxx1",
				"ComponentDisplayName":"Tez Client",
				"HostId":"124903",
				"ServiceDisplayName":"Tez",
				"PrivateIp":"192.168.143.231",
				"HostName":"emr-header-1",
				"InstanceType":"ecs.n4.xlarge",
				"SerialNumber":"x11-05e5-4d36-b773-8ae4106babd4",
				"Status":"STARTED",
				"ServiceName":"TEZ",
				"PublicIp":"47.97.106.27",
				"Role":"MASTER",
				"ComponentName":"TezInit"
			},
			{
				"NeedRestart":false,
				"HostInstanceId":"i-xxx2",
				"ComponentDisplayName":"Tomcat",
				"HostId":"124903",
				"ServiceDisplayName":"Tez",
				"PrivateIp":"192.168.143.231",
				"HostName":"emr-header-1",
				"InstanceType":"ecs.n4.xlarge",
				"SerialNumber":"1xx1-05e5-x-b773-xxx",
				"Status":"STARTED",
				"ServiceName":"TEZ",
				"PublicIp":"47.97.106.27",
				"Role":"MASTER",
				"ComponentName":"Tomcat"
			},
			{
				"NeedRestart":false,
				"HostInstanceId":"i-xxx3",
				"ComponentDisplayName":"Tez Client",
				"HostId":"124902",
				"ServiceDisplayName":"Tez",
				"PrivateIp":"192.168.143.232",
				"HostName":"emr-worker-1",
				"InstanceType":"ecs.n4.xlarge",
				"SerialNumber":"asd1x1-af39-1c-32b27d83d4c3",
				"Status":"STARTED",
				"ServiceName":"TEZ",
				"PublicIp":"",
				"Role":"CORE",
				"ComponentName":"TezInit"
			},
			{
				"NeedRestart":false,
				"HostInstanceId":"i-xxx4",
				"ComponentDisplayName":"Tez Client",
				"HostId":"124901",
				"ServiceDisplayName":"Tez",
				"PrivateIp":"192.168.143.233",
				"HostName":"emr-worker-2",
				"InstanceType":"ecs.n4.xlarge",
				"SerialNumber":"1cc-2762-4d84-a430-xxx",
				"Status":"STARTED",
				"ServiceName":"TEZ",
				"PublicIp":"",
				"Role":"CORE",
				"ComponentName":"TezInit"
			}
		]
	}
}

エラーコード

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 エラーセンター」をご参照ください。