DNATエントリを照会します。

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

NATゲートウェイのリージョンID。

DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

ForwardTableId String 任意 ftb-bp1mbjubq34hlcqpa ****

DNATテーブルのID。

説明 ForwardTableIdパラメーターとNatGatewayIdパラメーターの少なくとも1つを設定する必要があります。
ForwardEntryId String 任意 fwd-8vbn3bc8roygjp0gy ****

DNATエントリのID。

ExternalIp String 任意 116.28.XX.XX
  • インターネットNATゲートウェイのDNATエントリを照会するときにインターネット経由でアクセスできるEIPアドレス (EIP) 。
  • Virtual Private Cloud (VPC) NAT GatewayのDNATエントリを照会するときに外部ネットワークからアクセスできるNAT IPアドレス。
ExternalPort String 任意 8080
  • インターネットNATゲートウェイのDNATエントリを照会するときにポート転送に使用される外部ポートまたはポート範囲。
    • 有効な値: 165535
    • ポート範囲を照会する場合は、最初のポートと最後のポートをスラッシュ (/) (10/20など) で区切ります。
    • ExternalPortをポート範囲に設定する場合、InternalPortもポート範囲に設定する必要があります。これらのパラメーターで指定されるポートの数は同じである必要があります。 たとえば、ExternalPort10/20に設定した場合、InternalPort80/90に設定できます。
  • VPC NATゲートウェイのDNATエントリを照会するときに、NAT IPアドレスが外部ネットワークからアクセスできるときに使用されるポート。 有効な値: 165535
InternalIp String 任意 192.168.XX.XX

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

  • インターネットNATゲートウェイのDNATエントリを照会するときに、DNATエントリを使用してインターネットと通信するECSインスタンスのプライベートIPアドレス。
  • VPC NAT GatewayのDNATエントリをクエリするときに、通信にDNATエントリを使用するプライベートIPアドレス。
InternalPort String 任意 80
  • インターネットNATゲートウェイのDNATエントリを照会するときにポート転送に使用される内部ポートまたはポート範囲。 有効な値: 165535
  • VPC NAT GatewayのDNATエントリを照会するときにマッピングされる宛先ECSインスタンスのポート。 有効な値: 165535
IpProtocol String 任意 TCP

プロトコル。 有効な値:

  • TCP: NATゲートウェイはTCPパケットを転送します。
  • UDP: NATゲートウェイはUDPパケットを転送します。
  • 任意: NATゲートウェイは、すべてのプロトコルのパケットを転送します。
ForwardEntryName String 任意 ForwardEntry-1

DNATエントリの名前。

名前は2 ~ 128文字で、数字、ピリオド (.) 、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は文字である必要があります。

PageNumber Integer いいえ 1

返されるページのページ番号。 既定値:1

PageSize Integer いいえ 10

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

NatGatewayId String 任意 ngw-bp1uewa15k4iy5770 ****

NAT ゲートウェイの ID 。

説明 ForwardTableIdパラメーターとNatGatewayIdパラメーターの少なくとも1つを設定する必要があります。

レスポンスパラメーター

項目 データ型 例: 説明 
PageSize Integer 10

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

RequestId String A6C4A8B1-7561-4509-949C-20DEB40D71E6

リクエストの ID です。

PageNumber Integer 1

返されたページ数。

TotalCount Integer 5

返されたエントリの数。

ForwardTableEntries ForwardTableEntryの配列

DNATエントリの詳細。

ForwardTableEntry
Status String Available

DNATエントリのステータス。 有効な値:

  • 保留中: 作成または変更中
  • 利用可能: 利用可能
  • Deleting: 削除中
ForwardEntryId String fwd-119smw5tk ****

DNATエントリのID。

InternalIp String 192.168.XX.XX

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

  • インターネットNATゲートウェイのDNATエントリを照会するときに、DNATエントリを使用してインターネットと通信するECSインスタンスのプライベートIPアドレス。
  • VPC NAT GatewayのDNATエントリをクエリするときにDNATエントリを使用するプライベートIPアドレス。
