ec2-detach-volume

previous page next page

Syntax

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

Detaches an Amazon EBS volume from an instance.

	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.

Option	Description	Required
`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 a volume 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

Amazon EBS returns a table that contains the following information:

Amazon EBS displays errors on stderr.

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