Модуль infoblox.nios_modules.nios_mx_record – настройка записей MX Infoblox NIOS

Примечание

Этот модуль входит в коллекцию infoblox.nios_modules (версия 1.9.0).

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

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

Чтобы использовать модуль в плейбуке, укажите: infoblox.nios_modules.nios_mx_record.

Добавлено в infoblox.nios_modules 1.0.0

Краткое описание
Требования
Параметры
Примечания
Примеры

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

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

Требования

Следующие компоненты необходимы на узле, где выполняется этот модуль.

infoblox-client

Параметры

Параметр	Комментарии
comment строка	Задает текстовый комментарий, связанный с экземпляром этого объекта. Указанный текст будет задан для экземпляра объекта.
extattrs словарь	Позволяет настраивать расширяемые атрибуты экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
mail_exchanger псевдонимы: mx строка / обязательный	Задает полное доменное имя почтового обменника для этой записи MX.
name строка / обязательный	Указывает полное доменное имя узла, которое нужно добавить в систему или удалить из нее. Также можно изменить имя, передав словарь, содержащий new_name и old_name. См. примеры.
preference целое число / обязательный	Задает приоритет (0–65535) для этой записи MX.
provider словарь	Объект dict, содержащий сведения о подключении.
cert строка	Указывает файл сертификата клиента с дайджестом конфигурации x509 для дополнительного уровня защиты соединения с удаленным экземпляром NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_CERT`.
host строка	Указывает DNS-имя узла или адрес для подключения к удаленному экземпляру NIOS WAPI через REST Значение также можно задать с помощью переменной среды `INFOBLOX_HOST`.
http_pool_connections целое число	Вставьте описание здесь По умолчанию: `10`
http_pool_maxsize целое число	Вставьте описание здесь По умолчанию: `10`
http_request_timeout целое число	Время ожидания получения ответа Значение также можно задать с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key строка	Указывает файл закрытого ключа для шифрования с помощью сертификата, необходимого для подключения к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_KEY`.
max_results целое число	Указывает максимальное количество возвращаемых объектов. Если задано отрицательное число, устройство выдаст ошибку, когда количество возвращаемых объектов превысит это значение. Значение также можно задать с помощью переменной среды `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries целое число	Задает количество повторных попыток подключения, прежде чем соединение будет признано работоспособным Значение также можно задать с помощью переменной среды `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password строка	Указывает пароль для аутентификации при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_PASSWORD`.
silent_ssl_warnings логическое значение	Вставьте описание здесь Варианты: `false` `true` ← (по умолчанию)
username строка	Задает имя пользователя для аутентификации при подключении к удаленному экземпляру NIOS. Значение также можно задать с помощью переменной среды `INFOBLOX_USERNAME`.
validate_certs псевдонимы: ssl_verify логическое значение	Логическое значение, позволяющее включить или отключить проверку SSL-сертификатов Значение также можно задать с помощью переменной среды `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version строка	Указывает версию WAPI, которую следует использовать Значение также можно задать с помощью переменной среды `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4 По умолчанию: `"2.12.3"`
state строка	Задает требуемое состояние экземпляра объекта на сервере NIOS. Если задано значение `present`, объект настраивается на устройстве; если задано значение `absent`, объект удаляется с устройства (при необходимости). Варианты: `"present"` ← (по умолчанию) `"absent"`
ttl целое число	Задает TTL для этой записи узла.
view псевдонимы: dns_view строка	Задает DNS-представление, с которым связывается эта запись. DNS-представление должно быть предварительно настроено в системе. По умолчанию: `"default"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Модуль необходимо выполнять локально; для этого можно указать connection: local.
Подробные сведения об использовании Infoblox с Ansible см. в руководстве :ref:`nios_guide`.

Примеры

- name: Configure an MX record
  infoblox.nios_modules.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
  infoblox.nios_modules.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: Update name of MX Record
  infoblox.nios_modules.nios_mx_record:
    name: {old_name: ansible.com, new_name: newAnsible.com}
    mx: mailhost.ansible.com
    preference: 0
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove an MX record from the system
  infoblox.nios_modules.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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/infoblox/nios_modules/nios_mx_record_module.html