ec2-detach-volume

Description

Detaches an Amazon EBS volume from an instance. For more information about Amazon EBS, go to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.

	Important
	Make sure to unmount any file systems 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.

	Note
	If an Amazon EBS volume is the root device of an instance, it cannot be detached while the instance is in the ‘running’ state. To detach the root volume, stop the instance first.

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

Name	Description	Required
`volume_id`	The ID of the volume. Type: String Default: None Example: vol-4282672b	Yes
`--instance` `instance_id`	The ID of the instance. Type: String Default: None Example: i-6058a509	No
`--device` `device`	The device name. Type: String Default: None 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. Type: Boolean Default: None Example: None	No

The command returns a table that contains the following information:

Amazon EC2 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