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