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)