Documentation
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. |
| description (required) |
string | Name of the media type. |
| type (required) |
integer | Transport used by the media type. Possible values: 0 - e-mail; 1 - script; 2 - SMS; 3 - Jabber; 100 - Ez Texting. |
| exec_path | string | For script media types exec_path contains the name of the executed script.For Ez Texting exec_path contains the message text limit.Possible text limit values: 0 - USA (160 characters); 1 - Canada (136 characters). Required for script and Ez Texting media types. |
| gsm_modem | string | Serial device name of the GSM modem. Required for SMS media types. |
| passwd | string | Authentication password. Required for Jabber and Ez Texting 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. |
| status | integer | Whether the media type is enabled. Possible values: 0 - (default) enabled; 1 - disabled. |
| username | string | Username or Jabber identifier. Required for Jabber and Ez Texting 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-10 Default value: 3 |
| attempt_interval | string | The interval between retry attempts. Accepts seconds and time unit with suffix. Possible values: 0-60s Default value: 10s |
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, support macros. Supported macros described on 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. |