接口功能介绍
支持批量快照的回滚。只支持回滚至源云硬盘，不支持回滚至其他云硬盘。
接口约束
1、快照状态为可用，快照源云硬盘为可用（云硬盘处于未挂载状态或已挂载但云主机关机）;
2、单个用户单次批量重置磁盘操作的最大个数是8个；
3、只支持同一个可用区同一资源池下的磁盘批量重置；
接口是否审批
否
URI
POST /v4/ebs_snapshot/batch-rollback-ebs-snap
Content-Type
application/json
路径参数
无
Query参数
无
请求头header参数
无
请求体body参数
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| snapshotList | 是 | String | 快照ID列表,以逗号分隔，最多8个；全部快照都存在才可进行批量重置 | 参考请求示例 | |
| regionID | 是 | String | 资源池ID | 参考请求示例 | |
| azName | 是 | String | 多可用区资源池下，必须指定可用区 | 参考请求示例 |
响应参数
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| 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
}
状态码
请参考状态码
错误码
请参考错误码
