全部产品
Search

搜索本产品

    边缘节点服务ENS：DescribeSnatAttribute - 查询SNAT规则明细

    文档中心

    边缘节点服务ENS：DescribeSnatAttribute - 查询SNAT规则明细

    更新时间：Aug 27, 2026

    调用DescribeSnatAttribute查询指定SNAT规则的明细信息。

    调试

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

    调试

    授权信息

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

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

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

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

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

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

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

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

    操作

    访问级别

    资源类型

    条件关键字

    关联操作

    ens:DescribeSnatAttribute

    get

    *全部资源

    *

    		 无 无

    请求参数

    名称

    类型

    必填

    描述

    示例值
    SnatEntryId

    string

    是

    SNAT 条目的 ID。

    snat-5tc08qfj5ecblfdn2rqr9****

    返回参数

    名称

    类型

    描述

    示例值

    object

    返回结果。

    RequestId

    string

    请求 ID。

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

    string

    NAT 网关的 ID。

    nat-5t7nh1cfm6kxiszlttr38****
    SnatEntryId

    string

    SNAT 条目的 ID。

    snat-5tfi6f8gds82mjmlofeym****
    SnatIp

    string

    SNAT 条目中的 EIP，多个 EIP 之间用半角逗号（,）隔开。

    120. XXX. XXX.71
    SourceCIDR

    string

    SNAT 条目的源网段。

    10. XXX. XXX.0/24
    SnatEntryName

    string

    SNAT 条目的名称。

    test0
    Status

    string

    SNAT 条目状态。

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

    • Available：可用。

    • Deleting：删除中。

    Available
    CreationTime

    string

    创建时间，UTC 时间。

    2020-04-26T15:38:27Z
    SnatIps

    array<object>

    SNAT 中公网 IP 信息。

    object

    SNAT 中公网 IP 信息。

    Ip

    string

    IP 地址。

    203. XXX. XXX.139
    Status

    string

    SNAT IP 的状态。

    • Running：已启用。

    • Stopping：停用中。

    • Stopped：已停用。

    • Starting：启动中。

    • Releasing：释放中。

    Running
    CreationTime

    string

    创建时间，UTC 时间。

    2020-04-26T15:38:27Z
    StandbySnatIp

    string

    SNAT 条目中的备用 EIP，多个备用 EIP 之间用半角逗号（,）隔开。

    101. XXX. XXX.4
    StandbyStatus

    string

    备用 EIP 状态。

    • Running：开启。

    • Stopping：关闭中。

    • Stopped：关闭。

    • Starting：启动中。

    Stopped
    Type

    string

    NAT 类型。

    • 返回为空值，表示对称型 NAT。

    • FullCone：全锥形 NAT

    FullCone
    IdleTimeout

    integer

    超时时间，单位：秒。

    10
    DestCIDR

    string

    目标网段，表示只有访问目标网段的请求走该规则。

    101. XXX. XXX.0/24
    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",
  "NatGatewayId": "nat-5t7nh1cfm6kxiszlttr38****",
  "SnatEntryId": "snat-5tfi6f8gds82mjmlofeym****",
  "SnatIp": "120. XXX. XXX.71",
  "SourceCIDR": "10. XXX. XXX.0/24",
  "SnatEntryName": "test0",
  "Status": "Available",
  "CreationTime": "2020-04-26T15:38:27Z",
  "SnatIps": [
    {
      "Ip": "203. XXX. XXX.139",
      "Status": "Running",
      "CreationTime": "2020-04-26T15:38:27Z"
    }
  ],
  "StandbySnatIp": "101. XXX. XXX.4",
  "StandbyStatus": "Stopped",
  "Type": "FullCone",
  "IdleTimeout": 10,
  "DestCIDR": "101. XXX. XXX.0/24",
  "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.SnatNotFound The specified snat is not found. 指定的SNAT规则不存在。
    400 ens.interface.error Failed to call API. 接口调用发生异常。
    400 NoPermission Permission denied.
    400 InvalidParameter.%s The specified field %s invalid. Please check it again.

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

    变更历史

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