Limites et quotas

Suivez ce guide pour comprendre les limites et les quotas lorsque vous utilisez l'API Gestionnaire de données.

Limites des projets

Vous avez besoin d'un projet Google Cloud pour utiliser l'API Data Manager. Le projet Google Cloud fournit le client et les identifiants OAuth que vous utilisez pour authentifier les requêtes d'API.

L'API Data Manager applique des limites de débit à chaque projet Google Cloud, en fonction du service et du type d'opération (lecture ou modification) :

Service Opération Requêtes par jour Requêtes par minute
IngestionService Modification (écriture) 100 000 300
IngestionService Lecture 100 000 300
Tous les autres services combinés Modification (écriture) 50 000 300
Tous les autres services combinés Lecture 50 000 300

Les requêtes qui dépassent les limites sont refusées et renvoient l'erreur RESOURCE_EXHAUSTED et l'état HTTP 429 Too Many Requests.

Vous pouvez prendre le contrôle de votre application et atténuer les limites de débit en réduisant activement le nombre de requêtes et en limitant les requêtes par seconde côté client. Vous pouvez également configurer des alertes de quota et une surveillance dans la console Google Cloud pour recevoir des notifications avant que votre application n'atteigne ses limites.

Noms des quotas

Chaque limite correspond à un nom et à une métrique de limite de quota dans Google Cloud. Lorsqu'une requête dépasse une limite, l'API Data Manager renvoie le nom de la limite de quota dans la charge utile de détails standards ErrorInfo sous metadata.quota_limit :

Nom de la limite de quota Service Opération Fenêtre Limite
IngestionMutateRequestsPerDayPerProject IngestionService Modification Jour 100 000
IngestionMutateRequestsPerMinutePerProject IngestionService Modification Minute 300
IngestionReadRequestsPerDayPerProject IngestionService Lecture Jour 100 000
IngestionReadRequestsPerMinutePerProject IngestionService Lecture Minute 300
ManagementMutateRequestsPerDayPerProject Tous les autres services Modification Jour 50 000
ManagementMutateRequestsPerMinutePerProject Tous les autres services Modification Minute 300
ManagementReadRequestsPerDayPerProject Tous les autres services Lecture Jour 50 000
ManagementReadRequestsPerMinutePerProject Tous les autres services Lecture Minute 300

Inspectez metadata.quota_limit dans la charge utile ErrorInfo pour faire la distinction entre les erreurs de limite quotidienne et par minute, et déterminer s'il faut suspendre temporairement et réessayer avec un délai, ou suspendre jusqu'à ce que le quota quotidien soit réinitialisé. Pour en savoir plus, consultez Erreurs de quota et de limitation du débit.

Limites de requêtes

Voici les limites pour les demandes spécifiques :