Amazon Elastic Compute Cloud
API Reference (API Version 2014-02-01)
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Did this page help you?  Yes | No |  Tell us about it...



Attaches an Amazon EBS volume to a running or stopped instance and exposes it to the instance with the specified device name.

For a list of supported device names, see Attaching the Volume to an Instance. Any device names that aren't reserved for instance store volumes can be used for Amazon EBS volumes. For more information, see Amazon EC2 Instance Store in the Amazon Elastic Compute Cloud User Guide.


If a volume has an AWS Marketplace product code:

  • The volume can only be attached to the root device of a stopped instance.

  • You must be subscribed to the AWS Marketplace code that is on the volume.

  • The configuration (instance type, operating system) of the instance must support that specific AWS Marketplace code. For example, you cannot take a volume from a Windows instance and attach it to a Linux instance.

  • AWS Marketplace product codes are copied from the volume to the instance.

For an overview of the AWS Marketplace, see For details on how to use the AWS Marketplace, see AWS Marketplace.

Request Parameters


The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone.

Type: String

Default: None

Required: Yes


The ID of the instance.

Type: String

Default: None

Required: Yes


The device name to expose to the instance (for example, /dev/sdh or xvdh).

Type: String

Default: None

Required: Yes

Response Elements

The following elements are returned in an AttachVolumeResponse element.


The ID of the request.

Type: xsd:string


The ID of the volume.

Type: xsd:string


The ID of the instance.

Type: xsd:string


The device name.

Type: xsd:string


The attachment state of the volume.

Type: xsd:string

Valid values: attaching | attached | detaching | detached


The time stamp when the attachment initiated.

Type: xsd:dateTime


The following are some of the client API errors you may encounter when using this request. For more information about common API errors, see Common Causes of EC2 API Client Errors. For a summary of API error codes, see Client Error Codes.


Example Request

This example request attaches the volume with the ID vol-1a2b3c4d to the instance with the ID i-1a2b3c4d and exposes it as /dev/sdh.

Example Response

<AttachVolumeResponse xmlns="">