This topic describes the common request parameters and response parameters that are used by all Hybrid Backup Recovery (HBR) 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*/
        }