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 usuario Administrador y Superadministrador. Los permisos para llamar al método se pueden revocar en la configuración del rol de usuario. Ver Roles de usuario para obtener más información.

Parámetros

(objeto/matriz) 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 de 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.
schedule matriz Programación SLA para reemplazar el actual.

Especificar un parámetro como vacío se interpretará como una programación 24x7.
excluded_downtimes matriz Tiempos de inactividad excluidos de SLA para reemplazar los actuales.

Valores de retorno

(objeto) Devuelve un objeto que contiene los ID 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 cambiar su cronograma ni excluir los tiempos de inactividad; establezca 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 horario de un SLA

Cambie el SLA con ID "5" a un horario 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 nuevamente) 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.