[comment]: # ({35eb8af0-f5d7e62f})
# sla.create

[comment]: # ({/35eb8af0-f5d7e62f})

[comment]: # ({52bc5931-c44d5a50})
### Description

`object sla.create(object/array SLAs)`

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

::: noteclassic
Cette méthode est disponible uniquement pour les types d'utilisateur *Admin* et *Super admin*.
Les autorisations d'appel de cette méthode peuvent être révoquées dans les paramètres des rôles utilisateur.
Voir [Rôles utilisateur](/manual/web_interface/frontend_sections/users/user_roles) pour plus d'informations.
:::

[comment]: # ({/52bc5931-c44d5a50})

[comment]: # ({bdf1088b-69be5e01})
### Paramètres

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

En plus des [propriétés SLA standard](object#sla), la
méthode accepte les paramètres suivants.

|Paramètre|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|service_tags|array|[Tags de service SLA](/manual/api/reference/sla/object#sla-service-tag) à créer pour le SLA.<br><br>[Comportement du paramètre](/manual/api/reference_commentary#parameter-behavior):<br>- *obligatoire*|
|schedule|array|[Planification SLA](/manual/api/reference/sla/object#sla-schedule) à créer pour le SLA.<br>La spécification d'un paramètre vide sera interprétée comme une planification 24x7.<br>Par défaut : planification 24x7.|
|excluded_downtimes|array|[Périodes d'arrêt exclues du SLA](/manual/api/reference/sla/object#sla-excluded-downtime) à créer pour le SLA.|

[comment]: # ({/bdf1088b-69be5e01})

[comment]: # ({49fa241a-f5eb6cfd})
### 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.

[comment]: # ({/49fa241a-f5eb6cfd})

[comment]: # ({b41637d2-b41637d2})
### Exemples

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({4591adda-fc6bed3c})
#### 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 %.

[comment]: # ({/4591adda-fc6bed3c})

[comment]: # ({ce7393a0-18749288})
[Requête](/manual/api#performing-requests) :

```json
{
    "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 :

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

[comment]: # ({/ce7393a0-18749288})

[comment]: # ({b5a2d850-fda6729e})
### Source

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

[comment]: # ({/b5a2d850-fda6729e})
