DeregisterImage

The DeregisterImage operation deregisters an AMI. Once deregistered, instances of the AMI can no longer be launched.

Request Parameters

The following table describes the request parameters for DeregisterImage. Parameter names are case sensitive.

Name Description Required

Name	Description	Required
`imageId`	Unique ID of the AMI which was assigned during registration (see RegisterImage). For information on viewing the IDs of AMIs you own, see DescribeImages. Type: xsd:string	Yes

imageId

Unique ID of the AMI which was assigned during registration (see RegisterImage). For information on viewing the IDs of AMIs you own, see DescribeImages.

Type: xsd:string

Yes

Response Elements

The following table describes the default response tags included in DeregisterImage responses.

Name Description

Name	Description
`return`	`true` if deregistration succeeded; otherwise `false`. Type: xsd:boolean

return

true if deregistration succeeded; otherwise false.

Type: xsd:boolean

Sample Request

<DeregisterImage xmlns="http://ec2.amazonaws.com/doc/2007-08-29">
    <imageId>ami-61a54008</imageId>
</DeregisterImage>

Sample Response

<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2007-08-29">
  <return>true</return>
</DeregisterImageResponse>

Related Operations

RegisterImage
DescribeImages