カスタムルーティングリスナーのエンドポイントグループマッピングを変更します。

説明　

  • UpdateCustomRoutingEndpointGroupDestinationsは非同期操作です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はシステムバックグラウンドで実行中です。 DescribeCustomRoutingEndpointGroup操作を呼び出して、カスタムルートリスナーに関連付けられたエンドポイントグループの状態を照会し、エンドポイントグループのマッピングが変更されているかどうかを確認できます。
    • エンドポイントグループが更新中の状態の場合、エンドポイントグループのマッピングは変更中です。 この場合、クエリ操作のみを実行できます。
    • エンドポイントグループがアクティブ状態の場合、エンドポイントグループのマッピングが変更されます。
  • UpdateCustomRoutingEndpointGroupDestinations操作は、特定の期間内に同じGlobal Accelerator (GA) インスタンスに対して繰り返し呼び出すことはできません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 UpdateCustomRoutingEndpointGroupDestinations

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

RegionId String 必須 cn-hangzhou

GAインスタンスがデプロイされているリージョンのID。 値をcn-hangzhouに設定します。

ClientToken String 任意 123e4567-e89b-12d3-a456-426655440000

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 クライアントトークンにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 RequestIdの値は、APIリクエストごとに異なる場合があります。
DryRun Boolean いいえ false

リクエストのみを事前チェックするかどうかを指定します。 デフォルト値：false 有効な値：

  • true: 操作を実行せずにリクエストを事前チェックします。 システムは、必要なパラメーター、要求構文、および制限をチェックします。 リクエストが事前チェックに失敗した場合、エラーメッセージが返されます。 リクエストが事前チェックに合格した場合、DryRunOperationエラーコードが返されます。
  • false: リクエストを送信します。 リクエストが事前チェックに合格すると、2xx HTTPステータスコードが返され、操作が実行されます。
EndpointGroupId String 任意 epg-bp1dmlohjjz4kqaun****

エンドポイントグループの ID。

DestinationConfigurations.N.Protocols.N String 任意 tcp

エンドポイントグループのバックエンドサービスプロトコル。 有効な値：

  • tcp: TCP
  • udp: UDP
  • tcp,udp :TCPおよびUDP。

エンドポイントグループごとに最大4つのバックエンドサービスプロトコルを指定できます。

DestinationConfigurations.N.FromPort Integer いいえ 80

エンドポイントグループのバックエンドサービスのポート範囲の開始ポート。

有効な値: 1〜65499。 FromPort値はToPort値以下である必要があります。

各リクエストで最大20個のバックエンドサービスポート範囲の開始ポートを指定できます。

DestinationConfigurations.N.ToPort Integer いいえ 80

エンドポイントグループのバックエンドサービスのポート範囲の終了ポート。

有効な値: 1〜65499。 FromPort値はToPort値以下である必要があります。

各リクエストには、バックエンドサービスのポート範囲の最大20個のエンドポートを指定できます。

N.DestinationId String 任意 dst-abc123 ****

エンドポイントグループのマッピング設定のID。

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String 04F0F334-1335-436C-A1D7-6C044FE73368

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/? アクション=UpdateCustomRoutingEndpointGroupDestinations
&RegionId=cn-hangzhou
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&DryRun=false
&EndpointGroupId=epg-bp1dmlohjjz4kqaun ****
&DestinationConfigurations=[{"Protocols":["tcp"],"FromPort":80,"ToPort":80,"DestinationId":"dst-abc123 ****"}]
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateCustomRoutingEndpointGroupDestinationsResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
</UpdateCustomRoutingEndpointGroupDestinationsResponse>

JSON 形式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368"
}

エラーコード

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