ansible.builtin.indexed_items 查询 – 重写列表以返回“索引项”

注意

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

摘要

  • 如果您想遍历数组并同时获取您在数组中的位置的数字索引，请使用此查询。

  • 任何给定的列表都将被转换，每个生成的元素都将在 item.0 中具有其先前的 位置，在 item.1 中具有其值。

术语

参数

注释

术语

字符串 / 必需

项目列表

示例

- name: indexed loop demo
  ansible.builtin.debug:
    msg: "at array position {{ item.0 }} there is a value {{ item.1 }}"
  with_indexed_items:
    - "{{ some_list }}"

返回值

键

描述

返回值

列表 / 元素=列表

列表，每个 item.0 提供位置，item.1 提供值。

返回：成功

作者

  • Michael DeHaan

提示

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