Documentation
Table of Contents
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 %.
{
"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:
Cambiar el cronograma de un SLA
Cambie el SLA con ID "5" a un horario 24x7.
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"slaid": "5",
"schedule": []
},
"id": 1
}Respuesta:
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".
{
"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:
Fuente
CSla::update() en ui/include/classes/api/services/CSla.php.