zabbix_host_facts – Сбор фактов о хосте Zabbix

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

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

Описание

Этот модуль позволяет искать записи о хостах Zabbix.

Требования

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

python >= 2.6
zabbix-api

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
exact_match boolean	Варианты: нет ← да	Найти точное совпадение
host_inventory список добавлено в 2.8		Список ключей инвентаризации хостов для отображения в результате. Вся инвентаризация хостов извлекается, если ключи не указаны.
host_ip -		IP-адрес интерфейса хоста в Zabbix.
host_name - / требуется		Имя хоста в Zabbix. host_name является уникальным идентификатором и не может быть обновлён с помощью этого модуля.
http_login_password строка добавлено в 2.1		Пароль аутентификации Basic Auth
http_login_user строка / требуется добавлено в 2.1		Логин аутентификации 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 добавлено в 2.5	Варианты: нет да ←	Если установлено в False, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых сайтах с самозаверяющими сертификатами.

Примеры

- name: Get host info
  local_action:
    module: zabbix_host_facts
    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: zabbix_host_facts
    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/3.4/manual/api/reference/host/get для списка значений хоста. Пример: [{'available': '1', 'description': '', 'disable_until': '0', 'error': '', 'flags': '0', 'groups': ['1'], 'host': 'Хост A', '...': None}]

Статус

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

Авторы

Michael Miko (@RedWhiteMiko)

Подсказка

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

© 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/modules/zabbix_host_facts_module.html