文档首页/ NAT网关 NAT/ API参考（吉隆坡区域）/ API v2/ SNAT规则/ 查询SNAT规则列表
更新时间：2022-08-08 GMT+08:00
查看PDF

查询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的id使用逗号分隔。
  • 取值范围：最大长度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" 
         } 
     ] 
 }

状态码

请参考状态码。

父主题： SNAT规则