zabbix_mediatype – Создание/обновление/удаление типов оповещений Zabbix

Новая версия 2.9.

Описание
Требования
Параметры
Примечания
Примеры
Статус

Описание

Этот модуль позволяет создавать, изменять и удалять типы оповещений Zabbix.

Требования

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

zabbix-api >= 0.5.4

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
attempt_interval целое число	По умолчанию: 10	Интервал между попытками повтора. Возможный диапазон значений: 0-60
gsm_modem строка		Имя последовательного порта GSM-модема. Обязательно, когда type=sms.
http_login_password строка		Пароль для Basic Auth.
http_login_user строка / обязательно		Логин для Basic Auth.
login_password строка / обязательно		Пароль пользователя Zabbix.
login_user строка / обязательно		Имя пользователя Zabbix.
max_attempts целое число	По умолчанию: 3	Максимальное количество попыток отправки оповещения. Возможный диапазон значений: 0-10
max_sessions целое число	По умолчанию: 1	Максимальное количество обрабатываемых оповещений параллельно. Возможная величина равна 1, когда type=sms и 0-100 в противном случае.
message_text_limit строка	Варианты: США Канада	Предел длины текста сообщения. Обязательно, когда type=ez_texting. 160 символов для США и 136 символов для Канады.
name строка / обязательно		Имя типа оповещения.
password строка		Пароль для аутентификации. Обязательно, когда type=jabber или type=ez_texting. Обязательно, когда type=email и smtp_authentication=true.
script_name строка		Имя выполняемого скрипта. Обязательно, когда type=script.
script_params список / элементы=строка		Список параметров скрипта. Обязательно, когда type=script.
server_url строка / обязательно		URL сервера Zabbix, включая протокол (http или https). `url` является псевдонимом для `server_url`. псевдонимы: url
smtp_authentication булево	Варианты: нет ← да	Включить/выключить аутентификацию SMTP с именем пользователя и паролем. Если установлено значение `true`, необходимо указать значения для `username` и `password`.
smtp_email строка		Адрес электронной почты, с которого будут отправляться уведомления. Обязательно, когда type=email.
smtp_helo строка	По умолчанию: "localhost"	SMTP HELO. Обязательно, когда type=email.
smtp_security строка	Варианты: Нет STARTTLS SSL/TLS	Уровень безопасности подключения SMTP.
smtp_server строка	По умолчанию: "localhost"	Хост SMTP сервера. Обязательно, когда type=email.
smtp_server_port целое число	По умолчанию: 25	Порт SMTP сервера. Обязательно, когда type=email.
smtp_verify_host булево	Варианты: нет ← да	Проверка хоста SSL для SMTP. Можно указать при smtp_security=STARTTLS или smtp_security=SSL/TLS
smtp_verify_peer булево	Варианты: нет ← да	Проверка клиента SSL для SMTP. Можно указать при smtp_security=STARTTLS или smtp_security=SSL/TLS
state строка	Варианты: present ← absent	Желаемое состояние типа оповещения. При значении `present`, будет создан тип оповещения, если он не существует, или обновлен, если данные отличаются. При значении `absent`, тип оповещения будет удален, если он существует.
status строка	Варианты: enabled ← disabled	Включен ли тип оповещения.
timeout целое число	По умолчанию: 10	Таймаут запроса к API (секунды).
type строка / обязательно	Варианты: email script sms jabber ez_texting	Тип оповещения.
username строка		Имя пользователя или идентификатор Jabber. Обязательно, когда type=jabber или type=ez_texting. Обязательно, когда type=email и smtp_authentication=true.
validate_certs булево добавлен в 2.5	Варианты: нет да ←	Если установлено значение False, сертификаты SSL не будут проверяться. Это следует использовать только на контролируемых сайтах с самоподписанными сертификатами.

Примечания

Примечание

Если используется login_password=zabbix, слово “zabbix” заменяется на “****” во всех выходных данных модуля, так как login_password использует no_log. Дополнительную информацию можно найти в этом FAQ.

Примеры

- name: 'Create an email mediatype with SMTP authentication'
  zabbix_mediatype:
    name: "Ops email"
    server_url: "http://example.com/zabbix/"
    login_user: Admin
    login_password: "zabbix"
    type: 'email'
    smtp_server: 'example.com'
    smtp_server_port: 2000
    smtp_email: 'ops@example.com'
    smtp_authentication: true
    username: 'smtp_user'
    password: 'smtp_pass'

- name: 'Create a script mediatype'
  zabbix_mediatype:
    name: "my script"
    server_url: "http://example.com/zabbix/"
    login_user: Admin
    login_password: "zabbix"
    type: 'script'
    script_name: 'my_script.py'
    script_params:
      - 'arg1'
      - 'arg2'

- name: 'Create a jabber mediatype'
  zabbix_mediatype:
    name: "My jabber"
    server_url: "http://example.com/zabbix/"
    login_user: Admin
    login_password: "zabbix"
    type: 'jabber'
    username: 'jabber_id'
    password: 'jabber_pass'

- name: 'Create an SMS mediatype'
  zabbix_mediatype:
    name: "My SMS Mediatype"
    server_url: "http://example.com/zabbix/"
    login_user: Admin
    login_password: "zabbix"
    type: 'sms'
    gsm_modem: '/dev/ttyS0'

Статус

Этот модуль не гарантирует обратной совместимости. [preview]
Этот модуль поддерживается сообществом Ansible. [community]

Авторы

Ruben Tsirunyan (@rubentsirunyan)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.

© 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_mediatype_module.html