建立一個NAT Gateway。

在調用本介面建立NAT Gateway時,請注意:

  • 目前不支援NAT Gateway與自建SNAT Gateway(使用一台ECS作為SNAT Gateway)在VPC中並存。

  • NAT Gateway建立後,系統會在VPC的路由表中自動添加一條目標網段為0.0.0.0/0,下一跳為NAT Gateway的路由條目,用於將流量路由到NAT Gateway。

  • 如果在建立NAT Gateway前,VPC的路由表中已經存在一條目標網段為0.0.0.0/0的路由條目,請先刪除該路由條目。否則,無法建立NAT Gateway。

NAT Gateway的規格

NAT Gateway提供不同的規格。NAT Gateway的規格會影響SNAT功能的最大串連數和每秒新建串連數,但不會影響資料輸送量。

NAT Gateway規格與SNAT效能的關係如下表所示。

規格 最大串連數 每秒新建串連數
小型 1萬 1千
中型 5萬 5千
大型 20萬 1萬
超大型 100萬 3萬

請求參數

名稱 類型 是否必須 描述
Action String

要執行的操作。 取值:

CreateNatGateway

RegionId String

NAT Gateway所在的地域。

您可以通過調用 DescribeRegions介面獲取地域ID。

VpcId String

VPC的ID。

Spec String
NAT Gateway的規格。取值:
  • Small(預設值):小型

  • Middle:中型

  • Large:大型

  • XLarge.1:超大型

BandwidthPackage.n.Bandwidth String

第n個共用頻寬包的頻寬值,取值範圍:[5,5000]

由用戶端生成該參數值,要保證在不同請求間唯一,最大不值過64個 ASCII 字元。

说明
本參數僅支援在2018年1月26日之前帳號下存在NAT頻寬包的使用者指定。2018年1月26日之前帳號下不存在NAT頻寬包的使用者,請綁定EIP。
BandwidthPackage.n.Zone String

第n個共用頻寬包的可用性區域。不指定該參數時,系統將隨機分配一個可用性區域。

NAT頻寬包的IP與後端ECS不處於同一個可用性區域,並不影響其連通性;但是位於相同可用性區域時,可減小延遲。

说明
本參數僅支援在2018年1月26日之前帳號下存在NAT頻寬包的使用者指定。2018年1月26日之前帳號下不存在NAT頻寬包的使用者,請綁定EIP。
Name String

NAT Gateway的名稱。

長度為 2-128個字元,必須以字母或中文開頭,可包含數字,點號(.),底線(_)和短橫線(-)。但不能以http://https://開頭。

Description String

NAT Gateway的描述資訊。

長度為 2-256個字元,必須以字母或中文開頭,但不能以http://https://開頭。

ClientToken String

用戶端token,用於保證請求的等冪性。

由用戶端生成該參數值,要保證在不同請求間唯一,最大不值過64個 ASCII 字元。

返回參數

名稱 類型 描述
RequestId String 請求ID。
NatGatewayId String NAT Gateway的ID。
ForwardTableIds String NAT Gateway的轉寄條目列表。
BandwidthPackageIds String NAT Gateway的共用頻寬包。

樣本

請求樣本

https://vpc.aliyuncs.com/?Action=CreateNatGateway
&VpcId=vpc-11af8lp67
&Name=MyNatGW
&BandwidthPackage.1.IpCount=5
&RegionId=cn-shanghai
&BandwidthPackage.1.Bandwidth=150
&BandwidthPackage.1.Zone=cn-shanghai-a
&公共請求參數
返回樣本
  • XML格式

    <?xml version="1.0" encoding="UTF-8" ?>
    <CreateNatGatewayResponse>
    	<BandwidthPackageIds>
    		<BandwidthPackageId>bwp-11odxu2k7</BandwidthPackageId>
    	</BandwidthPackageIds>
    	<ForwardTableIds>
    		<ForwardTableId>ftb-11tc6xgmv</ForwardTableId>
    	</ForwardTableIds>
    	<NatGatewayId>ngw-112za33e4</NatGatewayId>
    	<RequestId>2315DEB7-5E92-423A-91F7-4C1EC9AD97C3</RequestId>
    </CreateNatGatewayResponse>
  • JSON格式

    {
      "BandwidthPackageIds": {
        "BandwidthPackageId": [
          "bwp-11odxu2k7"
        ]
      },
      "ForwardTableIds": {
        "ForwardTableId": [
          "ftb-11tc6xgmv"
        ]
      },
      "NatGatewayId": "ngw-112za33e4",
      "RequestId": "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3"
    }