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'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) 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
(obligatoire)
array Tags de service SLA à créer pour le SLA.
Au moins un tag de service doit être spécifié.
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 : planification24x7.
excluded_downtimes array Temps d'arrêt exclus du SLA à créer pour le SLA.

Valeurs retournées

(object) Retourne un objet contenant les identifiants des SLAs sous la propriété slaids. L'ordre des ID retournés correspond à l'ordre des SLA transmis.

Exemples

Création d'un SLA

Lancer la création d'une entrée SLA  : * pour suivre de la disponibilité des services liés au moteur SQL ; * avec horaire personnalisé tous les jours de la semaine à l'exception de la dernière heure du samedi ; * avec une date effective au dernier jour de l'année 2022 ; * avec 1 heure et 15 minutes d'arrêt planifié à partir de minuit le 4 juillet ; * le calcul du rapport hebdomadaire SLA sera activé ; * le SLO minimum acceptable sera de 99,9995 %.

Requête :

{
           "jsonrpc": "2.0",
           "method": "sla.create",
           "params": [
               {
                   "name": "Database Uptime",
                   "slo": "99.9995",
                   "period": "1",
                   "timezone": "America/Toronto",
                   "description": "Provide excellent uptime for main database engines.",
                   "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": "Software version upgrade rollout",
                           "period_from": "1648760400",
                           "period_to": "1648764900"
                       }
                   ]
               }
           ],
           "auth": "038e1d7b1735c6a5436ee9eae095879e",
           "id": 1
       }

Réponse :

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

Source

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