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

Name Description Required

Name	Description	Required
`ImageId`	ID of the AMI to deregister. Type: String Default: None	Yes

ImageId

ID of the AMI to deregister.

Type: String

Default: None

Yes

Response Elements

The elements in the following table come wrapped in a DeregisterImageResponse structure.

Name Description

Name	Description
`requestId`	The ID of the request. Type: xsd:string
`return`	Returns true if the request succeeds. Otherwise, returns an error. Type: xsd:boolean

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/2010-08-31/">
  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
  <return>true</return>
</DeregisterImageResponse>