sla.update

Description

object sla.update(object/array slaids)

Cette méthode permet de mettre à jour des entrées de SLA existantes.

Cette méthode est disponible uniquement pour les types d’utilisateur Admin et Super admin. Les autorisations d’appel de la méthode peuvent être révoquées dans les paramètres du rôle utilisateur. Voir User roles pour plus d’informations.

Paramètres

(object/array) Propriétés de 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 Balises de service SLA pour remplacer les balises de service SLA actuelles.
schedule array Planification SLA pour remplacer la planification actuelle.
La spécification du paramètre comme vide sera interprétée comme une planification 24x7.
excluded_downtimes array Périodes d’indisponibilité exclues du SLA pour remplacer celles actuellement définies.

Valeurs de retour

(object) Renvoie un objet contenant les identifiants des SLA mis à jour dans la propriété slaids.

Exemples

Mise à jour des tags de service

Faites en sorte que le SLA avec l’ID « 5 » soit calculé à des intervalles mensuels pour les services liés à NoSQL, sans modifier sa planification ni les temps d’arrêt exclus ; définissez le SLO à 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"
                }
            ]
        }
    ],
    "id": 1
}

Réponse :

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

Modification de la planification d’un SLA

Basculez le SLA avec l’ID « 5 » vers une planification 24x7.

Requête:

{
    "jsonrpc": "2.0",
    "method": "sla.update",
    "params": {
        "slaid": "5",
        "schedule": []
    },
    "id": 1
}

Réponse :

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

Modification des périodes d’indisponibilité exclues pour un SLA

Ajoutez une période d’indisponibilité planifiée de 4 heures pour une mise à niveau de la RAM le 6 avril 2022, tout en conservant (elle doit être redéfinie) une mise à niveau logicielle planifiée existante auparavant le 4 juillet pour le SLA avec l’ID « 5 ».

Requête:

{
    "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
}

Réponse :

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

Source

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