Skip to main content
Kinetic Community

AWS EC2 Image List

Retrieves list of machine images attached to the AWS credentials supplied

Downloads

By downloading this file, you acknowledge that you agree to our Terms of Service

aws_ec2_image_list_v1.zip

Detailed Description

This handler will be used primarily in a loop to iterate over multiple EC2 image
instances. In order to be used by the Loop handler, a single value is returned
as an escaped XML string. called "Instance List".

The Instance List will have the following format:
<images>
    <image>ari-fe916297</image>
    <image>ari-8b779ae2</image>
    <image>ari-926b8bfb<image>
</instances>

To setup the Loop handler, refer to the Image List from this handler for
'Data Source' and use '/images/image'as the 'Variable Path'.

The describe_images function is the base AWS::EC2 gem call we are using for
this handler and returns a multi-level hash/array nest with a top level hash key
of "imagesSet".

The imagesSet has the following pseudo-xml form. Elements with the <item> 
tag are array members and are referenced by numerical index.

All others are hash members and are references by element/key name.

  <imagesSet>
    <item>
      <imageId/>
      <imageLocation/>
      <imageState/>
      <imageOwnerId/>
      <isPublic/>
      <architecture/>
      <imageType/>
      <kernelId/>
      <ramdiskId/>
      <imageOwnerAlias/>
      <name/>
      <description/>
      <rootDeviceType/>
      <rootDeviceName/>
      <blockDeviceMapping>
        <item>
          <deviceName/>
          <ebs>
            <snapshotId/>
            <volumeSize/>
            <deleteOnTermination/>
          </ebs>
        </item>
      </blockDeviceMapping>
      <virtualizationType/>
      <tagSet/>
      <hypervisor/>
    </item>
  </imagesSet>

To retrieve the imageId, for example, simply flatten the above structure by 
removing inapplicable items

  <imagesSet>
    <item>
      <imageId/>
    </item>
  </imagesSet>

 

Parameters

Name Description
Image Launch Permissions Public indicates public launch permissions. Private is for an image with only implicit and explicit launch permissions.
Image Architecture The architecture of the image.
Image Type The type of image
Image State Current state of the AMI. If the operation returns available, the image is successfully registered and available for launching

Sample Configuration

Parameter Example Configuration
Image Launch Permissions
Image Architecture
Image Type
Image State

Results

Name Description
Image List An XML string representing a list of images (by id)

Change Log

Version Date Description
1.1 2017-08-24 * Update the EC2 gem to AWS SDK 2.2.34.
* Change Info Values to be more consistent with the other AWS handlers.
* Internal tweaks to make execution similar to other AWS handlers.
1 2012-05-02 * Initial version. See README for details.