indexed_items

Collection Note

This module is part of the ansible.builtin collection. To install the collection, use:

ansible-galaxy collection install ansible.builtin

Added in version 1.3.

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

Parameter	Defaults / Choices	Comments
_terms required		list of items

Examples

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

Return Values

Key	Data Type	Description	Returned
_raw	list	list with each item.0 giving you the position and item.1 the value

Authors

• Michael Dehaan