文档首页/ NAT网关 NAT/ API参考/ 历史API/ API v2.0/ SNAT规则/ 查询SNAT规则列表
更新时间：2023-12-06 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询SNAT规则列表

功能介绍

查询SNAT规则列表。

URI

GET /v2.0/snat_rules

可以在URI后面用‘?’和‘&’添加不同的查询条件组合。支持参数说明中所有非必选参数过滤，请参考请求样例。

表1 参数说明

参数

是否必选

参数类型

描述

id

否

String

SNAT规则的id。

limit

否

Integer

每页返回的个数。

tenant_id

否

String

项目的ID。

nat_gateway_id

否

String

所属公网NAT网关的id。

network_id

否

String

规则使用的网络id。

cidr

否

String

cidr，vpc子网网段的子集或专线侧网段。

source_type

否

Integer

0：VPC侧，可以指定network_id或者cidr

1：专线侧，只能指定cidr

不输入默认为0（VPC）

floating_ip_id

否

String
  • 功能说明：弹性公网IP的id。
  • 取值范围：长度限制为4096。

floating_ip_address

否

String
  • 功能说明：弹性公网IP。
  • 取值范围：长度限制为1024。

status

否

String

admin_state_up

否

Boolean
  • 解冻/冻结状态。
  • 取值范围：
    • “true”：解冻
    • “false”：冻结

created_at

否

String

SNAT规则的创建时间戳，遵循UTC时间，保留小数点后6位，格式是yyyy-mm-dd hh:mm:ss

请求消息

无

响应消息

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

snat_rules

List(snat_rule)

snat_rule对象列表。详见表3。
表3 snat_rule字段说明

参数

参数类型

描述

id

String

SNAT规则的id。

tenant_id

String

项目的ID。

nat_gateway_id

String

所属公网NAT网关的id。

network_id

String

规则使用的网络id。

cidr

String

cidr，vpc子网网段的子集或专线侧网段。

source_type

Integer

0：VPC侧，可以指定network_id或者cidr

1：专线侧，只能指定cidr

不输入默认为0（VPC）

floating_ip_id

String
  • 功能说明：弹性公网IP的id，多个弹性公网IP的id使用逗号分隔。
  • 取值范围：最大长度4096字节。
  • 约束：弹性公网IP的id个数不能超过20个

floating_ip_address

String
  • 功能说明：弹性公网IP，多个弹性公网IP使用逗号分隔。
  • 取值范围：最大长度1024字节。

status

String

admin_state_up

Boolean
  • 解冻/冻结状态。
  • 取值范围：
    • “true”：解冻
    • “false”：冻结

created_at

String

SNAT规则的创建时间戳，遵循UTC时间，保留小数点后6位，格式是yyyy-mm-dd hh:mm:ss

示例

  • 请求样例 
    GET https://{Endpoint}/v2.0/snat_rules?limit=10
  • 响应样例 
    {
    "snat_rules": [
      {
            "floating_ip_id": "bf99c679-9f41-4dac-8513-9c9228e713e1",
            "status": "ACTIVE",
            "nat_gateway_id": "cda3a125-2406-456c-a11f-598e10578541",
            "admin_state_up": true,
            "network_id": "9a469561-daac-4c94-88f5-39366e5ea193",
            "cidr": "null",
            "source_type":0,
            "tenant_id": "abc",
            "created_at": "2017-11-15 15:44:42.595173",
            "id": "79195d50-0271-41f1-bded-4c089b2502ff",
            "floating_ip_address": "5.21.11.242"
        },
        {
            "floating_ip_id": "6e496fba-abe9-4f5e-9406-2ad8c809ac8c",
            "status": "ACTIVE",
            "nat_gateway_id": "e824f1b4-4290-4ebc-8322-cfff370dbd1e",
            "admin_state_up": true,
            "network_id": "97e89905-f9c8-4ae3-9856-392b0b2fbe7f",
            "cidr": "null",
            "source_type":0,
            "tenant_id": "abc",
            "created_at": "2017-11-17 07:43:44.830845",
            "id": "4a1a10d7-0d9f-4846-8cda-24cffeffef5c",
            "floating_ip_address": "5.21.11.142"
        }
    ]
}

状态码

请参考状态码。

父主题： SNAT规则

相关文档