华为云计算 云知识 回滚快照到云硬盘RollbackSnapshot
回滚快照到云硬盘RollbackSnapshot

 

功能介绍

将快照数据回滚到 云硬盘 。支持企业项目授权功能。

接口约束

  • 只支持快照回滚到源云硬盘,不支持快照回滚到其它指定云硬盘。

  • 只有云硬盘状态处于“available”或“error_rollbacking”状态才允许快照回滚到源云硬盘。

  • 名称以autobk_snapshot_为前缀的快照是创建 云硬盘备份 时系统自动创建的,请不要进行“回滚快照到云硬盘”操作。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

URI

POST /v2/{project_id}/cloudsnapshots/{snapshot_id}/rollback

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。 获取方法请参见"获取项目ID"。

snapshot_id

String

快照ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。 通过调用 IAM 服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

表3 请求Body参数

参数

是否必选

参数类型

描述

rollback

RollbackSnapshotOption object

快照回滚信息。

表4 RollbackSnapshotOption

参数

是否必选

参数类型

描述

name

String

回滚的目标云硬盘名称。

volume_id

String

回滚的目标云硬盘UUID。

响应参数

状态码: 202

表5 响应Body参数

参数

参数类型

描述

rollback

RollbackInfo object

快照回滚信息。

表6 RollbackInfo

参数

参数类型

描述

volume_id

String

回滚的目标云硬盘UUID。

状态码: 400

表7 响应Body参数

参数

参数类型

描述

error

Error object

出现错误时,返回的错误信息,具体请参见 error参数说明

表8 Error

参数

参数类型

描述

code

String

出现错误时,返回的错误码。错误码和其对应的含义请参考错误码说明

message

String

出现错误时,返回的错误消息。

请求示例

回滚快照到云硬盘,目标云硬盘的名称为test-001,UUID为5aa119a8-d25b-45a7-8d1b-88e127885635。

POST https://{endpoint}/v2/{project_id}/cloudsnapshots/{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

错误码

请参见错误码

 

上一篇:创建对端网关CreateCgw 下一篇:创建AddonInstanceCreateAddonInstance

云硬盘 EVS

云硬盘(Elastic Volume Service)是一种为ECS、BMS等计算服务提供持久性块存储的服务,通过数据冗余和缓存加速等多项技术,提供高可用性和持久性,以及稳定的低时延性能。您可以对云硬盘做格式化、创建文件系统等操作,并对数据做持久化存储