DescribeImageAttribute

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

Request Parameters

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

Name Description Required

Name	Description	Required
ImageIdParam;	ID of the AMI for which an attribute will be described. Type: String	Yes
`Attribute`	Specifies the attribute to describe. Type: String Valid Value: `launchPermission`	Yes

ImageIdParam;

ID of the AMI for which an attribute will be described.

Type: String

Yes

Attribute

Specifies the attribute to describe.

Type: String

Valid Value: launchPermission

Yes

Attributes

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

Response Elements

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

Name Description

Name	Description
`imageId`	ID of the AMI described. Type: xsd:string
`launchPermission`	Launch permissions of the AMI. Returned if `launchPermission` is specified. Type: ec2:LaunchPermissionItemType[]
`productCodes`	Product codes of the AMI. Returned if `productCodes` is specified. Type: ec2:ProductCodeItemType[]

imageId

ID of the AMI described.

Type: xsd:string

launchPermission

Launch permissions of the AMI. Returned if launchPermission is specified.

Type: ec2:LaunchPermissionItemType[]

productCodes

Product codes of the AMI. Returned if productCodes is specified.

Type: 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-08-29">
  <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>