Модуль community.general.ipwcli_dns — управление DNS-записями Ericsson IPWorks с помощью ipwcli

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: 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 / обязательный	Задает зону-контейнер для записи.
dnsname string / обязательный	Имя записи.
flags string	Задает один из возможных флагов записи NAPTR. Обязателен для `type=NAPTR`. Варианты: `"S"` `"A"` `"U"` `"P"`
order integer	Задает порядок записи NAPTR. Обязателен для `type=NAPTR`.
password string / обязательный	Пароль для входа в 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 / обязательный	Тип записи. Варианты: `"NAPTR"` `"SRV"` `"A"` `"AAAA"`
username string / обязательный	Имя пользователя для входа в ipwcli.
weight integer	Задает вес записи SRV. По умолчанию: `10`

Атрибуты

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

Примечания

Примечание

Чтобы изменения 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 string	Созданная запись на основе входных параметров. Возвращается: всегда

Авторы

Christian Wollinger (@cwollinger)

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

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