Reinitialize a disk

Last Updated: Jul 25, 2017

Description

Reinitialize the disk to the initial state. To carry out this operation, the disk must be in the In_use status and the instance state must be Stopped. However, if the instance has not been activated for the first time after creation, the attached disks on it cannot be reinitialized.

Calling this interface restores the disk to its initial state at the time of creation. That is:

  • A data disk based on a directly created empty disk is initialized to the empty disk status.
  • A data disk created using a snapshot is initialized to the snapshot status.
  • A system disk is initialized to the initial status of the image.

Request Parameters

Name Type Required Description
Action String Yes Required parameter, with a value: ReInitDisk.
DiskId String Yes The ID of the specified disk device.

Return Parameters

All are public return parameters. For details, see Public Return Parameters.

Error Code

Error Code Description Http status code Meaning
MissingParameter The input parameter DiskId that is mandatory for processing this request is not supplied. 400 DiskId not specified.
InvalidDiskId.NotFound The specified disk does not exist. 404 The specified disk does not exist.
IncorrectDiskStatus The current disk status does not support this operation. 403 The disk status is incorrect.
IncorrectInstanceStatus The current status of the resource does not support this operation. 403 The status of the specified instance is incorrect.
InstanceLockedForSecurity The instance is locked due to security. 403 The specified instance has a safety lock.
InvalidSnapshot.TooOld The disk is created from a snapshotId made before 2013-07-15, it cannot be re-initiated the specified disk any more since the detached first time. 403 The specified source snapshot was created on or before July 15, 2013, so the disk cannot be reinitialized.
InvalidSourceSnapshot The snapshot which is used to create the specified disk has been deleted. 403 The source snapshot of the specified disk has been deleted, so the disk cannot be reinitialized.
InstanceExpiredOrInArrears The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode). 403 Payment is overdue for the specified instance.
DiskCreatingSnapshot The operation is denied due to a snapshot of the specified disk is not completed yet. 403 A snapshot of the specified disk is being created.
IncorrectDiskStatus.NeverUsed The specified disk has never been used after creating. 403 The disk has not been used since creation, so the content has not changed.

Examples

Request Example

  1. https://ecs.aliyuncs.com/?Action=ReInitDisk
  2. &DiskId=d-23jbf2v5m
  3. &<Public Request Parameters>

Return Example

XML format

  1. <ReInitDiskResponse>
  2. <RequestId>F3CD6886-D8D0-4FEE-B93E-1B73239673DE</RequestId>
  3. </ReInitDiskResponse>

JSON format

  1. {
  2. "RequestId":"F3CD6886-D8D0-4FEE-B93E-1B73239673DE"
  3. }
Thank you! We've received your feedback.