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`.
	ssl_verify boolean	Варианты: нет ← да	Булево значение для включения или отключения проверки сертификатов SSL Значение также можно указать с помощью переменной среды `INFOBLOX_SSL_VERIFY`.
	username -		Настраивает имя пользователя для аутентификации подключения к удаленному экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_USERNAME`.
	wapi_version -	По умолчанию: 1.4	Указывает версию WAPI для использования Значение также можно указать с помощью переменной среды `INFOBLOX_WAP_VERSION`.
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'}) }}"

Возвращаемые значения

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

Ключ		Возвращаемое	Описание
obj_type complex		всегда	Тип объекта, указанный в аргументе 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.7/plugins/lookup/nios.html