文档首页> NAT网关 NAT> API参考> API> 公网NAT网关> 创建公网NAT网关
更新时间：2022-03-31 GMT+08:00
查看PDF
分享

创建公网NAT网关

功能介绍

创建公网NAT网关实例。

调试

您可以在API Explorer中调试该接口。

URI

POST /v2/{project_id}/nat_gateways

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目的ID。

最小长度：1

最大长度：36

获取方法详见获取项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token。用户Token也就是调用获取用户Token获取请求认证接口的响应值，该接口是唯一不需要认证的接口。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

最小长度：1

最大长度：10240
表3 请求Body参数

参数

是否必选

参数类型

描述

nat_gateway

是

CreateNatGatewayOption object

创建公网NAT网关实例的请求体。
表4 CreateNatGatewayOption

参数

是否必选

参数类型

描述

name

是

String

公网NAT网关实例的名字，长度限制为64。公网NAT网关实例的名字仅支持数字、字母、_（下划线）、-（中划线）、中文。

最大长度：64

router_id

是

String

VPC的id。

获取请参见查询VPC列表。

internal_network_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_project_id

否

String

企业项目ID 创建公网NAT网关实例时，关联的企业项目ID。关于企业项目ID的获取及企业项目特性的详细信息，请参考《企业管理用户指南》。

缺省值：0

最大长度：36

响应参数

状态码： 201

表5 响应Body参数

参数

参数类型

描述

nat_gateway

NatGatewayResponseBody object

公网NAT网关实例的响应体。
表6 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_network_id

String

公网NAT网关下行口（DVR的下一跳）所属的network id。

enterprise_project_id

String

企业项目ID。创建公网NAT网关实例时，关联的企业项目ID。

最大长度：36

请求示例

创建公网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网关实例成功。

错误码

请参见错误码。

父主题： 公网NAT网关
分享：

    相关文档

    相关产品

关闭导读