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 区域还是反向 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)