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

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

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.