community.zabbix.zabbix_hostmacro – Создание/обновление/удаление макросов хостов Zabbix

Примечание

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

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

Чтобы использовать его в книге задач, укажите: community.zabbix.zabbix_hostmacro.

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

Обзор

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

Требования

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

python >= 2.6
zabbix-api >= 0.5.4

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
force булево	Варианты: no да ←	Обновляет существующий макрос только если установлено значение `yes`.
host_name строка / обязательно		Имя хоста.
http_login_password строка		Пароль аутентификации Basic.
http_login_user строка		Имя пользователя аутентификации Basic.
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	Состояние макроса. В `present`, он создаст макрос, если он не существует, или обновит его, если связанные данные отличаются. В `absent`, он удалит макрос, если он существует.
timeout целое число	По умолчанию: 10	Таймаут запроса API (секунды).
validate_certs булево	Варианты: no да ←	Если значение равно 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/zabbix/zabbix_hostmacro_module.html