DescribeImageAttribute

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

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

Element NameDefinitionRequired?Type
imageId ID of the AMI for which an attribute will be described. Yesxsd:string
launchPermissionDescribes launch permissions of the AMI.Choiceec2:EmptyElementType
productCodesDescribes product codes of the AMI.Choiceec2:EmptyElementType

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

Element NameDefinitionType
imageId ID of the AMI of which parameters are being described.xsd:string
launchPermissionLaunch permissions of the AMI. Returned if launchPermissions are being described.ec2:LaunchPermissionItemType[]
productCodesProduct codes of the AMI. Returned if productCodes are being described.ec2:ProductCodeItemType[]
<DescribeImageAttribute xmlns="http://ec2.amazonaws.com/doc/2007-03-01">
  <imageId>ami-61a54008</imageId>
  <launchPermission />
</DescribeImageAttribute>
<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>
<DescribeImageAttribute xmlns="http://ec2.amazonaws.com/doc/2007-03-01">
  <imageId>ami-61a54008</imageId>
  <productCodes />
</DescribeImageAttribute>
<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2007-03-01">
  <imageId>ami-61a54008</imageId>
  <productCodes>
    <item>
      <productCode>774F4FF8</productCode>
    </item>
  </productCodes>
</DescribeImageAttributeResponse>