4.1 公网 NAT 网关
4.1.2 创建公网 NAT 网关
"id" : "e824f1b4-4290-4ebc-8322-cfff370dbd1e", "router_id" : "305dc52f-13dd-429b-a2d4-444a1039ba0b", "status" : "ACTIVE",
"description" : "1234", "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", "name" : "lyl001",
"enterprise_project_id" : "0"
} ] }
状态码
状态码 描述
200 查询公网NAT网关实例列表成功
错误码
请参见错误码。
4.1.2 创建公网 NAT 网关
功能介绍
创建公网NAT网关实例。
调试
您可以在API Explorer中调试该接口。
URI
POST /v2/{project_id}/nat_gateways
表4-6 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目的ID。
最小长度：1 最大长度：36
获取方法详见获取项目ID。
请求参数
表4-7 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。用户Token也就是 调用获取用户Token获取请求认 证接口的响应值，该接口是唯一 不需要认证的接口。请求响应成 功后在响应消息头中包含的“X-Subject-Token”的值即为Token 值。
最小长度：1 最大长度：10240
表4-8 请求 Body 参数
参数 是否必选 参数类型 描述
nat_gateway 是 CreateNatGa tewayOption object
创建公网NAT网关实例的请求 体。
表4-9 CreateNatGatewayOption
参数 是否必选 参数类型 描述
name 是 String 公网NAT网关实例的名字，长度
限制为64。公网NAT网关实例 的名字仅支持数字、字母、_
（下划线）、-（中划线）、中 文。
最大长度：64 router_id 是 String VPC的id。
参数 是否必选 参数类型 描述 internal_netw
ork_id 是 String 公网NAT网关下行口（DVR的下
一跳）所属的network id。
获取请参见查询子网列表。
description 否 String 公网NAT网关实例的描述，长度 限制为255。
最大长度：255
spec 是 String 公网NAT网关的规格。取值为：
“1”：小型，SNAT最大连接数 10000；“2”：中型，SNAT最 大连接数50000；“3”：大 型，SNAT最大连接数200000；
“4”：超大型，SNAT最大连接 数1000000
枚举值：
● 1
● 2
● 3
● 4 enterprise_pro
ject_id 否 String 企业项目ID 创建公网NAT网关
实例时，关联的企业项目ID。关 于企业项目ID的获取及企业项目 特性的详细信息，请参考《企业 管理用户指南》。
缺省值：0 最大长度：36
响应参数
状态码： 201
表4-10 响应 Body 参数
参数 参数类型 描述
nat_gateway NatGateway ResponseBod y object
公网NAT网关实例的响应体。
表4-11 NatGatewayResponseBody
参数 参数类型 描述
id String 公网NAT网关实例的ID。
长度：36 tenant_id String 项目的ID。
name String 公网NAT网关实例的名字，长度限制为64。
最小长度：1 最大长度：64
description String 公网NAT网关实例的描述，长度限制为255。
最大长度：255
spec String 公网NAT网关的规格。取值为： “1”：小型，
SNAT最大连接数10000；“2”：中型，SNAT最 大连接数50000；“3”：大型，SNAT最大连接 数200000；“4”：超大型，SNAT最大连接数 1000000
枚举值：
● 1
● 2
● 3
● 4
status String 公网NAT网关实例的状态。
枚举值：
● ACTIVE
● PENDING_CREATE
● PENDING_UPDATE
● PENDING_DELETE
● INACTIVE admin_state_
up Boolean 解冻/冻结状态。取值范围：
● "true"：解冻
● "false"：冻结
created_at String 公网NAT网关实例的创建时间，遵循UTC时间，
格式是yyyy-mm-ddThh:mm:ssZ。
router_id String VPC的id。
internal_netw
ork_id String 公网NAT网关下行口（DVR的下一跳）所属的 network id。
enterprise_pro
ject_id String 企业项目ID。创建公网NAT网关实例时，关联的 企业项目ID。
请求示例
创建公网NAT网关
POST https://{Endpoint}/v2/70505c941b9b4dfd82fd351932328a2f/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",
"enterprise_project_id " : "0aad99bc-f5f6-4f78-8404-c598d76b0ed2"
}}
响应示例
状态码： 201
创建公网NAT网关实例成功。
{ "nat_gateway" : {
"id" : "14338426-6afe-4019-996b-3a9525296e11", "name" : "nat_001",
"description" : "my nat gateway 01",
"router_id" : "d84f345c-80a1-4fa2-a39c-d0d397c3f09a", "spec" : "1",
"admin_state_up" : true,
"tenant_id" : "70505c941b9b4dfd82fd351932328a2f",
"internal_network_id" : "89d66639-aacb-4929-969d-07080b0f9fd9", "enterprise_project_id" : "0aad99bc-f5f6-4f78-8404-c598d76b0ed2", "status" : "ACTIVE",
"created_at" : "2019-04-22T08:47:13"
}}
状态码
状态码 描述
201 创建公网NAT网关实例成功。
错误码
请参见错误码。