NAT Gateway を作成します。

NAT Gateway を作成する前に、次の事項にご注意ください。

  • NAT Gateway と自己構築型 SNAT Gateway は 同じ VPC 内で共存できません。

  • NAT Gateway が作成されると、宛先 CIDR ブロックが 0.0.0.0/0 、次のホップが NAT Gateway であるルートエントリが VPC のルートテーブルに自動的に追加され、 トラフィックが NAT Gatewayにルーティングされます。

  • 宛先 CIDR ブロックが 0.0.0.0/0 であるルートエントリが VPC のルートテーブルにすでに存在している場合、ルーターエントリを削除してから NAT Gatewayを作成します。

デバッグ

API Explorer を使用すると、API を簡単にデバッグし、SDK コード例を自動的に生成して、API をすばやく検索できます。 クラウド API を利用する際に発生する問題を軽減できる、 API Explorer のご利用を推奨します。

リクエストパラメーター

パラメーター データ型 必須/任意 値の例 説明
Action String 必須 CreateNatGateway

操作の実行に使用する API (CreateNatGateway) を設定します。

 

RegionId String 必須 cn-hangzhou

NAT Gateway が設定されているリージョンの ID を設定します。

リージョン ID を照会するには、DescribeRegions を呼び出します。

VpcId String 必須 vpc-bp1di7uewzmtvfuq8ufpv

使用する VPC の ID を設定します。

BandwidthPackage.n.Bandwidth String 任意 5

NAT 帯域幅パッケージ (n) の帯域幅を設定します。 設定可能な値は 5 から 5000 です。

この API は、NAT 帯域幅パッケージを 2018 年 1 月 26 日より前に購入している場合にのみ呼び出すことができます。 2018 年 1 月 26 日より前に購入したNAT帯域幅パッケージがアカウントにない場合は、EIP を関連付ける必要があります。
BandwidthPackage.N.ISP String 任意 BGP

共有帯域幅パッケージ (n) の ISP タイプ を設定します。 デフォルト値は BGP (multiple lines) です。

BandwidthPackage.n.IpCount String 任意 5

共有帯域幅パッケージ内のパブリック IP アドレスの数を設定します。 設定可能な値は 1 から 50 です。ここで、 n は、n 番目の帯域幅パッケージを表し、 設定可能な値は 1 から 4 です。

この API は、NAT 帯域幅パッケージを 2018 年 1 月 26 日より前に購入している場合にのみ呼び出すことができます。 2018 年 1 月 26 日より前に購入したNAT帯域幅パッケージがアカウントにない場合は、EIP を関連付ける必要があります。
BandwidthPackage.n.Zone String 任意 cn-hangzhou

共有帯域幅パッケージ (n) のゾーンを設定します。 このパラメーターが設定されていない場合、システムはゾーンをランダムに割り当てます。

NAT 帯域幅パッケージとバックエンド ECS インスタンスが同じゾーンにない場合、接続の応答時間は変化しません。同じゾーンにある場合は応答時間が改善される場合があります。

この API は、NAT 帯域幅パッケージを 2018 年 1 月 26 日より前に購入している場合にのみ呼び出すことができます。 2018 年 1 月 26 日より前に購入したNAT帯域幅パッケージがアカウントにない場合は、EIP を関連付ける必要があります。
ClientToken String 任意 shefffxxddjehfh123

要求のべき等性を保証するために使用されるクライアントトークンを設定します。

このパラメーター値はクライアントによって生成され、一意である必要があります。 64 文字を超える ASCII 文字は使用できません。

説明 String 任意 testnat

NAT Gateway の説明内容を設定します。

長さは 2 から 256 文字で、 http:// または https:// で始めることはできません。

Name String 任意 fortest

NAT Gateway の名前を設定します。

長さは 4 から 100 文字で、 ピリオド (.)、アンダースコア (_)、およびハイフン (-) も使用できます。 名前は文字で始める必要があり、 http:// または https:// で始めることはできません。

このパラメーターが設定されていない場合、ゲートウェイ ID が使用されます。

Spec String 任意 small
NAT Gateway の仕様を設定します。  設定可能な値は次のとおりです。
  • Small: 小 (デフォルト値)

  • Middle: 中

  • Large: 大

  • Xlarge. 1: 超大型

