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 文字で、 |
Name | String | 任意 | fortest |
NAT Gateway の名前を設定します。 長さは 4 から 100 文字で、 ピリオド (.)、アンダースコア (_)、およびハイフン (-) も使用できます。 名前は文字で始める必要があり、 このパラメーターが設定されていない場合、ゲートウェイ ID が使用されます。 |
Spec | String | 任意 | small |
NAT Gateway の仕様を設定します。 設定可能な値は次のとおりです。
|
レスポンスパラメーター
パラメータ | データ型 | 値の例 | 説明 |
---|---|---|---|
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. | 指定された仕様が正しくない場合に返されるエラーメッセージです。 |