Modifies an application acceleration rule.

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 UpdateApplicationAccelerateRuleAttribute

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

DryRun Boolean No false

Specifies whether to precheck the request. Check items include permissions and the status of the specified cloud resources. Valid values:

  • false (default): sends the request. After the request passes the check, the application acceleration rule is modified.
  • true: prechecks the request without modifying the application acceleration rule. If you select this option, the system checks whether the required parameters are set, and whether the request syntax is valid. If the request fails to pass the precheck, the system returns an error. If the request passes the precheck, the DryRunOperation error code is returned.
ClientToken String No 02fb3da4-130e-11e9-8e44-001****

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

You can use the client to generate a token, but you must make sure that it is unique among different requests. The token can contain only ASCII characters and cannot exceed 64 characters in length.

RegionId String Yes cn-shanghai

The region ID of the bandwidth plan for application acceleration.

You can call the DescribeRegions operation to query the most recent region list.

ApplicationAccelerateRuleId String Yes abwpr-2dq2jj5m73jdy****

The ID of the application acceleration rule.

You can call the ListApplicationAccelerateRules operation to query the IDs of application acceleration rules that are added to a bandwidth plan for application acceleration.

Bandwidth String Yes 1

The maximum bandwidth value of the application acceleration rule. Unit: Mbit/s.

Note For each bandwidth plan for application acceleration, the sum of bandwidth values that you specify for different application acceleration rules cannot exceed the maximum bandwidth value of the bandwidth plan for application acceleration.
Applications Array of String Yes O365

The applications that you want to accelerate.

You can call the ListAccelerateApplications operation to query the information about applications that can be accelerated by Smart Access Gateway (SAG).

Response parameters

Parameter Type Example Description
RequestId String 6DB579AC-A831-4863-8BBE-BDAE1E818017

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=UpdateApplicationAccelerateRuleAttribute
&DryRun=false
&ClientToken=02fb3da4-130e-11e9-8e44-001****
&RegionId=cn-shanghai
&ApplicationAccelerateRuleId=abwpr-2dq2jj5m73jdy****
&Bandwidth=1
&Applications=["O365"]
&<Common request parameters>

Sample success responses

XML format

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

<UpdateApplicationAccelerateRuleAttributeResponse>
    <RequestId>6DB579AC-A831-4863-8BBE-BDAE1E818017</RequestId>
</UpdateApplicationAccelerateRuleAttributeResponse>

JSON format

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

{
  "RequestId" : "6DB579AC-A831-4863-8BBE-BDAE1E818017"
}

Error codes

HttpCode Error code Error message Description
400 OperationDenied.Arrearage The operation is denied due to overdue payment. The error message returned because the operation is denied due to overdue payments.
400 OperationDenied.BandwidthExceeded The total bandwidth exceeds the limit. The operation is denied. The error message returned because the sum of maximum bandwidth values has reached the upper limit and the operation is denied.
500 InternalError An error occurred while processing your request. The error message returned because an unknown error occurred.

For a list of error codes, visit the API Error Center.