更新时间:2022-01-25 GMT+08:00

查询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(4096)

功能说明:弹性公网IP的id。

floating_ip_address

String(1024)

功能说明:弹性公网IP。

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(4096)

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

floating_ip_address

String(1024)

  • 功能说明:弹性公网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"
            }
        ]
    }

状态码

请参考状态码