サブスクリプションのインターネットNATゲートウェイをアップグレードします。

使用上の注意

  • この操作を呼び出して、サブスクリプションのインターネットNATゲートウェイをダウングレードすることはできません。 サブスクリプションのインターネットNATゲートウェイは、コンソールでのみダウングレードできます。
  • このAPIを呼び出してサブスクリプションのインターネットNATゲートウェイをアップグレードすると、注文が生成されます。 注文センターで支払いを完了すると、インターネットNATゲートウェイがアップグレードされます。
  • ModifyNatGatewaySpecは非同期操作です。 リクエストを行うと、リクエストのIDが返されますが、インターネットNATゲートウェイはアップグレードされません。 システムはバックグラウンドでNATゲートウェイをアップグレードします。 DescribeNatGatewaysを呼び出して、インターネットNATゲートウェイのステータスを照会できます。
    • インターネットNATゲートウェイが [変更] 状態の場合、NATゲートウェイはアップグレード中です。 この場合、NATゲートウェイのみを照会できますが、その他の操作は実行できません。
    • インターネットNATゲートウェイが利用可能状態の場合、インターネットNATゲートウェイはアップグレードされます。
  • ModifyNatGatewaySpec操作を繰り返し呼び出して、仕様課金NATゲートウェイのサイズを変更することはできません。

インターネットNAT Gatewayは、さまざまなサイズで利用できます。 インターネットNATゲートウェイのサイズによって、SNATのパフォーマンスが決まります。これには、最大接続数と1秒あたりの新しい接続数が含まれます。 ただし、NATゲートウェイのサイズはデータスループットに影響しません。 次の表に、さまざまなサイズのインターネットNATゲートウェイとSNATパフォーマンスメトリックの相関関係を示します。

サイズ

最大接続数

1秒あたりの新しい接続数

Small

10,000

1,000

中

50,000

5,000

Large

200,000

10,000

デバッグ

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

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 ModifyNatGatewaySpec

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

RegionId String 必須 cn-hangzhou

インターネットNATゲートウェイがデプロイされているリージョンのID。

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

NatGatewayId String 必須 ngw-bp1uewa15k4iy5770 ****

アップグレードするインターネットNATゲートウェイのID。

Spec String 必須 中間

インターネットNATゲートウェイのサイズ。 有効な値：

  • 小さい: 小さい
  • Middle：中
  • Large：大
AutoPay Boolean いいえ false

支払いを自動的に完了するかどうかを指定します。

  • true: 自動支払いを有効にします。 支払いは自動的に完了します。
  • false (デフォルト): 自動支払いを無効にします。 このオプションを選択した場合、注文が生成された後、注文センターに移動して支払いを完了する必要があります。
ClientToken String 任意 123e4567-e89b-12d3-a456-426655 ****

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

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

レスポンスパラメーター

項目 データ型 例: 説明　
RequestId String DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D

リクエストの ID です。

例

リクエストの例

http(s)://[Endpoint]/?Action=ModifyNatGatewaySpec
&RegionId=cn-hangzhou
&NatGatewayId=ngw-bp1uewa15k4iy5770 ****
&スペック=ミドル
&AutoPay=false
&ClientToken=123e4567-e89b-12d3-a456-426655 ****
&共通リクエストパラメータ

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

XML 形式 

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

<ModifyNatGatewaySpecResponse>
    <RequestId>DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D</RequestId>
</ModifyNatGatewaySpecResponse>

JSON 形式 

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

{
  "RequestId" : "DBD4E4A2-786E-4BD2-8EB6-107FFC2B5B7D"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 NATGW_MODIFY_SPEC_SAME 指定された Spec は現行と同じです。 指定されたゲートウェイのサイズが現在のサイズと同じである場合に返されるエラーメッセージ。
400 InvalidParameter.Spec.ValueNotSupported 指定された Spec は無効です。 指定されたサイズが無効な場合に返されるエラーメッセージ。
404 InvalidRegionId.NotFound 指定された RegionId はレコードに存在しません。 指定されたリージョンIDが存在しない場合に返されるエラーメッセージ。
404 InvalidNatGatewayId.NotFound 指定された NatGatewayId はレコードに存在しません。 指定されたNATゲートウェイIDが存在しない場合に返されるエラーメッセージ。 NatGatewayIdパラメーターの値が有効かどうかを確認します。
404 OperationUnsupported.PayByLcuNatModifySpec payByLcu natの仕様は、変更がサポートされていません。 従量課金NAT Gatewayのサイズを変更できない場合に返されるエラーメッセージ。

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