Back to Amazon EC2 Integrations
Handler · Version 1

AWS EC2 Instance List

Download GitHub


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: i-01234567 i-abcdefgh i-0123abcd

To setup the Loop handler, refer to the Instance List from this handler for 'Data Source' and use '/instances/instance'as the 'Variable Path'.

The describe_instances 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 "reservationsSet".

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

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

, , , , , , , , , , ", , , , , , ", , , , ,

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


Treat items as arrays and all other members as hash keys. Doing so, we can reference imageId value in the following manner:


Name Description
Instance List An XML string representing a list of instances

AWS EC2 Instance List V1.1 (2017-08-23)

  • 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.

AWS EC2 Instance List V1 (2011-03-03)

  • Initial version. See README for details.
Download GitHub

On This Page

Looking for a workflow engine? Learn more about the Kinetic Data Enterprise Workflow Platform. Check it out
Return to Top