Class CmdRemoveImage

source code

removeimage [options] <imageid>

Deregister an EC2 image (AMI)

WARNING: This command, by default, will *permanently* remove an AMI from
EC2. This includes removing any AMI files in the S3-backed case and the
root volume snapshot in the EBS-backed case. Be careful!

Example:

    $ starcluster removeimage ami-999999

If the image is S3-backed then the image files on S3 will be removed in
addition to deregistering the AMI.

If the image is EBS-backed then the image's snapshot on EBS will be removed
in addition to deregistering the AMI.

If you'd rather keep the S3 files/EBS Snapshot backing the image use the
--keep-image-data:

    $ starcluster removeimage -k ami-999999

For S3-backed images this will leave the AMI's files on S3 instead of
deleting them. For EBS-backed images this will leave the root volume
snapshot on EBS instead of deleting it.