DetachVolume

Amazon Elastic Compute Cloud: 2009-03-01

previous page next page

DetachVolume

The DetachVolume operation detaches an Amazon EBS volume from an instance. For more information about Amazon EBS, see Amazon Elastic Block Store.

Request Parameters

The following table describes the request parameters for DetachVolume. Parameter names are case sensitive.

Name	Description	Required
`VolumeId`	The ID of the Amazon EBS volume Type: String Default: none Valid Values: ID of a volume that you own Constraints: none	Yes
`InstanceId`	The ID of the instance from which the volume will detach Type: String Default: none Valid Values: ID of the instance attached to the volume Constraints: none	No
`Device`	The device name Type: String Default: none Valid Values: Valid device ID Constraints: 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 Valid Values: none Constraints: none	No

Response Elements

The following table describes the default response tags included in DetachVolume responses.

Name	Description
`volumeId`	The ID of the volume Type: xsd:string
`instanceId`	The ID of the instance Type: xsd:string
`device`	The device as it is exposed to the instance Type: xsd:string
`status`	Volume state (e.g., `detaching`, `detached`) Type: xsd:string
`attachTime`	Time stamp when detaching was initiated Type: xsd:dateTime

Sample Request

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

Sample Response

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

Related Operations

previous page start next page