community.general.nios_mx_record – Настройка записей MX Infoblox NIOS

Примечание

Этот плагин является частью коллекции community.general (версия 1.3.2).

Для его установки используйте: ansible-galaxy collection install community.general

Для использования в книге задач укажите: community.general.nios_mx_record

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Добавляет и/или удаляет экземпляры объектов записей MX из серверов Infoblox NIOS. Этот модуль управляет объектами NIOS record:mx с использованием интерфейса Infoblox WAPI через REST.

Требования

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

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment строка			Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка будет настроена для экземпляра объекта.
extattrs строка			Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
mail_exchanger строка			Настраивает FQDN почтового обменника для этой записи MX. псевдонимы: mx
name строка / обязательный			Указывает полное доменное имя хоста для добавления или удаления из системы
preference строка			Настраивает приоритет (0-65535) для этой записи MX.
provider словарь			Объект словаря, содержащий сведения о подключении.
	host строка		Указывает имя хоста DNS или адрес для подключения к удаленному экземпляру NIOS WAPI через REST Значение также можно указать, используя переменную окружения `INFOBLOX_HOST`
	http_request_timeout целое число	Значение по умолчанию: 10	Время ожидания ответа Значение также можно указать, используя переменную окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT`
	max_results целое число	Значение по умолчанию: 1000	Указывает максимальное количество возвращаемых объектов; если установлено отрицательное число, прибор вернёт ошибку, если количество возвращаемых объектов превысит установленное значение. Значение также можно указать, используя переменную окружения `INFOBLOX_MAX_RESULTS`
	max_retries целое число	Значение по умолчанию: 3	Настраивает количество попыток повтора до того, как подключение будет признано работоспособным. Значение также можно указать, используя переменную окружения `INFOBLOX_MAX_RETRIES`
	password строка		Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать, используя переменную окружения `INFOBLOX_PASSWORD`
	username строка		Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать, используя переменную окружения `INFOBLOX_USERNAME`
	validate_certs булево	Варианты: нет ← да	Булево значение для включения или выключения проверки сертификатов SSL Значение также можно указать, используя переменную окружения `INFOBLOX_SSL_VERIFY` псевдонимы: ssl_verify
	wapi_version строка	Значение по умолчанию: "2.1"	Указывает версию WAPI для использования Значение также можно указать, используя переменную окружения `INFOBLOX_WAP_VERSION` До Ansible 2.8 значением по умолчанию для WAPI была 1.4
state строка		Варианты: present ← absent	Настраивает желаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства.
ttl строка			Настраивает TTL, который будет связан с этой записью хоста
view строка		Значение по умолчанию: "default"	Устанавливает представление DNS для связи с этой записью. Представление DNS должно быть уже настроено в системе псевдонимы: dns_view

Примечания

Примечание

Этот модуль должен выполняться локально, что можно сделать, указав connection: local
Для получения более подробной информации о том, как использовать Infoblox с Ansible, обратитесь к Руководству по Infoblox.

Примеры

- name: Configure an MX record
  community.general.nios_mx_record:
    name: ansible.com
    mx: mailhost.ansible.com
    preference: 0
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to an existing MX record
  community.general.nios_mx_record:
    name: ansible.com
    mx: mailhost.ansible.com
    preference: 0
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove an MX record from the system
  community.general.nios_mx_record:
    name: ansible.com
    mx: mailhost.ansible.com
    preference: 0
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Blair Rampling (@brampling)

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