標準のインターネット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にダウングレードすることはできません。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
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) ユーザー権限、および必要なパラメーターをチェックします。 リクエストが事前チェックに失敗した場合、エラーメッセージが返されます。
リクエストが事前チェックに合格した場合、 false (デフォルト): リクエストが事前チェックに合格した場合、2XX HTTPステータスコードが返され、標準NATゲートウェイがアップグレードされます。 |
ClientToken | String | 任意 | 0c593ea1-3bea-11e9-b96b-88e9fe637760 |
リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、異なるリクエスト間で一意であることを確認する必要があります。 クライアントトークンにはASCII文字のみを含めることができます。 説明 このパラメーターを設定しない場合、ClientTokenはRequestIdの値に設定されます。 各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 エラーセンター」をご参照ください。