DescribeImageAttribute

Description

Returns information about an attribute of an AMI. You can get information about only one attribute per call. These are the available attributes:

description—Description of the AMI provided at image creation
kernel—ID of the kernel associated with the AMI
ramdisk—ID of the RAM disk associated with the AMI
launchPermission—Launch permissions for the AMI
productCodes—Product code associated with the AMI (if any)
blockDeviceMapping—Block device mapping of the AMI

Request Parameters

Name Description Required

Name	Description	Required
`ImageId`	The AMI ID. Type: String Default: None	Yes
`Attribute`	The AMI attribute to get. Type: String Default: None Valid Values: `description` \| `kernel` \| `ramdisk` \| `launchPermission` \| `productCodes` \| `blockDeviceMapping`	Yes

ImageId

The AMI ID.

Type: String

Default: None

Yes

Attribute

The AMI attribute to get.

Type: String

Default: None

Yes

Response Elements

The elements in the following table come wrapped in a DescribeImageAttributeResponse structure.

Name	Description
`requestId`	The ID of the request. Type: xsd:string
`imageId`	The ID of the AMI. Type: xsd:string
`launchPermission`	A list of launch permissions. Each launch permission's information is wrapped in an `item` element. Type: LaunchPermissionItemType
`productCodes`	A list of product codes. Each product code's information is wrapped in an `item` element. Type: ProductCodeItemType
`kernel`	Kernel ID, wrapped in a `value` element. Type: xsd:string
`ramdisk`	RAM disk ID, wrapped in a `value` element. Type: xsd:string
`description`	User-created description of the AMI, wrapped in a `value` element. Type: xsd:string
`blockDeviceMapping`	List of block device mappings. Each mapping's information is wrapped in an `item` element. Type: BlockDeviceMappingItemType

Examples

Example Request

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

https://ec2.amazonaws.com/?Action=DescribeImageAttribute
&ImageId=ami-61a54008
&Attribute=launchPermission
&AuthParams

Example Response

<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2010-08-31/">
  <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
  <imageId>ami-61a54008</imageId>
  <launchPermission>
    <item>
      <group>all</group>
    </item>
    <item>
      <userId>495219933132</userId>
    </item>
  </launchPermission>
</DescribeImageAttributeResponse>

Example Request

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

https://ec2.amazonaws.com/?Action=DescribeImageAttribute
&ImageId=ami-2bb65342
&Attribute=productCodes
&AuthParams

Example Response

<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2010-08-31/">
   <requestId>59dbff89-35bd-4eac-99ed-be587EXAMPLE</requestId> 
   <imageId>ami-2bb65342</imageId>
   <productCodes> 
      <item>
         <productCode>774F4FF8</productCode>
      </item> 
   </productCodes> 
</DescribeImageAttributeResponse>

DescribeImageAttribute

Description

Request Parameters

Response Elements

Examples

Example Request

Example Response

Example Request

Example Response

Related Operations