infoblox.nios_modules.nios_mx_record модуль — Настройка записей MX в Infoblox NIOS

Примечание

Этот модуль является частью коллекции infoblox.nios_modules (версия 1.7.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 string	Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная текстовая строка будет настроена в экземпляре объекта.
extattrs dictionary	Позволяет настраивать расширяемые атрибуты в экземпляре объекта. Этот аргумент принимает набор пар ключ/значение для настройки.
mail_exchanger aliases: mx string / required	Настраивает FQDN почтового обмена для этой записи MX.
name string / required	Указывает полное доменное имя для добавления или удаления из системы. Пользователи также могут обновить имя, так как можно передать словарь, содержащий new_name, old_name. См. примеры.
preference integer / required	Настраивает приоритет (0-65535) для этой записи MX.
provider dictionary	Объект словаря, содержащий данные подключения.
cert string	Указывает файл клиентского сертификата с дайджестом конфигурации x509 для дополнительного уровня безопасного соединения с удаленным экземпляром NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_CERT`.
host string	Указывает имя хоста DNS или адрес для подключения к удаленному экземпляру NIOS WAPI по REST Значение также может быть указано с помощью переменной среды `INFOBLOX_HOST`.
http_pool_connections integer	Вставьте описание сюда По умолчанию: `10`
http_pool_maxsize integer	Вставьте описание сюда По умолчанию: `10`
http_request_timeout integer	Время ожидания получения ответа Значение также может быть указано с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`. По умолчанию: `10`
key string	Указывает файл закрытого ключа для шифрования с сертификатом для подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_KEY`.
max_results integer	Указывает максимальное количество объектов, которые должны быть возвращены; если установлено отрицательное число, устройство вернет ошибку, когда количество возвращенных объектов превысит установку. Значение также может быть указано с помощью переменной среды `INFOBLOX_MAX_RESULTS`. По умолчанию: `1000`
max_retries integer	Настраивает количество попыток повторного подключения перед тем, как соединение будет объявлено работоспособным Значение также может быть указано с помощью переменной среды `INFOBLOX_MAX_RETRIES`. По умолчанию: `3`
password string	Указывает пароль, который будет использоваться для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_PASSWORD`.
silent_ssl_warnings boolean	Вставьте описание сюда Варианты: `false` `true` ← (по умолчанию)
username string	Настраивает имя пользователя, которое будет использоваться для аутентификации подключения к удаленному экземпляру NIOS. Значение также может быть указано с помощью переменной среды `INFOBLOX_USERNAME`.
validate_certs aliases: ssl_verify boolean	Логическое значение для включения или отключения проверки SSL-сертификатов Значение также может быть указано с помощью переменной среды `INFOBLOX_SSL_VERIFY`. Варианты: `false` ← (по умолчанию) `true`
wapi_version string	Указывает версию WAPI для использования Значение также может быть указано с помощью переменной среды `INFOBLOX_WAPI_VERSION`. До Ansible 2.8 версией WAPI по умолчанию была 1.4 По умолчанию: `"2.12.3"`

state string	Настраивает требуемое состояние экземпляра объекта на сервере NIOS. При значении `present`, объект настраивается на устройстве, а при значении `absent` значение удаляется (при необходимости) с устройства. Варианты: `"present"` ← (по умолчанию) `"absent"`
ttl integer	Настраивает TTL, который будет связан с этим записями хоста.
view aliases: dns_view string	Устанавливает DNS-представление, с которым нужно связать эту запись. DNS-представление должно быть уже настроено в системе. По умолчанию: `"default"`

Примечания

Примечание

Этот модуль поддерживает check_mode.
Этот модуль должен выполняться локально, что можно сделать, указав connection: local.
Обратитесь к :ref:`nios_guide`, чтобы получить более подробную информацию о том, как использовать Infoblox с Ansible.

Примеры

- 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–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/infoblox/nios_modules/nios_mx_record_module.html