全部产品
Search

搜索本产品

    边缘节点服务ENS：DescribeSnatTableEntries - 查询SNAT条目

    文档中心

    边缘节点服务ENS：DescribeSnatTableEntries - 查询SNAT条目

    更新时间：Aug 27, 2026

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

    调试

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

    调试

    授权信息

    下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

    • 操作：是指具体的权限点。

    • 访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。

    • 资源类型：是指操作中支持授权的资源类型。具体说明如下：

      • 对于必选的资源类型，用前面加 * 表示。

      • 对于不支持资源级授权的操作，用全部资源表示。

    • 条件关键字：是指云产品自身定义的条件关键字。

    • 关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ens:DescribeSnatTableEntries

    list

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    NatGatewayId

    string

    是

    NAT 网关的 ID。

    nat-5tawjw5j7sgd2deujxuk0****
    SnatEntryId

    string

    否

    SNAT 条目的 ID。

    snat-5tfjp36fsrb36zs36faj0****
    SnatIp

    string

    否

    SNAT 条目中的 EIP 地址。

    58.XXXX.XXX.29
    SourceCIDR

    string

    否

    SNAT 条目的源网段。

    10.1.0.50/32
    SnatEntryName

    string

    否

    SNAT 条目的名称。

    test0
    SnatIps

    array

    否

    SNAT 中公网 IP 数组。

    string

    否

    SNAT 中公网 IP。

    58.XXXX.XXX.30
    PageNumber

    integer

    否

    查询列表的页码。起始值为 1。

    默认值：1。

    1
    PageSize

    integer

    否

    分页查询时设置的每页行数，最大值为 100 行。

    默认值：10。

    10

    返回参数

    名称

    类型

    描述

    示例值

    object

    Schema of Response

    RequestId

    string

    请求 ID。

    473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E
    PageNumber

    integer

    当前查询页码。

    1
    TotalCount

    integer

    查询的 SNAT 列表条目数。

    7
    PageSize

    integer

    分页查询时每页的行数。

    10
    SnatTableEntries

    array<object>

    查询的 SNAT 列表详细信息。

    object

    查询的 SNAT 列表详细信息。

    NatGatewayId

    string

    NAT 网关实例的 ID。

    nat-5t7nh1cfm6kxiszlttr38****
    SnatEntryId

    string

    SNAT 条目的 ID。

    snat-5tfjp3537mi6iokl59g5c****
    SnatIp

    string

    SNAT 条目中的 EIP 地址。

    120.XXX.XXX.71
    SourceCIDR

    string

    SNAT 条目的源网段。

    10.0.0.13/32
    SnatEntryName

    string

    SNAT 条目的名称。

    test0
    Status

    string

    SNAT 条目状态，取值：

    • Pending：配置中，可能是创建中或修改中。

    • Available：可用。

    • Deleting：删除中。

    Available
    StandbySnatIp

    string

    备用 EIP，多个 EIP 之间用半角逗号（,）隔开。

    101.XXX.XXX.7
    StandbyStatus

    string

    备用弹性公网 IP 的状态

    • Running：开启

    • Stopping：关闭中

    • Stopped：关闭

    • Starting：启动中

    Stopped
    IdleTimeout

    integer

    连接空闲超时时间，取值：1~86400，单位：秒。

    900
    IspAffinity

    boolean

    是否打开运营商亲和性。取值：

    • false：不开启。

    • true：打开。

    true
    EipAffinity

    boolean

    是否打开 IP 亲和性。取值：

    • false：关闭 IP 亲和性。

    • true：打开 IP 亲和性。

    说明

    说明 打开 IP 亲和性开关后，如果 SNAT 条目绑定多个 EIP，同一个客户端将使用相同的 EIP 进行访问，否则客户端将从绑定的 EIP 中随机选取进行访问。

    false

    示例

    正常返回示例

    JSON格式

    {
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E",
  "PageNumber": 1,
  "TotalCount": 7,
  "PageSize": 10,
  "SnatTableEntries": [
    {
      "NatGatewayId": "nat-5t7nh1cfm6kxiszlttr38****",
      "SnatEntryId": "snat-5tfjp3537mi6iokl59g5c****",
      "SnatIp": "120.XXX.XXX.71",
      "SourceCIDR": "10.0.0.13/32",
      "SnatEntryName": "test0",
      "Status": "Available",
      "StandbySnatIp": "101.XXX.XXX.7",
      "StandbyStatus": "Stopped",
      "IdleTimeout": 900,
      "IspAffinity": true,
      "EipAffinity": false
    }
  ]
}

    错误码

    HTTP status code

    错误码

    错误信息

    描述
    400 Invalid%s The specified parameter %s is invalid.
    400 Missing%s You must specify the parameter %s.
    400 InvalidParameter.NatNotFound The specified Nat is not found. 指定的参数Nat不存在。
    400 ens.interface.error Failed to call API. 接口调用发生异常。
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

    变更历史

    更多信息，参考变更详情。