ec2-describe-image-attribute

Description

Returns information about an attribute of an AMI. You can get information about only one attribute per call.

The short version of this command is ec2dimatt.

Syntax

ec2-describe-image-attribute ami_id {-l | -p | -B | --kernel | --ramdisk}

Options

Name	Description	Required
`ami_id`	The ID of the AMI for which an attribute will be described. Type: String Default: None Example: ami-4fa54026	Yes
`-l, --launch-permission`	Describes the launch permissions of the AMI. Type: String Default: None Example: -l	No
`-p, --product-code`	Describes the product code associated with the AMI. Type: String Default: None Example: -p	No
`-B, --block-device-mapping`	Describes the mapping that defines native device names to use when exposing virtual devices. Type: String Default: None Example: -B	No
`--kernel`	Describe the kernel ID the AMI will be launched with. Type: String Default: None Example: --kernel	No
`--ramdisk`	Describe the RAM disk ID the AMI will be launched with. Type: String Default: None Example: -ramdisk	No

Common Options

Option	Description
`--region` `REGION`	Overrides the Region specified in the `EC2_URL` environment variable and the URL specified by the `-U` option. Default: The `EC2_URL` environment variable, or `us-east-1` if the environment variable is not set. Example: `--region eu-west-1`
`-U, --url` `URL`	`URL` is the uniform resource locator of the Amazon EC2 web service entry point. Default: The `EC2_URL` environment variable, or https://ec2.amazonaws.com if the environment variable is not set. Example: `-U https://ec2.amazonaws.com`
`-K, --private-key` `EC2-PRIVATE-KEY`	The private key to use when constructing requests to Amazon EC2. Default: The value of the `EC2_PRIVATE_KEY` environment variable. Example: `-K pk-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem`
`-C, --cert` `EC2-CERT`	The X.509 certificate to use when constructing requests to Amazon EC2. Default: The value of the `EC2_CERT` environment variable. Example: `-C cert-HKZYKTAIG2ECMXYIBH3HXV4ZBZQ55CLO.pem`
`--connection-timeout` `TIMEOUT`	Specifies a connection timeout (in seconds). Example: --connection-timeout 30
`--request-timeout` `TIMEOUT`	Specifies a request timeout (in seconds). Example: --request-timeout 45
`-v, --verbose`	Displays verbose output by showing the SOAP request and response on the command line. This is particularly useful if you are building tools to talk directly to our SOAP API.
`-H, --headers`	Displays column headers in the output.
`--show-empty-fields`	Shows empty columns as `(nil)`.
`--hide-tags`	Do not display tags for tagged resources.
`--debug`	Prints internal debugging information. This is useful to assist us when troubleshooting problems.
`-?, --help, -h`	Displays Help.
`-`	If `-` is specified as an argument to one of the parameters, a list of arguments is read from standard input. This is useful for piping the output of one command into the input of another. Example: `ec2-describe-instances \| grep stopped \| cut -f 2 \| ec2-start-instances -`

Output

The command returns a table that contains the following information:

Attribute type identifier
ID of the AMI
Information about the attribute

Amazon EC2 command line tools display errors on stderr.

Examples

Example Request

This example lists the launch permissions for the ami-61a54008 AMI

PROMPT> ec2-describe-image-attribute ami-2bb65342 -l
launchPermission ami-2bb65342 group all
launchPermission ami-2bb65342 userId 495219933132

Example Request

This example lists the product code for the ami-2bb65342 AMI.

PROMPT> ec2-describe-image-attribute ami-2bb65342 -p
productCodes ami-2bb65342 productCode  774F4FF8

Example Request

This example describes the RAM disk for the ami-d5ed03bc AMI, with the --show-empty-fields option.

PROMPT> ec2-describe-image-attribute ami-d5ed03bc --ramdisk --show-empty-fields
ramdisk ami-d5ed03bc    (nil)   ari-96c527ff

Description

Syntax

Options

Common Options

Output

Examples

Example Request

Example Request

Example Request

Related Operations