调用DescribeSnatTableEntries接口查询已创建的SNAT条目。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeSnatTableEntries

系统规定参数。取值：DescribeSnatTableEntries。

RegionId String 是 cn-hangzhou

NAT网关所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

SnatTableId String 否 stb-8vbczigrhop8x5u3t****

SNAT表ID。

说明 SnatTableId和NatGatewayId参数至少输入一个。
SnatEntryId String 否 snat-8vbae8uqh7rjpk7d2****

SNAT条目ID。

SourceVSwitchId String 否 vsw-3xbjkhjshjdf****

交换机的ID。

  • 当查询公网NAT网关的SNAT条目时，该参数表示该交换机内的ECS实例均可以通过SNAT规则访问公网。
  • 当查询VPC NAT网关的SNAT条目时，该参数表示该交换机内的ECS实例均可以通过SNAT规则访问外部网络。
SourceCIDR String 否 116.22.XX.XX/24

SNAT条目的源网段。

SnatIp String 否 116.22.XX.XX
  • 当查询公网NAT网关的SNAT条目时，该参数为SNAT条目中的EIP。
  • 当查询VPC NAT网关的SNAT条目时，该参数为SNAT条目中的NAT IP地址。
SnatEntryName String 否 SnatEntry-1

SNAT条目的名称。

名称长度为2~128个字符，以大小写字母或中文开头， 可包含数字、下划线（_）和短划线（-）。
PageNumber Integer 否 1

列表的页码，默认值为1。

PageSize Integer 否 10

分页查询时每页的行数，最大值为50，默认值为10。

NatGatewayId String 否 ngw-bp1uewa15k4iy5770****

要查询的NAT网关的ID。

说明 SnatTableId和NatGatewayId参数至少输入一个。

返回数据

名称 类型 示例值 描述
PageSize Integer 5

每页包含的条目数。
RequestId String 6D7E89B1-1C5B-412B-8585-4908E222EED5

请求ID。
PageNumber Integer 1

当前页码。
TotalCount Integer 1

列表条目数。
SnatTableEntries Array of SnatTableEntry

查询的SNAT列表详细信息。
SnatTableEntry
Status String Pending

SNAT条目状态，取值：

  • Pending：配置中，可能是创建中或修改中。
  • Available：可用。
  • Deleting：删除中。
SnatEntryName String SnatEntry-1

SNAT条目的名称。
SourceVSwitchId String vsw-3xbdsffvfgdfds****
  • 当查询公网NAT网关时，该返回参数为通过SNAT功能访问互联网的交换机ID。
  • 当查询VPC NAT网关时，该返回参数为通过SNAT功能访问外部网络的交换机ID。
SourceCIDR String 116.22.XX.XX/24

SNAT条目的源网段。

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网关的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>
    <PageNumber>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" : [ {
    "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"
  } ]
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定的RegionId不存在。
404 InvalidSnatTableId.NotFound Specified SNAT table does not exist. 指定的 SNAT 表不存在，请您检查输入参数是否正确。

访问错误中心查看更多错误码。