# 查询实例恢复记录
#### 功能介绍
查询指定缓存实例的恢复记录列表。
#### **URI**
GET /v1.0/{project_id}/instances/{instance_id}/restores?start={start}\&limit={limit}\&beginTime={beginTime}\&endTime={endTime}
参数说明见[表1]。
 表1参数说明 
| 参数         | 类型        | 必选 | 说明                                          |
|:---|:---|:---|:---|
| project_id  | String   | 是 | 项目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 | 返回记录数。        |
   
表3restore_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](https://support.huaweicloud.com/api-dcs/dcs-api-0312022.html#dcs-api-0312022__table1255361919491)。                                                                                                                                                                                                                                                                                          |
   
**响应示例**
```
{
    "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",
            "error_code": null
        }
    ],
    "total_num": 1
}
```
#### **状态码**
操作成功的状态码如[表4]所示，其他响应见[表1](https://support.huaweicloud.com/api-dcs/dcs-api-0312043.html#dcs-api-0312043__table5210141351517)。
 表4状态码 
| 状态码 | 描述         |
|:---|:---|
| 200 | 查询实例恢复记录成功。 |