接口功能介绍
当发生误操作或系统故障等问题时，您可以使用已创建的快照来回滚数据，使云硬盘的数据恢复至创建快照的时刻，实现云硬盘数据的恢复。
注意：
1、快照回滚为不可逆操作，从快照创建时刻到回滚操作开始时刻这段时间内的数据会被删除。为避免误操作，建议您在回滚之前为云硬盘创建一次快照进行数据备份。
2、如果您在创建云硬盘快照之后对该盘进行了扩容，当您回滚到该快照后，您之前扩容的分区和文件系统会丢失。因此，您需要在回滚后登录云主机重新进行扩展分区和文件系统的操作，以恢复到扩容后的状态。
接口约束
1.快照状态为“可用”状态，快照源云硬盘状态为“未挂载”时支持回滚操作。
2.快照状态为“可用”状态，快照源云硬盘为“已挂载”状态，同时源云硬盘所挂载主机为“关机”状态时支持回滚。
3.只支持回滚至源云硬盘，不支持回滚至其他云硬盘。
接口是否审批
否
URI
POST /v4/ebs_snapshot/rollback-ebs-snap
Content-Type
application/json
路径参数
无
Query参数
无
请求头header参数
无
请求体body参数
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| snapshotID | 是 | String | 快照ID。 | 3f868846-f47f-4619-a5b4-a02e9714f744 | |
| diskID | 是 | String | 快照所属的云硬盘ID。 | 9fabb6c2-2f75-4685-8fbe-4430dadf5175 | |
| regionID | 是 | String | 资源池ID。 | 81f7728662dd11ec810800155d307d5b | |
| azName | 是 | String | 快照所属的可用区名称。 | az1 |
响应参数
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码（800为成功，900为失败/处理中）。 | 800 | |
| message | String | 成功或失败时的描述，一般为英文描述。 | 参考响应示例。 | |
| description | String | 成功或失败时的描述，一般为中文描述。 | 参考响应示例。 | |
| returnObj | Object | 返回数据结构体。 | returnObj | |
| details | String | 可忽略。 | 参考响应示例。 | |
| errorCode | String | 业务细分码，为product.module.code三段式码。请参考错误码。 | 参考响应示例。 | |
| error | String | 业务细分码，为product.module.code三段式大驼峰码。请参考错误码。 | 参考响应示例 |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| snapshotJobID | String | 异步任务ID，可通过公共接口/v4/job/info查询该jobID来查看异步任务最终执行结果。 | 参考响应示例。 |
枚举参数
无
请求头header示例
{
}请求url示例
无
请求体body示例
{
"snapshotID":"3f868846-f47f-4619-a5b4-a02e9714f744",
"diskID": "9fabb6c2-2f75-4685-8fbe-4430dadf5175",
"regionID":"81f7728662dd11ec810800155d307d5b",
"azName": "az2"
}响应示例
{
"returnObj": {
"snapshotJobID": "aa871684-c3d6-4fef-9326-2ee309dee031"
},
"details": "",
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}状态码
请参考状态码
错误码
请参考错误码
