更新时间:2025-11-14 GMT+08:00

恢复指定实例

功能介绍

恢复指定的缓存实例。

只有主备和集群类型的缓存实例支持备份恢复操作,单机实例不支持备份恢复操作。

URI

POST /v2/{project_id}/instances/{instance_id}/restores

表1 路径参数

参数

是否必选

参数类型

描述

instance_id

String

实例ID。

project_id

String

项目ID。获取方法请参见获取项目ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

backup_id

String

备份记录ID。

remark

String

恢复缓存实例的备注信息。

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

restore_id

String

恢复记录ID。

状态码:400

表4 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

error_code

String

参数解释

错误码。

取值范围

请参见错误码

error_ext_msg

String

参数解释

扩展错误信息(暂未使用,赋值为null)。

取值范围

不涉及。

状态码:500

表5 响应Body参数

参数

参数类型

描述

error_msg

String

参数解释

错误信息。

取值范围

不涉及。

error_code

String

参数解释

错误码。

取值范围

请参见错误码

error_ext_msg

String

参数解释

扩展错误信息(暂未使用,赋值为null)。

取值范围

不涉及。

请求示例

恢复缓存实例的备份文件。

POST https://{dcs_endpoint}/v2/{project_id}/instances/{instance_id}/restores

{
  "backup_id" : "8ba256cb-e5ac-44f6-a3da-c03d8f0e5029",
  "remark" : "restore instance"
}

响应示例

状态码:200

恢复指定实例成功。

{
  "restore_id" : "a6155972-800c-4170-a479-3231e907d2f6"
}

状态码

状态码

描述

200

恢复指定实例成功。

400

非法请求。

500

内部服务错误。

错误码

请参见错误码