拡張インターネット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ゲートウェイを作成することはできません。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
操作 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文字である必要があり、http:// またはhttps:// で始めることはできません。

ClientToken String 任意 5A2CFF0E-5718-45B5-9D4D-70B3FF3898

リクエストのべき等性を保証するために使用されるクライアントトークン。

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。

説明 このパラメーターを指定しない場合、システムはRequestIdClientTokenとして使用します。 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アドレスを割り当てます。

  • NAT gatewayを既存のvSwitchにアタッチするには、vSwitchが属するゾーンがNAT gatewayをサポートしていることを確認します。 さらに、vSwitchにはアイドルIPアドレスが必要です。
  • VPCにvSwitchが存在しない場合は、NAT GatewayをサポートするゾーンにvSwitchを作成します。 次に、NAT gatewayのvSwitchを指定します。
説明 ListEnhashcedNatGatewayAvailableZones操作を呼び出して、NATゲートウェイをサポートするゾーンを照会できます。 DescribeVSwitch操作を呼び出して、vSwitchで使用可能なIPアドレスの数を照会できます。
ナットタイプ String 必須 Enhanced

NAT gatewayのタイプ。 値を拡張 (拡張NATゲートウェイ) に設定します。

InternetChargeType String 任意 PayByLcu

NATゲートウェイの計測方法。 値をPayByLcuに設定します。これは、CU課金方式を指定します。

NetworkType String 任意 internet

NATゲートウェイのネットワークタイプ。 有効な値:

  • internet: インターネットNATゲートウェイ
  • イントラネット: VPC NATゲートウェイ
SecurityProtectionEnabled Boolean いいえ false

ファイアウォール機能を有効にするかどうかを指定します。 有効な値:

  • false (デフォルト): ファイアウォール機能を無効にします。
  • true: ファイアウォール機能を有効にします。
IcmpReplyEnabled Boolean いいえ false

ICMP非検索機能を有効にするかどうかを指定します。 有効な値:

  • false (デフォルト): ICMP非取得を無効にします
  • true: ICMP非取得を有効にします
EipBindMode String 任意 MULTI_BINDED

EIPがNATゲートウェイに関連付けられているモード。 有効な値:

  • MULTI_BINDED (デフォルト): マルチEIP-to-ENIモード。
  • NAT: NATモード。 IPv4ゲートウェイがサポートされています。
    説明 NATモードを使用する場合、EIPはNATゲートウェイのvSwitchで1つのプライベートIPアドレスを占有します。 vSwitchに十分なプライベートIPアドレスがあることを確認します。 それ以外の場合、NATゲートウェイはEIPに関連付けられません。 NATモードでは、NATゲートウェイを最大50のEIPに関連付けることができます。

レスポンスパラメーター

項目 データ型 例: 説明 
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ゲートウェイをサポートしていない場合に返されるエラーメッセージ。

エラーコードのリストについては、エラーセンターをご覧ください。