
# 创建公网NAT网关
#### 功能介绍
创建公网NAT网关实例。
#### URI
POST /v2.0/nat_gateways
#### 请求消息
请求参数如[表1]所示。
 表1请求参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                    |
|:---|:---|:---|:---|
| nat_gateway | 是    | Object | 公网NAT网关对象。详见[表2]。 |
   
 表2nat_gateway字段说明 
| 参数                  | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| 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 | VPC的id。获取router_id的方法请参考[查询VPC路由列表](https://support.huaweicloud.com/api-vpc/vpc_route_0001.html)下的vpc_id。                                                                                                                                                                                                                                                                                                                                                                      |
| internal_network_id | 是    | String | 公网NAT网关下行口（DVR的下一跳）所属的network id。获取network id的方法请参考[查询子网列表](https://support.huaweicloud.com/api-vpc/vpc_subnet01_0003.html)下的neutron_network_id。                                                                                                                                                                                                                                                                                                                               |
   
#### 响应消息
响应参数如[表3]所示。
 表3响应参数 
| 参数          | 参数类型   | 描述                                                       |
|:---|:---|:---|
| nat_gateway | Object | nat_gateway对象。详见[表4]。 |
   
 表4nat_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                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
#### 示例
- 请求示例
  ```
  POST https://{Endpoint}/v2.0/nat_gateways
  {
      "nat_gateway": {
          "name": "nat_001",
          "description": "my nat gateway 01",
          "router_id": "d84f345c-80a1-4fa2-a39c-d0d397c3f09a",
          "internal_network_id": "89d66639-aacb-4929-969d-07080b0f9fd9",
          "spec": "1"
      }
  }
  ```
  

- 响应示例
  ```
  {
      "nat_gateway": { 
           "router_id": "d84f345c-80a1-4fa2-a39c-d0d397c3f09a", 
           "status": "PENDING_CREATE", 
           "description": "my nat gateway 01", 
           "admin_state_up": true, 
           "tenant_id": "27e25061336f4af590faeabeb7fcd9a3", 
           "created_at": "2017-11-18 07:34:32.203044", 
           "spec": "1", 
           "internal_network_id": "89d66639-aacb-4929-969d-07080b0f9fd9", 
           "id": "a78fb3eb-1654-4710-8742-3fc49d5f04f8",
           "name": "nat_001" 
      }
  }
  ```
  
 
#### 状态码
请参考[状态码](https://support.huaweicloud.com/api-natgateway/nat_api_0038.html)。
