Objeto tipo de medio

Los siguientes objetos están directamente relacionados con la API mediatype.

Tipo de medio

El objeto de tipo de medio tiene las siguientes propiedades.

Propiedad Tipo Descripción
mediatypeid ID ID del tipo de medio.

Comportamiento de la propiedad:
- solo lectura
- obligatoria para operaciones de actualización
name string Nombre del tipo de medio.

Comportamiento de la propiedad:
- obligatoria para operaciones de creación
type integer Transporte utilizado por el tipo de medio.

Valores posibles:
0 - Correo electrónico;
1 - Script;
2 - SMS;
4 - Webhook.

Comportamiento de la propiedad:
- obligatoria para operaciones de creación
exec_path string Nombre del archivo de script (por ejemplo, notification.sh) ubicado en el directorio especificado en el parámetro de configuración del server AlertScriptsPath.

Comportamiento de la propiedad:
- obligatoria si type está establecido en "Script"
gsm_modem string Nombre del dispositivo serie del módem GSM.

Comportamiento de la propiedad:
- obligatoria si type está establecido en "SMS"
passwd string Contraseña de autenticación.

Comportamiento de la propiedad:
- compatible si smtp_authentication está establecido en "Contraseña normal"
provider integer Proveedor de correo electrónico.

Valores posibles:
0 - (predeterminado) SMTP genérico;
1 - Gmail;
2 - Retransmisión de Gmail;
3 - Office365;
4 - Retransmisión de Office365.
smtp_email string Dirección de correo electrónico desde la que se enviarán las notificaciones.

Comportamiento de la propiedad:
- obligatoria si type está establecido en "Email"
smtp_helo string HELO de SMTP.

Comportamiento de la propiedad:
- compatible si type está establecido en "Email"
smtp_server string server SMTP.

Comportamiento de la propiedad:
- obligatoria si type está establecido en "Email"
smtp_port integer Puerto del server SMTP al que conectarse.

Predeterminado: 25.

Comportamiento de la propiedad:
- compatible si type está establecido en "Email"
smtp_security integer Nivel de seguridad que se utilizará para la conexión SMTP.

Valores posibles:
0 - (predeterminado) Ninguno;
1 - STARTTLS;
2 - SSL/TLS.

Comportamiento de la propiedad:
- compatible si type está establecido en "Email"
smtp_verify_host integer Verificación SSL del host para SMTP.

Valores posibles:
0 - (predeterminado) No;
1 - Sí.

Comportamiento de la propiedad:
- compatible si smtp_security está establecido en "STARTTLS" o "SSL/TLS"
smtp_verify_peer integer Verificación SSL del par para SMTP.

Valores posibles:
0 - (predeterminado) No;
1 - Sí.

Comportamiento de la propiedad:
- compatible si smtp_security está establecido en "STARTTLS" o "SSL/TLS"
smtp_authentication integer Método de autenticación SMTP que se utilizará.

Valores posibles:
0 - (predeterminado) Ninguno;
1 - Contraseña normal.

Comportamiento de la propiedad:
- compatible si type está establecido en "Email"
status integer Indica si el tipo de medio está habilitado.

Valores posibles:
0 - (predeterminado) Habilitado;
1 - Deshabilitado.
username string Nombre de usuario.

Comportamiento de la propiedad:
- compatible si smtp_authentication está establecido en "Contraseña normal"
maxsessions integer Número máximo de alertas que se pueden procesar en paralelo.

Valores posibles si type está establecido en "SMS": 1.

Valores posibles si type está establecido en "Email", "Script" o "Webhook": 0-100.

Predeterminado: 1.
maxattempts integer Número máximo de intentos para enviar una alerta.

Valores posibles: 1-100.

Predeterminado: 3.
attempt_interval string Intervalo entre los intentos de reenvío.
Acepta un número de segundos (por ejemplo, 1, 60, 300) o un valor con un sufijo de tiempo (por ejemplo, 30s, 1m, 1h).

Valores posibles: 0-1h.

