文档中心

云服务器

云盘

ReInitializeVolume - 重新初始化云盘

ReInitializeVolume - 重新初始化云盘

调用ReInitializeVolume接口重新初始化云盘。

使用说明

重新初始化云盘后，云盘ID不变。不同创建方式的云盘，恢复的初始状态不同，说明如下：

通过快照创建的云盘：重新初始化后，将恢复到云盘创建时的快照状态，并且清空云盘创建成功后产生的数据。

不是通过快照创建的云盘：重新初始化后，将清空云盘所有数据。

建议您在重新初始化云盘前创建快照，备份云盘数据。

仅数据盘支持重新初始化功能，更多注意事项，请参见重新初始化云盘。

调试

API Explorer

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

去调试

请求参数

下方仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Action string 必选示例值：ReInitializeVolume

要执行的操作，取值：ReInitializeVolume。

Version string 必选示例值：2020-04-01

API的版本，取值：2020-04-01。

VolumeId string 必选示例值：vol-3vi4xtz7r142xlz6****

初始化的云盘ID。

返回参数

本接口无特有的返回参数。更多信息请见返回结构。

请求示例

返回示例

错误码

下表为您列举了该接口与业务逻辑相关的错误码。公共错误码请参见公共错误码文档。

状态码	错误码	错误信息	说明
400	VolumeInCreatingSnapshot	The operation is not permitted due to the volume is creating a snapshot.	指定的云盘有正在创建的快照。
400	MissingVolumeID	The specified parameter VolumeId is missing.	缺少云盘ID。
400	IncorrectSnapshotStatus	The specified snapshot status is invalid.	指定的快照状态不合法。
400	SnapshotStatusNotAvailable	Current snapshot state does not support volume reinitialization.	待初始化云盘源快照状态不支持云盘初始化。
403	IncorrectInstanceStatus	The rollback condition is not permitted due to the instance which volume attached must be in stopped status.	当前的实例没有处于停止状态，无法执行重新初始化操作。
403	OperationDenied.InstanceIsCreatingImage	The operation is not permitted due to the instance is creating an image.	当前实例正在创建镜像，无法执行重新初始化操作。
403	OperationDenied.InstanceIsSnapshotRollback	The operation is not permitted due to the instance is locked by snapshot rollback or volume reInitialization.	当前实例挂载的云盘正在执行快照回滚或云盘初始化，无法执行重新初始化操作。
404	VolumeNotFound	The specified volume does not exist.	云盘不存在。
404	SnapshotNotFound	The specified snapshot does not exist.	指定的快照不存在。
412	VolumeStatusForbidReInitialize	volume status forbid reInitialize.	当前云盘状态不支持执行重新初始化操作。
412	SystemVolumeForbidReInitialize	system volume currently does not support reInitialize.	系统盘不支持执行重新初始化操作。
412	SnapshotTaskExceedLimit	Exceeded the limit on the number of ongoing snapshot tasks.	超过了正在进行的快照任务的限制数量。

最近更新时间：2026.01.07 17:09:45

这个页面对您有帮助吗？

有用

有用

无用

无用