community.general.udm_dns_zone 模块 – 在 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_zone。

概要

  • 此模块允许在 Univention 企业服务器 (UCS) 上管理 DNS 区域。 它使用 UCS 的 Python API 创建新对象或对其进行编辑。

参数

参数

注释

contact

字符串

SOA 记录中的联系人。

默认值： ""

expire

整数

指定在区域不再具有权威性之前可以经过的时间间隔上限。

默认值： 604800

interfaces

列表 / 元素=字符串

服务器应响应此区域的接口 IP 地址列表。如果 state=present，则为必需。

默认值： []

mx

列表 / 元素=字符串

MX 服务器列表。（必须声明为 A 或 AAAA 记录）。

默认值： []

nameserver

列表 / 元素=字符串

适当的名称服务器列表。如果 state=present，则为必需。

默认值： []

refresh

整数

应刷新区域之前的间隔。

默认值： 3600

retry

整数

在应重试失败的刷新之前应该经过的间隔。

默认值： 1800

state

字符串

DNS 区域是否存在。

选择

  • "present" ← (默认)

  • "absent"

ttl

整数

应从此区域导出任何 RR 的最小 TTL 字段。

默认值： 600

type

字符串 / 必需

定义区域是正向还是反向 DNS 区域。

可用的选择是：forward_zone、reverse_zone。

zone

别名：name

字符串 / 必需

DNS 区域名称，例如 example.com。

属性

属性

支持

描述

check_mode

支持：完全

可以在 check_mode 中运行，并返回已更改的状态预测，而无需修改目标。

diff_mode

支持：部分

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

示例

- name: Create a DNS zone on a UCS
  community.general.udm_dns_zone:
    zone: example.com
    type: forward_zone
    nameserver:
      - ucs.example.com
    interfaces:
      - 192.0.2.1

作者

  • Tobias Rüetschi (@keachi)