全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
专有网络 VPC

CreateNatGateway

更新时间:2018-04-09 22:26:00

描述

在指定的VPC中创建一个NAT网关。

在调用本接口创建NAT网关时,请注意:

  • 目前不支持NAT网关与自建SNAT网关(使用一台ECS作为SNAT网关)在VPC中并存。

  • NAT网关创建后,系统会在VPC的路由表中自动添加一条目标网段为0.0.0.0/0,下一跳为NAT网关的路由条目,用于将流量路由到NAT网关。

  • 如果在创建NAT网关前,VPC的路由表中已经存在一条目标网段为0.0.0.0/0的路由条目,删除该路由条目。否则,无法创建NAT网关。

NAT网关规格

NAT网关提供不同的规格。NAT网关的规格会影响SNAT功能的最大连接数和每秒新建连接数,但不会影响数据吞吐量。

NAT网关规格与SNAT性能的关系如下表所示。

规格 最大连接数 每秒新建连接数
小型 1万 1千
中型 5万 5千
大型 20万 1万

请求参数

请求参数 类型 是否必须 描述
Action String 系统规定参数,取值:CreateNatGateway
RegionId String NAT网关所在的地域。

您可以从地域和可用区列表或通过调用DescribeRegions接口查询地域ID。

VpcId String NAT网关的所属VPC的ID。
Spec String

NAT网关的规格。取值:

  • Small(默认值):小型
  • Middle:中型
  • Large:大型
BandwidthPackage.n.IpCount Integer 第n个共享带宽包中的公网IP数量(n最大为4)。

取值范围:[1,50]

说明:本参数仅支持在2017年11月3日23:59之前账户下存在NAT带宽包的用户指定。2017年11月3日23:59之前账户下不存在NAT带宽包的用户请参考绑定弹性公网IP,在NAT网关上绑定弹性公网IP。

BandwidthPackage.n.Bandwidth Integer 第n个共享带宽包的带宽值(n最大为4),取值范围:[5,5000]

说明:本参数仅支持在2017年11月3日23:59之前账户下存在NAT带宽包的用户指定。2017年11月3日23:59之前账户下不存在NAT带宽包的用户请参考绑定弹性公网IP,在NAT网关上绑定弹性公网IP。

BandwidthPackage.n.Zone String 第n个共享带宽包位于的可用区(n最大为4)。不指定该参数时,系统将随机分配一个可用区。

说明:共享带宽包上的IP与后端ECS不处于同一个可用区,并不影响其连通性;但是位于相同可用区时,可减小延迟。

说明:本参数仅支持在2017年11月3日23:59之前账户下存在NAT带宽包的用户指定。2017年11月3日23:59之前账户下不存在NAT带宽包的用户请参考绑定弹性公网IP,在NAT网关上绑定弹性公网IP。

Name String

NAT网关的名称,默认值为NAT网关的ID。

长度为 [2, 128] 个英文或中文字符,必须以大小字母或中文开头,可包含数字,下划线(_)和短横线(-),不能以“http://” 或 “https://” 开头。

Description String

NAT网关的描述信息,默认值为空。

长度为 [2, 256] 个英文或中文字符,不能以“http://” 或“https://” 开头。

ClientToken String

用于保证请求的幂等性。

由客户端生成该参数值,要保证在不同请求间唯一,最大值不能超过64个ASCII字符。

更多关于幂等性的信息,请参考如何保证幂等性

返回参数

返回参数 类型 描述
RequestId String 请求ID。
NatGatewayId String

NAT网关的ID。

ForwardTableIds Array 转发条目列表。
BandwidthPackageIds Array 共享带宽包列表。

错误码

关于本接口的错误码的详细解释,请参见VPC API错误中心

示例

请求示例

  1. https://vpc.aliyuncs.com/?Action=CreateNatGateway
  2. &VpcId=vpc-11af8lp67
  3. &Name=MyNatGW
  4. &BandwidthPackage.1.IpCount=5
  5. &RegionId=cn-shanghai
  6. &BandwidthPackage.1.Bandwidth=150
  7. &BandwidthPackage.1.Zone=cn-shanghai-a
  8. &Description=My+first+NAT+Gateway
  9. <公共请求参数>

返回示例

JSON格式

  1. {
  2. "BandwidthPackageIds": {
  3. "BandwidthPackageId": [
  4. "bwp-11odxu2k7"
  5. ]
  6. },
  7. "ForwardTableIds": {
  8. "ForwardTableId": [
  9. "ftb-11tc6xgmv"
  10. ]
  11. },
  12. "NatGatewayId": "ngw-112za33e4",
  13. "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
  14. }
本文导读目录