ec2-detach-volume

Amazon Elastic Compute Cloud: 2008-08-08

previous page next page

ec2-detach-volume

Syntax

ec2-detach-volume volume_id [--instance instance_id [--device device]] [--force]

Description

Detaches an Amazon EBS volume from an instance.

[Important]Important

Make sure to unmount any filesystems on the device within your operating system before detaching the volume. Failure to unmount file systems, or otherwise properly release the device from use, can result in lost data and will corrupt the file system.

Options

OptionDescriptionRequired

volume_id

The ID of the Amazon EBS volume.

Example: vol-4d826724

Yes

--instance instance_id

The ID of the instance.

Example: i-6058a509

No

--device device

The device name.

Example: /dev/sdh

No

--force

Forces detachment if the previous detachment attempt did not occur cleanly (logging into an instance, unmounting the volume, and detaching normally). This option can lead to data loss or a corrupted file system. Use this option only as a last resort to detach an instance from a failed instance. The instance will not have an opportunity to flush file system caches nor file system meta data.

If you use this option, you must perform file system check and repair procedures.

No

Output

Amazon EBS returns a table that contains the following information:

  • ATTACHMENT identifier

  • ID of the volume

  • ID of the instance

  • Device as which the volume is exposed within the instance

  • Attachment state (e.g., detaching)

  • Time stamp when detaching was initiated

Amazon EBS displays errors on stderr.

Example

This example detaches volume vol-4d826724.

PROMPT> ec2-detach-volume vol-4d826724
ATTACHMENT vol-4d826724 i-6058a509 /dev/sdh detaching 2008-02-14T00:00:17+0000

Related Topics

ec2-create-volume

  • ec2-delete-volume

  • ec2-describe-volumes

  • ec2-attach-volume

    • previous page start next page