すべてのプロダクト
Search
ドキュメントセンター

NAT Gateway:DescribeForwardTableEntries

最終更新日:Apr 27, 2026

DNAT エントリをクエリします。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

この操作の認証情報はありません。問題が発生した場合は、アカウントマネージャーにご連絡ください。

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

NAT ゲートウェイを作成するリージョンの ID です。

最新のリージョン一覧を取得するには、DescribeRegions 操作を呼び出してください。

cn-hangzhou

ForwardTableId

string

任意

DNAT テーブルの ID です。

**

説明 ForwardTableId および NatGatewayId のいずれか一方は必ず指定する必要があります。

ftb-bp1mbjubq34hlcqpa****

ForwardEntryId

string

任意

DNAT エントリの ID です。

fwd-8vbn3bc8roygjp0gy****

ExternalIp

string

任意

  • インターネット NAT ゲートウェイの DNAT エントリをクエリする場合、インターネット経由でアクセス可能な EIP (Elastic IP アドレス) です。

  • VPC NAT ゲートウェイの DNAT エントリをクエリする場合、外部ネットワークからアクセス可能な NAT IP アドレスです。

116.28.XX.XX

ExternalPort

string

任意

  • インターネット NAT ゲートウェイの DNAT エントリをクエリする場合に使用されるポート転送用の外部ポートまたはポート範囲です。

    • 有効値:165535

    • ポート範囲をクエリする場合は、最初のポートと最後のポートをスラッシュ (/) で区切って指定します。例:10/20

    • ExternalPort をポート範囲として設定する場合は、InternalPort もポート範囲として設定し、両方のパラメーターで指定するポート数を一致させる必要があります。たとえば、ExternalPort10/20 に設定した場合、InternalPort80/90 に設定できます。

  • VPC NAT ゲートウェイの DNAT エントリをクエリする場合、外部ネットワークから NAT IP アドレスにアクセスする際に使用されるポートです。有効値:165535

8080

InternalIp

string

任意

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

  • インターネット NAT ゲートウェイの DNAT エントリをクエリする場合、インターネットとの通信に DNAT エントリを使用する ECS インスタンスのプライベート IP アドレスです。

  • VPC NAT ゲートウェイの DNAT エントリをクエリする場合、DNAT エントリを使用して通信を行うプライベート IP アドレスです。

192.168.XX.XX

InternalPort

string

任意

  • インターネット NAT ゲートウェイの DNAT エントリをクエリする場合に使用されるポート転送用の内部ポートまたはポート範囲です。有効値:165535

  • VPC NAT ゲートウェイの DNAT エントリをクエリする場合、マッピング対象の送信先 ECS インスタンスのポートです。有効値:165535

80

IpProtocol

string

任意

プロトコルです。有効値:

  • TCP

  • UDP

  • Any

tcp

ForwardEntryName

string

任意

DNAT エントリの名前です。

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

ForwardEntry-1

PageNumber

integer

任意

ページ番号です。デフォルト値:1

1

PageSize

integer

任意

1 ページあたりのエントリ数です。最大値:50。デフォルト値:10

10

NatGatewayId

string

任意

NAT ゲートウェイの ID です。

**

説明 ForwardTableId および NatGatewayId のいずれか一方は必ず指定する必要があります。

ngw-bp1uewa15k4iy5770****

レスポンスフィールド

フィールド

説明

object

PageSize

integer

1 ページあたりのエントリ数です。

10

RequestId

string

リクエスト ID です。

A6C4A8B1-7561-4509-949C-20DEB40D71E6

PageNumber

integer

ページ番号です。

1

TotalCount

integer

返されたエントリの数です。

5

ForwardTableEntries

object

ForwardTableEntry

array<object>

DNAT エントリの詳細です。

object

Status

string

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

  • Pending

  • Available

  • Deleting

Available

ForwardEntryId

string

DNAT エントリの ID です。

fwd-119smw5tk****

InternalIp

string

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

  • インターネット NAT ゲートウェイの DNAT エントリをクエリする場合、インターネットとの通信に DNAT エントリを使用する ECS インスタンスのプライベート IP アドレスです。

  • VPC NAT ゲートウェイの DNAT エントリをクエリする場合、DNAT エントリを使用して通信を行うプライベート IP アドレスです。

192.168.XX.XX

InternalPort

string

  • インターネット NAT ゲートウェイの DNAT エントリをクエリする場合に使用されるポート転送用の内部ポートまたはポート範囲です。

  • VPC NAT ゲートウェイの DNAT エントリをクエリする場合、マッピング対象の送信先 ECS インスタンスのポートです。

25

ForwardEntryName

string

DNAT エントリの名前です。

ForwardEntry-1

ForwardTableId

string

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

ftb-11tc6xgmv****

IpProtocol

string

プロトコルです。有効値:

  • TCP

  • UDP

  • Any

tcp

ExternalPort

string

  • インターネット NAT ゲートウェイの DNAT エントリをクエリする場合に使用されるポート転送用の外部ポートまたはポート範囲です。

  • VPC NAT ゲートウェイの DNAT エントリをクエリする場合、外部ネットワークから NAT IP アドレスにアクセスする際に使用されるポートです。

80

ExternalIp

string

  • インターネット NAT ゲートウェイの DNAT エントリをクエリする場合、インターネット経由でアクセス可能な EIP です。

  • VPC NAT ゲートウェイの DNAT エントリをクエリする場合、外部ネットワークからアクセス可能な NAT IP アドレスです。

139.79.XX.XX

NatGatewayId

string

DNAT エントリが属する NAT ゲートウェイの ID です。

ngw-bp1uewa15k4iy5770****

成功レスポンス

JSONJSON

{
  "PageSize": 10,
  "RequestId": "A6C4A8B1-7561-4509-949C-20DEB40D71E6",
  "PageNumber": 1,
  "TotalCount": 5,
  "ForwardTableEntries": {
    "ForwardTableEntry": [
      {
        "Status": "Available",
        "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",
        "NatGatewayId": "ngw-bp1uewa15k4iy5770****"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 IncorretForwardEntryStatus Some Forward entry status blocked this operation..
400 DESCRIBE_FORWARD_PARAM_INVALID ForwardTableId and natGatewayId can not both be null
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
404 InvalidForwardTableId.NotFound Specified forwardTableId does not exist

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。