ansible.builtin.items (v2.16.5) — lookup

list of items

| "added in version" historical of ansible.builtin"

Authors: Michael DeHaan

Install Ansible via pip

Install with pip install ansible-core==2.16.5

Description

this lookup returns a list of items given to it, if any of the top level items is also a list it will flatten it, but it will not recurse

Usage examples

  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "loop through list"
  ansible.builtin.debug:
    msg: "An item: {{ item }}"
  with_items:
    - 1
    - 2
    - 3
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: add several users
  ansible.builtin.user:
    name: "{{ item }}"
    groups: "wheel"
    state: present
  with_items:
     - testuser1
     - testuser2
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: "loop through list from a variable"
  ansible.builtin.debug:
    msg: "An item: {{ item }}"
  with_items: "{{ somelist }}"
  • Success
    Steampunk Spotter scan finished with no errors, warnings or hints.
- name: more complex items to add several users
  ansible.builtin.user:
    name: "{{ item.name }}"
    uid: "{{ item.uid }}"
    groups: "{{ item.groups }}"
    state: present
  with_items:
     - { name: testuser1, uid: 1002, groups: "wheel, staff" }
     - { name: testuser2, uid: 1003, groups: staff }

Inputs

    
_terms:
    description: list of items
    required: true

Outputs

_raw:
  description:
  - once flattened list
  type: list