RollbackVolume--云服务器-火山引擎

文档中心

立即注册

导航

云服务器

RollbackVolume

最近更新时间：2024.11.01 18:49:57首次发布时间：2022.04.28 10:05:43

调用RollbackVolume接口使用快照回滚云盘。

调试

API Explorer

您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。

去调试

前提条件

当前只支持将快照数据回滚至源云盘，因此回滚前，请确保源云盘未被删除。
源云盘处于以下状态：
- 源云盘处于“可用”状态（即未挂载至实例），可以直接执行回滚操作。
- 源云盘处于“已挂载”状态（已挂载至实例），需对应实例处于“停止”状态才能执行回滚操作。
源云盘没有在创建中的快照。
快照状态为“可用”。
更换操作系统后，历史系统盘快照不能用于回滚新的系统盘。

请求参数

名称	类型	是否必填	示例值	描述
Action	string	是	RollbackVolume	要执行的操作，取值：RollbackVolume
Version	String	是	2020-04-01	API的版本，取值：2020-04-01。
VolumeId	string	是	vol-bp1s5fnvk4gn2tws0****	要回滚的云盘ID。
SnapshotId	string	是	snap-bp1s5fnvk4gn2tws0****	使用的快照ID。

返回数据

无

请求示例

GET /?Action=RollbackVolume&SnapshotId=snap-31akybwsxi8rudc6****&Version=2020-04-01&VolumeId=vol-31ale588uo8rud93**** HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
ServiceName: storage_ebs

返回示例

{
		"ResponseMetadata": {
				"RequestId": "20220308180931010225243139000D****",
				"Action": "RollbackVolume",
				"Version": "2020-04-01",
				"Service": "storage_ebs",
				"Region": "cn-beijing"
		},
		"Result": {}
}

错误码

HttpCode	错误码	错误信息
404	SnapshotNotFound	未找到快照
404	VolumeNotFound	未找到云盘
400	IncorrectSnapshotStatus	快照状态不合法
400	ErrIncorrectVolumeStatus	云盘状态不合法
400	VolumeSnapshotNotMatch	云盘与快照不匹配