# 查询公网NAT网关列表
#### 功能介绍
查询公网NAT网关列表。如无特殊说明，匹配规则为精确匹配。
#### URI
GET /v2.0/nat_gateways
![](https://support.huaweicloud.com/api-natgateway/public_sys-resources/note_3.0-zh-cn.png)
可以在URI后面用'?'和'\&'添加不同的查询条件组合。支持参数说明中所有非必选参数过滤，请参考请求样例。
表1参数说明 
| 参数                  | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|:---|
| id                  | 否    | String  | 公网NAT网关的id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| limit               | 否    | Integer | 每页返回的个数。                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| tenant_id           | 否    | String  | 项目的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| name                | 否    | String  | 公网NAT网关的名字，长度限制为64。 公网NAT网关的名字仅支持数字、字母、_（下划线）、-（中划线）、中文。                                                                                                                                                                                                                                                                                                                                                                                              |
| description         | 否    | String  | 公网NAT网关的描述，长度限制为255。                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| spec                | 否    | String  | 公网NAT网关的规格。 取值为： - "1"：小型，SNAT最大连接数10000  - "2"：中型，SNAT最大连接数50000  - "3"：大型，SNAT最大连接数200000  - "4"：超大型，SNAT最大连接数1000000   |
| router_id           | 否    | String  | 路由器的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| internal_network_id | 否    | String  | 公网NAT网关下行口（DVR的下一跳）所属的network id。                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| status              | 否    | String  | - 功能说明：公网NAT网关的状态。  - 取值范围：[资源状态说明](https://support.huaweicloud.com/api-natgateway/nat_api_0042.html#nat_api_0042__table1390614366107)。                                                                                                                                                                                |
| admin_state_up      | 否    | Boolean | - 解冻/冻结状态。  - 取值范围： - "true"：解冻  - "false"：冻结                                                                                                     |
| created_at          | 否    | String  | 公网NAT网关的创建时间戳，遵循UTC时间，保留小数点后6位，格式是yyyy-mm-dd hh:mm:ss                                                                                                                                                                                                                                                                                                                                                                                                                                |
   
#### 请求消息
无
#### 响应消息
响应参数如[表2]所示。
 表2响应参数 
| 参数           | 参数类型              | 描述                                                         |
|:---|:---|:---|
| nat_gateways | List(nat_gateway) | nat_gateway对象列表。详见[表3]。 |
   
 表3nat_gateway字段说明 
| 参数                  | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|
| id                  | String  | 公网NAT网关的id。                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| tenant_id           | String  | 项目的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| name                | String  | 公网NAT网关的名字，长度限制为64。 公网NAT网关的名字仅支持数字、字母、_（下划线）、-（中划线）、中文。                                                                                                                                                                                                                                                                                                                                                                                               |
| description         | String  | 公网NAT网关的描述，长度限制为255。                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| spec                | String  | 公网NAT网关的规格。 取值为： - "1"：小型，SNAT最大连接数10000  - "2"：中型，SNAT最大连接数50000  - "3"：大型，SNAT最大连接数200000  - "4"：超大型，SNAT最大连接数1000000   |
| router_id           | String  | 路由器的ID。                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| internal_network_id | String  | 公网NAT网关下行口（DVR的下一跳）所属的network id。                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| status              | String  | - 功能说明：公网NAT网关的状态。  - 取值范围：[资源状态说明](https://support.huaweicloud.com/api-natgateway/nat_api_0042.html#nat_api_0042__table1390614366107)。                                                                                                                                                                             |
| admin_state_up      | Boolean | - 解冻/冻结状态。  - 取值范围： - "true"：解冻  - "false"：冻结                                                                                                                       |
| created_at          | String  | 公网NAT网关的创建时间戳，遵循UTC时间，保留小数点后6位，格式是yyyy-mm-dd hh:mm:ss                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
#### 示例
- 请求样例
  ```
  GET https://{Endpoint}/v2.0/nat_gateways?limit=10
  ```
  
 
- 响应样例
  ```
  {
       "nat_gateways": [ 
           { 
               "router_id": "b1d81744-5165-48b8-916e-e56626feb88f", 
               "status": "ACTIVE", 
               "description": "", 
               "admin_state_up": true, 
               "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
               "created_at": "2017-11-15 14:50:39.505112", 
               "spec": "2", 
               "internal_network_id": "5930796a-6026-4d8b-8790-6c6bfc9f87e8", 
               "id": "a253be25-ae7c-4013-978b-3c0785eccd63",
               "name": "wj3" 
           }, 
           { 
               "router_id": "305dc52f-13dd-429b-a2d4-444a1039ba0b", 
               "status": "ACTIVE", 
               "description": "", 
               "admin_state_up": true, 
               "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
               "created_at": "2017-11-17 07:41:07.538062", 
               "spec": "2", 
               "internal_network_id": "fc09463b-4ef8-4c7a-93c8-92d9ca6daf9d", 
               "id": "e824f1b4-4290-4ebc-8322-cfff370dbd1e", 
               "name": "lyl001" 
          }
      ]
  }
  ```
  
#### 状态码
请参考[状态码](https://support.huaweicloud.com/api-natgateway/nat_api_0038.html)。