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 cronograma de un SLA

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

Solicitud:

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

Respuesta:

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

Fuente

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