community.zabbix.zabbix_hostmacro – Создание/обновление/удаление макросов хостов Zabbix
Примечание
Этот плагин является частью коллекции community.zabbix (версия 1.2.0).
Для его установки используйте: ansible-galaxy collection install community.zabbix.
Для использования в книге задач укажите: community.zabbix.zabbix_hostmacro.
Описание
- управляет макросами хостов Zabbix, может создавать, обновлять или удалять их.
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- python >= 2.6
- zabbix-api >= 0.5.4
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| force логическое |
| Обновляет существующий макрос только в том случае, если задано yes. |
| host_name строка / обязательный | Имя хоста. | |
| http_login_password строка | Пароль для аутентификации Basic Auth | |
| http_login_user строка | Логин для аутентификации Basic Auth | |
| login_password строка / обязательный | Пароль пользователя Zabbix. | |
| login_user строка / обязательный | Имя пользователя Zabbix. | |
| macro_name строка / обязательный | Имя макроса хоста в формате Zabbix {$MACRO} или в простом формате MACRO. | |
| macro_value строка | Значение макроса хоста. Требуется, если state=present. | |
| server_url строка / обязательный | URL сервера Zabbix с протоколом (http или https). url является псевдонимом для server_url.псевдонимы: url | |
| state строка |
| Состояние макроса. В случае present, будет создано, если макрос не существует, или обновлен, если связанные данные отличаются.В случае absent будет удален макрос, если он существует. |
| timeout целое число | По умолчанию: 10 | Таймаут запроса API (секунды). |
| validate_certs логическое |
| Если значение равно False, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, которыми вы контролируете, и на которых используются самозаверенные сертификаты. |
Примечания
Примечание
- Если вы используете login_password=zabbix, слово «zabbix» заменяется на «****» во всем выводе модуля, потому что login_password использует
no_log. Более подробную информацию см. в этом FAQ.
Примеры
- name: Create new host macro or update an existing macro's value
local_action:
module: community.zabbix.zabbix_hostmacro
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
macro_name: EXAMPLE.MACRO
macro_value: Example value
state: present
# Values with curly brackets need to be quoted otherwise they will be interpreted as a dictionary
- name: Create new host macro in Zabbix native format
local_action:
module: community.zabbix.zabbix_hostmacro
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
macro_name: "{$EXAMPLE.MACRO}"
macro_value: Example value
state: present
- name: Delete existing host macro
local_action:
module: community.zabbix.zabbix_hostmacro
server_url: http://monitor.example.com
login_user: username
login_password: password
host_name: ExampleHost
macro_name: "{$EXAMPLE.MACRO}"
state: absent
Авторы
- Cove (@cove)
- Dean Hailin Song (!UNKNOWN)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/zabbix/zabbix_hostmacro_module.html
