This is a translation of the original English documentation page. Help us make it better.

> Adathordozó típusú objektum

A következő objektumok közvetlenül kapcsolódnak a "mediatype" API-hoz.

Media type

The media type object has the following properties.

Property Type Description
mediatypeid string (readonly) ID of the media type.
name
(required)
string Name of the media type.
type
(required)
integer Transport used by the media type.

Possible values:
0 - email;
1 - script;
2 - SMS;
4 - Webhook.
exec_path string For script media types exec_path contains the name of the executed script.

Required for script media types.
gsm_modem string Serial device name of the GSM modem.

Required for SMS media types.
passwd string Authentication password.

Used for email media types.
smtp_email string Email address from which notifications will be sent.

Required for email media types.
smtp_helo string SMTP HELO.

Required for email media types.
smtp_server string SMTP server.

Required for email media types.
smtp_port integer SMTP server port to connect to.
smtp_security integer SMTP connection security level to use.

Possible values:
0 - None;
1 - STARTTLS;
2 - SSL/TLS.
smtp_verify_host integer SSL verify host for SMTP.

Possible values:
0 - No;
1 - Yes.
smtp_verify_peer integer SSL verify peer for SMTP.

Possible values:
0 - No;
1 - Yes.
smtp_authentication integer SMTP authentication method to use.

Possible values:
0 - None;
1 - Normal password.
status integer Whether the media type is enabled.

Possible values:
0 - (default) enabled;
1 - disabled.
username string User name.

Used for email media types.
exec_params string Script parameters.

Each parameter ends with a new line feed.
maxsessions integer The maximum number of alerts that can be processed in parallel.

Possible values for SMS:
1 - (default)

Possible values for other media types:
0-100
maxattempts integer The maximum number of attempts to send an alert.

Possible values:
1-100

Default value:
3
attempt_interval string The interval between retry attempts. Accepts seconds and time unit with suffix.

Possible values:
0-1h

Default value:
10s
content_type integer Message format.

Possible values:
0 - plain text;
1 - (default) html.
script string Media type webhook script javascript body.
timeout string Media type webhook script timeout. Accepts seconds and time unit with suffix.

Possible values:
1-60s

Default value:
30s
process_tags integer Defines should the webhook script response to be interpreted as tags and these tags should be added to associated event.

Possible values:
0 - (default) Ignore webhook script response.
1 - Process webhook script response as tags.
show_event_menu integer Show media type entry in problem.get and event.get property urls.

Possible values:
0 - (default) Do not add urls entry.
1 - Add media type to urls property.
event_menu_url string Define url property of media type entry in urls property of problem.get and event.get.
event_menu_name string Define name property of media type entry in urls property of problem.get and event.get.
parameters array Array of webhook input parameters.
description string Media type description.

Note that for some methods (update, delete) the required/optional parameter combination is different.

Webhook parameters

A webhook-szkriptnek a meghívásakor átadott paraméterek rendelkeznek a következő tulajdonságokkal.

Property Type Description
name
(required)
string Parameter name.
value string Parameter value, support macros. Supported macros described on page.

Script parameters

Parameters passed to a script when it is being called have the following properties.

Property Type Description
sortorder
(required)
integer The order in which the parameters will be passed to the script as command-line arguments. Starting with 0 as the first one.
value string Parameter value, supports macros.
Supported macros are described on the Supported macros page.

Message template

Az üzenetsablon objektum meghatároz egy sablont, amely az alapértelmezett üzenet az értesítés küldéséhez szükséges műveletekhez. Melyben megvan a következő tulajdonságok.

Property Type Description
eventsource
(required)
integer Event source.

Possible values:
0 - triggers;
1 - discovery;
2 - autoregistration;
3 - internal;
4 - services.
recovery
(required)
integer Operation mode.

Possible values:
0 - operations;
1 - recovery operations;
2 - update operations.
subject string Message subject.
message string Message text.