創建NAT網關

　　描述

　　在指定的VPC中創建NAT網關。

　　一些說明：

　　目前不支持Nat網關與“自建SNAT網關”(使用一臺ECS充當SNAT網關)在VPC中并存;如果這樣使用，會產生未定義的產品行為;(這種用法會在將來的產品迭代中支持)

　　Nat網關創建時，路由表中會出現一條“0.0.0.0->NatGateway_id”的系統路由，從而保證需要由NAT網關向公網轉發的消息可以被路由器轉發到NAT網關上。

　　當路由表中已經存在一條“0.0.0.0/0->某臺ECS”的自定義路由時，NatGateway創建失敗;

　　請求參數

名稱 類型 是否必須 描述
Action   String   是   系統規定參數，取值：CreaeNatGateway  
RegionId   String   是   創建的NatGateWay 所在的地域  
VpcId   String   是   在哪個VPC中創建NatGateway  
BandwidthPackage.n.IpCount   Integer   至少指定一個   第n個帶寬包中的公網IP個數（n的取值目前只能為1）
取值范圍：1-50  
BandwidthPackage.n.Bandwidth   Integer   至少指定一個   第n個帶寬包的帶寬值（n的取值目前只能為1）
取值范圍：5-5000  
BandwidthPackage.n.Zone   String   否   第n個帶寬包位于的可用區（n的取值目前只能為1）
不指定該參數時，系統將隨機選擇可用區進行分配。n共享帶寬包上的IP與后端ECS不處于同一個可用區時，并不影響其連通性；但是位于共可用區時可以獲得更為極致的Latancy表現。。  
Name   String   否   實例的顯示名稱，[2, 128] 英文或中文字符，必須以大小字母或中文開頭，可包含數字，“.”，“_”或“-”。
實例名稱會顯示在控制臺。n如果沒有指定該參數，默認值為實例的 InstanceIdn不能以 和 https:// 開頭。  
Description   String   否   自定義描述[[2, 256] 個字符，實例描述會顯示在控制臺。不填則為空，默認為空。不能以 和 https:// 開頭  
ClientToken   String   否   用于保證請求的冪等性。由客戶端生成該參數值，要保證在不同請求間唯一，最大不值過 64 個 ASCII 字符。
具體參見附錄  

　　返回參數

名稱 類型 描述
NatGatewayId   String   NatGateway實例 ID，由系統生成，全局唯一。是訪問實例的唯一標識  
ForwardTableIds   Array   端口轉發表的ID列表  
BandwidthPackageIds   Array   一同創建的帶寬包的ID列表  

　　錯誤碼

錯誤代碼 描述 Http 狀態碼 語義
InvalidRegionId.NotFound   Specified value of “RegionId” is not supported.   404   指定的 Region 不存在  
InvalidZoneId.NotFound   Specified value of ZoneId is not supported.   404   指定的ZoneId不存在  
InvalidVpcId.NotFound   Specified value of ZoneId is not found in our record.   404   指定的vpc不存在  
MissingParameter.BandwidthPackage   At least 1 BandwidthPackage must be created with NatGateway.   400   至少需要隨NatGW創建一個共享帶寬包  
MissingParameter.BandwidthPackage.n.IpCount   Missing parameter IpCount in Bandwidth n.   400   第n個帶寬包參數不完整，未指定IpCount  
MissingParameter.BandwidthPackage.n.Bandwidth(n需要給出具體值)   Missing parameter Bandwidth in BandwidthPackage n.(n需要給出具體值)   400   第n個帶寬包參數不完整，未指定IpCount  
QuotaExceeded.NatGatewayCountInONeVpc   Natgateway count limit in one vpc exceeded.   400   一個VPC中目前只能有一個NatGateway  
RouterEntryConflict.Duplicated   A route entry already exists, which CIDR is ‘0.0.0.0/0’   400   當路由表中存在’0.0.0.0/0’的自定義路由時，無法添加NatGateway  

　　示例

　　請求示例