EUCA2OOLS(1)

NAME
euca2ools - Shows information about machine images.

DESCRIPTION
Shows information about machine images.

euca-describe-images [-A, --access-key <access_key> ][-S, --secret-key

    <secret_key> ][--config <config_path> ][--debug][--debugger][-h, --help][--region <region_name> ][-U, --url <url> ][--version][--euca-auth][-a, --all][-o, --owner <owner> ][-x, --executable-by <executable_by> ] [--filter name=value] [ image ]

OPTIONAL PARAMETERS

-A,--access-key
    User's Access Key ID.

-S,--secret-key
    User's Secret Key.

--config
    Read credentials and cloud settings from the specified config file (defaults to $HOME/.eucarc or /etc/euca2ools/eucarc).

--debug
    Turn on debugging output.

--debugger
    Enable interactive debugger on error

-h,--help
    Display this help message.

--region
    region to direct requests to

-U,--url
    URL of the Cloud to connect to.

--version
    Display the version of this tool.

--euca-auth
    Use NC authentication mode

-a,--all
    Show all images that the user has access to.

-o,--owner
    Show only images owned by the user. Valid values: account ID|self|amazon

-x,--executable-by
    Show only images for which user has explicit launch permissions. Valid values: account ID|self|all

AVAILABLE FILTERS

architecture
    Image architecture. Valid values are i386 | x86_64 | armhf

    block-device-mapping.delete-on-terminationWhether the Amazon EBS volume is deleted on

    instance termination.

    block-device-mapping.device-nameDevice name (e.g., /dev/sdh) for an Amazon EBS

volume
    mapped to the

    image.

    block-device-mapping.snapshot-idSnapshot ID for an Amazon EBS volume mapped

    to the image.

    block-device-mapping.volume-sizeVolume size for an Amazon EBS volume mapped

    to the image.

description
    Description of the AMI

hypervisor
    Hypervisor type of the image. Valid values are ovm | xen.

image-id
    ID of the imageID

image-type
    Type of the image. Valid values are machine | kernel | ramdisk

is-public
    Whether the image is public.

kernel-id
    Kernel ID.

manifest-location
    Location of the image manifest.

name
    Name of the AMI.

owner-alias
    AWS account alias (e.g., amazon or self) or AWS account ID that owns the AMI.

owner-id
    AWS account ID of the image owner.

platform
    Use windows if you have Windows based AMIs; otherwise leave blank.

product-code
    Product code associated with the AMI.

ramdisk-id
    The ramdisk ID.

root-device-name
    Root device name of the AMI (e.g., /dev/sda1).

root-device-type
    Root device type the AMI uses. Valid Values: ebs | instance-store.

state
    State of the image. Valid values: available | pending | failed.

state-reason-code
    Reason code for the state change.

state-reason-message
    Message for the state change.

tag-key
    Key of a tag assigned to the resource.

tag-value
    Value of a tag assigned to the resource.

tag:key
    Filters the results based on a specific tag/value combination.

virtualization-type
    Virtualization type of the image. Valid values: paravirtual | hvm