接口功能介绍
执行快照回滚后,云硬盘中的数据将恢复至快照创建时刻。
接口约束
1.快照状态为可用,快照源云硬盘为可用(云硬盘处于未挂载状态或已挂载但云主机关机);
2.只支持回滚至源云硬盘,不支持回滚至其他云硬盘;
URI
POST /v4/ebs_snapshot/rollback
请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
snapshotID | 是 | String | 快照ID | 参考请求示例 |
volumeID | 是 | String | 快照的所属云硬盘ID | 参考请求示例 |
regionID | 是 | String | 资源池ID | 参考请求示例 |
azName | 是 | String | 快照所属可用区 | 参考请求示例 |
响应参数是
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
statusCode | 是 | Integer | 返回状态码(800为成功,900为失败) | 参考响应示例 | |
message | 是 | String | 失败时的错误描述,一般为英文描述 | 参考响应示例 | |
description | 是 | String | 失败时的错误描述,一般为中文描述 | 参考响应示例 | |
returnObj | 是 | Object | 参考表 returnObj | 参考响应示例 | 参考表returnObj |
errorCode | 是 | String | 业务细分码,为product.module.code三段式码. 参考通用结果码 |
参考响应示例 |
表 returnObj
参数 | 是否必填 | 参数类型 | 说明 | 示例 |
---|---|---|---|---|
jobID | 是 | String | 异步任务ID,可通过公共接口查询/v4/job/info该jobID来查看异步任务最终执行结果 | 参考响应示例 |
请求示例
请求头header
无
请求体body
{
"snapshotID":"3f868846-f47f-4619-a5b4-a02e9714f744",
"volumeID": "9fabb6c2-2f75-4685-8fbe-4430dadf5175",
"regionID":"81f7728662dd11ec810800155d307d5b",
"azName": "az2"
}
响应示例
{
"returnObj": {
"jobID": "aa871684-c3d6-4fef-9326-2ee309dee031"
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
状态码 | 描述 |
---|---|
800 | 表示请求成功 |
错误码
请参考通用结果码。