DeregisterImage

Amazon Elastic Compute Cloud: 2009-04-04

previous page next page

DeregisterImage

Description

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

[Note]Note

This command does not delete the AMI from Amazon S3.

Request Parameters

NameDescriptionRequired

DeregisterImage

DeregisterImage element.

Type:

DeregisterImage

Ancestor: None

Children: imageId

imageId

Unique ID of the AMI which was assigned during registration. To register an AMI, use

Type: xsd:string

Default: None

Ancestor: DeregisterImage

Children: None

Yes

Response Elements

Name Description

DeregisterImageResponse

DeregisterImageResponse element.

Type: DeregisterImageResponse

Ancestor: None

Children: requestId, return

requestId

The ID of the request.

Type: xsd:string

Ancestor: DeregisterImageResponse

Children: None

return

Returns

Type: xsd:boolean

Ancestor: DeregisterImageResponse

Children: None

Examples

Example Request

This example deregisters the ami-4fa54026 AMI.

<DeregisterImage xmlns="http://ec2.amazonaws.com/doc/2009-04-04/">
    <imageId>ami-4fa54026</imageId>
</DeregisterImage>

Example Response

<DeregisterImageResponse xmlns="http://ec2.amazonaws.com/doc/2009-04-04/">
  <return>true</return>
</DeregisterImageResponse>
previous page start next page