sla.update

Descripción

object sla.update(object/array slaids)

Este método permite actualizar las entradas SLA existentes.

Este método solo está disponible para los tipos de usuarios Administrador y Superadministrador. Los permisos para activar el método se pueden revocar en el rol de de ajustes de usuario. Ver User roles para más información.

Parámetros

(object/array) Propiedades del SLA que se actualizarán.

La propiedad slaid debe definirse para cada SLA, todas las demás propiedades son opcionales. Sólo se actualizarán las propiedades pasadas, todas las demás permanecerán sin cambios.

Además de las propiedades estándar del SLA, el método acepta los siguientes parámetros.

Parámetro Tipo Descripción
service_tags matriz etiquetas de servicio SLA para reemplazar las etiquetas de servicio SLA actuales.

Se debe especificar al menos una etiqueta de servicio.
schedule matriz programación de SLA para reemplazar el actual.

Especificar el parámetro como vacío se interpretará como una programación 24x7.
excluded_downtimes matriz tiempo de inactividad excluido de SLA para reemplazar el actual.

Valores de retorno

(object) Devuelve un objeto que contiene los IDs de los SLA actualizados bajo la propiedad slaids.

Ejemplos

Actualización de etiquetas de servicio

Haga que el SLA con ID "5" se calcule a intervalos mensuales para los servicios relacionados con NoSQL sin modificar su horario ni excluir tiempos de inactividad; establezca SLO en 95%.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "sla.update",
           "params": [
               {
                   "slaid": "5",
                   "name": "NoSQL Database engines",
                   "slo": "95",
                   "period": 2,
                   "service_tags": [
                       {
                           "tag": "Database",
                           "operator": "0",
                           "value": "Redis"
                       },
                       {
                           "tag": "Database",
                           "operator": "0",
                           "value": "MongoDB"
                       }
                   ]
               }
           ],
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "slaids": [
                   "5"
               ]
           },
           "id": 1
       }

Cambiando el cronograma de un SLA

Cambie el SLA con ID "5" a un cronograma de 24 horas al día, 7 días a la semana.

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "slaid": "5",
               "schedule": []
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "slaids": [
                   "5"
               ]
           },
           "id": 1
       }

Cambiando los tiempos de inactividad excluidos para un SLA

Agregue un tiempo de inactividad planificado de actualización de RAM de 4 horas de duración el 6 de abril de 2022, manteniendo (debe definirse de nuevo) una actualización de software previamente existente prevista para el 4 de julio para el SLA con ID "5".

Solicitud:

{
           "jsonrpc": "2.0",
           "method": "service.update",
           "params": {
               "slaid": "5",
               "excluded_downtimes": [
                   {
                       "name": "Software version upgrade rollout",
                       "period_from": "1648760400",
                       "period_to": "1648764900"
                   },
                   {
                       "name": "RAM upgrade",
                       "period_from": "1649192400",
                       "period_to": "1649206800"
                   }
               ]
           },
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Respuesta:

{
           "jsonrpc": "2.0",
           "result": {
               "slaids": [
                   "5"
               ]
           },
           "id": 1
       }

Fuente

CSla::update() en ui/include/classes/api/services/CSla.php.