ansible.builtin.failed 测试 – 任务是否失败

注意

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

概要

  • 测试任务是否以失败结束,与 succeeded 相反。

  • 此测试检查输入字典中是否存在 failed 键,如果存在,则该键为 True

  • 由于其他失败(语法、模板、无法访问的主机等)而被跳过或未执行的任务不会返回“failed”状态。

别名:failure

输入

这描述了测试的输入,即 is ansible.builtin.failedis not ansible.builtin.failed 前的值。

参数

注释

输入

字典 / 必需

从 Ansible 任务注册的结果

示例

# test 'status' to know how to respond
{{ taskresults is failed }}

返回值

描述

返回值

布尔值

如果任务失败,则返回 True,否则返回 False

返回:成功

作者

  • Ansible Core

提示

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