Limites de débit sur l'API des projets

{{< details >}}

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

{{< /details >}}

[!note] Lors de la mise à niveau vers GitLab 18.0 ou 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 savoir quelles limites de débit sont concernées, consultez Rate limitations announced for Projects, Groups, and Users APIs.

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

{{< history >}}

• Disponible de manière générale dans GitLab 16.0. Indicateur de feature flag rate_limit_for_unauthenticated_projects_api_access supprimé.
• 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 de manière générale 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 suivants de l'API des projets :

Limite	Valeur par défaut	Intervalle
GET /projects (requêtes non authentifiées)	400	10 minutes
GET /projects (requêtes authentifiées)	2 000	10 minutes
GET /projects/:id	400	1 minute
GET /users/:user_id/projects	300	1 minute
GET /users/:user_id/contributed_projects	100	1 minute
GET /users/:user_id/starred_projects	100	1 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 Limitations du débit de l'API des projets.
4. Modifiez la valeur d'une 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.

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

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

Pour plus d'informations sur les points de terminaison de l'API des projets, consultez l'API des projets.

Configurer les limites de débit pour la suppression de membres de projet {#configure-rate-limits-on-deleting-project-members}

{{< history >}}

• Introduction dans GitLab 16.9.

{{< /history >}}

Configurez la limite de débit pour chaque projet et utilisateur pour les requêtes vers le point de terminaison de suppression de 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 à chaque projet 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 enregistré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.

Configurer les limites de débit pour le listage des membres de projet {#configure-rate-limits-on-listing-project-members}

{{< history >}}

• Introduit dans GitLab 18.6.

{{< /history >}}

Configurez la limite de débit pour les requêtes vers le point de terminaison de listage des membres du projet.

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 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 Limitations du débit de l'API des projets.
4. Dans la zone de texte Nombre maximum de requêtes vers l'API GET /projects/:id/members/all par minute et 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 à chaque projet et utilisateur.
• Peut être définie sur 0 pour désactiver les limites de débit.

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

Par exemple, si vous définissez une limite de 200, 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.