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 по руководству 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 сложный		всегда	Тип объекта, указанный в аргументе terms
	obj_field -

Статус

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

Авторы

НЕИЗВЕСТНО

Подсказка

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

Подсказка

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

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