Modifies a Global Accelerator (GA) instance.

  • UpdateAccelerator 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 DescribeAccelerator operation to query the status of a GA instance.
    • If the GA instance is in the configuring state, the GA instance is being modified. In this case, you can perform only query operations.
    • If the GA instance is in the active state, the GA instance is modified.
  • The UpdateAccelerator 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 UpdateAccelerator

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

RegionId String No cn-hangzhou

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

ClientToken String No 123e4567****

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 all requests. The 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 of each API request may be different.
Name String No Accelerator

The name of the GA instance.

The name must be 2 to 128 characters in length, and can contain digits, periods (.), underscores (_), and hyphens (-). It must start with a letter.

Description String No Accelerator

The description of the GA instance. The description can be up to 200 characters in length.

AcceleratorId String Yes ga-bp1odcab8tmno0hdq****

The ID of the GA instance.

Spec String No 1

The specification of the GA instance. Valid values:

  • 1: Small Ⅰ
  • 2: Small Ⅱ
  • 3: Small Ⅲ
  • 5: Medium Ⅰ
  • 8: Medium Ⅱ
  • 10: Medium Ⅲ
  • 20: Large Ⅰ
  • 30: Large Ⅱ
  • 40: Large Ⅲ
  • 50: Large Ⅳ
  • 60: Large Ⅴ
  • 70: Large Ⅵ
  • 80: Large VⅡ
  • 90: Large VⅢ
  • 100: Super Large Ⅰ
  • 200: Super Large Ⅱ
Note The Large Ⅲ specification and higher specifications are available only for accounts that are added to the whitelist. To use GA instances of these specifications, contact your Alibaba Cloud account manager.

Different specifications provide different capabilities. For more information, see Instance specifications.

AutoPay Boolean No false

Specifies whether to enable automatic payment. Default value: false. Valid values:

  • false: disables automatic payment. If you select this option, you must go to the Order Center to complete the payment after an order is generated.
  • true: enables automatic payment. Payments are automatically completed.
AutoUseCoupon Boolean No false

Specifies whether to automatically pay bills by using coupons. Default value: false. Valid values:

  • true: automatically pays bills by using coupons.
  • false: does not automatically pay bills by using coupons.
Note This parameter is required only if AutoPay is set to true.

Response parameters

Parameter Type Example Description
RequestId String 6FEA0CF3-D3B9-43E5-A304-D217037876A8

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=UpdateAccelerator
&RegionId=cn-hangzhou
&ClientToken=123e4567****
&Name=Accelerator
&Description=Accelerator
&AcceleratorId=ga-bp1odcab8tmno0hdq****
&Spec=1
&AutoPay=false
&AutoUseCoupon=false
&Common request parameters

Sample success responses

XML format

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

<UpdateAcceleratorResponse>
    <RequestId>6FEA0CF3-D3B9-43E5-A304-D217037876A8	</RequestId>
</UpdateAcceleratorResponse>

JSON format

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

{
  "RequestId" : "6FEA0CF3-D3B9-43E5-A304-D217037876A8\t"
}

Error codes

HttpCode Error code Error message Description
400 NotExist.Accelerator The accelerated instance does not exist. The error message returned because the GA instance does not exist.
400 IllegalParameter.Spec The specified Spec is invalid. The error message returned because the specified Spec parameter is invalid.
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.
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 the request was being processed. Try again later.

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