Poster of Linux kernelThe best gift for a Linux geek
EC2-DESCRIBE-IMAGES

EC2-DESCRIBE-IMAGES

Section: User Commands (1) Updated: 1.3-57419 api=2010-08-31
Local index Up
 

NAME

ec2-describe-images - Describe a registered image  

SYNOPSIS


 ec2dim ([ec2-describe-images])
 ec2dim [GENERAL OPTIONS] [AMI [...]] [-a] [-o OWNER [...]] [-x USER [...]]  

GENERAL NOTES


 Any command option/parameter may be passed a value of '-' to indicate
 that values for that option should be read from stdin.  

DESCRIPTION


 List and describe registered AMIs and AMIs you have launch permissions for.
 The AMI parameters, if specified, are the AMIs to describe.
 The result set of AMIs described are the intersection of the AMIs specified,
 AMIs owned by the owners specified and AMIs with launch permissions as specified
 by the executable by options.

 

GENERAL OPTIONS


 -K--private-key KEY
     Specify KEY as the private key to use. Defaults to the value of the
     EC2_PRIVATE_KEY environment variable (if set). Overrides the default.


 -C--cert CERT
     Specify CERT as the X509 certificate to use. Defaults to the value 
     of the EC2_CERT environment variable (if set). Overrides the default.


 -U--url URL
     Specify URL as the web service URL to use. Defaults to the value of
     'https://ec2.amazonaws.com' or to that of the EC2_URL environment
     variable (if set). Overrides the default.


 --region REGION
     Specify REGION as the web service region to use.
     This option will override the URL specified by the "-U URL" option
     and EC2_URL environment variable.


 -v--verbose
     Verbose output.


 -?--help
     Display this help.


 -H--headers
     Display column headers.


 --debug
     Display additional debugging information.


 --show-empty-fields
     Indicate empty fields.


 --hide-tags
     Do not display tags for tagged resources.


 --connection-timeout TIMEOUT
     Specify a connection timeout TIMEOUT (in seconds).


 --request-timeout TIMEOUT
     Specify a request timeout TIMEOUT (in seconds).

 

SPECIFIC OPTIONS


 -a--all
     Describe all AMIs, public, private or owned, that the user has access to.


 -o--owner OWNER
     Only AMIs owned by the users specified are described. OWNER may either be a
     user's account id for images owned by that user, 'self' for images owned by
     you, or 'amazon' for images owned by Amazon.


 -x--executable-by USER
     Only AMIs with launch permissions as specified are described. USER may either
     be a user's account id for AMIs owned by you for which the user has explicit
     launch permissions, 'self' for AMIs you have explicit launch permissions for,
     or 'all' for AMIs with public launch permissions.


 -F--filter FILTER
     Add a filter criterion for the result-set.  

SEE ALSO


  http://docs.amazonwebservices.com/AWSEC2/2010-08-31/CommandLineReference
  http://docs.amazonwebservices.com/AWSEC2/latest/CommandLineReference


 

Index

NAME
SYNOPSIS
GENERAL NOTES
DESCRIPTION
GENERAL OPTIONS
SPECIFIC OPTIONS
SEE ALSO

This document was created by man2html, using the manual pages.
Time: 21:12:31 GMT, April 16, 2011