標準のインターネットNATゲートウェイを拡張インターネットNATゲートウェイにアップグレードします。

使用上の注意

この操作を呼び出す前に、次の制限事項に注意してください。

  • UpdateNatGatewayNatTypeは非同期操作です。 リクエストを行うと、リクエストのIDが返されますが、NATゲートウェイはアップグレードされません。 システムはバックグラウンドでNATゲートウェイをアップグレードします。 GetNatGatewayConvertStatus操作を呼び出して、NATゲートウェイのアップグレードの進行状況を照会できます。 詳細については、「GetNatGatewayConvertStatus」をご参照ください。
    • NAT gatewayが処理中の場合、NAT gatewayがアップグレード中であることを示します。 NAT gatewayの状態のみを照会できますが、その他の操作は実行できません。
    • NAT gatewayが成功している場合は、NAT gatewayがアップグレードされていることを示します。
    • NATゲートウェイの状態が失敗している場合は、システムがNATゲートウェイのアップグレードに失敗したことを示します。
  • UpdateNatGatewayNatTypeを繰り返し呼び出して、指定された期間内にNATゲートウェイをアップグレードすることはできません。
  • 課金方法と課金可能な項目は、アップグレード後も変わりません。
  • 標準NATゲートウェイを拡張NATゲートウェイにアップグレードするには、約5分かかります。 アップグレード中に、一時的な接続が1回または2回発生する場合があります。 ビジネス要件に基づいて、自動再接続を有効にするか手動再接続を使用するかを決定できます。
  • 標準NAT Gatewayを拡張NAT Gatewayにのみアップグレードできます。 拡張NAT Gatewayを標準NAT Gatewayにダウングレードすることはできません。

デバッグ

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

リクエストパラメーター

項目 データ型 必須/任意 例: 説明 
RegionId String 必須 cn-qingdao

アップグレードするNATゲートウェイがデプロイされているリージョンのID。

DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。

NatGatewayId String 必須 ngw-bp1b0lic8uz4r6vf2 ****

アップグレードする標準NATゲートウェイのID。

VSwitchId String 必須 vsw-bp17nszybg8epodke ****

拡張インターネットNATゲートウェイが属するvSwitch。

説明 このパラメーターを設定しないと、仮想プライベートクラウド (VPC) のランダムなvSwitchにインターネットNATゲートウェイが作成されます。
ナットタイプ String 必須 Enhanced

インターネットNATゲートウェイのタイプ。 値を [拡張] に設定します。これは、拡張インターネットNATゲートウェイを指定します。

DryRun Boolean いいえ false

このリクエストのみを事前チェックするかどうかを指定します。 有効な値:

true: リクエストを事前にチェックしますが、インターネットNATゲートウェイはアップグレードしません。 システムは、AccessKeyペア、Resource Access Management (RAM) ユーザー権限、および必要なパラメーターをチェックします。 リクエストが事前チェックに失敗した場合、エラーメッセージが返されます。 リクエストが事前チェックに合格した場合、DryRunOperationエラーコードが返されます。

false (デフォルト): リクエストが事前チェックに合格した場合、2XX HTTPステータスコードが返され、標準NATゲートウェイがアップグレードされます。

ClientToken String 任意 0c593ea1-3bea-11e9-b96b-88e9fe637760

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

クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 クライアントトークンにはASCII文字のみを含めることができます。

説明 このパラメーターを設定しない場合、ClientTokenRequestIdの値に設定されます。 各APIリクエストのRequestIdの値は異なる場合があります。
操作 String 必須 UpdateNatGatewayNatType

実行する操作です。 値をUpdateNatGatewayNatTypeに設定します。

レスポンスパラメーター

項目 データ型 例: 説明 
RequestId String 0ED8D006-F706-4D23-88ED-E11ED28DCAC0

リクエストの ID です。

リクエストの例

http(s):// [エンドポイント]/?RegionId=cn-qingdao
&NatGatewayId=ngw-bp1b0lic8uz4r6vf2 ****
&VSwitchId=vsw-bp17nszybg8epodke ****
&NatType=強化
&DryRun=false
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe637760
&アクション=UpdateNatGatewayNatType
&共通リクエストパラメータ

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpdateNatGatewayNatTypeResponse>
    <RequestId>0ED8D006-F706-4D23-88ED-E11ED28DCAC0</RequestId>
</UpdateNatGatewayNatTypeResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "0ED8D006-F706-4D23-88ED-E11ED28DCAC0"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明 
400 OperationUnsupported.NatConvert NATゲートウェイ変換機能はサポートされていません。 NAT gatewayのアップグレード機能がサポートされていない場合に返されるエラーメッセージ。
400 NATGW_NOT_EXIST 指定されたNAT gatewayは存在しません。 指定されたNAT gatewayが存在しない場合に返されるエラーメッセージ。
400 OperationFailed.VpcNotExist 指定された VPC は存在しません。 指定された VPC が存在しない場合に返されるエラーメッセージ。
400 OperationFailed.VswNotExist 指定された VSwitch は存在しません。 指定されたvSwitchが存在しない場合に返されるエラーメッセージ。
400 OperationFailed.NatTypeNotEnhanced 指定されたNAT gatewayタイプが拡張されていないため、操作に失敗しました。 指定されたゲートウェイタイプが拡張NATゲートウェイではない場合に返されるエラーメッセージ。
400 OperationFailed.NatGwBindWithBandwidthPackage NAT gatewayが帯域幅パッケージにバインドされているため、操作に失敗しました。 1つ以上のNATサービスプランがNATゲートウェイに関連付けられている場合に返されるエラーメッセージ。
400 IncorrectStatus.NatGateway NAT gatewayのステータスが正しくありません。 NAT gatewayのステータスが無効な場合に返されるエラーメッセージ。
400 OperationFailed.EipInMiddleStatus 指定されたNAT gatewayに関連付けられているEIPのステータスが異常であるため、操作に失敗しました。 指定されたNATゲートウェイに関連付けられているelastic IPアドレス (EIP) のステータスが異常な場合に返されるエラーメッセージ。
400 OperationFailed.SnatInMiddleStatus 指定されたNAT gatewayのSNATエントリの状態が異常であるため、操作に失敗しました。 NATゲートウェイの送信元ネットワークアドレス変換 (SNAT) エントリのステータスが異常な場合に返されるエラーメッセージ。
400 OperationFailed.DnatInMiddleStatus NATゲートウェイに関連付けられているDNATエントリのステータスが異常なため、操作に失敗しました。 NATゲートウェイの宛先ネットワークアドレス変換 (DNAT) エントリのステータスが異常な場合に返されるエラーメッセージ。
400 OperationFailed.NatGwRouteInMiddleStatus NAT gatewayに関連付けられているルートエントリの状態が異常であるため、操作に失敗しました。 NATゲートウェイに関連付けられているルートエントリのステータスが異常である場合に返されるエラーメッセージ。
400 OperationFailed.EnhancedInventoryNotEnough 指定されたゾーンで拡張NATゲートウェイインベントリが不足しています。 指定されたゾーンで拡張NAT Gatewayのクォータが不足している場合に返されるエラーメッセージ。
400 OperationFailed.EnhancedUserIsUnAuthorized ユーザーが拡張NATゲートウェイを作成する権限がないため、操作に失敗しました。 拡張NATゲートウェイを作成する権限がない場合に返されるエラーメッセージ。
400 OperationFailed.EnhancedRegion 拡張NAT Gatewayが指定されたリージョンで販売されていないため、操作に失敗しました。 拡張NAT Gatewayが指定されたリージョンで販売されていない場合に返されるエラーメッセージ。
400 OperationFailed.EnhancedQuotaExceed 同じVPC内の拡張NATゲートウェイの最大数を超えたため、操作に失敗しました。 指定されたVPC内の拡張NATゲートウェイの数が上限に達した場合に返されるエラーメッセージ。
400 InvalidBandwidthPackageIdNumber.NotSupported BandwidthPackageIdsの数が制限を超えています。 EIP帯域幅プランの数が上限に達した場合に返されるエラーメッセージ。
400 OperationFailed.VswNotBelongToVpc 指定されたVSwitchがNAT gatewayと同じVPCにバインドされていないため、操作に失敗しました。 vSwitchとNATゲートウェイが同じVPCに属しておらず、操作が失敗した場合に返されるエラーメッセージ。
400 OperationUnsupported.VpcAttachedCen VPCがCENに接続されているため、操作に失敗しました。 VPCがCloud Enterprise Network (CEN) インスタンスに接続されている場合に返されるエラーメッセージ。
400 OperationUnsupported.RouterInterfaceExist VPCにルーターインターフェイスがあるため、操作に失敗しました。 VPCにルーターインターフェイスがある場合に返されるエラーメッセージ。
400 OperationFailed.VRouterNotExist VRouterが存在しないため、操作に失敗しました。 vRouterが存在しない場合に返されるエラーメッセージ。
400 OperationFailed.SnatQuotaExceed SNATエントリの最大数を超えたため、操作に失敗しました。 SNATエントリの数が上限に達した場合に返されるエラーメッセージ。
400 OperationFailed.DnatQuotaExceed 転送エントリの最大数を超えたため、操作に失敗しました。 DNATエントリの数が上限に達した場合に返されるエラーメッセージ。
400 OperationFailed.VswBindedRouteTable サブネットルートを含むカスタムルートテーブルが指定されたVSwitchに関連付けられているため、操作に失敗しました。 指定されたvSwitchがサブネットルートテーブルに関連付けられている場合に返されるエラーメッセージ。
400 OperationFailed.VswBindedAcl ネットワークACLが指定されたVSwitchに関連付けられているため、操作に失敗しました。 指定されたvSwitchがネットワークACLに関連付けられている場合に返されるエラーメッセージ。
400 禁じられた改宗者 ユーザーに操作権限がありません。 該当の操作を実行する権限がない場合に返されるエラーメッセージです。
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。