community.zabbix.zabbix_group – Создание/удаление групп хостов Zabbix
Примечание
Этот плагин является частью коллекции community.zabbix (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.zabbix.
Чтобы использовать его в книге задач, укажите: community.zabbix.zabbix_group.
Обзор
- Создаёт группы хостов, если они не существуют.
- Удаляет существующие группы хостов, если они существуют.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| host_groups список / элементы=строка / обязательный | Список групп хостов для создания или удаления. псевдонимы: host_group | |
| http_login_password строка | Пароль аутентификации Basic. | |
| http_login_user строка | Логин аутентификации Basic. | |
| login_password строка / обязательный | Пароль пользователя Zabbix. | |
| login_user строка / обязательный | Имя пользователя Zabbix. | |
| server_url строка / обязательный | URL сервера Zabbix, с протоколом (http или https). url, является псевдонимом для server_url. псевдонимы: url | |
| state строка |
| Создание или удаление группы хостов. |
| timeout целое число | По умолчанию: 10 | Таймаут запроса API (секунды). |
| validate_certs логическое |
| Если установлено в значение False, сертификаты SSL не будут проверяться. Это следует использовать только на контролируемых вами сайтах, использующих самозаверенные сертификаты. |
Примечания
Примечание
- Слишком много одновременных обновлений одной и той же группы могут привести к ошибке возврата Zabbix, см. примеры для обходного решения, если это необходимо.
- Если вы используете login_password=zabbix, слово «zabbix» заменяется на «****» во всех выходных данных модуля, потому что login_password использует
no_log. См. эту страницу FAQ для получения дополнительной информации.
Примеры
# Base create host groups example
- name: Create host groups
local_action:
module: community.zabbix.zabbix_group
server_url: http://monitor.example.com
login_user: username
login_password: password
state: present
host_groups:
- Example group1
- Example group2
# Limit the Zabbix group creations to one host since Zabbix can return an error when doing concurrent updates
- name: Create host groups
local_action:
module: community.zabbix.zabbix_group
server_url: http://monitor.example.com
login_user: username
login_password: password
state: present
host_groups:
- Example group1
- Example group2
when: inventory_hostname==groups['group_name'][0]
Авторы
- Cove (@cove)
- Tony Minfei Ding (!UNKNOWN)
- Harrison Gu (@harrisongu)
© 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_group_module.html