InternalPort String 25
  • インターネットNATゲートウェイのDNATエントリを照会するときにポート転送に使用される内部ポートまたはポート範囲。
  • VPC NAT GatewayのDNATエントリを照会するときにマッピングされる宛先ECSインスタンスポート。
ForwardEntryName String ForwardEntry-1

DNATエントリの名前。

ForwardTableId String ftb-11tc6xgmv ****

DNATエントリが属するDNATテーブルのID。

IpProtocol String TCP

プロトコル。 有効な値:

  • TCP: NATゲートウェイはTCPパケットを転送します。
  • UDP: NATゲートウェイはUDPパケットを転送します。
  • 任意: NATゲートウェイは、すべてのプロトコルのパケットを転送します。
ExternalPort String 80
  • インターネットNATゲートウェイのDNATエントリを照会するときにポート転送に使用される外部ポートまたはポート範囲。
  • VPC NATゲートウェイのDNATエントリを照会するときに、NAT IPアドレスが外部ネットワークからアクセスできるときに使用されるポート。
ExternalIp String 139.79.XX.XX
  • インターネットNATゲートウェイのDNATエントリを照会するときにインターネット経由でアクセスできるEIP。
  • VPC NATゲートウェイのDNATエントリを照会するときに外部ネットワークからアクセスできるNAT IPアドレス。

リクエストの例

http(s)://[Endpoint]/?Action=DescribeForwardTableEntries
&RegionId=cn-hangzhou
&ForwardTableId=ftb-bp1mbjubq34hlcqpa ****
&ForwardEntryId=fwd-8vbn3bc8roygjp0gy ****
&ExternalIp=116.28.XX.XX
&ExternalPort=8080
&InternalIp=192.168.XX.XX
&InternalPort=80
&IpProtocol=TCP
&ForwardEntryName=ForwardEntry-1
&PageNumber=1
&PageSize=10
&NatGatewayId=ngw-bp1uewa15k4iy5770 ****
&共通リクエストパラメータ

レスポンスの例

XML 形式

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

<DescribeForwardTableEntriesResponse>
    <のPageSize> 10 </がPageSize>
    <RequestId>A6C4A8B1-7561-4509-949C-20DEB40D71E6</RequestId>
    <ページ番号> 1 </ PAGENUMBER>
    <TotalCount>5</TotalCount>
    <ForwardTableEntries>
        <Status>Active</Status>
        <ForwardEntryId>fwd-119smw5tk ****</ForwardEntryId>
        <InternalIp>192.168.XX.XX</InternalIp>
        <InternalPort>25</InternalPort>
        <ForwardEntryName>ForwardEntry-1</ForwardEntryName>
        <ForwardTableId>ftb-11tc6xgmv ****</ForwardTableId>
        <IpProtocol>TCP</IpProtocol>
        <ExternalPort>80</ExternalPort>
        <ExternalIp>139.79.XX.XX</ExternalIp>
    </ForwardTableEntries>
</DescribeForwardTableEntriesResponse>

JSON 形式

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

{
  "PageSize" : 10,
  "RequestId" : "A6C4A8B1-7561-4509-949C-20DEB40D71E6" 、
  "PageNumber" : 1,
  "TotalCount" : 5、
  "ForwardTableEntries" : [ {
    "ステータス" : "利用可能" 、
    "ForwardEntryId" : "fwd-119smw5tk ****" 、
    "InternalIp" : "192.168.XX.XX" 、
    "InternalPort" : "25" 、
    "ForwardEntryName" : "ForwardEntry-1" 、
    "ForwardTableId" : "ftb-11tc6xgmv ****" 、
    "IpProtocol" : "TCP" 、
    "ExternalPort" : "80" 、
    "ExternalIp" : "139.79.XX.XX"
  } ]
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明 
400 IncorretForwardEntryStatus 一部のForward entryステータスがこの操作をブロックしました。 指定された操作を実行する権限がない場合に返されるエラーメッセージ。 DNATテーブルの1つ以上のDNATエントリがPendingまたはModifying状態にある場合に返されるエラーメッセージ。
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。
404 InvalidForwardTableId.NotFound 指定された forwardTableId は存在しません 指定されたDNATテーブルが存在しない場合に返されるエラーメッセージ。 パラメーター値を確認して、もう一度お試しください。

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