All Products
Search
Document Center

:Common parameters

Last Updated:Sep 21, 2023

This topic describes the common request parameters and response parameters that are used by all Cloud Backup API operations.

Common request parameters

Parameter

Type

Required

Description

Action

String

Yes

The name of the API operation. For more information about the valid values, see List of operations by function.

Format

String

No

The format of the response. Valid values:

  • JSON. Default value: JSON.

  • XML

Version

String

Yes

The API version in the YYYY-MM-DD format. Valid value:

2017-09-08

AccessKeyId

String

Yes

The AccessKey ID that is used to access the required service. For more information, see Obtain an AccessKey pair.

Signature

String

Yes

The signature string of the request. For more information, see Request signatures.

SignatureMethod

String

Yes

The encryption method of the signature string. Valid value:

HMAC-SHA1

Timestamp

String

Yes

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

Example: 2013-01-10T12:00:00Z, which specifies 20:00:00 on January 10, 2013 (UTC+8).

SignatureVersion

String

Yes

The version of the signature encryption algorithm. Valid value:

1.0

SignatureNonce

String

Yes

A unique random number that is used to prevent replay attacks.

You must use different random numbers for different requests.

Sample requests

http://hbr.cn-hangzhou.aliyuncs.com/?Action=DescribeLoadBalancers
&TimeStamp=2014-05-19T10%3A33%3A56Z
&Format=xml
&AccessKeyId=testid
&SignatureMethod=Hmac-SHA1
&SignatureNonce=NwDAxvLU6tFE0DVb
&Version=2014-05-15
&SignatureVersion=1.0
&Signature=Signature

Common response parameters

API responses use the HTTP response format. Responses can be returned in the JSON or XML format. The default response format is XML. You can specify the response format in the request. Each call returns a unique RequestId in the response regardless of whether the call is successful.

Parameter

Type

Required

Description

RequestId

String

Yes

The ID of the request. This parameter is returned regardless of whether the call is successful.

Sample responses

Sample success responses

  • XML format

    <?xml version="1.0" encoding="utf-8"?> 
        <!--Result Root Node-->
        <API Operation Name+Response>
            <!--Return Request Tag-->
            <RequestId>4C467B38-3910-447D-87BC-AC049166F216</RequestId>
            <!--Return Result Data-->
        </API Operation Name+Response>
  • JSON format

    {
        "RequestId":"4C467B38-3910-447D-87BC-AC049166F216",
        /*Return Result Data*/
        }