ansible.builtin.items – список элементов
Примечание
Этот модуль входит в состав ansible-base и включён во все установки Ansible. В большинстве случаев вы можете использовать короткое имя модуля items, даже не указывая ключевое слово collections:. Несмотря на это, мы рекомендуем использовать полное имя класса (FQCN) для удобной ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Описание
- Этот поиск возвращает список переданных элементов, если таковые имеются. Если любой из элементов верхнего уровня является списком, он будет сплющен, но рекурсия не выполняется
Параметры
| Параметр | Варианты/Значения по умолчанию | Настройка | Комментарии |
|---|---|---|---|
| _terms строка / обязательно | список элементов |
Примечания
Примечание
- Этот поиск используется по умолчанию для циклов во многих примерах
- Изучите поиск ‘flattened’ для рекурсивного сплющивания
- Если вам не нужно ни сплющивание, ни другие преобразования, посмотрите на поиск ‘list’.
Примеры
- name: "loop through list"
debug:
msg: "An item: {{ item }}"
with_items:
- 1
- 2
- 3
- name: add several users
user:
name: "{{ item }}"
groups: "wheel"
state: present
with_items:
- testuser1
- testuser2
- name: "loop through list from a variable"
debug:
msg: "An item: {{ item }}"
with_items: "{{ somelist }}"
- name: more complex items to add several users
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 }
Значения возврата
Общие значения возврата описаны здесь, следующие поля уникальны для данного поиска:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| _raw список / элементы=строка | успех | список после сплющивания |
Авторы
- Михаил ДеХан
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/ansible/builtin/items_lookup.html
