| Did this page help you? Yes No Tell us about it... |
Deregisters the specified AMI. Once deregistered, the AMI cannot be used to launch new instances.
![]() | Note |
|---|---|
This command does not delete the AMI. |
The short version of this command is ec2dereg.
ec2-deregister
ami_id
| Name | Description | Required |
|---|---|---|
|
|
ID of the AMI to deregister. Type: String Default: None Example: ami-4fa54026 |
Yes |
| Option | Description |
|---|---|
|
|
Overrides the Region specified in the Default: The Example: |
|
|
Default: The Example: |
|
|
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: |
|
|
Specifies a connection timeout (in seconds). Example: --connection-timeout 30 |
|
|
Specifies a request timeout (in seconds). Example: --request-timeout 45 |
|
|
Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API. |
|
|
Displays column headers in the output. |
|
|
Shows empty columns as |
|
|
Do not display tags for tagged resources. |
|
|
Prints internal debugging information. This is useful to assist us when troubleshooting problems. |
|
|
Displays Help. |
|
|
If Example: |
The command returns a table that contains the following information:
IMAGE identifier
The ID of the AMI that was deregistered
Amazon EC2 command line tools display errors on stderr.
This example deregisters the ami-4fa54026 AMI.
PROMPT>ec2-deregister ami-4fa54026IMAGE ami-4fa54026