更新时间:2022-01-25 GMT+08:00

创建NAT网关

功能介绍

创建NAT网关实例。

URI

POST /v2/{project_id}/nat_gateways

表1 参数说明

参数

是否必选

参数类型

描述

project_id

String

项目ID。

请求消息

请求参数如表2所示。

表2 请求参数

参数

是否必选

参数类型

描述

nat_gateway

Object

NAT网关对象。请参考表3

表3 nat_gateway字段说明

参数

是否必选

参数类型

描述

tenant_id

String

项目的ID。

name

String(64)

NAT网关的名字。

NAT网关的名字仅支持数字、字母、_(下划线)、-(中划线)、中文。

description

String(255)

NAT网关的描述。

spec

String

NAT网关的规格。

取值为:

  • “1”:小型,SNAT最大连接数10000
  • “2”:中型,SNAT最大连接数50000
  • “3”:大型,SNAT最大连接数200000
  • “4”:超大型,SNAT最大连接数1000000

router_id

String

VPC的id。

internal_network_id

String

NAT网关下行口(DVR的下一跳)所属的network id。

enterprise_project_id

String

  • 功能说明:企业项目ID。创建NAT网关时,给NAT网关绑定企业项目 ID。默认值:0,表示默认企业项目。
  • 取值范围:最大长度36字节,带 “-”连字符的UUID格式,或者是字符串“0”。

响应消息

响应参数如表4所示。

表4 响应参数

参数

参数类型

描述

nat_gateway

Object

nat_gateway对象。请参考表5

表5 nat_gateway字段说明

参数

参数类型

描述

id

String

NAT网关的id。

tenant_id

String

项目的ID。

name

String(64)

NAT网关的名字。

NAT网关的名字仅支持数字、字母、_(下划线)、-(中划线)、中文。

description

String(255)

NAT网关的描述。

spec

String

NAT网关的规格。

取值为:

  • “1”:小型,SNAT最大连接数10000
  • “2”:中型,SNAT最大连接数50000
  • “3”:大型,SNAT最大连接数200000
  • “4”:超大型,SNAT最大连接数1000000

router_id

String

路由器的UUID。

internal_network_id

String

NAT网关下行口(DVR的下一跳)所属的network id。

status

String

admin_state_up

Boolean

  • 解冻/冻结状态。
  • 取值范围:
    • “true”:解冻
    • “false”:冻结

created_at

String

NAT网关的创建时间戳,遵循UTC时间,保留小数点后6位,格式是yyyy-mm-dd hh:mm:ss

dnat_rules_limit

String

NAT网关的DNAT规则最多条数限制值

snat_rule_public_ip_limit

String

NAT网关的任意一条SNAT规则最多绑定的弹性公网IP的数量最大限制值。

billing_info

String

包周期NAT网关订单关联信息,按需值为空字符串。

enterprise_project_id

String

  • 功能说明:企业项目ID。创建NAT网关时,给NAT网关绑定企业项目 ID。默认值:0,表示默认企业项目。
  • 取值范围:最大长度36字节,带 “-”连字符的UUID格式,或者是字符串“0”。

示例

  • 请求示例
    POST https://{Endpoint}/v2/27e25061336f4af590faeabeb7fcd9a3/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"
        } 
    }
  • 响应示例
    { 
        "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",
            "dnat_rules_limit": "200",
            "snat_rule_public_ip_limit": "20",
            "enterprise_project_id": "0aad99bc-f5f6-4f78-8404-c598d76b0ed2",
            "billing_info": ""
        } 
    }

状态码

请参考状态码