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 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
|
| Attribute Name | Description |
|---|---|
| launchPermission | The AMIs launch permissions. |
| productCodes | The product codes attached to the AMI. |
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[]
|
https://ec2.amazonaws.com/ ?Action=DescribeImageAttribute &ImageId=ami-61a54008 &Attribute=launchPermission &...auth parameters...
<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2007-01-03">
<imageId>ami-61a54008</imageId>
<launchPermission>
<item>
<group>all</group>
</item>
<item>
<userId>495219933132</userId>
</item>
</launchPermission>
</DescribeImageAttributeResponse>
https://ec2.amazonaws.com/ ?Action=DescribeImageAttribute &ImageId=ami-61a54008 &Attribute=productCodes &...auth parameters...
<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2007-01-03">
<imageId>ami-61a54008</imageId>
<productCodes>
<item>
<productCode>774F4FF8</productCode>
</item>
</productCodes>
</DescribeImageAttributeResponse>