Global Accelerator (GA) インスタンスのアクセラレーションエリア内の複数のアクセラレーションリージョンを変更します。
説明
- UpdateIpSetは非同期操作です。 リクエストを送信した後、システムはリクエストIDを返しますが、操作はシステムバックグラウンドで実行中です。 DescribeIpSet操作を呼び出して、アクセラレーションリージョンの状態を照会できます。
- 加速領域が更新状態にある場合、加速領域は修正中である。 この場合、クエリ操作のみを実行できます。
- 加速領域がアクティブ状態にある場合、加速領域は変更される。
- UpdateIpSet操作は、特定の期間内に同じGAインスタンスに対して繰り返し呼び出すことはできません。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | UpdateIpSets |
実行する操作です。 値をUpdateIpSetsに設定します。 |
RegionId | String | 必須 | cn-hangzhou |
GAインスタンスがデプロイされているリージョンのID。 値をcn-hangzhouに設定します。 |
IpSets.N.Bandwidth | Integer | 〇 | 4 |
アクセラレーションリージョンに割り当てられる新しい帯域幅。 単位:Mbit/秒。 最大100個のアクセラレーションリージョンの帯域幅を指定できます。 |
IpSets.N.IpSetId | String | 必須 | ips-bp11c9mpphtb1xkds**** |
変更するアクセラレーションリージョンの ID です。 最大100個のアクセラレーションリージョンのIDを指定できます。 |
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
RequestId | String | 685662FF-B1CE-4D5C-A4C8-2FF3C2146BFC |
リクエストの ID です。 |
例
リクエストの例
http(s):// [エンドポイント]/?Action=UpdateIpSets
&RegionId=cn-hangzhou
&IpSets=[{"帯域幅":4,"IpSetId":"ips-bp11c9mpphtb1xkds ****"}]
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateIpSetsResponse>
<RequestId>685662FF-B1CE-4D5C-A4C8-2FF3C2146BFC</RequestId>
</UpdateIpSetsResponse>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "685662FF-B1CE-4D5C-A4C8-2FF3C2146BFC"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | Repeat.IpSets | IpSetの設定が重複しています。 | 重複したアクセラレーションリージョンが指定されている場合に返されるエラーメッセージ。 |
400 | NotExist.IpSets | IpSetは存在しません。 | 指定されたアクセラレーションリージョンが存在しない場合に返されるエラーメッセージ。 |
400 | NotActive.IpSet | IpSetの状態はアクティブではありません。 | 指定されたアクセラレーションリージョンが不安定な状態にある場合に返されるエラーメッセージ。 |
400 | NotExist.BasicBandwidthPackage | 基本帯域幅パッケージを指定する必要があります。 | 基本帯域幅プランが指定されていない場合に返されるエラーメッセージ。 |
400 | GreaterThanGa.IpSetBandwidth | IpSetの合計帯域幅がGAインスタンスの合計帯域幅を超えています。 | アクセラレーションリージョンの合計帯域幅がGAインスタンスでサポートされている上限に達した場合に返されるエラーメッセージ。 |
エラーコードリストについては、「API エラーセンター」をご参照ください。