レスポンスパラメーター

パラメータ データ型 値の例 説明
NatGatewayId String ngw-112za33e4

NAT Gateway の ID を設定します。

ID はシステムによって生成され、グローバルに一意です。

ForwardTableIds ftb-11tc6xgmv

転送テーブルのリストを設定します。

BandwidthPackageIds bwp-11odxu2k7

共有帯域幅パッケージのリストを設定します。

RequestId String 2315DEB7-5E92-423A-91F7-4C1EC9AD97C3

リクエストの ID を設定します。

SnatTableIds stb-SnatTableIds

SNAT テーブルの ID を設定します。

リクエストの例


https://vpc.aliyuncs.com/?Action=CreateNatGateway
&RegionId=cn-hangzhou
&VpcId= vpc-bp1di7uewzmtvfuq8ufpv
&<CommonParameters>
レスポンスの例
  • XML 形式

    <CreateNatGatewayResponse>
      <BandwidthPackageIds>bwp-**************</BandwidthPackageIds>
      <forwardTableIds>ftb-**************</forwardTableIds>
      <natGatewayId>ngw-**************</natGatewayId>
      <snatTableIds>stb-**************</snatTableIds>
      <RequestId>E43E51F2-344F-4685-8DF5-30EB298CFA81</RequestId>
    </CreateNatGatewayResponse>
    
  • JSON 形式

    {
    	"BandwidthPackageIds":[
    		"bwp-**************"
    	],
    	"snatTableIds":[
    		"stb-**************"
    	],
    	"natGatewayId":"ngw-**************",
    	"RequestId":"E43E51F2-344F-4685-8DF5-30EB298CFA81",
    	"forwardTableIds":[
    		"ftb-**************"
    	]
    }
    

エラーコード

HTTP コード エラーコード エラーメッセージ 説明
400 InvalidVPCStatus vpc incorrect status. VPC のステータスが正しくない場合に返されるエラーメッセージです。
404 InvalidRegionId.NotFound The specified RegionId does not exist in our records. 指定されたリージョン ID が存在しない場合に返されるエラーメッセージです。
400 MissingParameter.BandwidthPackage only support one BandwidthPackage be created with NatGateway. 少なくとも 1 つの共有帯域幅パッケージを指定する必要がある場合に返されるエラーメッセージです。
400 MissingParameter Miss mandatory parameter. 必須パラメーターが設定されていない場合に返されるエラーメッセージです。
404 InvalidZoneId.NotFound Specified value of ZoneId is not exists. 指定されたゾーンが正しくない場合に返されるエラーメッセージです。
404 InvalidZoneId.NotFound Can not find ZoneId for allocated ip. IP アドレスのゾーンが正しくない場合に返されるエラーメッセージです。
400 QuotaExceeded.BandwidthPackageIps The specified ipCount exceeded quota. IP アドレス数が上限に達した場合に返されるエラーメッセージです。 チケットを起票して、アドレス数の追加を申請できます。
400 InvalidParameter.Name.Malformed The specified Name is not valid. 指定された名前が正しくない場合に返されるエラーメッセージです。
400 InvalidParameter.Description.Malformed The specified Description is not valid. 指定された説明内容が正しくない場合に返されるエラーメッセージです。
400 ZONE_NO_AVAILABLE_IP The Zone have no available ip. ゾーンで使用可能な IP アドレスが不足した場合に返されるエラーメッセージです。
400 InvalidParameter.BandwidthPackage.n.ISP.ValueNotSupport The specified ISP of BandwidthPackage is not valid. 共有帯域幅パッケージの ISP が正しくない場合に返されるエラーメッセージです。
400 InvalidNatGatewayId.NotFound The NatGatewayId not exist. 指定された NatGatewayId が正しくない場合に返されるエラーメッセージです。
400 VswitchStatusError The VSwitch is creating . VSwitch が作成中である場合に返されるエラーメッセージです。
400 VpcStatusError The Vpc is creating . VPC が作成中である場合に返されるエラーメッセージです。
400 InvalidParameter.Spec.ValueNotSupported The specified Spec is not valid. 指定された仕様が正しくない場合に返されるエラーメッセージです。

本プロダクトのエラーコードをご参照ください。