ansible.builtin.items 查询 – 项目列表
注意
此查询插件是 ansible-core 的一部分，包含在所有 Ansible 安装中。在大多数情况下，您可以使用简短的插件名称 items。但是，我们建议您使用完全限定的集合名称 (FQCN) ansible.builtin.items，以便轻松链接到插件文档并避免与可能具有相同查询插件名称的其他集合冲突。
概要
此查询返回给定的项目列表，如果任何顶级项目也是列表，它将展平它，但不会递归。
术语
参数 |
注释 |
|---|---|
项目列表 |
备注
注意
这是大多数示例中用于循环的标准查询。
查看“展平”查询以进行递归展平。
如果您不想要展平或任何其他转换，请查看“列表”查询。
示例
- name: "loop through list"
ansible.builtin.debug:
msg: "An item: {{ item }}"
with_items:
- 1
- 2
- 3
- name: add several users
ansible.builtin.user:
name: "{{ item }}"
groups: "wheel"
state: present
with_items:
- testuser1
- testuser2
- name: "loop through list from a variable"
ansible.builtin.debug:
msg: "An item: {{ item }}"
with_items: "{{ somelist }}"
- name: more complex items to add several users
ansible.builtin.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 }
返回值
键 |
描述 |
|---|---|
展平后的列表 返回：成功 |