DescribeImageAttribute
Description
Returns information about an attribute of an AMI. Only one attribute can be specified per call.
Request Parameters
| Name | Description | Required |
|---|---|---|
|
Type: |
Ancestor: None
Children: imageId, launchPermission, productCodes, kernel, ramdisk, blockDeviceMapping, and platform
imageId
The ID of the AMI for which an attribute will be described.
Type: xsd:string
Default: None
Ancestor: DescribeImageAttribute
Children: None
Yes
launchPermission
Describes the launch permissions of the AMI.
Type: xsd:string
Default: None
Ancestor: DescribeImageAttribute
Children: None
No
productCodes
Describes the product code associated with the AMI.
Type: xsd:string
Default: None
Ancestor: DescribeImageAttribute
Children: None
No
kernel
Describes the ID of the kernel associated with the AMI.
Type: xsd:string
Default: None
Ancestor: DescribeImageAttribute
Children: None
No
ramdisk
Describes the ID of the RAM disk associated with the AMI.
Type: xsd:string
Default: None
Ancestor: DescribeImageAttribute
Children: None
No
blockDeviceMapping
Describes the mapping that defines native device names to use when exposing virtual devices.
Type: xsd:string
Default: None
Ancestor: DescribeImageAttribute
Children: None
No
platform
Describes the operating system platform.
Type: xsd:string
Default: None
Ancestor: DescribeImageAttribute
Children: None
No
Response Elements
| Name | Description |
|---|---|
|
|
Type: DescribeImageAttributeResponse Ancestor: None Children: |
|
The ID of the request. Type: xsd:string Ancestor: Children: None |
|
The ID of the AMI. Type: xsd:string Ancestor: Children: None |
|
Launch permissions set. Type: LaunchPermissionListType Ancestor: Children: |
|
Information for launch permissions. Type: LaunchPermissionItemType Ancestor: Children: |
|
User IDs associated with the launchPermission attribute. Type: xsd:string Ancestor: Children: None |
|
Security groups associated with the launchPermission attribute. You can specify the Type: xsd:string Ancestor: Children: None |
|
Product codes set. Type: ProductCodeListType Ancestor: Children: |
|
Information for one product code. Type: ProductCodeItemType Ancestor: Children: |
|
Amazon DevPay product code. Currently only one product code can be associated with an AMI. Once set, the product code cannot be changed or reset. Type: xsd:string Ancestor: Children: None |
|
Kernel set. Type: NullableAttributeValueType Ancestor: Children: |
|
ID of the kernel or RAM disk. Type: xsd:string Ancestor: Children: None |
|
RAM disk set. Type: NullableAttributeValueType Ancestor: Children: |
|
ID of the kernel or RAM disk. Type: xsd:string Ancestor: Children: None |
|
Block device mapping set. Type: BlockDeviceMappingType Ancestor: Children: |
|
Information for one block device mapping. Type: BlockDeviceMappingItemType Ancestor: Children: |
|
The virtual name. Type: xsd:string Ancestor: Children: None |
|
The device name (e.g., /dev/sdh). Type: xsd:string Ancestor: Children: None |
Examples
Example Request
This example lists the launch permissions for the ami-61a54008 AMI
<DescribeImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-04-04/"> <imageId>&exampleamiid;</imageId> <launchPermission/> </DescribeImageAttribute>
Example Response
<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-04-04/">
<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-2bb65342AMI.
<DescribeImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-04-04/"> <imageId>&exampleamiid;</imageId> <productCodes/> </DescribeImageAttribute>
Example Response
<DescribeImageAttributeResponse xmlns="http://ec2.amazonaws.com/doc/2009-04-04/">
<imageId>ami-61a54008</imageId>
<productCodes>
<item>
<productCode>774F4FF8</productCode>
</item>
</productCodes>
</DescribeImageAttributeResponse>