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

查询SNAT规则列表

功能介绍

查询SNAT规则列表。

URI

GET /v2/{project_id}/snat_rules

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

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

项目ID。

limit

Integer

功能说明:每页返回的个数。

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

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

Array(Object)

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字节。

description

String(255)

SNAT规则的描述。

status

String

admin_state_up

Boolean

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

created_at

String

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

floating_ip_address

String(1024)

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

freezed_ip_address

String(1024)

  • 功能说明:冻结的弹性公网IP,多个冻结的弹性公网IP使用逗号分隔。
  • 取值范围:最大长度1024字节。

示例

  • 请求样例
    GET https://{Endpoint}/v2/d199ba7e0ba64899b2e81518104b1526/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", 
                 "source_type":0,
                 "tenant_id": "d199ba7e0ba64899b2e81518104b1526", 
                 "created_at": "2017-11-15 15:44:42.595173", 
                 "id": "79195d50-0271-41f1-bded-4c089b2502ff", 
                 "floating_ip_address": "5.21.11.242", 
                 "freezed_ip_address": "", 
                 "description": "my snat rule 01" 
             }, 
             { 
                 "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", 
                 "source_type":0,
                 "tenant_id": "d199ba7e0ba64899b2e81518104b1526",
                 "created_at": "2017-11-17 07:43:44.830845", 
                 "id": "4a1a10d7-0d9f-4846-8cda-24cffeffef5c", 
                 "floating_ip_address": "5.21.11.142,5.21.11.143", 
                 "freezed_ip_address": "5.21.11.142", 
                 "description": "my snat rule 01" 
             } 
         ] 
     }

状态码

请参考状态码