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

Новая в версии 2.7.

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

Обзор

Добавляет и/или удаляет экземпляры объектов записей 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`.
	ssl_verify boolean	Варианты: нет ← да	Булево значение для включения или отключения проверки сертификатов SSL Значение также можно указать с помощью переменной среды `INFOBLOX_SSL_VERIFY`.
	username -		Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_USERNAME`.
	wapi_version -	По умолчанию: 1.4	Указывает версию WAPI для использования Значение также можно указать с помощью переменной среды `INFOBLOX_WAP_VERSION`.
state -		Варианты: present ← absent	Настраивает целевое состояние экземпляра объекта на сервере NIOS. При установке этого значения в `present`, объект настраивается на устройстве, а при установке значения в `absent`, значение удаляется (при необходимости) с устройства.
ttl -			Настраивает TTL, который будет ассоциирован с этой записью хоста
view - / обязательно		По умолчанию: "default"	Устанавливает просмотр DNS для ассоциации этой записи. Просмотр DNS должен быть уже настроен в системе псевдонимы: dns_view

Примечания

Примечание

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

Примеры

- name: configure an MX record
  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
  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
  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

Статус

Гарантия обратной совместимости интерфейса этого модуля не предоставляется. [предварительная версия]
Этот модуль поддерживается партнёром Ansible. [сертифицировано]

Авторы

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.7/modules/nios_mx_record_module.html