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
- 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
