sla.create

Description

object sla.create(object/array SLAs)

This method allows to create new SLA objects.

This method is only available to Admin and Super admin user types. Permissions to call the method can be revoked in user role settings. See User roles for more information.

Parameters

(object/array) SLA objects to create.

Additionally to the standard SLA properties, the method accepts the following parameters.

Parameter	Type	Description
service_tags (required)	array	SLA service tags to be created for the SLA. At least one service tag must be specified.
schedule	array	SLA schedule to be created for the SLA. Specifying an empty parameter will be interpreted as a 24x7 schedule. Default: 24x7 schedule.
excluded_downtimes	array	SLA excluded downtimes to be created for the 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 %.

Request:

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

Response:

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

Source

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

Documentation