Documentation
Table of Contents
mediatype.create
¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô
object mediatype.create(object/array mediaTypes)
Este m¨¦todo permite crear nuevos tipos de medios.
Este m¨¦todo solo est¨¢ disponible para el tipo de usuario Super administrador. Los permisos para llamar al m¨¦todo se pueden revocar en la configuraci¨®n de roles de usuario. Ver Roles de usuario para m¨¢s informaci¨®n.
±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ
(objeto/matriz) Tipos de medios a crear.
Adem¨¢s de las propiedades de tipo de medio est¨¢ndar, el m¨¦todo acepta los siguientes par¨¢metros.
| ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç | Tipo | ¶Ù±ð²õ³¦°ù¾±±è³¦¾±¨®²Ô |
|---|---|---|
| parameters | matriz | ±Ê²¹°ù¨¢³¾±ð³Ù°ù´Ç²õ de webhook que se crear¨¢n para el tipo de medio. |
| message_templates | matriz | Plantillas de mensajes que se crear¨¢n para el tipo de medio. |
Valores de retorno
(objeto) Devuelve un objeto que contiene los ID de los tipos de medios creados bajo la propiedad mediatypeids. El orden de las identificaciones devueltas coincide con el orden de los tipos de medios pasados.
Ejemplos
Creaci¨®n de un tipo de medio de correo electr¨®nico
Cree un nuevo tipo de medio de correo electr¨®nico con un puerto SMTP personalizado y plantillas de mensajes.
Solicitud:
{
"jsonrpc": "2.0",
"method": "mediatype.create",
"params": {
"type": "0",
"name": "E-mail",
"smtp_server": "mail.example.com",
"smtp_helo": "example.com",
"smtp_email": "[email protected]",
"smtp_port": "587",
"content_type": "1",
"message_templates": [
{
"eventsource": "0",
"recovery": "0",
"subject": "Problem: {EVENT.NAME}",
"message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" started at {EVENT.TIME}."
},
{
"eventsource": "0",
"recovery": "1",
"subject": "Resolved in {EVENT.DURATION}: {EVENT.NAME}",
"message": "Problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" has been resolved at {EVENT.RECOVERY.TIME} on {EVENT.RECOVERY.DATE}."
},
{
"eventsource": "0",
"recovery": "2",
"subject": "Updated problem in {EVENT.AGE}: {EVENT.NAME}",
"message": "{USER.FULLNAME} {EVENT.UPDATE.ACTION} problem \"{EVENT.NAME}\" on host \"{HOST.NAME}\" at {EVENT.UPDATE.DATE} {EVENT.UPDATE.TIME}."
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta:
Creando un tipo de medio de secuencia de comandos
Cree un nuevo tipo de medio de secuencia de comandos con un valor personalizado para el n¨²mero de intentos y el intervalo entre ellos.
Solicitud:
{
"jsonrpc": "2.0",
"method": "mediatype.create",
"params": {
"type": "1",
"name": "Push notifications",
"exec_path": "push-notification.sh",
"exec_params": "{ALERT.SENDTO}\n{ALERT.SUBJECT}\n{ALERT.MESSAGE}\n",
"maxattempts": "5",
"attempt_interval": "11s"
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta:
Creando un tipo de medio de webhook
Cree un nuevo tipo de medio de webhook.
Solicitud:
{
"jsonrpc": "2.0",
"method": "mediatype.create",
"params": {
"type": "4",
"name": "Webhook",
"script": "var Webhook = {\r\n token: null,\r\n to: null,\r\n subject: null,\r\n message: null,\r\n\r\n sendMessage: function() {\r\n // some logic\r\n }\r\n}",
"parameters": [
{
"name": "Message",
"value": "{ALERT.MESSAGE}"
},
{
"name": "Subject",
"value": "{ALERT.SUBJECT}"
},
{
"name": "To",
"value": "{ALERT.SENDTO}"
},
{
"name": "Token",
"value": "<Token>"
}
]
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Respuesta:
Fuente
CMediaType::create() en ui/include/classes/api/services/CMediaType.php.