infoblox.nios_modules.nios_lookup lookup – Запрос объектов Infoblox NIOS

Примечание

Этот плагин поиска является частью коллекции infoblox.nios_modules (версия 1.7.0).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install infoblox.nios_modules. Для использования этого плагина поиска потребуются дополнительные требования. Подробности см. в разделе Требования.

Чтобы использовать его в книге задач, укажите: infoblox.nios_modules.nios_lookup.

Новое в infoblox.nios_modules 1.0.0

Описание
Требования
Термины
Ключевые параметры
Примечания
Примеры
Возвращаемое значение

Описание

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

Требования

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

infoblox-client

Термины

Параметр	Комментарии
Термины строка / обязательно	Имя сетевого объекта, который должен быть возвращен из устройства Infoblox.

Ключевые параметры

Здесь описаны ключевые параметры поиска. Это значения key1=value1, key2=value2 и так далее в следующих примерах: lookup('infoblox.nios_modules.nios_lookup', key1=value1, key2=value2, ...) и query('infoblox.nios_modules.nios_lookup', key1=value1, key2=value2, ...)

Параметр	Комментарии
extattrs словарь	Объект словаря, используемый для фильтрации на основе расширяемых атрибутов.
filter словарь	Объект словаря, используемый для фильтрации возвращаемых объектов.
return_fields список / элементы=строка	Список имен полей для возврата для указанного объекта.

Примечания

Примечание

При совместном использовании ключевых и позиционных параметров позиционные параметры должны быть указаны перед ключевыми параметрами: lookup('infoblox.nios_modules.nios_lookup', term1, term2, key1=value1, key2=value2) и query('infoblox.nios_modules.nios_lookup', term1, term2, key1=value1, key2=value2).

Примеры

- name: fetch all networkview objects
  ansible.builtin.set_fact:
    networkviews: "{{ lookup('infoblox.nios_modules.nios_lookup', 'networkview', provider={'host': 'nios01', 'username': 'admin', 'password': 'password'}) }}"

- name: fetch the default dns view
  ansible.builtin.set_fact:
    dns_views: "{{ lookup('infoblox.nios_modules.nios_lookup', '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
  ansible.builtin.set_fact:
    host_records: "{{ lookup('infoblox.nios_modules.nios_lookup', 'record:host', return_fields=['extattrs', 'name', 'view', 'comment']}) }}"


- name: use env variables to pass credentials
  ansible.builtin.set_fact:
    networkviews: "{{ lookup('infoblox.nios_modules.nios_lookup', 'networkview') }}"

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

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

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

Ключ	Описание
obj_type список / элементы=строка	Тип объекта, указанный в параметре термины Возвращается: всегда
obj_field строка	Одно или несколько полей obj_type, как указано в параметре return_fields, или набор полей по умолчанию в соответствии с типом объекта Возвращается: успех

Подсказка

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

Ссылки на коллекцию

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/infoblox/nios_modules/nios_lookup_lookup.html