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

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

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

Обзор

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

Требования

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

infoblox-client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
_terms обязательно			Имя объекта для возврата из NIOS
extattrs			Объект словаря, используемый для фильтрации по extattrs
filter			Объект словаря, используемый для фильтрации возвращаемых объектов
provider			Объект словаря, содержащий данные подключения.
	host обязательно		Указывает имя или адрес хоста DNS для подключения к удаленному экземпляру NIOS WAPI через REST Значение также можно указать с помощью переменной среды `INFOBLOX_HOST`.
	username		Устанавливает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_USERNAME`.
	password		Указывает пароль для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_PASSWORD`.
	ssl_verify bool	Варианты: нет ← да	Булевое значение для включения или отключения проверки сертификатов SSL Значение также можно указать с помощью переменной среды `INFOBLOX_SSL_VERIFY`.
	http_request_timeout	По умолчанию: 10	Время ожидания ответа Значение также можно указать с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`.
	max_retries	По умолчанию: 3	Устанавливает количество попыток повторных подключений перед объявлением подключения работоспособным Значение также можно указать с помощью переменной среды `INFOBLOX_MAX_RETRIES`.
	wapi_version	По умолчанию: 1.4	Указывает используемую версию WAPI Значение также можно указать с помощью переменной среды `INFOBLOX_WAP_VERSION`.
	max_results	По умолчанию: 1000	Указывает максимальное количество возвращаемых объектов. Если значение отрицательное, при превышении количества возвращаемых объектов будет выдано сообщение об ошибке. Значение также можно указать с помощью переменной среды `INFOBLOX_MAX_RESULTS`.
return_fields			Список имен полей для возврата для указанного объекта.

Примечания

Примечание

Этот модуль должен выполняться локально, что можно сделать, указав connection: local.

Примеры

- 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'}) }}"

Значения возврата

Общие значения возврата описаны в этом разделе, следующие поля уникальны для этого поиска:

Ключ		Возвращаемое	Описание
obj_type сложный		всегда	Тип объекта, указанный в аргументе terms
	obj_field

Статус

Автор

НЕИЗВЕСТНО

Подсказка

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

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/plugins/lookup/nios.html