Documentation
Table of Contents
> Objeto de 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 | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| mediatypeid | cadena | ID del tipo de medio. Comportamiento de la propiedad: - solo lectura - obligatorio para operaciones de actualizaci¨®n |
| name | cadena | Nombre del tipo de medio. Comportamiento de la propiedad: - obligatorio para operaciones de creaci¨®n |
| type | entero | Transporte utilizado por el tipo de medio. Valores posibles: 0 - Correo electr¨®nico; 1 - Script; 2 - SMS; 4 - Webhook. Comportamiento de la propiedad: - obligatorio para operaciones de creaci¨®n |
| exec_path | cadena | Para los tipos de medios de script, exec_path contiene el nombre del script ejecutado.Comportamiento de la propiedad: - obligatorio si type est¨¢ configurado como "Script" |
| gsm_modem | cadena | Nombre del dispositivo serial del m¨®dem GSM. Comportamiento de la propiedad: - requerido si type est¨¢ configurado en "SMS" |
| passwd | cadena | Contrase?a de autenticaci¨®n. Comportamiento de la propiedad: - compatible si type est¨¢ configurado en "Email" |
| smtp_email | cadena | Direcci¨®n de correo electr¨®nico desde la que se enviar¨¢n las notificaciones. Comportamiento de la propiedad: - requerido si type est¨¢ configurado en "Email" |
| smtp_helo | cadena | SMTP HELO. Comportamiento de la propiedad: - obligatorio si type est¨¢ establecido en "Email" |
| smtp_server | cadena | Servidor SMTP. Comportamiento de la propiedad: - obligatorio si type est¨¢ establecido en "Email" |
| smtp_port | entero | Puerto del servidor SMTP al que conectarse. |
| smtp_security | entero | Nivel de seguridad de la conexi¨®n SMTP a utilizar. Valores posibles: 0 - Ninguno; 1 - STARTTLS; 2 - SSL/TLS. |
| smtp_verify_host | entero | Verificaci¨®n SSL del host para SMTP. Valores posibles: 0 - No; 1 - S¨ª. |
| smtp_verify_peer | entero | Verificaci¨®n SSL del peer para SMTP. Valores posibles: 0 - No; 1 - S¨ª. |
| smtp_authentication | entero | M¨¦todo de autenticaci¨®n SMTP a utilizar. Valores posibles: 0 - Ninguno; 1 - Contrase?a normal. |
| status | entero | Si el tipo de medio est¨¢ habilitado. Valores posibles: 0 - (predeterminado) Habilitado; 1 - Deshabilitado. |
| username | cadena | Nombre de usuario. Comportamiento de la propiedad: - compatible si type est¨¢ configurado en "Correo electr¨®nico" |
| maxsessions | entero | La cantidad m¨¢xima de alertas que se pueden procesar en paralelo. Valores posibles si type est¨¢ configurado en "SMS": (predeterminado) 1.Valores posibles si type est¨¢ configurado en "Correo electr¨®nico", "Script" o "Webhook": 0-100. |
| maxattempts | entero | La cantidad m¨¢xima de intentos para enviar una alerta. Valores posibles: 1-100. Valor predeterminado: 3. |
| attempt_interval | cadena | El intervalo entre los reintentos. Acepta segundos y unidades de tiempo con sufijo. Valores posibles: 0-1 h. Valor predeterminado: 10 s. |
| content_type | entero | Formato del mensaje. Valores posibles: 0 - texto sin formato; 1 - (predeterminado) html. |
| script | texto | Tipo de medio: cuerpo de script de webhook en javascript. |
| timeout | string | Tipo de medio: tiempo de espera de script de webhook. Acepta segundos y unidades de tiempo con sufijo. Valores posibles: 1-60 s. Predeterminado: 30 s. |
| process_tags | integer | Define si la respuesta del script de webhook debe interpretarse como etiquetas y si estas etiquetas deben agregarse al evento asociado. Posibles valores: 0 - (predeterminado) Ignorar la respuesta del script de webhook; 1 - Procesar la respuesta del script de webhook como etiquetas. |
| show_event_menu | entero | Mostrar la entrada de tipo de medio en la propiedad urls de problem.get y event.get.Posibles valores: 0 - (predeterminado) No agregar la entrada urls;1 - Agregar el tipo de medio a la propiedad urls. |
| event_menu_url | cadena | Definir la propiedad url de la entrada de tipo de medio en la propiedad urls de problem.get y event.get. |
| event_menu_name | string | Defina la propiedad name de la entrada de tipo de medio en la propiedad urls de problem.get y event.get. |
| parameters | matriz | Matriz de par¨¢metros de entrada webhook o script. |
| description | texto | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô del tipo de medio. |
Par¨¢metros del webhook
Los par¨¢metros pasados a un script de webhook cuando se llama tienen las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| name | cadena | Nombre del par¨¢metro. Comportamiento de la propiedad: - obligatorio |
| value | cadena | Valor del par¨¢metro, admite macros. Las macros admitidas se describen en la p¨¢gina Macros admitidas. |
Par¨¢metros de secuencia de comandos
Los par¨¢metros pasados a un script cuando se llama tienen las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| sortorder | entero | El orden en el que 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: - obligatorio |
| value | cadena | Valor del par¨¢metro, admite macros. Las macros admitidas se describen en la p¨¢gina Macros admitidas. |
Plantilla de mensaje
El objeto de plantilla de mensaje define una plantilla que se utilizar¨¢ como mensaje predeterminado para operaciones de acci¨®n para enviar una notificaci¨®n. Tiene las siguientes propiedades.
| Propiedad | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| eventsource | entero | Fuente del evento. Valores posibles: 0 - desencadenantes; 1 - descubrimiento; 2 - registro autom¨¢tico; 3 - interno; 4 - servicios. Comportamiento de la propiedad: - obligatorio |
| recovery | entero | Modo de operaci¨®n. Valores posibles: 0 - operaciones; 1 - operaciones de recuperaci¨®n; 2 - operaciones de actualizaci¨®n. [Comportamiento de la propiedad] (/manual/api/reference_commentary#property-behavior): - obligatorio |
| subject | cadena | Asunto del mensaje. |
| message | cadena | Texto del mensaje. |