更新时间：2025-08-24 GMT+08:00
备份恢复
功能介绍
恢复备份数据
URI
POST /v3/{project_id}/backups/{backup_id}/restore
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
用户Token。 通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
restore |
是 |
BackupRestore object |
恢复请求参数体 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
mappings |
否 |
Array of BackupRestoreServerMapping objects |
恢复的映射关系(整机恢复时必填，卷恢复时可选但是不会用到填写的值） |
|
power_on |
否 |
Boolean |
恢复后是否开机，默认为true。 - true：开机 - false：关机 |
|
server_id |
否 |
String |
恢复的目标虚拟机ID（整机恢复时必填） 获取方法请参见"获取云服务器ID"。 |
|
volume_id |
否 |
String |
恢复的目标卷ID（卷恢复时必填） 获取方法请参见"获取云硬盘ID"。 |
|
resource_id |
否 |
String |
待恢复的目标资源ID，格式为UUID。可根据待备份的资源类型查询对应的资源情况。 |
|
details |
否 |
RestoreDetails object |
恢复详情 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
backup_id |
是 |
String |
卷备份ID，可以通过控制台查看云服务器备份详情中磁盘级备份的ID；或“查询指定备份”接口，获取备份中children内的磁盘级备份的ID。 |
|
volume_id |
是 |
String |
待恢复目标卷ID。获取方法请参见"获取云硬盘ID"。 |
响应参数
状态码：202
Accepted
无
请求示例
恢复指定备份数据到虚拟机。
POST https://{endpoint}/v3/{f841e01fd2b14e7fa41b6ae7aa6b0594}/backups/a5200268-74a5-4806-acc6-95793ab0228b/restore
{
"restore" : {
"mappings" : [ {
"backup_id" : "5d822633-2bbf-4af8-a16e-5ab1c7705235",
"volume_id" : "eccbcfdd-f843-4bbb-b2c0-a5ce861f9376"
} ],
"power_on" : true,
"server_id" : "94eba8b2-acc9-4d82-badc-127144cc5526"
}
}
响应示例
无
状态码
|
状态码 |
描述 |
|---|---|
|
202 |
Accepted |
错误码
请参见错误码。
父主题： 备份
