サブスクリプションのインターネット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 |
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | ModifyNatGatewaySpec |
実行する操作です。 値をModifyNatGatewaySpecに設定します。 |
RegionId | String | 必須 | cn-hangzhou |
インターネットNATゲートウェイがデプロイされているリージョンのID。 DescribeRegions を呼び出して、最新のリージョンリストをクエリできます。 |
NatGatewayId | String | 必須 | ngw-bp1uewa15k4iy5770 **** |
アップグレードするインターネットNATゲートウェイのID。 |
Spec | String | 必須 | 中間 |
インターネットNATゲートウェイのサイズ。 有効な値:
|
AutoPay | Boolean | いいえ | 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 エラーセンター」をご参照ください。