Predeterminado: 10s.
content_type
(deprecated)		 integer Este parámetro está obsoleto; utilice message_format en su lugar.
Formato del mensaje.

Valores posibles:
0 - Texto sin formato;
1 - (predeterminado) HTML.

Comportamiento de la propiedad:
- compatible si type está establecido en "Email"
message_format integer Formato del mensaje.

Valores posibles:
0 - Texto sin formato;
1 - (predeterminado) HTML.

Comportamiento de la propiedad:
- compatible si type está establecido en "Email"
script text Cuerpo del script de Webhook (JavaScript).

Comportamiento de la propiedad:
- obligatoria si type está establecido en "Webhook"
timeout string Tiempo de espera del script de Webhook.
Acepta un número de segundos (por ejemplo, 1, 60) o un valor con un sufijo de tiempo (por ejemplo, 30s, 1m).

Valores posibles: 1-60s.

Predeterminado: 30s.

Comportamiento de la propiedad:
- compatible si type está establecido en "Webhook"
process_tags integer Procesa como etiquetas los valores de las propiedades JSON de la respuesta del script de Webhook. Estas etiquetas se añaden a las etiquetas de problema existentes.

Valores posibles:
0 - (predeterminado) Ignorar la respuesta del script de Webhook;
1 - Procesar la respuesta del script de Webhook como etiquetas.

Comportamiento de la propiedad:
- compatible si type está establecido en "Webhook"
show_event_menu integer Incluye una entrada en el menú de eventos que enlaza con una URL personalizada. También añade la propiedad urls a la salida de problem.get y event.get.

Valores posibles:
0 - (predeterminado) No incluir la entrada del menú de eventos ni la propiedad urls;
1 - Incluir la entrada del menú de eventos y la propiedad urls.

Comportamiento de la propiedad:
- compatible si type está establecido en "Webhook"
event_menu_url string URL utilizada en la entrada del menú de eventos y en la propiedad urls devuelta por problem.get y event.get.

Comportamiento de la propiedad:
- compatible si show_event_menu está establecido en "Incluir la entrada del menú de eventos y la propiedad urls"
event_menu_name string Nombre utilizado para la entrada del menú de eventos y en la propiedad urls devuelta por problem.get y event.get.

Comportamiento de la propiedad:
- compatible si show_event_menu está establecido en "Incluir la entrada del menú de eventos y la propiedad urls"
parameters array Parámetros de Webhook o de script.

Comportamiento de la propiedad:
- compatible si type está establecido en "Webhook" o "Script"
description text Descripción del tipo de medio.

Parámetros de webhook

Los parámetros de webhook tienen las siguientes propiedades.

Propiedad Tipo Descripción
name string Nombre del parámetro.

Comportamiento de la propiedad:
- obligatorio
value string Valor del parámetro, admite macros.
Las macros admitidas se describen en la página Macros admitidas.

Parámetros de script

Los parámetros de script tienen las siguientes propiedades.

Propiedad Tipo Descripción
sortorder integer El orden en el que los valores de los parámetros se pasarán al script como argumentos de línea de comandos, comenzando con 0 como el primero.

Comportamiento de la propiedad:
- requerido
value string Valor del parámetro, admite macros.
Las macros admitidas se describen en la página Macros soportadas.

Plantilla de mensaje

El objeto de plantilla de mensaje define una plantilla que se utilizará como mensaje por defecto para las operaciones de acción para enviar una notificación. Tiene las siguientes propiedades.

Propiedad Tipo Descripción
eventsource integer Fuente del evento.

Valores posibles:
0 - Triggers;
1 - Descubrimiento;
2 - Autoregistro;
3 - Interno;
4 - Servicios.

Comportamiento de la propiedad:
- obligatorio
recovery integer Modo de operación.

Valores posibles:
0 - Operaciones;
1 - Operaciones de recuperación;
2 - Operaciones de actualización.

Comportamiento de la propiedad:
- obligatorio
subject string Asunto del mensaje.
message string Texto del mensaje.