Documentation
Table of Contents
sla.update
Descripció
object sla.update(object/array slaids)
Aquest mètode permet actualitzar les entrades SLA existents.
Aquest mètode és disponible només per als usuaris de tipus Admin i Super admin. Els permisos per cridar al mètode es poden revocar a la configuració de rols d'usuaris. Per a més informació, veieu Rols d'usuari.
Paràmetres
(object/array) Propietats SLA per actualitzar.
La propietat slaid s'ha d'establir per a cada SLA, totes les altres propietats són opcionals. Només s'actualitzaran les propietats aprovades, totes les altres romandran sense canvis.
A més de les [propietats SLA estàndard] (object#sla), el mètode admet els paràmetres següents.
Paràmetre | Tipus | Descripció |
|-------|------------------------------------------ -------------|------------------------------------- ------------------------------------ -------------- ------------------------------------ -------------- ---------------------------------| | service_tags | array | Etiquetes de servei de SLA que substitueixen les etiquetes actuals.
S'ha d'especificar com a mínim una etiqueta de servei. | | schedule | array | Programació de l'SLA que anul·la la programació actual.
Especificar un paràmetre buit es prendrà com una programació 24/7 i 7 dies a la setmana.| | excluded_downtimes | array | Temps d'inactivitat exclòs de l'SLA que substitueix l'actual.|
Valors de retorn
(object) Retorna un objecte contingut als IDs dels SLAs actualitzats sota la propietat slaids.
Exemples
Actualitzar les etiquetes de servei
Fer que es calculi a intervals mensuals l'SLA amb ID "5", per als serveis vinculats a NoSQL, sense modificar la seva programació ni excloure els temps d'aturada; establir l'SLO a 95%.
Petició:
{
"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
}Resposta:
Canviar la planificació d'un SLA
Canviar l'SLA amb ID "5" cap a una programació 24x7.
Petició:
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"slaid": "5",
"schedule": []
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Resposta:
Canviar el temps d'aturada exclosos per un SLA
Afegir un temps d'aturada d'actualització de la RAM programat de 4 hores el 6 d'Abril de 2022, tot i conservant (s'ha de definir de nou) una actualització del programari existent previst per al 4 de Juliol per l'SLA amb ID "5".
Petició:
{
"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
}Resposta:
Font
CSla::update() in ui/include/classes/api/services/CSla.php.