zabbix_host_info – Сбор информации о хосте Zabbix
Новая версия в 2.7.
Обзор
- Этот модуль позволяет искать записи о хостах Zabbix.
- Этот модуль назывался
zabbix_host_factsдо Ansible 2.9. Использование не изменилось.
Псевдонимы: zabbix_host_facts
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| exact_match boolean |
| Найти точное совпадение |
| host_inventory список / элементы=строка добавлено в 2.8 | Список ключей инвентаризации хостов для отображения в результате. Вся инвентаризация хостов извлекается, если ключи не указаны. | |
| host_ip список / элементы=строка | IP-адрес интерфейса хоста в Zabbix. Требуется, когда host_name не используется. | |
| host_name строка | Имя хоста в Zabbix. host_name является уникальным идентификатором и не может быть обновлен с помощью этого модуля. Требуется, когда host_ip не используется. | |
| http_login_password строка | Пароль базовой аутентификации | |
| http_login_user строка / требуется | Логин базовой аутентификации | |
| 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 не будут проверены. Это следует использовать только на контролируемых вами сайтах, использующих самозаверяющие сертификаты. |
Примечания
Примечание
- Если вы используете login_password=zabbix, слово «zabbix» заменяется на «****» во всех выходных данных модуля, так как login_password использует
no_log. См. данный вопрос-ответ для получения дополнительной информации.
Примеры
- name: Get host info
local_action:
module: 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: 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/3.4/manual/api/reference/host/get для списка значений хоста. Пример: [{'available': '1', 'description': '', 'disable_until': '0', 'error': '', 'flags': '0', 'groups': ['1'], 'host': '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.9/modules/zabbix_host_info_module.html
