Modifies multiple acceleration regions in an acceleration area for a Global Accelerator (GA) instance.
Description
- UpdateIpSet is an asynchronous operation. After you send a request, the system returns a request
ID, but the operation is still being performed in the system background. You can call
the DescribeIpSet operation to query the state of an acceleration region.
- If the acceleration region is in the updating state, the acceleration region is being modified. In this case, you can perform only query operations.
- If the acceleration region is in the active state, the acceleration region is modified.
- The UpdateIpSet operation cannot be repeatedly called for the same GA instance within a specific period of time.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | UpdateIpSets |
The operation that you want to perform. Set the value to UpdateIpSets. |
RegionId | String | Yes | cn-hangzhou |
The ID of the region where the GA instance is deployed. Set the value to cn-hangzhou. |
IpSets.N.Bandwidth | Integer | Yes | 4 |
The new bandwidth to be allocated to the acceleration region. Unit: Mbit/s. You can specify the bandwidth for up to 100 acceleration regions. |
IpSets.N.IpSetId | String | Yes | ips-bp11c9mpphtb1xkds**** |
The ID of the acceleration region that you want to modify. You can specify the IDs of up to 100 acceleration regions. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
RequestId | String | 685662FF-B1CE-4D5C-A4C8-2FF3C2146BFC |
The ID of the request. |
Examples
Sample requests
http(s)://[Endpoint]/?Action=UpdateIpSets
&RegionId=cn-hangzhou
&IpSets=[{"Bandwidth":4,"IpSetId":"ips-bp11c9mpphtb1xkds****"}]
&<Common request parameters>
Sample success responses
XML
format
HTTP/1.1 200 OK
Content-Type:application/xml
<UpdateIpSetsResponse>
<RequestId>685662FF-B1CE-4D5C-A4C8-2FF3C2146BFC</RequestId>
</UpdateIpSetsResponse>
JSON
format
HTTP/1.1 200 OK
Content-Type:application/json
{
"RequestId" : "685662FF-B1CE-4D5C-A4C8-2FF3C2146BFC"
}
Error codes
HTTP status code | Error code | Error message | Description |
---|---|---|---|
400 | Repeat.IpSets | The configuration of IpSet is duplicated. | The error message returned because duplicated acceleration regions are specified. |
400 | NotExist.IpSets | The IpSet does not exist. | The error message returned because the specified acceleration region does not exist. |
400 | NotActive.IpSet | The state of IpSet is not active. | The error message returned because the specified acceleration region is in an unstable state. |
400 | NotExist.BasicBandwidthPackage | You must specify the basic bandwidth package. | The error message returned because no basic bandwidth plan is specified. |
400 | GreaterThanGa.IpSetBandwidth | The total bandwidth for IpSet exceeds the total bandwidth of the GA instance. | The error message returned because the total bandwidth of acceleration regions has reached the upper limit supported by the GA instance. |
For a list of error codes, visit the API Error Center.