sla.update

Descripción

object sla.update(object/array slaids)

Este método permite actualizar entradas de SLA existentes.

Este método solo está disponible para los tipos de usuario Admin y Super admin. Los permisos para llamar al método pueden ser revocados en la configuración de roles de usuario. Consulte Roles de usuario para más información.

Parámetros

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

La propiedad slaid debe definirse para cada SLA, todas las demás propiedades son opcionales. Solo 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 array Etiquetas de servicio del SLA para reemplazar las etiquetas de servicio actuales del SLA.
schedule array Calendario del SLA para reemplazar el actual.
Especificar el parámetro como vacío se interpretará como un calendario 24x7.
excluded_downtimes array Tiempos de inactividad excluidos del SLA para reemplazar los actuales.

Valores de retorno

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

Ejemplos

Actualización de etiquetas de servicio

Hacer que el SLA con ID "5" se calcule en intervalos mensuales para servicios relacionados con NoSQL, sin cambiar su programación ni los tiempos de inactividad excluidos; establecer el 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"
                }
            ]
        }
    ],
    "id": 1
}

Respuesta:

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

Cambiar el calendario de un SLA

Cambie el SLA con ID "5" a un calendario 24x7.

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": {
        "slaid": "5",
        "schedule": []
    },
    "id": 1
}

Respuesta:

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

Cambiar los tiempos de inactividad excluidos para un SLA

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

Solicitud:

{
    "jsonrpc": "2.0",
    "method": "sla.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"
            }
        ]
    },
    "id": 1
}

Respuesta:

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

Fuente

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