| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
ec2-attach-volume
Description
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.
Note
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 https://aws.amazon.com/marketplace/help/200900000. For details on how to use the AWS Marketplace, see AWS Marketplace.
The short version of this command is ec2attvol.
Syntax
ec2-attach-volume
volume_id --instance
instance_id --device
device
Options
| Name | Description |
|---|---|
|
|
The ID of the Amazon EBS volume. The volume and instance must be within the same Availability Zone and the instance. Type: String Default: None Required: Yes Example: vol-4d826724 |
|
|
The ID of the instance to attach the volume to. The volume and instance must be within the same Availability Zone. Type: String Default: None Required: Yes Example: -i i-6058a509 |
|
|
The device name to expose to the instance. Type: String Default: None Required: Yes Example: -d /dev/sdf (for Linux/UNIX) or -d xvdf (for Windows) |
Common Options
| Option | Description |
|---|---|
|
|
Overrides the region specified by the Default: The value of the Example: |
|
|
The uniform resource locator (URL) of the Amazon EC2 web service entry point. Default: The value of the Example: |
|
|
The private key that identifies you to Amazon EC2. For more information, see Tell the Tools Who You Are. Default: The value of the Example: |
|
|
The X.509 certificate that identifies you to Amazon EC2. Default: The value of the Example: |
|
|
The access key ID associated with your AWS account. For more information, see Tell the Tools Who You Are. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The secret access key associated with your AWS account. Default: The value of the Example: Note For more information, see the following section, Deprecated Options. |
|
|
The AWS delegation token. Default: The value of the environment variable (if set). |
|
|
The connection timeout, in seconds. Example: |
|
|
The request timeout, in seconds. Example: |
|
|
Displays verbose output, including the API request and response on the command line. This is useful if you are building tools to talk directly to our Query API. |
|
|
Includes column headers in the command output. |
|
|
Shows empty columns as |
|
|
Omits tags for tagged resources. |
|
|
Displays internal debugging information. This can assist us when helping you troubleshooting problems. |
|
|
Displays usage information for the command. |
|
|
Reads arguments from standard input. This is useful when piping the output from one command to the input of another. Example: |
Deprecated Options
For a limited time, you can still use the private key and X.509 certificate instead of your access key ID and secret access key. However, we recommend that you start using your access key ID (-O, --aws-access-key) and secret access key (-W, --aws-secret-key) now, as the private key (-K, --private-key) and X.509 certificate (-C, --cert) won't be supported after the transition period elapses. For more information, see Tell the Tools Who You Are.
| Option | Description |
|---|---|
|
|
The private key to use when constructing requests to Amazon EC2. Default: The value of the Example: |
|
|
The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the Example: |
Output
This command returns a table that contains the following information:
The ATTACHMENT identifier
The ID of the volume
The ID of the instance
The device name
The attachment state of the volume
The time stamp of the last operation on the volume
Whether or not the volume is set to delete on termination (
trueorfalse)
Amazon EC2 command line tools display errors using stderr.
Examples
Example Request
This example attaches volume vol-1a2b3c4d to instance i-1a2b3c4d
and exposes it as /dev/sdh. For information on standard storage
locations, see the Amazon Elastic Compute Cloud User Guide.
PROMPT>ec2-attach-volume vol-1a2b3c4d -i i-1a2b3c4d -d /dev/sdhATTACHMENT vol-1a2b3c4d i-1a2b3c4d /dev/sdh attaching YYYY-MM-DDTHH:MM:SS+0000
