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

Примечание

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

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

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

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

Обзор

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

Требования

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

python >= 2.6
zabbix-api >= 0.5.4

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
exact_match boolean	Варианты: нет ← да	Найти точное соответствие
host_inventory list / elements=string		Список ключей инвентаризации хоста для отображения в результате. Если ключи не указаны, вся инвентаризация хоста извлекается.
host_ip list / elements=string		IP-адрес сетевого интерфейса хоста в Zabbix. Требуется, когда host_name не используется.
host_name string		Имя хоста в Zabbix. host_name является уникальным идентификатором и не может быть обновлен с помощью этого модуля. Требуется, когда host_ip не используется.
http_login_password string		Пароль авторизации Basic Auth
http_login_user string		Логин авторизации Basic Auth
login_password string / required		Пароль пользователя Zabbix.
login_user string / required		Имя пользователя Zabbix.
remove_duplicate boolean	Варианты: нет да ←	Удалить дублирующиеся хосты из результата
server_url string / required		URL сервера Zabbix с протоколом (http или https). `url` является псевдонимом для `server_url`. псевдонимы: url
timeout integer	По умолчанию: 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 dictionary	успешно	Список хостов 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/zabbix/zabbix_host_facts_module.html