说明
当前接口使用前请使用资源池概况信息查询接口查询带对接的资源池信息,如资源池信息"regionVersion": "v4.0",即可使用;如资源池信息"regionVersion": "v3.0", 不可使用。
接口功能介绍
支持批量快照的回滚。
接口约束
1、快照状态为可用,快照源云硬盘为可用(云硬盘处于未挂载状态或已挂载但云主机关机);
2、只支持回滚至源云硬盘,不支持回滚至其他云硬盘;
3、单个用户单次批量重置磁盘操作的最大个数是8个;
4、只支持同一个可用区同一资源池下的磁盘批量重置
URI
POST /v4/ebs_snapshot/batch-rollback-ebs-snap
请求参数
请求体body参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
snapshotList | 是 | String | 快照ID列表,以逗号分隔,最多8个;全部快照都存在才可进行批量重置 | 参考请求示例 | |
regionID | 是 | String | 资源池ID | 参考请求示例 | |
azName | 是 | String | 多可用区资源池下,必须指定可用区 | 参考请求示例 |
响应参数
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
statusCode | 是 | Integer | 返回状态码(800为成功,900为失败/处理中) | 参考响应示例 | |
message | 是 | String | 失败时的错误描述,一般为英文描述 | 参考响应示例 | |
description | 是 | String | 失败时的错误描述,一般为中文描述 | 参考响应示例 | returnObj |
returnObj | 是 | Object | 参考响应示例 | returnObj | |
details | 是 | String | 可忽略 | 参考响应示例 | |
errorCode | 是 | String | 业务细分码,为product.module.code三段式码.参考通用结果码 | 参考响应示例 |
表 returnObj
参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
---|---|---|---|---|---|
snapshotJobID | 是 | String | 异步任务ID,可通过公共接口查询/v4/job/info该jobID来查看异步任务最终执行结果 | 参考响应示例 |
请求示例
请求头header
{
}
请求体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"
]},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
状态码 | 描述 |
---|---|
800 | 表示请求成功。 |
错误码
请参考通用结果码。