Modifies the attributes of a specified acceleration region in an acceleration area for a Global Accelerator (GA) instance.

Usage notes

  • 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 status of acceleration regions.
    • 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 UpdateIpSet

The operation that you want to perform. Set the value to UpdateIpSet.

RegionId String Yes cn-hangzhou

The ID of the region where the GA instance is deployed. Set the value to cn-hangzhou.

ClientToken String No 7D2F7E4E-B958-439C-9821-56D6213A31EC

The client token that is used to ensure the idempotence of the request.

You can use the client to generate the value, but you must make sure that it is unique among different requests. The client token can contain only ASCII characters.

Note If you do not set this parameter, the system sets ClientToken to the value of RequestId. The value of RequestId may be different for each API request.
IpSetId String Yes ips-bp11r5jb8ogp122xl****

The ID of the acceleration region that you want to modify.

Bandwidth Integer Yes 3

The new bandwidth to be allocated to the acceleration region. Unit: Mbit/s.

Response parameters

Parameter Type Example Description
RequestId String 7D2F7E4E-B958-439C-9821-56D6213A31EC

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=UpdateIpSet
&RegionId=cn-hangzhou
&ClientToken=7D2F7E4E-B958-439C-9821-56D6213A31EC
&IpSetId=ips-bp11r5jb8ogp122xl****
&Bandwidth=3
&Common request parameters

Sample success responses

XML format 

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

<UpdateIpSetResponse>
    <RequestId>7D2F7E4E-B958-439C-9821-56D6213A31EC</RequestId>
</UpdateIpSetResponse>

JSON format 

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

{
  "RequestId" : "7D2F7E4E-B958-439C-9821-56D6213A31EC"
}

Error codes

HttpCode Error code Error message Description
400 Resource.QuotaFull The resource quota is exceeded. The error message returned because the number of resources has reached the upper limit.
400 NotExist.IpSet The IpSet does not exist. The error message returned because the specified acceleration region does not exist.
400 StateError.IpSet The state of IpSet is invalid. The error message returned because the specified acceleration region is in an invalid state.
400 NotExist.Accelerator The accelerated instance does not exist. The error message returned because the specified GA instance does not exist.
400 StateError.Accelerator The state of the accelerated instance is invalid. The error message returned because the specified GA instance is in an invalid 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.
403 Forbbiden.SubUser You are not authorized to operate on the specified resource because your account was created by another user. The error message returned because the current account is a RAM user and does not have permissions to manage the specified resources.
403 Forbidden The user is not authorized to operate on the specified resource. The error message returned because the current account does not have permissions to manage the specified resources.
500 UnknownError An error occurred while processing your request. Please try again. If the error persists, please submit a ticket. The error message returned because an error occurred while processing the request. Try again later. If the error persists, submit a ticket.

For a list of error codes, see Service error codes.