閱讀595 返回首頁    go windows

創建NAT網關__NAT網關相關接口_API 參考_雲服務器 ECS-阿裏雲

描述

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

一些說明：

  1. 目前不支持Nat網關與“自建SNAT網關”（使用一台ECS充當SNAT網關）在VPC中並存；如果這樣使用，會產生未定義的產品行為；（這種用法會在將來的產品迭代中支持）
  2. Nat網關創建時，路由表中會出現一條“0.0.0.0->NatGateway_id”的係統路由，從而保證需要由NAT網關向公網轉發的消息可以被路由器轉發到NAT網關上。
  3. 當路由表中已經存在一條“0.0.0.0/0->某台ECS”的自定義路由時，NatGateway創建失敗；

請求參數

名稱 類型 是否必須 描述
Action String 是 係統規定參數，取值：CreateNatGateway
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:// 和 https:// 開頭。
Description String 否 自定義描述[[2, 256] 個字符，實例描述會顯示在控製台。不填則為空，默認為空。不能以 https:// 和 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 VpcId 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

示例

請求示例

  1. https://ecs.aliyuncs.com/?SignatureVersion=1.0&VpcId=vpc-11af8lp67&Name=MyNatGW&Format=json&TimeStamp=2016-05-23T03%3A26%3A21Z&BandwidthPackage.1.IpCount=5&RegionId=cn-shanghai&AccessKeyId=jZgi0oyrQ6ihgKp9&SignatureMethod=HMAC-SHA1&Version=2014-05-26&Signature=I4KKhWgjJdImTqk4rCifAB3LbLw%3D&action=CreateNatGateway&SignatureNonce=1ebae49c-2096-11e6-b781-2cf0ee28adf2&BandwidthPackage.1.Bandwidth=150&BandwidthPackage.1.Zone=cn-shanghai-a&Description=My+first+NAT+Gateway

返回示例

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. }

XML格式

暫略；

最後更新：2016-11-23 16:04:11

  上一篇：go 查看磁盤的監控信息__監控相關接口_API 參考_雲服務器 ECS-阿裏雲
  下一篇：go 查詢NAT網關列表__NAT網關相關接口_API 參考_雲服務器 ECS-阿裏雲