Модуль community.general.udm_dns_record — Управление записями DNS на корпоративном сервере Univention

Примечание

Этот модуль входит в коллекцию community.general (версия 9.5.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

Чтобы установить её, используйте: ansible-galaxy collection install community.general. Для использования этого модуля необходимы дополнительные требования, см. Требования для подробностей.

Чтобы использовать его в книге задач, укажите: community.general.udm_dns_record.

Описание
Требования
Параметры
Атрибуты
Примеры

Описание

Этот модуль позволяет управлять записями DNS на корпоративном сервере Univention (UCS). Он использует API Python UCS для создания нового объекта или его редактирования.

Требования

Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.

Univention
ipaddress (для type=ptr_record)

Параметры

Параметр	Комментарии
data словарь	Дополнительные данные для этой записи, например `{'a': '192.0.2.1'}`. Требуется, если `state=present`. По умолчанию: `{}`
name строка / обязательно	Имя записи, это также запись DNS. Например, www для www.example.com. Для записей 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`), когда в режиме diff.

Примеры

- 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)

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/udm_dns_record_module.html