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