zabbix_host - Создание/обновление/удаление хостов Zabbix
Новая версия с 2.0.
Описание
- Этот модуль позволяет создавать, изменять и удалять записи хостов Zabbix и связанные данные о группах и шаблонах.
Требования (к хосту, выполняющему модуль)
- python >= 2.6
- zabbix-api
Параметры
| параметр | обязательно | значение по умолчанию | выбор | комментарии |
|---|---|---|---|---|
| force (добавлен в 2.0)
| нет | да |
| Перезаписать конфигурацию хоста, даже если она уже существует |
| host_groups | нет | Список групп хостов, к которым принадлежит хост. | ||
| host_name | да | Имя хоста в Zabbix. host_name является уникальным идентификатором и не может быть обновлен с помощью этого модуля. | ||
| http_login_password (добавлен в 2.1)
| нет | None | Пароль Basic Auth | |
| http_login_user (добавлен в 2.1)
| нет | None | Логин Basic Auth | |
| interfaces | нет | Список интерфейсов, которые нужно создать для хоста (см. пример ниже). Доступные значения: dns, ip, main, port, type и useip. Пожалуйста, ознакомьтесь с документацией по интерфейсам для получения дополнительной информации о поддерживаемых свойствах https://www.zabbix.com/documentation/2.0/manual/appendix/api/hostinterface/definitions#host_interface | ||
| inventory_mode (добавлен в 2.1)
| нет | None |
| Настройка режима инвентаризации. |
| link_templates | нет | None | Список шаблонов, связанных с хостом. | |
| login_password | да | Пароль пользователя Zabbix. | ||
| login_user | да | Имя пользователя Zabbix, используемое для аутентификации на сервере. | ||
| proxy | нет | None | Имя прокси-сервера Zabbix, которое будет использоваться | |
| server_url | да | URL-адрес сервера Zabbix с протоколом (http или https). псевдонимы: url | ||
| state | нет | present |
| Состояние хоста. В present, он будет создан, если хост не существует, или обновлен, если связанные данные отличаются.В absent, будет удален хост, если он существует. |
| status | нет | enabled |
| Статус мониторинга хоста. |
| timeout | нет | 10 | Таймаут запроса API (секунды). | |
| visible_name (добавлен в 2.3)
| нет | Видимое имя хоста в Zabbix. |
Примеры
- name: Create a new host or update an existing host's info
local_action:
module: zabbix_host
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
visible_name: ExampleName
host_groups:
- Example group1
- Example group2
link_templates:
- Example template1
- Example template2
status: enabled
state: present
inventory_mode: automatic
interfaces:
- type: 1
main: 1
useip: 1
ip: 10.xx.xx.xx
dns: ""
port: 10050
- type: 4
main: 1
useip: 1
ip: 10.xx.xx.xx
dns: ""
port: 12345
proxy: a.zabbix.proxy
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Для получения помощи в разработке модулей, если у вас есть такое желание, пожалуйста, прочитайте Информацию о сообществе и участие, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/zabbix_host_module.html
