community.general.udm_dns_record 模块 – 在 Univention 企业服务器上管理 DNS 条目

注意

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

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

要安装它，请使用：ansible-galaxy collection install community.general。您需要其他需求才能使用此模块，有关详细信息，请参见 需求。

要在 playbook 中使用它，请指定：community.general.udm_dns_record。

概要

  • 此模块允许管理 Univention 企业服务器 (UCS) 上的 DNS 记录。它使用 UCS 的 Python API 来创建一个新对象或编辑它。

需求

执行此模块的主机需要以下需求。

参数

参数

注释

data

字典

此记录的其他数据，例如 {'a': '192.0.2.1'}。

如果 state=present，则需要此参数。

默认值： {}

name

字符串 / 必需

记录的名称，这也是 DNS 记录。例如，对于 www.example.com，则为 www。

对于 PTR 记录，这必须是 IP 地址。

state

字符串

DNS 记录是否存在。

选项

  • "present" ← (默认)

  • "absent"

type

字符串 / 必需

定义记录类型。host_record 是 A 或 AAAA 记录，alias 是 CNAME，ptr_record 是 PTR 记录，srv_record 是 SRV 记录，txt_record 是 TXT 记录。

可用的选项包括：host_record、alias、ptr_record、srv_record、txt_record。

zone

字符串 / 必需

此记录对应的 DNS 区域，例如 example.com。

对于 PTR 记录，这必须是完整的反向区域（例如 1.1.192.in-addr.arpa）。

属性

属性

支持

描述

check_mode

支持：完全支持

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

diff_mode

支持：部分支持

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

示例

- name: Create a DNS record on a UCS
  community.general.udm_dns_record:
    name: www
    zone: example.com
    type: host_record
    data:
      a:
         - 192.0.2.1
         - 2001:0db8::42

- name: Create a DNS v4 PTR record on a UCS
  community.general.udm_dns_record:
    name: 192.0.2.1
    zone: 2.0.192.in-addr.arpa
    type: ptr_record
    data:
      ptr_record: "www.example.com."

- name: Create a DNS v6 PTR record on a UCS
  community.general.udm_dns_record:
    name: 2001:db8:0:0:0:ff00:42:8329
    zone: 2.4.0.0.0.0.f.f.0.0.0.0.0.0.0.0.0.0.0.0.8.b.d.0.1.0.0.2.ip6.arpa
    type: ptr_record
    data:
      ptr_record: "www.example.com."

作者

  • Tobias Rüetschi (@keachi)