Créer une limite de débit de l’API REST entrante

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, pour les utilisateurs ayant des rôles spécifiques ou pour tous les utilisateurs.

Remarque :

Au fur et à mesure que les demandes atteignent une instance, chaque nœud maintient un nombre de taux limite 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 débit peut ne pas entrer en vigueur pendant 30 secondes maximum.

Procédure

1. Accédez à la Tout > Services web du système > REST > Règles de limites de taux.
2. Cliquez sur Nouveau et entrez les valeurs de champ suivantes.

   Tableau 1. Formulaire Règle de limite de taux d’API REST

   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 orientées vers l’extérieur de 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 comme API REST.
   Table des jeux d'importation	Table des ensembles de données à importer que vous souhaitez cibler. Il vous suffit de sélectionner l’API de jeu d’importation comme API REST.
   Actif	Case à cocher pour 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, réinitialise Now Platform le nombre de demandes à 0 et supprime toutes les violations pour l’heure en cours.
   Appliquer à	Utilisateurs restreints par cette règle : Un seul utilisateur applique la limite de taux à un utilisateur spécifique. Utilisateurs disposant d’un rôle applique la limite de taux à tous les utilisateurs ayant un rôle spécifique. Tous les utilisateurs appliquent la limite de taux à tous les utilisateurs.
   Rôle	Rôle auquel s’applique la limite de taux. S’affiche uniquement lorsque vous sélectionnez Utilisateurs disposant d’un rôle dans le champ Appliquer à .
   Utilisateur	Utilisateur auquel s’applique la limite de taux. S’affiche uniquement lorsque vous sélectionnez Utilisateur unique dans le champ Appliquer à .

3. Cliquez sur Envoyer.
   La nouvelle limite de taux entre en vigueur.

Que faire ensuite

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

Nombres de limites de taux

Répertorie, par utilisateur, le nombre de demandes d’API REST 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 les nombres et les violations des limites de taux de l’API REST entrante.