Back to Gitlabhq

Limites de débit de l'API des groupes

doc-locale/fr-fr/administration/settings/rate_limit_on_groups_api.md

19.2.08.4 KB
Original Source

{{< details >}}

  • Niveau : Free, Premium, Ultimate
  • Offre : GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

[!note] Lors de la mise à niveau vers GitLab 18.0 ou une version ultérieure, les limites de débit configurables pour cette API sont définies sur 0. Les administrateurs peuvent ajuster les limites de débit selon leurs besoins. Pour obtenir des informations sur les limites de débit concernées, consultez Rate limitations announced for Projects, Groups, and Users APIs.

Configurer les limites de débit de l'API des groupes {#configure-groups-api-rate-limits}

{{< history >}}

  • Introduction de la limite de débit pour l'API des groupes et des projets dans GitLab 17.1 avec un indicateur nommé rate_limit_groups_and_projects_api. Désactivé par défaut.
  • Disponible en général dans GitLab 18.1. Indicateur de feature flag rate_limit_groups_and_projects_api supprimé.

{{< /history >}}

Configurez la limite de débit pour chaque adresse IP et utilisateur pour les requêtes vers les points de terminaison de l'API des groupes suivants :

LimiteValeur par défautIntervalle
GET /groups2001 minute
GET /groups/:id4001 minute
GET /groups/:id/groups/shared01 minute
GET /groups/:id/invited_groups601 minute
GET /groups/:id/projects6001 minute
POST /groups/:id/archive601 minute

Prérequis :

  • Accès administrateur.

Pour modifier la limite de débit :

  1. Dans le coin supérieur droit, sélectionnez Admin.
  2. Dans la barre latérale gauche, sélectionnez Paramètres > Réseau.
  3. Développez Limites de débit de l'API des groupes.
  4. Modifiez la valeur de n'importe quelle limite de débit, ou définissez une limite de débit sur 0 pour la désactiver.
  5. Sélectionnez Sauvegarder les modifications.

Les limites de débit :

  • S'appliquent à chaque utilisateur authentifié. Si les requêtes ne sont pas authentifiées, les limites de débit s'appliquent à l'adresse IP.
  • Peuvent être définies à 0 pour désactiver la limitation de débit.

Les requêtes dépassant la limite de débit sont consignées dans le fichier auth.log.

Par exemple, si vous définissez une limite de 400 pour GET /groups/:id, les requêtes vers le point de terminaison de l'API qui dépassent un débit de 400 par minute sont bloquées. L'accès au point de terminaison est rétabli après une minute.

Limite de débit sur la liste des membres d'un groupe {#rate-limit-on-listing-group-members}

{{< history >}}

{{< /history >}}

Une limite de débit est définie sur le point de terminaison de l'API listant tous les membres du groupe.

Les points de terminaison d'API GET /projects/:id/members/all et GET /groups/:id/members/all partagent la même configuration de limite de débit. Si vous définissez une limite de débit sur le point de terminaison des projets, la limite de débit s'applique également au point de terminaison des groupes.

Prérequis :

  • Accès administrateur.

Pour modifier cette limite de débit pour les deux points de terminaison :

  1. Dans le coin supérieur droit, sélectionnez Admin.
  2. Dans la barre latérale gauche, sélectionnez Paramètres > Réseau.
  3. Développez Limitations du débit de l'API des projets.
  4. Dans la zone de texte Maximum de requêtes vers l'API GET /projects/:id/members/all par minute par utilisateur ou adresse IP, saisissez une valeur.
  5. Sélectionnez Sauvegarder les modifications.

La limite de débit :

  • Par défaut, 200 requêtes par minute.
  • S'applique pour chaque groupe et utilisateur.
  • Est configurée via les paramètres de limitations du débit de l'API des projets. Pour plus d'informations, consultez Configurer les limites de débit sur la liste des membres d'un projet.
  • Peut être définie sur 0 pour désactiver la limite de débit pour les deux points de terminaison.

Les requêtes dépassant la limite de débit sont consignées dans le fichier auth.log.

Par exemple, les requêtes vers le point de terminaison de l'API qui dépassent un débit de 200 requêtes par minute sont bloquées. L'accès au point de terminaison reprend après une minute.

Configurer les limites de débit sur l'archivage et le désarchivage des groupes {#configure-rate-limits-on-group-archiving-and-unarchiving}

{{< details >}}

  • Statut : Expérimentation

{{< /details >}}

{{< history >}}

{{< /history >}}

Configurez une limite de débit sur les requêtes vers les points de terminaison d'archivage de groupe suivants :

plaintext
POST /groups/:id/archive
POST /groups/:id/unarchive

Prérequis :

  • Accès administrateur.

Pour modifier la limite de débit :

  1. Dans le coin supérieur droit, sélectionnez Admin.
  2. Dans la barre latérale gauche, sélectionnez Paramètres > Réseau.
  3. Développez Limites de débit de l'API des groupes.
  4. Dans la zone de texte Maximum de requêtes vers les API POST /groups/:id/archive et POST /groups/:id/unarchive par minute par utilisateur ou adresse IP, saisissez une valeur.
  5. Sélectionnez Sauvegarder les modifications.

La limite de débit :

  • Par défaut, 60 requêtes par minute
  • S'appliquent à chaque utilisateur authentifié. Si les requêtes ne sont pas authentifiées, les limites de débit s'appliquent à l'adresse IP.
  • Peut être définie sur 0 pour désactiver les limites de débit pour les deux points de terminaison

Les requêtes dépassant la limite de débit sont consignées dans le fichier auth.log.

Par exemple, si vous définissez une limite de 60, les requêtes vers le point de terminaison de l'API qui dépassent un débit de 60 requêtes par minute sont bloquées. L'accès au point de terminaison reprend après une minute.

Pour plus d'informations sur les points de terminaison d'archivage de groupe, consultez Archiver un groupe.

Configurer les limites de débit sur la suppression des membres d'un groupe {#configure-rate-limits-on-deleting-group-members}

{{< history >}}

{{< /history >}}

Configurez la limite de débit pour chaque groupe et utilisateur pour les requêtes vers le point de terminaison de suppression des membres.

Prérequis :

  • Accès administrateur.

Pour modifier la limite de débit :

  1. Dans le coin supérieur droit, sélectionnez Admin.
  2. Dans la barre latérale gauche, sélectionnez Paramètres > Réseau.
  3. Développez Members API rate limit.
  4. Dans la zone de texte Maximum de requêtes par minute et par groupe/projet, saisissez une valeur.
  5. Sélectionnez Sauvegarder les modifications.

La limite de débit :

  • Par défaut, 60 requêtes par minute.
  • S'applique pour chaque groupe et utilisateur.
  • Peut être définie sur 0 pour désactiver la limite de débit.

Les requêtes dépassant la limite de débit sont consignées dans le fichier auth.log.

Par exemple, si vous définissez une limite de 60, les requêtes vers le point de terminaison de l'API qui dépassent un débit de 60 requêtes par minute sont bloquées. L'accès au point de terminaison est rétabli après une minute.