回滚快照到云硬盘(废弃)
功能介绍
将快照数据回滚到云硬盘。
该接口已废弃，请使用性能更佳的接口，具体请参见回滚快照到云硬盘。
接口约束
只支持快照回滚到源云硬盘，不支持快照回滚到其它指定云硬盘。
只有云硬盘状态处于“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 |
错误码
请参见错误码。
