回滚快照到云硬盘(废弃) - RollbackSnapshotV3
功能介绍
将快照数据回滚到云硬盘。
该接口已废弃，请使用性能更佳的接口，具体请参见回滚快照到云硬盘。
接口约束
只支持快照回滚到源云硬盘，不支持快照回滚到其它指定云硬盘。
只有云硬盘状态处于“available”或“error_rollbacking”状态才允许快照回滚到源云硬盘。
名称以autobk_snapshot_为前缀的快照是创建云硬盘备份时系统自动创建的，请不要进行“回滚快照到云硬盘”操作。
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/os-vendor-snapshots/{snapshot_id}/rollback
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
project_id | 是 | String | 项目ID |
snapshot_id | 是 | String | 快照ID |
请求参数
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
X-Auth-Token | 是 | String | Token的有效期为24小时，需要使用一个Token鉴权时，可以先缓存起来，避免频繁调用 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
rollback | 是 | RollbackSnapshotOptionV3 object | 快照回滚信息，请参见rollback参数说明。 |
参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
name | 否 | String | 回滚的目标云硬盘名称。最大支持64个字符。查询目标云硬盘的名称，请参见查询单个云硬盘详情中的响应“name”。 说明： name不能单独传，若传name，必须带上对应的volume_id。 |
volume_id | 是 | String | 回滚的目标云硬盘的ID。查询目标云硬盘的ID，请参见查询单个云硬盘快照详细信息中的响应“volume_id”。 |
响应参数
状态码：202
参数 | 参数类型 | 描述 |
|---|---|---|
rollback | RollbackBody object | 快照回滚信息，请参见 |
状态码：400
参数 | 参数类型 | 描述 |
|---|---|---|
code | String | 参数解释 出现错误时，返回的错误码。 取值范围 错误码和其对应的含义请参考错误码说明。 |
message | String | 参数解释 出现错误时，返回的错误消息。 取值范围 不涉及。 |
请求示例
POST https://{endpoint}/v3/{project_id}/os-vendor-snapshots/{snapshot_id}/rollback
{
"rollback" : {
"name" : "test-001",
"volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635"
}
} 响应示例
状态码：202
Accepted
{
"rollback" : {
"volume_id" : "5aa119a8-d25b-45a7-8d1b-88e127885635"
}
} 状态码：400
Bad Request
{
"error" : {
"message" : "XXXX",
"code" : "XXX"
}
} 状态码
状态码 | 描述 |
|---|---|
202 | Accepted |
400 | Bad Request |
错误码
请参见错误码。
