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

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

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

Обзор

Добавляет и/или удаляет экземпляры объектов записей 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_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
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.

Примеры

- name: configure a NAPTR record
  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
  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
  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

Статус

Этот модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается партнёром 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.9/modules/nios_naptr_record_module.html