DetachVolume

Amazon Elastic Compute Cloud: 2009-10-31

previous page next page

DetachVolume

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]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]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.

Request Parameters

Name Description Required

VolumeId

The ID of the volume.

Type: String

Default: None

Yes

InstanceId

The ID of the instance.

Type: String

Default: None

No

Device

The device name.

Type: String

Default: None

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

No

Response Elements

Name Description

DetachVolumeResponseType

DetachVolumeResponseType element.

Type: DetachVolumeResponseType

Ancestor: None

Children: requestId, volumeId, instanceId, device, status, and attachTime

requestId

The ID of the request.

Type: xsd:string

Ancestor: DetachVolumeResponseType

Children: None

volumeId

The ID of the volume.

Type: xsd:string

Ancestor: DetachVolumeResponseType

Children: None

instanceId

The ID of the instance.

Type: xsd:string

Ancestor: DetachVolumeResponseType

Children: None

device

The device as it is exposed to the instance.

Type: xsd:string

Ancestor: DetachVolumeResponseType

Children: None

status

Attachment state.

Type: xsd:string

Valid Values: attaching | attached | detaching | detached

Ancestor: DetachVolumeResponseType

Children: None

attachTime

Time stamp when the attachment initiated.

Type: xsd:dateTime

Ancestor: DetachVolumeResponseType

Children: None

Examples

Example Request

This example detaches volume vol-4d826724.

https://ec2.amazonaws.com/?Action=DetachVolume&VolumeId=vol-4d826724
&InstanceId=i-6058a509&AuthParams

Example Response

<DetachVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
  <volumeId>vol-4d826724</volumeId>
  <instanceId>i-6058a509</instanceId>
  <device>/dev/sdh</device>
  <status>detaching</status>
  <attachTime>2008-05-08T11:51:50.000Z</attachTime>
</DetachVolumeResponse>
previous page start next page