| « PreviousNext » | |
![]() ![]() | Did this page help you? Yes | No | Tell us about it... |
Deletes a partially or fully uploaded disk image for conversion from Amazon S3. You can specify either the conversion task ID, or the URL to the import manifest file in Amazon S3. For more information, see Using the Command Line Tools to Import Your Virtual Machine to Amazon EC2 in the Amazon Elastic Compute Cloud User Guide.
The short version of this command is ec2ddi.
ec2-delete-disk-image { -t
task_id | -u url } -o
owner_access_key_id -w
owner_secret_access_key [--ignore-active-task]
| Name | Description |
|---|---|
|
|
The Task ID of the conversion task that is no longer active. Type: String Default: None Required: Conditional Condition: Either the task ID or the URL to the manifest is required. Example: -t import-i-fh95npoc |
|
|
The URL for an existing import manifest file. Use this option to delete the uploaded disk image even if one or more active conversion tasks still reference the manifest. Type: String Default: None Required: Conditional Condition: Either the task ID or the URL to the manifest is required. Example: -u http://s3.example.com/mydisk-to-delete.vmdk |
|
|
The access Key ID of the owner of the bucket containing the uploaded disk image to be deleted. This parameter value is not sent to Amazon EC2. Type: String Default: None Required: Yes Example: -o AKIAIOSFODNN7EXAMPLE |
|
|
The AWS Secret Access Key of the owner of the bucket containing the uploaded disk image to be deleted. This parameter value is not sent to Amazon EC2. Type: String Default: None Required: Yes Example: -w wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY |
|
|
Delete the uploaded disk image despite having an active task. Using this option may cause active tasks to fail. Use this option at your own risk. Type: String Default: None Required: No Example: --ignore-active-task |
| 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: |
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: |
This command returns a table that contains the following information:
Task ID
Amazon EC2 command line tools display errors on stderr.
This example deletes the import-i-fh95npoc disk image.
PROMPT>ec2-delete-disk-image -t import-i-fh95npoc -o AKIAIOSFODNN7EXAMPLE -w wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEYDELETE-TASK import-i-fh95npoc