接口功能介绍
当发生误操作或系统故障等问题时，您可以使用已创建的快照来回滚数据，使云硬盘的数据恢复至创建快照的时刻，实现云硬盘数据的恢复。
本接口支持快照批量回滚。
注意：
1、快照回滚为不可逆操作，从快照创建时刻到回滚操作开始时刻这段时间内的数据会被删除。为避免误操作，建议您在回滚之前为云硬盘创建一次快照进行数据备份。
2、如果您在创建云硬盘快照之后对该盘进行了扩容，当您回滚到该快照后，您之前扩容的分区和文件系统会丢失。因此，您需要在回滚后登录云主机重新进行扩展分区和文件系统的操作，以恢复到扩容后的状态。
接口约束
1、快照状态为“可用”，快照源云硬盘为“可用”（云硬盘处于“未挂载”或“已挂载”状态且云主机是“关机”状态）。
2、单个用户单次批量重置磁盘操作的最大个数是8个。
3、只支持同一个可用区同一资源池下的磁盘批量重置。
4、只支持回滚至源云硬盘，不支持回滚至其他云硬盘。
URI
POST /v4/ebs_snapshot/batch-rollback
请求参数
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| snapshotList | 是 | String | 快照ID列表,以逗号分隔，最多8个；全部快照都存在才可进行批量重置 | 参考请求示例 |
| regionID | 是 | String | 资源池ID | 参考请求示例 |
| azName | 是 | String | 多可用区资源池下，必须指定可用区 | 参考请求示例 |
响应参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| statusCode | 是 | Integer | 返回状态码(800为成功，900为失败) | 参考响应示例 | |
| message | 是 | String | 成功或失败时的描述，一般为英文描述 | 参考响应示例 | |
| description | 是 | String | 成功或失败时的描述，一般为中文描述 | 参考响应示例 | |
| returnObj | 是 | Object | 返回数据结构体 | 参考响应示例 | returnObj |
| errorCode | 是 | String | 业务细分码，为product.module.code三段式码. 参考通用结果码 | 参考响应示例 |
表 returnObj
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| jobID | 是 | String | 异步任务ID，可通过公共接口查询/v4/job/info该jobID来查看异步任务最终执行结果 | 参考响应示例 |
请求示例
请求头header
无
请求体body
{
"snapshotList":"3f868846-f47f-4619-a5b4-a02e9714f744,0fdd318a-89fd-4491-a3f4-6d504bce3c45",
"regionID":"81f7728662dd11ec810800155d307d5b",
"azName":"az2"
}响应示例
{
"returnObj": {
"jobID": [
"123744b9-bb1f-46e0-9e52-66edb3a0fc84",
"80be31f0-df59-4f35-9cc1-234f21cbc9ee"
]},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功 |
错误码
请参考通用结果码。
