Documentation

dict - returns key/value pair items from dictionaries

New in version 1.5.

Synopsis

  • Takes dictionaries as input and returns a list with each item in the list being a dictionary with ‘key’ and ‘value’ as keys to the previous dictionary’s structure.

Parameters

Parameter Choices/Defaults Configuration Comments
_terms
required
A list of dictionaries

Examples

tasks:
  - name: show dictionary
    debug: msg="{{item.key}}: {{item.value}}"
    with_dict: {a: 1, b: 2, c: 3}a

# with predefined vars
vars:
  users:
    alice:
      name: Alice Appleworth
      telephone: 123-456-7890
    bob:
      name: Bob Bananarama
      telephone: 987-654-3210
tasks:
  - name: Print phone records
    debug:
      msg: "User {{ item.key }} is {{ item.value.name }} ({{ item.value.telephone }})"
    loop: "{{ lookup('dict', users) }}"

Return Values

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

Key Returned Description
_list
list
list of composed dictonaries with key and value



Status

Author

  • UNKNOWN

Hint

If you notice any issues in this documentation you can edit this document to improve it.