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

デバッグ

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

リクエストパラメーター

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

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

RegionId String 必須 cn-hangzhou

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

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

SnatTableId String 任意 stb-8vbczigrhop8x5u3t ****

SNATテーブルのID。

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

SNATエントリのID。

SourceVSwitchId String 任意 vsw-3xbjkhjshjdf ****

VSwitch の ID です。

  • インターネットNATゲートウェイのSNATエントリを照会する場合、このパラメータは、vSwitchのECS (Elastic Compute Service) インスタンスがSNATエントリを使用してインターネットにアクセスできることを指定します。
  • 仮想プライベートクラウド (VPC) NAT GatewayのSNATエントリを照会する場合、このパラメータはvSwitchのECSインスタンスがSNATエントリを使用して外部ネットワークにアクセスできることを指定します。
ソースCIDR String 任意 116.22.XX.XX/24

SNATエントリで指定されたソースCIDRブロック。

SnatIp String 任意 116.22.XX.XX
  • インターネットNATゲートウェイのSNATエントリを照会する場合、このパラメータにはSNATエントリのEIPを指定します。
  • VPC NAT GatewayのSNATエントリを照会する場合、このパラメーターにはSNATエントリのNAT IPアドレスを指定します。
SnatEntryName String 任意 SnatEntry-1

SNATエントリの名前。

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

PageNumber Integer いいえ 1

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

PageSize Integer いいえ 10

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

NatGatewayId String 任意 ngw-bp1uewa15k4iy5770 ****

NAT ゲートウェイの ID 。

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

レスポンスパラメーター

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

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

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

リクエストの ID です。

PageNumber Integer 1

返されたページ数。

TotalCount Integer 1

返されたエントリの数。

SnatTableEntries SnatTableEntryの配列

SNATエントリの詳細。

SnatTableEntry
Status String Pending

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

  • 保留中: 作成または変更中
  • 利用可能: 利用可能
  • Deleting: 削除中
SnatEntryName String SnatEntry-1

SNATエントリの名前。

SourceVSwitchId String vsw-3xbdsffvfgdfds ****
  • インターネットNATゲートウェイのSNATエントリを照会する場合、このパラメータは、SNATを使用してインターネットにアクセスするvSwitchのIDを示します。
  • VPC NATゲートウェイのSNATエントリを照会する場合、このパラメーターはSNATを使用して外部ネットワークにアクセスするvSwitchのIDを示します。
ソースCIDR String 116.22.XX.XX/24

SNATエントリで指定されたソースCIDRブロック。

SnatEntryId String snat-kmd6nv8fy ****

SNATエントリのID。

SnatTableId String stb-gz3r3odawdgffde ****

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

SnatIp String 116.22.XX.XX
  • インターネットNATゲートウェイのSNATエントリを照会する場合、このパラメータはSNATエントリのEIPを示します。
  • VPC NAT GatewayのSNATエントリを照会する場合、このパラメーターはSNATエントリのNAT IPアドレスを示します。

リクエストの例

http(s)://[Endpoint]/?Action=DescribeSnatTableEntries
&RegionId=cn-hangzhou
&SnatTableId=stb-8vbczigrhop8x5u3t ****
&SnatEntryId=snat-8vbae8uqh7rjpk7d2 ****
&SourceVSwitchId=vsw-3xbjkhjshjdf ****
&SourceCIDR=116.22.XX.XX/24
&SnatIp=116.22.XX.XX
&SnatEntryName=SnatEntry-1
&PageNumber=1
&PageSize=10
&NatGatewayId=ngw-bp1uewa15k4iy5770 ****
&共通リクエストパラメータ

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

XML 形式

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

<DescribeSnatTableEntriesResponse>
    <PageSize>5</PageSize>
    <RequestId>6D7E89B1-1C5B-412B-8585-4908E222EED5</RequestId>
    <ページ番号> 1 </ PAGENUMBER>
    <TotalCount> 1 </ TotalCount>
    <SnatTableEntries>
        <Status>Pending</Status>
        <SnatEntryName>SnatEntry-1</SnatEntryName>
        <SourceVSwitchId>vsw-3xbdsffvfgdfds ****</SourceVSwitchId>
        <SourceCIDR>116.22.XX.XX/24</SourceCIDR>
        <SnatEntryId>snat-kmd6nv8fy ****</SnatEntryId>
        <SnatTableId>stb-gz3r3odawdgffde ****</SnatTableId>
        <SnatIp>116.22.XX.XX</SnatIp>
    </SnatTableEntries>
</DescribeSnatTableEntriesResponse>

JSON 形式

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

{
  "PageSize" : 5、
  "RequestId" : "6D7E89B1-1C5B-412B-8585-4908E222EED5" 、
  "PageNumber" : 1,
  "TotalCount" : 1、
  "SnatTableEntries" : [ {
    "ステータス" : "保留中" 、
    "SnatEntryName" : "SnatEntry-1" 、
    "SourceVSwitchId" : "vsw-3xbdsffvfgdfds ****" 、
    "SourceCIDR" : "116.22.XX.XX/24" 、
    "SnatEntryId" : "snat-kmd6nv8fy ****" 、
    "SnatTableId" : "stb-gz3r3odawdgffde ****" 、
    "SnatIp" : "116.22.XX.XX"
  } ]
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明 
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。
404 InvalidSnatTableId.NotFound 指定されたSNATテーブルが存在しません。 指定されたSNATテーブルが存在しない場合に返されるエラーメッセージ。 SNATテーブルのIDが有効かどうかを確認します。

エラーコードのリストについては、エラーセンターをご覧ください。