ansible.builtin.subset 测试 - 列表是否为此列表的子集

注意

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

概要

  • 验证第一个列表是否为第二个列表的子集（是否包含在内）。

别名：issubset

输入

这描述了测试的输入，即 is ansible.builtin.subset 或 is not ansible.builtin.subset 之前的值。

参数

注释

输入

列表 / 元素=任何 / 必需

列表。

关键字参数

这描述了测试的关键字参数。这些是以下示例中的值 key1=value1、key2=value2 等：input is ansible.builtin.subset(key1=value1, key2=value2, ...) 和 input is not ansible.builtin.subset(key1=value1, key2=value2, ...)

参数

注释

_superset

列表 / 元素=任何 / 必需

要测试的列表。

示例

big: [1,2,3,4,5]
small: [3,4]
issmallinbig: '{{ small is subset(big) }}'

返回值

键

描述

返回值

布尔值

如果指定的列表是提供的列表的子集，则返回 True，否则返回 False。

返回：成功

作者

  • Ansible 核心

提示

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