文档首页/分布式缓存服务 DCS/API参考（安卡拉区域）/历史API（V1）/备份和恢复/查询实例恢复记录
更新时间：2024-11-26 GMT+08:00
查看PDF
分享

查询实例恢复记录

功能介绍

查询指定缓存实例的恢复记录列表。

URI

GET /v1.0/{project_id}/instances/{instance_id}/restores?start={start}&limit={limit}&beginTime={beginTime}&endTime={endTime}

参数说明见表1。
表1 参数说明

参数

类型

必选

说明

project_id

String

是

项目ID。获取方式，参考获取项目ID。

instance_id

String

是

实例ID。

start

Integer

否

待查询的恢复记录的起始序号，默认起始序号为1。

limit

Integer

否

每页显示条数，最小值为1，若不设置该参数，默认显示10条。

beginTime

String

否

查询开始时间。格式：yyyyMMddHHmmss，如：20170718235959。

endTime

String

否

查询结束时间。格式：yyyyMMddHHmmss，如：20170718235959。

请求消息

请求参数

无

请求示例

GET https://{dcs_endpoint}/v1.0/{project_id}/instances/{instance_id}/restores?start={start}&limit={limit}&beginTime={beginTime}&endTime={endTime}

响应消息

响应参数

参数说明见表2。
表2 参数说明

参数

类型

说明

restore_record_response

Array

实例恢复记录的详情数组。

total_num

Integer

返回记录数。

表3 restore_record_response参数说明

参数

类型

说明

status

String

恢复状态。

  • waiting：等待中
  • restoring：恢复中
  • succeed：恢复成功
  • failed：恢复失败

progress

String

恢复进度。

restore_id

String

恢复记录ID。

backup_id

String

备份ID。

restore_remark

String

恢复备注信息。

backup_remark

String

备份备注信息。

created_at

String

恢复任务创建时间。

updated_at

String

恢复完成时间。

restore_name

String

恢复记录名称。

backup_name

String

备份记录名称。

error_code

String

恢复失败后错误码，参见表4。

响应示例 
{
    "restore_record_response": [
        {
            "status": "succeed",
            "progress": "100.00",
            "restore_id": "a6155972-800c-4170-a479-3231e907d2f6",
            "backup_id": "f4823e9e-fe9b-4ffd-be79-4e5d6de272bb",
            "restore_remark": "doctest",
            "backup_remark": null,
            "created_at": "2017-07-18T21:41:20.721Z",
            "updated_at": "2017-07-18T21:41:35.182Z",
            "restore_name": "restore_20170718214120",
            "backup_name": "backup_20170718000002",
            "sourceInstanceId":"dcb96c22-fd6f-41c0-88b5-544784558dd9",
            "sourceInstanceName":"Test-DCS-MS-3-f79a983f",
            "error_code": null
        }
    ],
    "total_num": 1
}

状态码

操作成功的状态码如表4所示，其他响应见表1。

表4 状态码

状态码

描述

200

查询实例恢复记录成功。

父主题：备份和恢复