sla.create

Description

object sla.create(object/array SLAs)

Cette méthode permet de créer de nouveaux objets SLA.

Cette méthode est disponible uniquement pour les types d’utilisateurs 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. Consultez User roles pour plus d’informations.

Paramètres

(object/array) Objets SLA à créer.

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 à créer pour le SLA.

Comportement du paramètre :
- obligatoire
schedule array Planification SLA à créer pour le SLA.
La spécification d’un paramètre vide sera interprétée comme une planification 24x7.
Par défaut : planification 24x7.
excluded_downtimes array Périodes d’indisponibilité exclues du SLA à créer pour le SLA.

Valeurs de retour

(object) Renvoie un objet contenant les ID des SLA créés dans la propriété slaids. L’ordre des ID renvoyés correspond à l’ordre des SLA transmis.

Exemples

Création d’un SLA

Indiquez de créer une entrée de SLA pour :

  • le suivi de la disponibilité des services liés au moteur SQL ;
  • un calendrier personnalisé couvrant tous les jours ouvrables, à l’exclusion de la dernière heure du samedi ;
  • une date d’effet fixée au dernier jour de l’année 2022 ;
  • un temps d’arrêt planifié d’une durée de 1 heure et 15 minutes, commençant à minuit le 4 juillet ;
  • l’activation du calcul du rapport hebdomadaire du SLA ;
  • un SLO minimum acceptable de 99,9995 %.

Requête :

{
    "jsonrpc": "2.0",
    "method": "sla.create",
    "params": [
        {
            "name": "Database Uptime",
            "slo": "99.9995",
            "period": "1",
            "timezone": "America/Toronto",
            "description": "Assurer une excellente disponibilité pour les principaux moteurs de base de données.",
            "effective_date": 1672444800,
            "status": 1,
            "schedule": [
                {
                    "period_from": 0,
                    "period_to": 601200
                }
            ],
            "service_tags": [
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "mysql"
                },
                {
                    "tag": "database",
                    "operator": "0",
                    "value": "postgresql"
                }
            ],
            "excluded_downtimes": [
                {
                    "name": "Déploiement de la mise à niveau de la version du logiciel",
                    "period_from": "1648760400",
                    "period_to": "1648764900"
                }
            ]
        }
    ],
    "id": 1
}

Réponse :

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

Source

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