Query CRS Instance Backup List

Last updated: 2020-06-04 18:23:48


    This is a legacy API which has been hidden and will no longer be updated. We recommend using the new Redis API 3.0 which is standardized and faster.

    1. API Description

    This API (GetRedisBackupList) is used to query the backup list of a CRS instance.
    Domain name for API request: redis.api.qcloud.com

    • Currently, backups can only be retained for 7 days, so you can just query the backups for the last 7 days, including the manual backups initiated by users and the backups initiated by the system in the early morning.

    2. Input Parameters

    The following request parameter list only provides API request parameters. Common request parameters are also needed when the API is called. The Action field for this API is GetRedisBackupList.

    Parameter Name Required Type Description
    limit Yes Int Length of a page.
    offset Yes Int Current page number. Default is 0. For query APIs, a maximum number of returned records is generally set for a single query by default. To traverse all the resources, you need to use "limit" and "offset" for a paged query; For example, to query the 40 records between 110 and 149, you can set offset = 110 and limit = 40.
    redisId Yes String ID of instance to work with. This can be obtained from redisId in the returned values of API DescribeRedis.
    beginTime No String Start time, such as: 2017-02-08 16:46:34. Query the list of instance backups initiated within the time period of [beginTime, endTime].
    endTime No String End time, such as: 2017-02-08 19:09:26. Query the list of instance backups initiated within the time period of [beginTime, endTime].

    3. Output Parameters

    Parameter Name Type Description
    code Int Common error code; 0: Succeeded; other values: Failed
    message String Error message description. A null value indicates a success
    codeDesc String Description of error code at business side. For a successful operation, "Success" will be returned. In case of an error, a message describing the reason for the error will be returned.
    totalCount Int Total number of backups
    data Object Details of instance backup list

    Parameter data indicates the details of instance backup list, and is composed as follows:

    Parameter Name Type Description
    data.redisBackupSet Array Array of instance backups

    Parameter redisBackupSet indicates the array of instance backups, and is composed as follows:

    Parameter Name Type Description
    startTime String The time when the backup starts
    backupId String Backup ID
    backupType String Backup type.
    manualBackupInstance: Manual backup initiated by the user;
    systemBackupInstance: Backup initiated by the system in the early morning
    status Int Backup status.
    1: "Backup is locked by another process";
    2: "Backup is normal without being locked by any process";
    -1: "Backup expired";
    3:"Backup is being exported";
    4:"Backup has been exported successfully"
    remark String Remarks of backup
    locked Int Whether the backup is locked. 0: Not Locked; 1: Locked

    4. Error Codes

    The following error codes include the business logic error codes for this API.

    Error Code Error Message Error Description
    11201 InvalidParameter Incorrect business parameter

    5. Example

    &beginTime=2017-02-08 16:46:34
    &endTime=2017-02-08 19:09:26

    The returned results are as below:

        "code": 0,
        "message": "",
        "codeDesc": "Success",
        "totalCount": 2,
        "data": {
            "redisBackupSet": [
                    "startTime": "2017-02-08 16:46:34",
                    "backupId": "19266626-eddb-11e6-890a-525400394272",
                    "backupType": "manualBackupInstance",
                    "status": 2,
                    "remark": "testAPI",
                    "locked": 0
                    "startTime": "2017-02-08 19:09:26",
                    "backupId": "0f87ffc6-edef-11e6-b88e-525400394272",
                    "backupType": "systemBackupInstance",
                    "status": 2,
                    "remark": "",
                    "locked": 0

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback