DescribeImageAttribute

Amazon Elastic Compute Cloud: 2009-03-01

previous page next page

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
`imageId`	ID of the AMI for which an attribute will be described. Type: xsd:string	Yes
`launchPermission`	Describes launch permissions of the AMI. Type: EmptyElementType	Choice
`productCodes`	Describes the product code associated with the AMI. Type: EmptyElementType	Choice
`kernel`	Describes the ID of the kernel associated with the AMI. Type: xsd:string	No
`ramdisk`	Describes the ID of the RAM disk associated with the AMI. Type: xsd:string	No
`blockDeviceMapping`	Describes the mapping that defines native device names to use when exposing virtual devices. Type: xsd:string	No

Response Elements

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

Name	Description
`imageId`	ID of the AMI of which parameters are described. Type: xsd:string
`launchPermission`	Launch permissions of the AMI. Returned if `launchPermission` is specified. Type: LaunchPermissionItemType[]
`productCodes`	Product codes of the AMI. Returned if `productCodes` is specified. Type: ProductCodeItemType[]
`kernel`	ID of the kernel associated with the AMI. Returned if `kernel` is specified. Type: xsd:string
`ramdisk`	ID of the RAM disk associated with the AMI. Returned if `ramdisk` is specified. Type: xsd:string
`blockDeviceMapping`	Mapping that defines native device names to use when exposing virtual devices. Returned if `blockDeviceMapping` is specified. Type: BlockDeviceMappingItemType[]
`platform`	The operating platform of the instance. Type: xsd:string

Sample Request - Launch Permission

<DescribeImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-03-01/">
  <imageId>ami-61a54008</imageId>
  <launchPermission />
</DescribeImageAttribute>

Sample Response - Launch Permission

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

Sample Request - Product Codes

<DescribeImageAttribute xmlns="http://ec2.amazonaws.com/doc/2009-03-01/">
  <imageId>ami-61a54008</imageId>
  <productCodes />
</DescribeImageAttribute>

Sample Response - Product Codes

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

Related Operations

previous page start next page