community.zabbix.zabbix_host_info – Сбор информации о хосте Zabbix

Примечание

Этот плагин входит в коллекцию community.zabbix (версия 1.2.0).

Для его установки используйте: ansible-galaxy collection install community.zabbix.

Для использования в плейбуке укажите: community.zabbix.zabbix_host_info.

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль позволяет искать записи о хостах Zabbix.
Этот модуль назывался zabbix_host_facts до Ansible 2.9. Способ использования не изменился.

Требования

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

python >= 2.6
zabbix-api >= 0.5.4

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
exact_match boolean	Варианты: нет ← да	Найти точное совпадение
host_inventory список / элементы=строка		Список ключей инвентаризации хостов для отображения в результате. Если ключи не указаны, извлекается вся инвентаризация хостов.
host_ip список / элементы=строка		IP-адрес интерфейса хоста в Zabbix. Требуется, когда host_name не используется.
host_name строка		Имя хоста в Zabbix. host_name является уникальным идентификатором и не может быть обновлен с помощью этого модуля. Требуется, когда host_ip не используется.
http_login_password строка		Пароль аутентификации Basic Auth
http_login_user строка		Логин аутентификации Basic Auth
login_password строка / обязательно		Пароль пользователя Zabbix.
login_user строка / обязательно		Имя пользователя Zabbix.
remove_duplicate boolean	Варианты: нет да ←	Удалить дубликаты хостов из результата
server_url строка / обязательно		URL сервера Zabbix, с протоколом (http или https). `url` — псевдоним для `server_url`. псевдонимы: url
timeout целое число	По умолчанию: 10	Таймаут запроса API (секунды).
validate_certs boolean	Варианты: нет да ←	Если установлено в False, сертификаты SSL не будут проверены. Это следует использовать только на управляемых вами сайтах, использующих самозаверенные сертификаты.

Примечания

Примечание

Если вы используете login_password=zabbix, слово «zabbix» заменяется на «****» во всех результатах модуля, потому что login_password использует no_log. Подробнее см. этот FAQ.

Примеры

- name: Get host info
  local_action:
    module: community.zabbix.zabbix_host_info
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    host_ip: 127.0.0.1
    timeout: 10
    exact_match: no
    remove_duplicate: yes

- name: Reduce host inventory information to provided keys
  local_action:
    module: community.zabbix.zabbix_host_info
    server_url: http://monitor.example.com
    login_user: username
    login_password: password
    host_name: ExampleHost
    host_inventory:
      - os
      - tag
    host_ip: 127.0.0.1
    timeout: 10
    exact_match: no
    remove_duplicate: yes

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

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

Ключ	Возвращаемое значение	Описание
hosts словарь	успех	Список хостов Zabbix. См. https://www.zabbix.com/documentation/4.0/manual/api/reference/host/get для списка значений хостов. Пример: [{'...': None, 'available': '1', 'description': '', 'disable_until': '0', 'error': '', 'flags': '0', 'groups': ['1'], 'host': 'Хост A'}]

Авторы

Michael Miko (@RedWhiteMiko)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/zabbix/zabbix_host_info_module.html