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

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

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

Обзор

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

Требования

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

infoblox_client

Параметры

Параметр		Варианты/Значения по умолчанию	Комментарии
_terms обязательно			Имя объекта для возврата из NIOS
extattrs		По умолчанию: Нет	Объект dict, используемый для фильтрации по extattrs
filter		По умолчанию: Нет	Объект dict, используемый для фильтрации возвращаемых объектов
provider		По умолчанию: Нет	Объект dict, содержащий данные подключения.
	username		Устанавливает имя пользователя для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_USERNAME`.
	http_request_timeout	По умолчанию: 10	Время ожидания получения ответа Значение также можно указать с помощью переменной среды `INFOBLOX_HTTP_REQUEST_TIMEOUT`.
	max_retries	По умолчанию: 3	Устанавливает количество попыток повторного подключения перед объявлением соединения работоспособным Значение также можно указать с помощью переменной среды `INFOBLOX_MAX_RETRIES`.
	wapi_version	По умолчанию: 1.4	Указывает версию WAPI для использования Значение также можно указать с помощью переменной среды `INFOBLOX_WAP_VERSION`.
	ssl_verify	По умолчанию: нет	Булево значение для включения или отключения проверки сертификатов SSL Значение также можно указать с помощью переменной среды `INFOBLOX_SSL_VERIFY`.
	max_results	По умолчанию: 1000	Указывает максимальное количество объектов для возврата; если значение отрицательное, при превышении установленного лимита возврата приложение выдаст ошибку. Значение также можно указать с помощью переменной среды `INFOBLOX_MAX_RESULTS`.
	host обязательно		Указывает имя хоста DNS или адрес для подключения к удалённому экземпляру NIOS WAPI по протоколу REST Значение также можно указать с помощью переменной среды `INFOBLOX_HOST`.
	password	По умолчанию: Нет	Указывает пароль для аутентификации подключения к удалённому экземпляру NIOS. Значение также можно указать с помощью переменной среды `INFOBLOX_PASSWORD`.
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.5/plugins/lookup/nios.html