Table of Contents
> Media type object
The following objects are directly related to the mediatype API.
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 | text | 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 | text | Media type description. |
Note that for some methods (update, delete) the required/optional parameter combination is different.
Webhook parameters
Parameters passed to webhook script when it is called, have the following properties.
| Property | Type | Description |
|---|---|---|
| name (required) |
string | Parameter name. |
| value | string | Parameter value, supports macros. Supported macros are described on the Supported macros page. |
Message template
The message template object defines a template that will be used as a default message for action operations to send a notification. It has the following properties.
| Property | Type | Description |
|---|---|---|
| eventsource (required) |
integer | Event source. Possible values: 0 - triggers; 1 - discovery; 2 - autoregistration; 3 - internal. |
| recovery (required) |
integer | Operation mode. Possible values: 0 - operations; 1 - recovery operations; 2 - update operations. |
| subject | string | Message subject. |
| message | string | Message text. |