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

Примечание

Этот плагин входит в коллекцию community.general (версия 2.0.1).

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

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

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

Обзор

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

Требования

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

infoblox_client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
comment строка			Настраивает текстовый комментарий, который будет связан с экземпляром этого объекта. Предоставленная строка будет настроена в экземпляре объекта.
extattrs словарь			Позволяет настроить расширяемые атрибуты для экземпляра объекта. Этот аргумент принимает набор пар «ключ/значение» для настройки.
flags строка			Настраивает поле флагов для этой записи NAPTR. Эти флагоы управляют интерпретацией полей для объекта записи NAPTR. Поддерживаемые значения для поля флагов — "U", "S", "P" и "A".
name строка / обязательно			Указывает полное доменное имя хоста для добавления или удаления из системы
order целое число			Настраивает порядок (0-65535) для этой записи NAPTR. Этот параметр определяет порядок применения правил NAPTR при наличии нескольких правил.
preference целое число			Настраивает приоритет (0-65535) для этой записи NAPTR. Поле приоритета определяет порядок обработки записей NAPTR, когда несколько записей с одинаковым параметром порядка присутствуют.
provider словарь			Объект словаря, содержащий данные подключения.
	host строка		Указывает имя или адрес DNS-хоста для подключения к удаленному экземпляру NIOS WAPI через REST Значение также может быть указано с помощью переменной окружения `INFOBLOX_HOST`.
	http_pool_connections целое число	Значение по умолчанию: 10	Количество пулов, которые будут использоваться объектом `infoblox_client.Connector`. Это передаётся как есть в базовый класс `requests.adapters.HTTPAdapter`.
	http_pool_maxsize целое число	Значение по умолчанию: 10	Максимальное количество подключений на пул, которые будут использоваться объектом `infoblox_client.Connector`. Это передаётся как есть в базовый класс `requests.adapters.HTTPAdapter`.
	http_request_timeout целое число	Значение по умолчанию: 10	Количество времени ожидания ответа Значение также может быть указано с помощью переменной окружения `INFOBLOX_HTTP_REQUEST_TIMEOUT`.
	max_results целое число	Значение по умолчанию: 1000	Указывает максимальное количество объектов, которые будут возвращены. Если значение установлено отрицательным, прикладное устройство вернёт ошибку, если количество возвращённых объектов превысит заданное значение. Значение также может быть указано с помощью переменной окружения `INFOBLOX_MAX_RESULTS`.
	max_retries целое число	Значение по умолчанию: 3	Настраивает количество попыток повтора до объявления подключения пригодным к использованию Значение также может быть указано с помощью переменной окружения `INFOBLOX_MAX_RETRIES`.
	password строка		Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS. Значение также может быть указано с помощью переменной окружения `INFOBLOX_PASSWORD`.
	silent_ssl_warnings логическое значение	Варианты: нет да ←	Отключить предупреждения SSL `urllib3` в объекте `infoblox_client.Connector`. Это передаётся как есть в базовый класс `requests.adapters.HTTPAdapter`.
	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
regexp строка			Настраивает поле regexp для этой записи NAPTR. Это правило переписывания записи NAPTR, основанное на регулярных выражениях. Это должно быть POSIX-совместимое регулярное выражение, включая правило подстановки и флаги. Обратитесь к RFC 2915 для получения подробной информации о синтаксисе поля.
replacement строка			Настраивает поле replacement для этой записи NAPTR. Для нетерминальных записей NAPTR это поле указывает следующее доменное имя для поиска.
services строка			Настраивает поле services (максимум 128 символов) для этой записи NAPTR. Поле services содержит идентификаторы протоколов и служб, такие как "http+E2U" или "SIPS+D2T".
state строка		Варианты: present ← absent	Настраивает предполагаемое состояние экземпляра объекта на сервере NIOS. Когда это значение установлено в `present`, объект настраивается на устройстве, а когда это значение установлено в `absent`, значение удаляется (при необходимости) с устройства.
ttl целое число			Настраивает TTL, который будет связан с этой записью NAPTR
view строка		Значение по умолчанию: "default"	Устанавливает DNS-представление для ассоциации этой записи. DNS-представление должно быть уже настроено в системе псевдонимы: dns_view

Примечания

Примечание

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

Примеры

- name: Configure a NAPTR record
  community.general.nios_naptr_record:
    name: '*.subscriber-100.ansiblezone.com'
    order: 1000
    preference: 10
    replacement: replacement1.network.ansiblezone.com
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Add a comment to an existing NAPTR record
  community.general.nios_naptr_record:
    name: '*.subscriber-100.ansiblezone.com'
    order: 1000
    preference: 10
    replacement: replacement1.network.ansiblezone.com
    comment: this is a test comment
    state: present
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

- name: Remove a NAPTR record from the system
  community.general.nios_naptr_record:
    name: '*.subscriber-100.ansiblezone.com'
    order: 1000
    preference: 10
    replacement: replacement1.network.ansiblezone.com
    state: absent
    provider:
      host: "{{ inventory_hostname_short }}"
      username: admin
      password: admin
  connection: local

Авторы

Blair Rampling (@brampling)

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