indexed_items – rewrites lists to return ‘indexed items’

• Synopsis
• Parameters
• Examples
• Return Values
• Status

Synopsis

• use this lookup if you want to loop over an array and also get the numeric index of where you are in the array as you go
• any list given will be transformed with each resulting element having the it’s previous position in item.0 and its value in item.1

Parameters

Examples

- name: indexed loop demo
  debug:
    msg: "at array position {{ item.0 }} there is a value {{ item.1 }}"
  with_indexed_items:
    - "{{ some_list }}"

Return Values

Common return values are documented here, the following are the fields unique to this lookup:

Status

• This lookup is not guaranteed to have a backwards compatible interface. [preview]
• This lookup is maintained by the Ansible Community. [community]

Authors

• Michael DeHaan <michael.dehaan@gmail.com>