创建NAT网关
更新时间：2026-05-27
描述
创建NAT网关
- 对于EIP只允许绑定一个，对于共享带宽可以绑定其中的多个IP
API Explorer
去调试
您可以在 API Explorer 中直接运行该接口，免去您计算签名的困扰。运行成功后，API Explorer 可以自动生成 SDK 代码示例。
请求结构
Plain Text
1POST /v{version}/nat?clientToken={clientToken} HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string
4{
5 "name": name,
6 "vpcId": vpcId,
7 "bindEips": [eips],
8 "billing": {
9 "paymentTiming": paymentTiming,
10 "reservation": {
11 "reservationLength": reservationLength,
12 "reservationTimeUnit": reservationTimeUnit
13 }
14 },
15 "tags":[
16 {
17 "tagKey": tagKey,
18 "tagValue": tagValue
19 }
20 ],
21 "resourceGroupId": resourceGroupId,
22 "deleteProtect":deleteProtect
23}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值1 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见ClientToken幂等性 |
| name | String | 是 | RequestBody参数 | NAT网关的名称，由大小写字母、数字以及-_ /.特殊字符组成，必须以字母开头，长度1-65 |
| vpcId | String | 是 | RequestBody参数 | VPC的ID |
| cuNum | Integer | 是 | RequestBody参数 | NAT网关的CU数量 |
| ipVersion | String | 否 | RequestBody参数 | NAT IP类型，默认v4 |
| bindEips | List |
否 | RequestBody参数 | 关联NAT网关EIP或者共享带宽中的一个或多个EIP |
| billing | Billing | 是 | RequestBody参数 | 计费信息 |
| sessionConfig | SessionConfig | 否 | RequestBody参数 | 会话连接配置 |
| tags | List<TagModel> | 否 | RequestBody参数 | 待创建的标签键值对列表。 |
| resourceGroupId | String | 否 | RequestBody参数 | 资源组 |
| deleteProtect | Boolean | 否 | RequestBody参数 | 是否开启释放保护。缺省值为false，代表允许删除 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| natId | String | 创建的NAT的ID |
请求示例-预付费
Plain Text
1POST /v1/nat?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2Host: bcc.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2018-07-05T04:17:29Z/3600/ host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "name":"nat1",
8 "vpcId":"vpc-a4sg6vsfzbra",
9 "bindEips":[
10 "10.107.247.192"
11 ],
12 "billing":{
13 "reservation":{
14 "reservationLength":1,
15 "reservationTimeUnit":"month"
16 },
17 "paymentTiming":"Prepaid"
18 },
19 "tags":[
20 {
21 "tagKey": "tagKey",
22 "tagValue": "tagValue"
23 }
24 ],
25 "resourceGroupId": "RESG-UoMgbkuLNjj",
26 "deleteProtect": true
27} 请求示例-后付费
Plain Text
1POST /v1/nat?clientToken=be31b98c-5e41-4838-9830-9be700de5a20 HTTP/1.1
2Host: bcc.bj.baidubce.com
3ContentType: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2018-07-05T04:17:29Z/3600/ host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
5
6{
7 "name":"nat1",
8 "vpcId":"vpc-a4sg6vsfzbra",
9 "spec":"small",
10 "billing":{
11 "paymentTiming":"Postpaid"
12 },
13 "tags":[
14 {
15 "tagKey": "tagKey",
16 "tagValue": "tagValue"
17 }
18 ],
19 "resourceGroupId": "RESG-UoMgbkuLNjj",
20 "deleteProtect": true
21} 返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3Date: Fri, 06 July 2018 07:06:06 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6
7{
8 "natId": "nat-b58rnkn1g98h"
9}评价此篇文章