Package starcluster :: Package commands :: Module removeimage :: Class CmdRemoveImage
[hide private]
[frames] | no frames]

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.

Instance Methods [hide private]
 
addopts(self, parser) source code
 
execute(self, args) source code

Inherited from completers.ImageCompleter (private): _completer

Inherited from base.CmdBase: cancel_command, catch_ctrl_c, warn_experimental

Inherited from base.CmdBase (private): _build_dict, _positive_int

Inherited from optcomplete.CmdComplete: autocomplete

Inherited from object: __delattr__, __format__, __getattribute__, __hash__, __init__, __new__, __reduce__, __reduce_ex__, __repr__, __setattr__, __sizeof__, __str__, __subclasshook__

Class Variables [hide private]
  names = ['removeimage', 'ri']

Inherited from base.CmdBase: gopts, gparser, opts, parser, subcmds_map

Inherited from base.CmdBase (private): _cfg, _cm, _ec2, _nm, _s3

Properties [hide private]

Inherited from completers.Completer: completer

Inherited from base.CmdBase: cfg, cluster_manager, cm, comp_words, ec2, goptions_dict, log, nm, node_manager, options_dict, s3, specified_options_dict

Inherited from object: __class__

Method Details [hide private]

addopts(self, parser)

source code 
Overrides: base.CmdBase.addopts