AttachVolume

Description

Attaches an Amazon EBS volume to a running instance and exposes it as the specified device.

	Note
Windows instances currently support devices xvda through xvdp. Devices xvda and xvdb are reserved by the operating system, xvdc is assigned to drive C:\, and, depending on the instance type, devices xvdd through xvde might be reserved by the instance stores. Any device that is not reserved can be attached to an Amazon EBS volume. For a list of devices that are reserved by the instance stores, go to the

Windows instances currently support devices xvda through xvdp. Devices xvda and xvdb are reserved by the operating system, xvdc is assigned to drive C:\, and, depending on the instance type, devices xvdd through xvde might be reserved by the instance stores. Any device that is not reserved can be attached to an Amazon EBS volume. For a list of devices that are reserved by the instance stores, go to the

Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.

Request Parameters

Name	Description	Required
`AttachVolumeType`	`AttachVolumeType` element. Type: AttachVolumeType Ancestor: None Children: `volumeId`, `instanceId`, and `device`
`volumeId`	The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone and the instance must be running. Type: xsd:string Default: None Ancestor: `AttachVolumeType` Children: None	Yes
`instanceId`	The ID of the instance to which the volume attaches. The volume and instance must be within the same Availability Zone and the instance must be running. Type: xsd:string Default: None Ancestor: `AttachVolumeType` Children: None	Yes
`device`	Specifies how the device is exposed to the instance (e.g., /dev/sdh). Type: xsd:string Default: None Ancestor: `AttachVolumeType` Children: None	Yes

Response Elements

Name	Description
`AttachVolumeResponseType`	`AttachVolumeResponseType` element. Type: AttachVolumeResponseType Ancestor: None Children: `requestId`, `volumeId`, `instanceId`, `device`, `status`, and `attachTime`
`requestId`	The ID of the request. Type: xsd:string Ancestor: `AttachVolumeResponseType` Children: None
`volumeId`	The ID of the volume. Type: xsd:string Ancestor: `AttachVolumeResponseType` Children: None
`instanceId`	The ID of the instance. Type: xsd:string Ancestor: `AttachVolumeResponseType` Children: None
`device`	The device as it is exposed to the instance. Type: xsd:string Ancestor: `AttachVolumeResponseType` Children: None
`status`	Volume state. Type: xsd:string Valid Values: `attaching` \| `attached` \| `detaching` \| `detached` Ancestor: `AttachVolumeResponseType` Children: None
`attachTime`	Time stamp when the attachment initiated. Type: xsd:dateTime Ancestor: `AttachVolumeResponseType` Children: None

Examples

Example Request

This example attaches volume vol-4d826724 to instance i-6058a509 and exposes it as /dev/sdh. For information on standard storage locations, go to the Amazon Elastic Compute Cloud Developer Guide or Amazon Elastic Compute Cloud User Guide.

<AttachVolume xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
  <volumeId>vol-4d826724</volumeId>
  <instanceId>i-6058a509</instanceId>
  <device>/dev/sdh</device>
</AttachVolume>

Example Response

<AttachVolumeResponse xmlns="http://ec2.amazonaws.com/doc/2009-10-31/">
  <volumeId>vol-4d826724</volumeId>
  <instanceId>i-6058a509</instanceId>
  <device>/dev/sdh</device>
  <status>attaching</status>
  <attachTime>2008-05-07T11:51:50.000Z</attachTime>
</AttachVolumeResponse>

AttachVolume

Amazon Elastic Compute Cloud: 2009-10-31

AttachVolume

Description

Request Parameters

Response Elements

Examples

Example Request

Example Response

Get in touch

AttachVolume

Amazon Elastic Compute Cloud: 2009-10-31

AttachVolume

Description

Request Parameters

Response Elements

Examples

Example Request

Example Response

Related Operations