All Products
Search
Document Center

Auto Scaling:Common parameters

Last Updated:Apr 08, 2025

The topic describes the common request parameters and response parameters for Auto Scaling API.

Common request parameters

The following common request parameters are applicable to scenarios in which GET requests are sent in URLs to call Auto Scaling API operations.

Parameter

Type

Required

Description

Action

String

Yes

The operation that you want to perform.

AccessKeyId

String

Yes

The AccessKey ID that is used to access the service. AccessKey pairs are used to call API operations. Usernames and passwords are used to log on to the Auto Scaling console. For more information, see Obtain an AccessKey pair.

Signature

String

Yes

The signature string. For more information, see Signatures.

SignatureMethod

String

Yes

The signature method. Set the value to HMAC-SHA1.

SignatureVersion

String

Yes

The version of the signature encryption algorithm. Set the value to 1.0.

SignatureNonce

String

Yes

A unique random number. We recommend that you use different numbers for different requests. We recommend that you use java.util.UUID.randomUUID() to generate a unique number in Java language.

Timestamp

String

Yes

The timestamp of the request. Specify the timestamp in the ISO 8601 standard in the YYYY-MM-DDThh:mm:ssZ format. The time must be in UTC.

For example, 2018-01-01T12:00:00Z specifies 20:00:00 on January 1, 2018 (UTC+8).

Version

String

Yes

The version number of the API. Specify the value in the YYYY-MM-DD format. Set the value to 2014-08-28.

Format

String

No

The format type of the response parameters. Valid values:

  • JSON

  • XML

Default value: JSON.

Sample request

http(s)://ess.aliyuncs.com/?Action=CreateScaling****
&Format=XML
&Version=2014-08-28
&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&AccessKeyId=key-test
&Timestamp=2018-01-01T12:00:00Z
...

Common response parameters

Parameter

Type

Description

RequestId

String

The request ID.

Every response returns a unique request ID regardless of whether the request is successful.

Sample success responses

XML format

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

<ModifyScalingGroupResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</ModifyScalingGroupResponse>

JSON format

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

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}