接口功能介绍
支持批量快照的回滚。
接口约束
1.快照状态为可用,快照源云硬盘为可用(云硬盘处于未挂载状态或已挂载但云主机关机);
2.只支持回滚至源云硬盘,不支持回滚至其他云硬盘;
3.单个用户单次批量重置磁盘操作的最大个数是8个;
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 | 表示请求成功 |
错误码
请参考通用结果码。