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

Примечание

Этот плагин поиска входит в коллекцию infoblox.nios_modules (версия 1.9.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 словарь	Объект dict, используемый для фильтрации по расширяемым атрибутам.
filter словарь	Объект dict, используемый для фильтрации возвращаемых объектов.
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 список / элементы=строка	Тип объекта, указанный в аргументе terms Возвращается: всегда
obj_field строка	Одно или несколько полей obj_type, указанных в аргументе return_fields, либо набор полей по умолчанию для данного типа объекта Возвращается: при успешном выполнении

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

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