拡張インターネットNATゲートウェイまたはVirtual Private Cloud (VPC) NATゲートウェイを作成します。
注意事項
この操作を呼び出す前に、次の制限事項に注意してください。
- NATゲートウェイを初めて作成すると、システムは自動的にサービスにリンクされたロールAliyunServiceRoleForNatgwを作成し、ポリシーAliyunServiceRolePolicyForNatgwをロールにアタッチします。 これにより、NAT gatewayはAlibaba Cloud上の他のリソースにアクセスできます。 詳細については、「サービスにリンクされたロール」をご参照ください。
- 拡張インターネットNATゲートウェイを作成すると、ルートエントリがVPCのルートテーブルに自動的に追加されます。 ルートエントリの宛先CIDRブロックは0.0.0.0/0で、ネクストホップはNATゲートウェイです。 これにより、トラフィックがNATゲートウェイにルーティングされます。
- CreateNatGatewayは非同期操作です。 リクエスト後、インターネットNATゲートウェイまたはVPC NATゲートウェイのIDが返されますが、NATゲートウェイは作成されません。 システムはバックグラウンドでNATゲートウェイを作成します。
DescribeNatGatewaysを呼び出して、NATゲートウェイのステータスを照会できます。
- NAT gatewayが [作成中] 状態の場合、NAT gatewayは作成中です。 この場合、NAT gatewayを照会できますが、他の操作は実行できません。
-
NATゲートウェイが使用可能状態の場合、NATゲートウェイが作成されます。
NATゲートウェイの作成には1〜3分かかります。
- CreateNatGatewayを繰り返し呼び出して、指定された期間内にVPC NATゲートウェイまたはインターネットNATゲートウェイを作成することはできません。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | CreateNatGateway |
実行する操作です。 値をCreateNatGatewayに設定します。 |
RegionId | String | 必須 | cn-hangzhou |
NATゲートウェイを作成するリージョンのID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
VpcId | String | 必須 | vpc-bp1di7uewzmtvfuq8 **** |
NATゲートウェイを作成するVPCのID。 |
名前 | String | 任意 | fortest |
NATゲートウェイの名前。 名前は2 ~ 128文字で、英数字、アンダースコア (_) 、ハイフン (-) を使用できます。 先頭は英字とする必要があります。 このパラメーターが設定されていない場合、システムはNATゲートウェイにデフォルト名を割り当てます。 |
説明 | String | 任意 | testnat |
NATゲートウェイの説明。 このパラメーターを空のままにするか、説明を入力できます。 説明を入力する場合、説明は2〜256文字である必要があり、 |
ClientToken | String | 任意 | 5A2CFF0E-5718-45B5-9D4D-70B3FF3898 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 説明 このパラメーターを指定しない場合、システムはRequestIdをClientTokenとして使用します。 RequestIdは、APIリクエストごとに異なる場合があります。
|
Spec | String | 任意 | 無効なパラメーター |
サブスクリプションインターネットNATゲートウェイは購入できなくなりました。 このパラメーターを無視します。 |
InstanceChargeType | String | 任意 | PostPaid |
NAT gatewayの課金方法。 値をPostPaid (従量課金) に設定します。これはデフォルト値です。 詳細については、「インターネットNATゲートウェイ課金」および「VPC NATゲートウェイ課金」をご参照ください。 |
PricingCycle | String | 任意 | 無効なパラメーター |
サブスクリプションインターネットNATゲートウェイは購入できなくなりました。 このパラメーターを無視します。 |
有効期間 | String | 任意 | 無効なパラメーター |
サブスクリプションインターネットNATゲートウェイは購入できなくなりました。 このパラメーターを無視します。 |
AutoPay | Boolean | いいえ | 無効なパラメーター |
サブスクリプションインターネットNATゲートウェイは購入できなくなりました。 このパラメーターを無視します。 |
VSwitchId | String | 必須 | vsw-bp1e3se98n9fq8hle **** |
NAT gatewayが接続されているvSwitchのID。 NATゲートウェイを作成するときは、NATゲートウェイにvSwitchを指定する必要があります。 次に、システムはvSwitchからNATゲートウェイにアイドルプライベートIPアドレスを割り当てます。
説明 ListEnhashcedNatGatewayAvailableZones操作を呼び出して、NATゲートウェイをサポートするゾーンを照会できます。 DescribeVSwitch操作を呼び出して、vSwitchで使用可能なIPアドレスの数を照会できます。
|
ナットタイプ | String | 必須 | Enhanced |
NAT gatewayのタイプ。 値を拡張 (拡張NATゲートウェイ) に設定します。 |
InternetChargeType | String | 任意 | PayByLcu |
NATゲートウェイの計測方法。 値をPayByLcuに設定します。これは、CU課金方式を指定します。 |
NetworkType | String | 任意 | internet |
NATゲートウェイのネットワークタイプ。 有効な値:
|
SecurityProtectionEnabled | Boolean | いいえ | false |
ファイアウォール機能を有効にするかどうかを指定します。 有効な値:
|
IcmpReplyEnabled | Boolean | いいえ | false |
ICMP非検索機能を有効にするかどうかを指定します。 有効な値:
|
EipBindMode | String | 任意 | MULTI_BINDED |
EIPがNATゲートウェイに関連付けられているモード。 有効な値:
|
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
NatGatewayId | String | ngw-112za33e4 **** |
NAT ゲートウェイの ID 。 |
RequestId | String | 2315DEB7-5E92-423A-91F7-4C1EC9AD97C3 |
リクエストの ID です。 |
ForwardTableId | 文字列の配列 | ftb-11tc6xgmv **** |
DNATエントリのリスト。 |
SnatTableIds | 文字列の配列 | stb-SnatTableIds **** |
SNATエントリのリスト。 |
FullNatTableIds | 文字列の配列 | fulltb-gw88z7hhlv43rmb26 **** |
FULLNATエントリのリスト。 |
例
リクエストの例
http(s)://[Endpoint]/?Action=CreateNatGateway
&RegionId=cn-hangzhou
&VpcId=vpc-bp1di7uewzmtvfuq8 ****
&名前=fortest
&Description=testnat
&ClientToken=5A2CFF0E-5718-45B5-9D4D-70B3FF3898
&InstanceChargeType=PostPaid
&VSwitchId=vsw-bp1e3se98n9fq8hle ****
&NatType=強化
&InternetChargeType=PayByLcu
&NetworkType=インターネット
&SecurityProtectionEnabled=false
&IcmpReplyEnabled=false
&EipBindMode=MULTI_BINDED
&共通リクエストパラメータ
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<CreateNatGatewayResponse>
<NatGatewayId>ngw-112za33e4 ****</NatGatewayId>
<RequestId>2315DEB7-5E92-423A-91F7-4C1EC9AD97C3</RequestId>
<ForwardTableIds>ftb-11tc6xgmv ****</ForwardTableIds>
<SnatTableIds>stb-SnatTableIds ****</SnatTableIds>
<FullNatTableIds>fulltb-gw88z7hhlv43rmb26 ****</FullNatTableIds>
</CreateNatGatewayResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"NatGatewayId" : "ngw-112za33e4 ****" 、
"RequestId" : "2315DEB7-5E92-423A-91F7-4C1EC9AD97C3" 、
"ForwardTableIds" : [ "ftb-11tc6xgmv ****"] 、
"SnatTableIds" : [ "stb-SnatTableIds ****"] 、
"FullNatTableIds" : [ "fulltb-gw88z7hhlv43rmb26 ****"]
}
エラーコード
HttpCode | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | Forbidden.NatPayBySpec | 従量課金NATはサポートされなくなりました。 新しく購入した従量課金NAT Gatewayは、CU課金方式のみをサポートしています。 | 従量課金NAT Gatewayが購入できなくなった場合に返されるエラーメッセージ。 InternetChargeTypeパラメーターをPayByLcuに設定します。 |
400 | InvalidVPCStatus | vpcのステータスが正しくありません。 | VPCが現在の状態の場合、操作がサポートされていない場合に返されるエラーメッセージ。 VPCの状態が有効かどうかを確認します。 |
400 | InvalidNatGatewayName.MalFormed | NatGateway名は無効です。 | 指定されたNATゲートウェイの名前が無効な場合に返されるエラーメッセージ。 |
400 | InvalidNatGatewayDescription.MalFormed | NatGatewayの説明は無効です。 | 指定された説明が無効な場合に表示されるエラーメッセージ。 |
400 | MissingParameter.BandwidthPackage | NatGatewayで作成される1つのBandwidthPackageのみをサポートします。 | EIP帯域幅プランが指定されていない場合に返されるエラーメッセージ。 EIP帯域幅プランを指定する必要があります。 |
400 | MissingParameter | 必須パラメータがありません | 1つ以上の必須パラメーターが設定されていない場合に返されるエラーメッセージ。 この操作を呼び出す前に、必要なパラメーターをすべて設定しているかどうかを確認してください。 |
400 | QuotaExceeded.BandwidthPackageIps | 指定されたipCountがクォータを超えました。 | IPアドレスの数が上限に達した場合に返されるエラーメッセージ。 クォータ管理ページでクォータの増加をリクエストします。 |
400 | InvalidParameter.Name.Malformed | 指定されたNameは無効です。 | 指定された名前の形式が無効な場合に返されるエラーメッセージ。 有効な形式で名前を入力します。 |
400 | InvalidParameter.Description.Malformed | 指定されたDescriptionは無効です。 | 指定された説明が無効な場合に表示されるエラーメッセージ。 |
400 | ZONE_NO_AVAILABLE_IP | ゾーンには利用可能なipがありません。 | ゾーンで使用可能なIPアドレスがない場合に返されるエラーメッセージ。 |
400 | InvalidParameter.BandwidthPackage.n.ISP.ValueNotSupport | BandwidthPackageの指定されたISPは無効です。 | EIP帯域幅プランの指定されたインターネットサービスプロバイダー (ISP) が無効な場合に返されるエラーメッセージ。 |
400 | InvalidNatGatewayId.NotFound | NatGatewayId は存在しません。 | 指定されたNATゲートウェイIDが存在しない場合に返されるエラーメッセージ。 NatGatewayIdパラメーターの値が有効かどうかを確認します。 |
400 | VswitchStatusError | VSwitchが作成中です。 | vSwitchの作成時に操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | VpcStatusError | Vpcは作成中です。 | VPCの作成中に操作がサポートされていない場合に返されるエラーメッセージ。 |
400 | InvalidParameter.Spec.ValueNotSupported | 指定された Spec は無効です。 | 指定されたサイズが無効な場合に返されるエラーメッセージ。 |
400 | タスク競合 | 操作が頻繁すぎる、TaskConflict。 | システムがビジー状態の場合に返されるエラーメッセージ。 しばらくしてからもう一度お試しください。 |
400 | Forbidden.CheckEntryRuleQuota | ルートエントリのクォータルールの確認エラー。 | システムがルートエントリのクォータをチェックしているときにエラーが発生した場合に返されるエラーメッセージ。 |
400 | OperationFailed.UnpaidBillsExist | アカウントには未払いの請求書があります。 まず延滞請求書をお支払いください。 | アカウントに未払いの注文がある場合に返されるエラーメッセージ。 |
400 | OperationFailed.EnhancedQuotaExceed | vpcクォータごとの拡張natゲートウェイを超えています | 指定されたVPC内の拡張NATゲートウェイの数が上限に達した場合に返されるエラーメッセージ。 |
400 | OperationFailed.VswNotBelongToVpc | 指定されたVSwitchがNAT gatewayと同じVPCにバインドされていないため、操作に失敗しました。 | vSwitchとNATゲートウェイが同じVPCに属していない場合に返されるエラーメッセージ。 |
400 | OperationFailed.EnhancedUserIsUnAuthorized | ユーザーが拡張NATゲートウェイを作成する権限がないため、操作に失敗しました。 | 拡張NATゲートウェイを作成する権限がない場合に返されるエラーメッセージ。 |
400 | OperationUnsupported.PrePaidPyByLcu | サブスクリプションNATゲートウェイが従量課金方式をサポートしていないため、操作が失敗しました。 | サブスクリプションNAT GatewayがCU課金方式をサポートしていない場合に返されるエラーメッセージ。 |
400 | OperationFailed.NormalInventoryNotEnough | 標準NATゲートウェイは提供されなくなりました。 拡張NATゲートウェイを作成し、正しいnatTypeを設定できます。 | 標準NAT Gatewayを作成できなくなった場合に返されるエラーメッセージ。 NatTypeパラメーターをEnhancedに設定します。 |
400 | UnsupportedFeature.IcmpReplyEnabled | IcmpReplyEnabledの機能はサポートされていません。 | IcmpReplyEnabledパラメーターの値を変更できない場合に返されるエラーメッセージ。 |
400 | ExclusiveParam.% sAnd % s | % sと % sのパラメーターは相互に排他的です。 | % sと % sを同時に設定することはできません。 |
404 | InvalidRegionId.NotFound | 指定された RegionId はレコードに存在しません。 | 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。 |
404 | InvalidVpcId.NotFound | VpcId に指定された値はレコードに見つかりません。 | 指定された VPC が存在しない場合に返されるエラーメッセージ。 指定されたVPC IDが有効かどうかを確認します。 |
404 | InvalidZoneId.NotFound | ZoneId に指定された値は存在しません。 | 指定されたゾーンが存在しない場合に返されるエラーメッセージ。 |
404 | InvalidZoneId.NotFound | 割り当てられた IP に対する ZoneId が見つかりません。 | 指定されたIPアドレスのゾーンが無効な場合に返されるエラーメッセージ。 |
404 | UnsupportedZoneForFwNat | このゾーンはFW NATでサポートされていません。 | 指定されたゾーンがファイアウォールが有効になっている拡張NATゲートウェイをサポートしていない場合に返されるエラーメッセージ。 |
エラーコードのリストについては、エラーセンターをご覧ください。