微服务引擎备份恢复 - MicroserviceEngineBackupRecovery

功能介绍

使用指定的备份文件恢复指定的微服务引擎。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
cse:engine:create
write
-
g:ResourceTag/<tag-key>
g:EnterpriseProjectId
g:TagKeys
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
cse:engine:create	write	-	g:ResourceTag/<tag-key> g:EnterpriseProjectId g:TagKeys	-	-

URI

POST /cseengine/v1/engines/{engine_id}/backups/{backup_id}/recovery

表1 路径参数
参数	是否必选	参数类型	描述
engine_id	是	String	微服务引擎ID。
backup_id	是	String	备份文件ID。

请求参数

表2 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。
X-Enterprise-Project-ID	否	String	如果不带则默认企业项目为“default”，ID为“0”。
Content-Type	是	String	该字段内容填为 "application/json;charset=UTF-8"。
Accept	是	String	该字段内容填为 "application/json"。

表3 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	恢复记录名称。
description	否	String	恢复记录描述。

响应参数

状态码： 200

表4 响应Body参数
参数	参数类型	描述
id	String	恢复记录的ID。
engineId	String	微服务引擎的ID。
backupId	String	微服务引擎备份文件的ID。
status	String	微服务引擎恢复记录的状态。取值范围： RecoveringData：数据恢复中。 RestartingService：重启服务中。 RecoveringDataFailed：数据恢复失败。 RestartingServiceFailed：重启服务失败。 Success：恢复成功。
backupName	String	微服务引擎的备份文件的名称。
name	String	微服务引擎的恢复记录的名称。
description	String	微服务引擎的恢复记录的描述。
progress	Integer	数据恢复完成度。
time	Long	数据恢复时长。
reason	String	数据恢复失败原因。

状态码： 400

表5 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误信息。
detail	String	详细定位信息。

状态码： 500

表6 响应Body参数
参数	参数类型	描述
error_code	String	错误码。
error_msg	String	错误信息。
detail	String	详细定位信息。

请求示例

POST https://{endpoint}/cseengine/v1/engines/{engine_id}/backups/{backup_id}/recovery

{
  "name" : "string",
  "description" : "string"
}

响应示例

状态码： 200

微服务引擎备份恢复响应结构体。

{
  "id" : "string",
  "name" : "test",
  "description" : "string",
  "engineId": "engineId",
  "backupId": "backupId",
  "backupName": "backupName",
  "status": "RecoveringData",
  "progress": "20",
  "time": "123",
  "reason": "string"
}