Créer une limite de taux d’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, les utilisateurs ayant des rôles spécifiques ou tous les utilisateurs.

Remarque :

Lorsque les demandes atteignent une instance, chaque nœud maintient un nombre de limites 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 Tous > 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 externes pour l’instance.
   Version	Version de l’API REST. Les valeurs répertoriées dépendent de l’API REST sélectionnée.
   Ressource	Ressource de 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 API de table comme API REST.
   Table des jeux d'importation	Table de jeux d’importation que vous souhaitez cibler. Apparaît uniquement lorsque vous sélectionnez 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 limites 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 nombre de demandes est remis à 0 et toutes les violations pour l’heure en cours sont supprimées.
   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.
   Rôle	Rôle auquel la limite de taux s’applique. S’affiche uniquement lorsque vous sélectionnez Utilisateurs ayant 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 à .

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

Que faire ensuite

Après avoir soumis la règle, les Now Platform listes connexes suivantes sont ajoutées à 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 des 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 de l’API REST entrante et les violations.