| « PreviousNext » | |
  | Did this page help you? Yes | No | Tell us about it... |
ec2-detach-volume
Description
Detaches an Amazon EBS volume from an instance. Make sure to unmount any file systems on the device within your operating system before detaching the volume. Failure to do so will result in volume being stuck in "busy" state while detaching. For more information about Amazon EBS, see Elastic Block Store in the Amazon Elastic Compute Cloud User Guide.
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.
If the root volume is detached from an instance with an AWS Marketplace product code, then the AWS Marketplace product codes from that volume are no longer associated with the instance.
The short version of this command is ec2detvol.
Syntax
ec2-detach-volume
volume_id [--instance
instance_id [--device
device]] [--force]
Options
| Name | Description |
|---|---|
|
|
The ID of the volume. Type: String Default: None Required: Yes Example: vol-4282672b |
|
|
The ID of the instance. Type: String Default: None Required: No Example: -i i-6058a509 |
|
|
The device name. Type: String Default: None Required: No Example: -d /dev/sdh |
|
|
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 or file system metadata. If you use this option, you must perform file system check and repair procedures. Type: Boolean Default: None Required: No Example: -f |
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 on stderr.
Examples
Example Request
This example detaches volume vol-1a2b3c4d.
PROMPT>ec2-detach-volume vol-1a2b3c4dATTACHMENT vol-1a2b3c4d i-1a2b3c4d /dev/sdh detaching YYYY-MM-DDTHH:MM:SS+0000
