nios – Запрос объектов Infoblox NIOS

Новое в версии 2.5.

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

Обзор

Использует API Infoblox WAPI для извлечения указанных объектов NIOS. Этот поиск поддерживает добавление дополнительных ключевых слов для фильтрации возвращаемых данных и указания набора возвращаемых полей.

Требования

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

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
_terms - / обязательно			Имя объекта для возвращения из NIOS
extattrs -			Объект словаря, используемый для фильтрации по extattrs
filter -			Объект словаря, используемый для фильтрации возвращаемых объектов
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
return_fields -			Список имён полей для возвращения для указанного объекта.

Примечания

Примечание

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

Примеры

- name: fetch all networkview objects
  set_fact:
    networkviews: "{{ lookup('nios', 'networkview', provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}"

- name: fetch the default dns view
  set_fact:
    dns_views: "{{ lookup('nios', 'view', filter={'name': 'default'}, provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}"

# all of the examples below use credentials that are  set using env variables
# export INFOBLOX_HOST=nios01
# export INFOBLOX_USERNAME=admin
# export INFOBLOX_PASSWORD=admin

- name: fetch all host records and include extended attributes
  set_fact:
    host_records: "{{ lookup('nios', 'record:host', return_fields=['extattrs', 'name', 'view', 'comment']}) }}"


- name: use env variables to pass credentials
  set_fact:
    networkviews: "{{ lookup('nios', 'networkview') }}"

- name: get a host record
  set_fact:
    host: "{{ lookup('nios', 'record:host', filter={'name': 'hostname.ansible.com'}) }}"

- name: get the authoritative zone from a non default dns view
  set_fact:
    host: "{{ lookup('nios', 'zone_auth', filter={'fqdn': 'ansible.com', 'view': 'ansible-dns'}) }}"

Статус

Данный поиск не гарантирует обратной совместимости интерфейса. [превью]
Этот поиск поддерживается сообществом Ansible. [сообщество]

Авторы

НЕИЗВЕСТНО

Подсказка

Если вы заметите какие-либо проблемы в этом документе, вы можете отредактировать его, чтобы улучшить его.

Подсказка

Записи конфигурации для каждого типа имеют порядок приоритета от низкого к высокому. Например, переменная, расположенная ниже в списке, переопределит переменную, расположенную выше.

© 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/plugins/lookup/nios.html