ansible.builtin.dict2items 过滤器 – 将字典转换为字典的条目列表

注意

此过滤器插件是 ansible-core 的一部分，并包含在所有 Ansible 安装中。在大多数情况下，您可以使用短插件名称 dict2items。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.dict2items，以便轻松链接到插件文档，并避免与其他可能具有相同过滤器插件名称的集合冲突。

概要

  • 获取一个字典并将其转换为字典列表，每个字典都有一个 key 和 value 键，它们对应于原始字典的键和值。

输入

这描述了过滤器的输入，即 | ansible.builtin.dict2items 之前的值。

参数

注释

输入

字典 / 必需

要转换的字典

位置参数

这描述了过滤器的位置参数。这些是以下示例中的 positional1、positional2 等值：input | ansible.builtin.dict2items(positional1, positional2, ...)

参数

注释

key_name

字符串

在 Ansible 2.8 中添加

表示字典键的项的属性名称。

默认值： "key"

value_name

字符串

在 Ansible 2.8 中添加

表示字典值的项的属性名称。

默认值： "value"

另请参阅

另请参阅

ansible.builtin.items2dict 过滤器插件

将条目化字典列表合并到一个字典中。

示例

# items => [ { "key": "a", "value": 1 }, { "key": "b", "value": 2 } ]
items: "{{ {'a': 1, 'b': 2}| dict2items }}"

# files_dicts: [
#       {
#           "file": "users",
#           "path": "/etc/passwd"
#       },
#       {
#           "file": "groups",
#           "path": "/etc/group"
#       }
# ]
vars:
  files:
    users: /etc/passwd
    groups: /etc/group
  files_dicts: "{{ files | dict2items(key_name='file', value_name='path') }}"

返回值

键

描述

返回值

列表 / elements=dictionary

字典列表。

返回： 成功

作者

  • Ansible 核心团队

提示

每个条目类型的配置条目都具有从低到高的优先级顺序。例如，列表中较低的变量将覆盖列表中较高的变量。