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

Примечание

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

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

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

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

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

Краткое описание

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

Требования

Следующие требования должны быть выполнены на узле, на котором выполняется этот модуль.

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	Поддержка: частичная	В режиме diff возвращает сведения об изменениях (или о том, что, возможно, потребуется изменить в `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."

Авторы

keachi (@keachi)

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

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