CreateNatGateway - - Alibaba Cloud ドキュメントセンター

拡張インターネット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	リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。説明このパラメーターを指定しない場合、システムは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アドレスを割り当てます。 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ゲートウェイをサポートしていない場合に返されるエラーメッセージ。

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