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

提示

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