DescribeImageAttribute

The DescribeImageAttribute operation returns information about an attribute of an AMI. Only one attribute may be specified per call.

Request Parameters

The following table describes the request parameters for DescribeImageAttribute. Parameter names are case-sensitive.

Element Name	Definition	Required?	Type
`ImageId`	Id of the AMI for which an attribute will be described.	Yes	`string`
`Attribute`	Specifies the attribute to describe. Currently, only `launchPermission` is supported.	Yes	`string`

Attributes

Attribute Name	Description
launchPermission	The AMIs launch permissions.
productCodes	The product codes attached to the AMI.

Response Tags

The following table describes the default response tags included in DescribeImageAttribute responses.

Element Name	Definition	Type
`imageId`	ID of the AMI being described.	`xsd:string`
`launchPermission`	Launch permissions of the AMI. Returned if launchPermissions are being described.	`ec2:LaunchPermissionItemType[]`
`productCodes`	Product codes of the AMI. Returned if productCodes are being described.	`ec2:ProductCodeItemType[]`

Sample Request - Launch Permission

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

Sample Response - Launch Permission

<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2007-03-01">
  <imageId>ami-61a54008</imageId>
  <launchPermission>
    <item>
      <group>all</group>
    </item>
    <item>
      <userId>495219933132</userId>
    </item>
  </launchPermission>
</DescribeImageAttributeResponse>

Sample Request - Product Codes

https://ec2.amazonaws.com/
?Action=DescribeImageAttribute
&ImageId=ami-61a54008
&Attribute=productCodes
&...auth parameters...

Sample Response - Product Codes

<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2007-01-03">
  <imageId>ami-61a54008</imageId>
  <productCodes>
    <item>
      <productCode>774F4FF8</productCode>
    </item>
  </productCodes>
</DescribeImageAttributeResponse>