Documentation
Table of Contents
sla.update
Description
object sla.update(object/array slaids)
Cette méthode permet de mettre à jour les entrées SLA existantes.
Cette méthode est disponible uniquement pour les types d'utilisateurs Admin et Super admin. Les autorisations d'appeler la méthode peuvent être révoquées dans les paramètres de rôles utilisateur. Voir Rôles Utilisateur pour plus d'informations.
Paramètres
(object/array) Propriétés SLA à mettre à jour.
La propriété slaid doit être définie pour chaque SLA, toutes les autres propriétés sont facultatives. Seules les propriétés transmises seront mises à jour, toutes les autres resteront inchangées.
En plus des propriétés SLA standard, la méthode accepte les paramètres suivants.
| Paramètre | Type | Description |
|---|---|---|
| service_tags | array | Tags de service de SLA en remplacement des tags actuels. Au moins untag de service doit être spécifié. |
| schedule | array | Planification de SLA en remplacement de la planification actuelle. La spécification d'un paramètre vide sera interprétée comme une planification 24h/24 et 7j/7. |
| excluded_downtimes | array | Temps d'arrêt exclus du SLA en remplacement de l'actuel. |
Valeurs retournées
(object) Retourne un objet contenant les identifiants des SLA mis à jour sous la propriété slaids.
Exemples
Mise à jour des tags de service
Faites en sorte que le SLA avec l'ID "5" soit calculé à intervalles mensuels pour les services liés à NoSQL, sans modifier son calendrier ni exclure les temps d'arrêt ; réglez le SLO sur 95 %.
Requête :
{
"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
}Réponse :
Modification de la planification d'un SLA
Basculez le SLA avec l'ID "5" vers un horaire 24x7.
Requête :
{
"jsonrpc": "2.0",
"method": "service.update",
"params": {
"slaid": "5",
"schedule": []
},
"auth": "038e1d7b1735c6a5436ee9eae095879e",
"id": 1
}Réponse :
Modification des temps d'arrêt exclus pour un SLA
Ajoutez un temps d'arrêt de mise à niveau de la RAM planifié de 4 heures le 6 avril 2022, tout en conservant (doit être défini à nouveau) une mise à niveau logicielle existante prévue le 4 juillet pour le SLA avec l'ID "5".
Requête :
{
"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
}Réponse :
Source
CSla::update() dans ui/include/classes/api/services/CSla.php.