ansible.builtin.dict – возвращает пары ключ/значение из словарей
Примечание
Этот модуль является частью ansible-base и включён во все установки Ansible. В большинстве случаев можно использовать короткое имя модуля dict, даже не указывая collections: ключевое слово. Несмотря на это, рекомендуется использовать FQCN для удобной ссылки на документацию модуля и для предотвращения конфликтов с другими коллекциями, которые могут иметь то же имя модуля.
Введено в версии 1.5: of ansible.builtin
Описание
- Принимает словари в качестве входных данных и возвращает список, где каждый элемент списка представляет собой словарь с ключами ‘ключ’ и ‘значение’, соответствующими структуре исходного словаря.
Параметры
| Параметр | Варианты/Значения по умолчанию | Конфигурация | Комментарии |
|---|---|---|---|
| _terms строка / обязательно | Список словарей |
Примеры
vars:
users:
alice:
name: Alice Appleworth
telephone: 123-456-7890
bob:
name: Bob Bananarama
telephone: 987-654-3210
tasks:
# with predefined vars
- name: Print phone records
debug:
msg: "User {{ item.key }} is {{ item.value.name }} ({{ item.value.telephone }})"
loop: "{{ lookup('dict', users) }}"
# with inline dictionary
- name: show dictionary
debug:
msg: "{{item.key}}: {{item.value}}"
with_dict: {a: 1, b: 2, c: 3}
# Items from loop can be used in when: statements
- name: set_fact when alice in key
set_fact:
alice_exists: true
loop: "{{ lookup('dict', users) }}"
when: "'alice' in item.key"
Возвращаемые значения
Общие возвращаемые значения описаны в документации, следующие поля уникальны для этого поиска:
| Ключ | Возвращённое значение | Описание |
|---|---|---|
| _list список / элементы=строка | успех | список составленных словарей с ключом и значением |
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/ansible/builtin/dict_lookup.html
