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

NAT Gateway:DescribeSnatTableEntries

最終更新日:Apr 27, 2026

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

今すぐお試しください

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

テスト

RAM 認証

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

リクエストパラメーター

パラメーター

必須 / 任意

説明

RegionId

string

必須

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

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

cn-hangzhou

SnatTableId

string

任意

SNAT テーブルの ID です。

説明

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

stb-8vbczigrhop8x5u3t****

SnatEntryId

string

任意

SNAT エントリの ID です。

snat-8vbae8uqh7rjpk7d2****

SourceVSwitchId

string

任意

vSwitch の ID です。

  • インターネット NAT ゲートウェイの SNAT エントリをクエリする場合、このパラメーターは、その vSwitch 内の Elastic Compute Service (ECS) インスタンスが SNAT エントリを使用してインターネットにアクセスできることを示します。

  • VPC NAT ゲートウェイの SNAT エントリをクエリする場合、このパラメーターは、その vSwitch 内の ECS インスタンスが SNAT エントリを使用して外部ネットワークにアクセスできることを示します。

vsw-3xbjkhjshjdf****

SourceCIDR

string

任意

SNAT エントリで指定された送信元 CIDR ブロックです。

116.22.XX.XX/24

SnatIp

string

任意

  • インターネット NAT ゲートウェイの SNAT エントリをクエリする場合、このパラメーターは SNAT エントリ内の EIP を示します。

  • VPC NAT ゲートウェイの SNAT エントリをクエリする場合、このパラメーターは SNAT エントリ内の NAT IP アドレスを示します。

116.22.XX.XX

SnatEntryName

string

任意

SNAT エントリの名前です。

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

SnatEntry-1

PageNumber

integer

任意

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

1

PageSize

integer

任意

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

10

NatGatewayId

string

任意

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

説明

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

ngw-bp1uewa15k4iy5770****

NetworkInterfaceIds

array

任意

クエリ対象のエラスティックネットワークインターフェースの ID です。

string

任意

エラスティックネットワークインターフェース ID

eni-gw8g131ef2dnbu3k****

レスポンスフィールド

フィールド

説明

object

PageSize

integer

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

5

RequestId

string

リクエスト ID です。

6D7E89B1-1C5B-412B-8585-4908E222EED5

PageNumber

integer

返されたページの番号です。

1

TotalCount

integer

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

1

SnatTableEntries

object

SnatTableEntry

array<object>

SNAT エントリの詳細情報です。

object

Status

string

SNAT エントリのステータスです。有効な値は次のとおりです。

  • Pending

  • Available

  • Deleting

Pending

SnatEntryName

string

SNAT エントリの名前です。

SnatEntry-1

SourceVSwitchId

string

  • インターネット NAT ゲートウェイの SNAT エントリをクエリする場合、このパラメーターは、SNAT を使用してインターネットにアクセスする vSwitch の ID を示します。

  • VPC NAT ゲートウェイの SNAT エントリをクエリする場合、このパラメーターは、SNAT を使用して外部ネットワークにアクセスする vSwitch の ID を示します。

vsw-3xbdsffvfgdfds****

SourceCIDR

string

SNAT エントリで指定された送信元 CIDR ブロックです。

116.22.XX.XX/24

SnatEntryId

string

SNAT エントリの ID です。

snat-kmd6nv8fy****

SnatTableId

string

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

stb-gz3r3odawdgffde****

SnatIp

string

  • インターネット NAT ゲートウェイの SNAT エントリをクエリする場合、このパラメーターは SNAT エントリ内の EIP を示します。

  • VPC NAT ゲートウェイの SNAT エントリをクエリする場合、このパラメーターは SNAT エントリ内の NAT IP アドレスを示します。

116.22.XX.XX

NatGatewayId

string

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

ngw-bp1uewa15k4iy5770****

NetworkInterfaceId

string

エラスティックネットワークインターフェース ID です。

eni-gw8g131ef2dnbu3k****

EipAffinity

string

IP アフィニティを有効にするかどうかを示します。値は次のとおりです。

  • 0:IP アフィニティを無効にします。 - 1:IP アフィニティを有効にします。

説明

IP アフィニティを有効にすると、SNAT エントリが複数の EIP または NAT IP にバインドされている場合、同一クライアントからのアクセスには常に同じ EIP または NAT IP が使用されます。無効の場合、クライアントはバインドされた EIP または NAT IP からランダムに選択してアクセスします。

1

成功レスポンス

JSONJSON

{
  "PageSize": 5,
  "RequestId": "6D7E89B1-1C5B-412B-8585-4908E222EED5",
  "PageNumber": 1,
  "TotalCount": 1,
  "SnatTableEntries": {
    "SnatTableEntry": [
      {
        "Status": "Pending",
        "SnatEntryName": "SnatEntry-1",
        "SourceVSwitchId": "vsw-3xbdsffvfgdfds****",
        "SourceCIDR": "116.22.XX.XX/24",
        "SnatEntryId": "snat-kmd6nv8fy****",
        "SnatTableId": "stb-gz3r3odawdgffde****",
        "SnatIp": "116.22.XX.XX",
        "NatGatewayId": "ngw-bp1uewa15k4iy5770****",
        "NetworkInterfaceId": "eni-gw8g131ef2dnbu3k****",
        "EipAffinity": "1"
      }
    ]
  }
}

エラーコード

HTTP ステータスコード

エラーコード

エラーメッセージ

説明

400 InvalidName.Malformed The specified Name is not valid.
400 DESCRIBE_SNAT_PARAM_INVALID SnatTableId and natGatewayId can not both be null
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records.
404 InvalidSnatTableId.NotFound Specified SNAT table does not exist.

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

変更履歴

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