Provided by: ec2-api-tools_220.127.116.11-0ubuntu1_all
ec2-describe-images - Describe a registered image
ec2dim ([ec2-describe-images]) ec2dim [GENERAL OPTIONS] [AMI [...]] [-a] [-o OWNER [...]] [-x USER [...]]
Any command option/parameter may be passed a value of '-' to indicate that values for that option should be read from stdin.
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.
-O, --aws-access-key KEY AWS Access Key ID. Defaults to the value of the AWS_ACCESS_KEY environment variable (if set). -W, --aws-secret-key KEY AWS Secret Access Key. Defaults to the value of the AWS_SECRET_KEY environment variable (if set). -T, --security-token TOKEN AWS delegation token. Defaults to the value of the AWS_DELEGATION_TOKEN environment variable (if set). -K, --private-key KEY [DEPRECATED] 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 [DEPRECATED] 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' (us-east-1) 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. This option defaults to the region specified by the EC2_URL environment variable or us-east-1 if this environment variable is not set. -D, --auth-dry-run Check if you can perform the requested action rather than actually performing it. -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).
-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, 'amazon' for images owned by Amazon and 'aws-marketplace' for images from the AWS Marketplace -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.