---
sourceDocument: Référence de l’API Xanadu
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/fr-FR/xanadu/api-reference

 Release :

    - xanadu

ft:locale :

    - fr-FR

ft:publication_title :

    - Référence de l’API Xanadu

ft:clusterId :

    - crapiref

bundleId :

    - crapiref

workflow :

    - Creator


---

# Créer une limite de taux de l'API REST entrante

# Créer une limite de taux de l'API REST entrante {#ariaid-title1}

* Rversion finale: Xanadu
* 
* Mis à jour 1 août 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes de lecture

Créez des règles de limite de taux pour limiter le nombre de demandes REST API entrantes traitées par heure.

## Avant de commencer

Rôle requis : rate_limit_admin

## Pourquoi et quand exécuter cette tâche

Définissez des limites de taux pour tous les utilisateurs, les utilisateurs ayant des rôles spécifiques ou tous les utilisateurs.  
Remarque :  
Lorsque les demandes atteignent une instance, chaque nœud maintient une limite de taux par utilisateur. Toutes les 30 secondes, le nombre est validé dans la base de données. Par conséquent, une règle de limite de taux peut ne pas prendre effet pendant 30 secondes maximum.

## Procédure

1. Accédez à la ToutServices web du systèmeRESTRègles de limites de taux.
2. Cliquez sur Nouveau et entrez les valeurs de champ suivantes.  
   {#create-REST-API-rate-limits__table_y41_qgq_hdb__entry__2}

   | Champ | Description |
   |:-|:-|
   | Ressource d'API REST | Valeur dérivée des valeurs saisies dans les champs suivants. |
   | Nom | Nom unique de la règle de limite de taux. |
   | API REST | API REST sélectionnée dans la liste de toutes les API REST externes pour l'instance. |
   | Version | Version de REST API. Les valeurs répertoriées dépendent de l'API REST sélectionnée. |
   | Ressource | Ressource pour la version. Les valeurs répertoriées dépendent de la version sélectionnée. |
   | Table | Table que vous souhaitez cibler. S'affiche uniquement lorsque vous sélectionnez l'API de table en tant qu'API REST. |
   | Table des ensembles de données à importer | Table de jeux d'importation que vous souhaitez cibler. Il s'affiche uniquement, vous sélectionnez l'API de jeu d'importation en tant qu'API REST. |
   | Actif | Case à cocher permettant d'indiquer que la règle de limite de taux est active. Les règles de limite de taux sont activées par défaut dès que vous les créez. Vous pouvez désactiver les règles de limite de taux pour arrêter l'application d'une limite de taux ou activer les règles de limite de taux pour reprendre l'application d'une limite de taux. |
   | Limite de demandes par heure | Nombre maximal de demandes autorisées par heure. Remarque : Chaque fois que vous mettez à jour la valeur de ce champ, le Now Platform réinitialise le nombre de demandes à 0 et supprime toutes les violations pour l'heure en cours. |
   | Appliquer à | Utilisateurs restreints par cette règle : * Un utilisateur unique applique la limite de taux à un utilisateur spécifique. * Utilisateurs avec rôle applique la limite de taux à tous les utilisateurs ayant un rôle spécifique. * Tous les utilisateurs applique la limite de taux à tous les utilisateurs. {#create-REST-API-rate-limits__ul_rns_vfk_hdb} |
   | Rôle | Rôle auquel la limite de taux s'applique. S'affiche uniquement lorsque vous sélectionnez Utilisateurs avec un rôle dans le champ Appliquer à . |
   | Utilisateur | Utilisateur auquel la limite de taux s'applique. S'affiche uniquement lorsque vous sélectionnez Utilisateur unique dans le champ Appliquer à . |
   [Tableau 1. Formulaire Règle de limite de taux de l'API REST]

   {#create-REST-API-rate-limits__table_y41_qgq_hdb}
3. Cliquez sur Envoyer.  
   La nouvelle limite de taux entre en vigueur.
{#create-REST-API-rate-limits__steps_ywz_44k_hdb}

## Que faire ensuite

Une fois que vous avez soumis la règle, ajoutez Now Platform les listes connexes suivantes à l'enregistrement de règle :

Nombres de limites de taux
:   Répertorie, par utilisateur, le nombre de demandes REST API entrantes affectées par cette règle de limite de taux.

Violations des limites de taux
:   Répertorie, par utilisateur, les violations de cette règle de limite de taux.

Vous pouvez utiliser ces listes connexes pour .[Surveiller le nombre de limites de taux et les violations des limites de taux de l'API REST entrantes](https://servicenow-prod.fluidtopics.net/jXabu160mn94sucdAOjZ8Q "Pour déterminer si vous avez correctement défini une règle de limite de débit, surveillez les nombres et les violations des demandes REST API entrantes qui sont limitées par la règle.")