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 }
返回值
键 |
描述 |
|---|---|
展平后的列表 返回：成功 |