# 备份恢复 - RestoreBackup
#### 功能介绍
恢复备份数据
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-cbr/cbr_04_0017.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
POST /v3/{project_id}/backups/{backup_id}/restore
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                          |
|:---|:---|:---|:---|
| backup_id  | 是    | String | 备份ID，默认取值不涉及。 获取方法请参见"[获取备份ID](https://support.huaweicloud.com/api-cbr/ListBackups.html)"。 |
| project_id | 是    | String | 项目ID，默认取值不涉及。 获取方法请参见"[获取项目ID](https://support.huaweicloud.com/api-cbr/cbr_04_0022.html)"。 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                               |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | 用户Token。通过调用IAM服务获取用户Token接口获取（响应消息头中X-Subject-Token的值）。默认取值不涉及。 |
   
表3请求Body参数 
| 参数      | 是否必选 | 参数类型                                                          | 描述      |
|:---|:---|:---|:---|
| restore | 是    | [BackupRestore] object | 恢复请求参数体 |
   
 表4BackupRestore 
| 参数          | 是否必选 | 参数类型                                                                                              | 描述                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| mappings    | 否    | Array of [BackupRestoreServerMapping] objects | 恢复的映射关系(整机恢复时必填，卷恢复时可选但是不会用到填写的值）                                                                                                                                                                                                                                                                                                                                                       |
| power_on    | 否    | Boolean                                                                                           | 恢复后是否开机，默认为true。 - true：开机   - false：关机    |
| server_id   | 否    | String                                                                                            | 恢复的目标虚拟机ID（整机恢复时必填）。默认取值不涉及。 获取方法请参见"[获取云服务器ID](https://support.huaweicloud.com/api-ecs/zh-cn_topic_0094148850.html)"。                                                                                                                                                                                                                                 |
| volume_id   | 否    | String                                                                                            | 恢复的目标卷ID（卷恢复时必填）。默认取值不涉及。 获取方法请参见"[获取云硬盘ID](https://support.huaweicloud.com/api-evs/evs_04_3033.html)"。                                                                                                                                                                                                                                                |
| resource_id | 否    | String                                                                                            | 待恢复的目标资源ID，格式为UUID。可根据待备份的资源类型查询对应的资源情况。默认取值不涉及。                                                                                                                                                                                                                                                                                                                                        |
| details     | 否    | [RestoreDetails] object                                   | 恢复详情                                                                                                                                                                                                                                                                                                                                                                                    |
   
 表5BackupRestoreServerMapping 
| 参数        | 是否必选 | 参数类型   | 描述                                                                                                                               |
|:---|:---|:---|:---|
| backup_id | 是    | String | 卷备份ID，可以通过控制台查看云服务器备份详情中磁盘级备份的ID；或"查询指定备份"接口，获取备份中children内的磁盘级备份的ID。默认取值不涉及。                                                    |
| volume_id | 是    | String | 待恢复目标卷ID。默认取值不涉及。 获取方法请参见"[获取云硬盘ID](https://support.huaweicloud.com/api-evs/evs_04_3033.html)"。 |
   
 表6RestoreDetails 
| 参数               | 是否必选 | 参数类型   | 描述                                               |
|:---|:---|:---|:---|
| destination_path | 是    | String | 目的路径，最大支持255个字符，只能由字母、数字、":"、"\\"、"/"组成。默认取值不涉及。 |
   
#### 响应参数
**状态码：202**
无
#### 请求示例
恢复指定备份数据到虚拟机。
```
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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-cbr/ErrorCode.html)。