AWS Documentation » Amazon EC2 » API Reference » Actions » DeregisterImage	« Previous Next »
	Did this page help you? Yes \| No \| Tell us about it...

DeregisterImage

Description

Deregisters the specified AMI. Once deregistered, the AMI cannot be used to launch new instances.

Note

This command does not delete the AMI.

Request Parameters

ImageId

The ID of the AMI to deregister.

Type: String

Default: None

Required: Yes

Response Elements

The following elements are returned in a DeregisterImageResponse element.

requestId

The ID of the request.

Type: xsd:string

return

Returns true if the request succeeds. Otherwise, returns an error.

Type: xsd:boolean

Examples

Example Request

This example deregisters the ami-4fa54026 AMI.

https://ec2.amazonaws.com/?Action=DeregisterImage
&ImageId=ami-4fa54026
&AUTHPARAMS

Example Response

<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2013-02-01/">
  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
  <return>true</return>
</DeregisterImageResponse>

Document Conventions	« Previous Next »
Terms of Use	Did this page help you? Yes \| No \| Tell us about it...