community.general.ipwcli_dns модуль – Управление записями DNS для Ericsson IPWorks через ipwcli

Примечание

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

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

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

Для использования в playbook, укажите: community.general.ipwcli_dns.

Новое в community.general 0.2.0

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

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

Управление записями DNS для сервера DNS Ericsson IPWorks. Модуль будет использовать ipwcli для развертывания записей DNS.

Требования

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

ipwcli (установлен на Ericsson IPWorks)

Параметры

Параметр	Комментарии
address string	IP-адрес для записи A или AAAA. Обязательно для `type=A` или `type=AAAA`.
container string / required	Устанавливает зону контейнера для записи.
dnsname string / required	Имя записи.
flags string	Устанавливает один из возможных флагов записи NAPTR. Обязательно для `type=NAPTR`. Варианты: `"S"` `"A"` `"U"` `"P"`
order integer	Устанавливает порядок записи NAPTR. Обязательно для `type=NAPTR`.
password string / required	Пароль для входа в ipwcli.
port integer	Устанавливает порт записи SRV. Обязательно для `type=SRV`.
preference integer	Устанавливает приоритет записи NAPTR. Обязательно для `type=NAPTR`.
priority integer	Устанавливает приоритет записи SRV. Значение по умолчанию: `10`
replacement string	Устанавливает замену записи NAPTR. Обязательно для `type=NAPTR`.
service string	Устанавливает сервис записи NAPTR. Обязательно для `type=NAPTR`.
state string	Должна ли существовать запись или нет. Варианты: `"absent"` `"present"` ← (по умолчанию)
target string	Устанавливает целевой адрес записи SRV. Обязательно для `type=SRV`.
ttl integer	Устанавливает TTL записи. Значение по умолчанию: `3600`
type string / required	Тип записи. Варианты: `"NAPTR"` `"SRV"` `"A"` `"AAAA"`
username string / required	Имя пользователя для входа в ipwcli.
weight integer	Устанавливает вес записи SRV. Значение по умолчанию: `10`

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения статуса, не изменяя целевой объект.
diff_mode	Поддержка: отсутствует	Вернет подробную информацию о том, что изменилось (или, возможно, должно измениться в `check_mode`), когда включен режим diff.

Примечания

Примечание

Для того, чтобы изменения записей DNS вступили в силу, необходимо выполнить update dnsserver в ipwcli.

Примеры

- name: Create A record
  community.general.ipwcli_dns:
    dnsname: example.com
    type: A
    container: ZoneOne
    address: 127.0.0.1

- name: Remove SRV record if exists
  community.general.ipwcli_dns:
    dnsname: _sip._tcp.test.example.com
    type: SRV
    container: ZoneOne
    ttl: 100
    state: absent
    target: example.com
    port: 5060

- name: Create NAPTR record
  community.general.ipwcli_dns:
    dnsname: test.example.com
    type: NAPTR
    preference: 10
    container: ZoneOne
    ttl: 100
    order: 10
    service: 'SIP+D2T'
    replacement: '_sip._tcp.test.example.com.'
    flags: S

Значения возврата

Общие значения возврата документированы здесь, следующие поля уникальны для данного модуля:

Ключ	Описание
record строка	Созданная запись на основе входных параметров Возвращается: всегда

Авторы

Christian Wollinger (@cwollinger)

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

© 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/ipwcli_dns_module.html