カスタムルーティングリスナーのポートマッピングテーブルを照会します。

説明　

Global Accelerator (GA) インスタンスのカスタムルーティングリスナーを設定すると、リスナーのポート範囲、バックエンドサービスプロトコル、関連付けられたエンドポイントグループのポート範囲、エンドポイントのIPアドレス (vSwitch) に基づいて、インスタンスはポートマッピングテーブルを生成します。 カスタムルーティングリスナーは、ポートマッピングテーブルに基づいて、vSwitchの指定されたIPアドレスとポートにクライアント要求を転送します。 この操作は、生成されたポートマッピングテーブルを照会するために使用されます。

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

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

PageNumber String いいえ 1

返されるページ数。 既定値：1

PageSize String 任意 10

各ページで返されるエントリ数。 最大値：50 既定値：1

AcceleratorId String 必須 ga-bp1odcab8tmno0hdq****

GA インスタンスの ID です。

ListenerId String 任意 lsr-bp1bpn0kn908w4nbw****

リスナーの ID を示します。

EndpointGroupId String 任意 epg-bp16jdc00bhe97sr5 ****

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

レスポンスパラメーター

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

リクエストの ID です。

TotalCount Integer 1

返されたエントリの数。

PageSize Integer 10

返された各ページのエントリ数を示します。

PageNumber Integer 1

返されたページ数。

ポートマッピング portMappingsの配列

ポートマッピングテーブルの詳細。

AcceleratorId String ga-bp1odcab8tmno0hdq****

GA インスタンスの ID です。

ListenerId String lsr-bp1bpn0kn908w4nbw****

リスナーの ID を示します。

EndpointGroupId String epg-bp14sz7ftcwwjgrdm ****

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

EndpointId String ep-bp14sz7ftcwwjgrdm ****

エンドポイントの ID

EndpointGroupRegion String us-west-1

エンドポイントグループが存在するリージョンのID。

Vswitch String vsw-test01

エンドポイント (vSwitch) の名前。

AcceleratorPort Integer 3000

アクセラレーションポート。

プロトコル 文字列の配列 tcp

バックエンドサービスのプロトコル。

  • tcp: TCP
  • udp: UDP
DestinationTrafficState String 許可する

バックエンドインスタンスのトラフィックのアクセスポリシー。 有効な値：

  • allow: バックエンドインスタンスへのトラフィックを許可します。
  • deny: バックエンドインスタンスへのトラフィックを拒否します。
DestinationSocketAddress オブジェクト

バックエンドインスタンスのサービスIPアドレスとポート。

IpAddress String 10.0.XX.XX

バックエンドインスタンスのサービスIPアドレス。

ポート Integer 443

バックエンドインスタンスのサービスポート。

例

リクエストの例

http(s)://[Endpoint]/?Action=ListCustomRoutingPortMappings
&RegionId=cn-hangzhou
&PageNumber=1
&PageSize=10
&AcceleratorId=ga-bp1odcab8tmno0hdq ****
&ListenerId=lsr-bp1bpn0kn908w4nbw ****
&EndpointGroupId=epg-bp16jdc00bhe97sr5 ****
&<共通リクエストパラメーター>

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

XML 形式 

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

<ListCustomRoutingPortMappingsResponse>
    <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId>
    <TotalCount> 1 </ TotalCount>
    <のPageSize> 10 </がPageSize>
    <ページ番号> 1 </ PAGENUMBER>
    <PortMappings>
        <AcceleratorId>ga-bp1odcab8tmno0hdq ****</AcceleratorId>
        <ListenerId>lsr-bp1bpn0kn908w4nbw****</ListenerId>
        <EndpointGroupId>epg-bp14sz7ftcwwjgrdm ****</EndpointGroupId>
        <EndpointId>ep-bp14sz7ftcwwjgrdm ****</EndpointId>
        <EndpointGroupRegion>us-west-1</EndpointGroupRegion>
        <Vswitch>vsw-test01</Vswitch>
        <AcceleratorPort>3000</AcceleratorPort>
        <プロトコル> tcp</プロトコル>
        <DestinationTrafficState> 許可 </DestinationTrafficState>
        <DestinationSocketAddress>
            <IpAddress>10.0.XX.XX</IpAddress>
            <ポート> 443</ポート>
        </DestinationSocketAddress>
    </PortMappings>
</ListCustomRoutingPortMappingsResponse>

JSON 形式 

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

{
  "RequestId" : "04F0F334-1335-436C-A1D7-6C044FE73368" 、
  "TotalCount" : 1、
  "PageSize" : 10,
  "PageNumber" : 1,
  "PortMappings" : [ {
    "AcceleratorId" : "ga-bp1odcab8tmno0hdq ****" 、
    "ListenerId" : "lsr-bp1bpn0kn908w4nbw ****" 、
    "EndpointGroupId" : "epg-bp14sz7ftcwwjgrdm ****" 、
    "EndpointId" : "ep-bp14sz7ftcwwjgrdm ****" 、
    "EndpointGroupRegion" : "us-west-1" 、
    "Vswitch" : "vsw-test01" 、
    "AcceleratorPort" : 3000、
    "Protocols" : [ "tcp"] 、
    "DestinationTrafficState" : "allow" 、
    "DestinationSocketAddress" : {
      "IpAddress" : "10.0.XX.XX" 、
      "ポート" : 443
    }
  } ]
}

エラーコード

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