community.general.memset_dns_reload 模块 – 请求重新加载 Memset 的 DNS 基础设施,

注意

此模块是 community.general 集合 (版本 10.1.0) 的一部分。

如果您正在使用 ansible 包，您可能已经安装了这个集合。它不包含在 ansible-core 中。要检查是否已安装，请运行 ansible-galaxy collection list。

要安装它，请使用：ansible-galaxy collection install community.general。

要在 Playbook 中使用它，请指定：community.general.memset_dns_reload。

概要

  • 请求重新加载 Memset 的 DNS 基础设施，并可以选择轮询直到完成。

参数

参数

注释

api_key

字符串 / 必需

从 Memset 控制面板获取的 API 密钥。

poll

布尔值

布尔值，如果设置，将轮询重新加载作业的状态，并在作业完成时返回（除非首先达到 30 秒的超时时间）。如果达到超时时间，则任务不会被标记为失败，但 stderr 将指示轮询失败。

选择

  • false ← (默认)

  • true

属性

属性

支持

描述

check_mode

支持: 无

可以在 check_mode 中运行，并在不修改目标的情况下返回更改状态预测。

diff_mode

支持: 无

在差异模式下，将返回有关已更改（或可能需要在 check_mode 中更改）的详细信息。

备注

注意

  • DNS 重新加载请求是 Memset 提供的尽力而为的服务；这些通常默认每 15 分钟发生一次，但是如果稍后的任务依赖于创建的记录，您可以请求立即重新加载。通过 Memset 客户控制面板生成的 API 密钥需要具有以下最小范围 - dns.reload。如果您希望轮询作业状态以等待重新加载完成，则还需要 job.status。

示例

- name: Submit DNS reload and poll
  community.general.memset_dns_reload:
    api_key: 5eb86c9196ab03919abcf03857163741
    poll: true
  delegate_to: localhost

返回值

常见返回值在此处记录 这里，以下是此模块独有的字段

键

描述

memset_api

复杂

来自 Memset API 的原始响应。

返回: 总是

error

布尔值

作业是否以错误状态结束。

返回: 总是

示例: true

finished

布尔值

作业是否在返回结果之前完成。

返回: 总是

示例: true

id

字符串

作业 ID。

返回: 总是

示例: "c9cc8ad2a3e3fb8c63ed83c424928ef8"

status

字符串

作业状态。

返回: 总是

示例: "DONE"

type

字符串

作业类型。

返回: 总是

示例: "dns"

作者

  • Simon Weald (@glitchcrab)