# 查询SNAT规则列表 #### 功能介绍 查询SNAT规则列表。 #### URI GET /v2.0/snat_rules ![](https://support.huaweicloud.com/api-natgateway/public_sys-resources/note_3.0-zh-cn.png) 可以在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 | - 功能说明：SNAT规则的状态。 - 取值范围：[资源状态说明](https://support.huaweicloud.com/api-natgateway/nat_api_0042.html#nat_api_0042__table1390614366107)。 | | 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]。 | 表3snat_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 | - 功能说明：SNAT规则的状态。 - 取值范围：[资源状态说明](https://support.huaweicloud.com/api-natgateway/nat_api_0042.html#nat_api_0042__table1390614366107)。 | | 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" } ] } ``` #### 状态码 请参考[状态码](https://support.huaweicloud.com/api-natgateway/nat_api_0038.html)。