接口功能介绍
快照回滚(重置云硬盘)。
接口约束
1.快照状态为可用,快照源云硬盘为可用(云硬盘处于未挂载状态或已挂载但云主机关机);
2.只支持回滚至源云硬盘,不支持回滚至其他云硬盘;
接口是否审批
否
URI
POST /v4/ebs_snapshot/rollback-ebs-snap
Content-Type
application/json
路径参数
无
Query参数
无
请求头header参数
无
请求体body参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
snapshotID | 是 | String | 快照ID | 参考请求示例 | |
diskID | 是 | String | 快照的所属云硬盘ID | 参考请求示例 | |
regionID | 是 | String | 资源池ID | 参考请求示例 | |
azName | 是 | String | 快照所属可用区 | 参考请求示例 |
响应参数
响应参数
参数 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|
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
}
状态码
请参考状态码
错误码
请参考错误码