Ce document recense les quotas et limites système qui s'appliquent à Cloud Vision.
- Les quotas spécifient la quantité d'une ressource partagée dénombrable que vous pouvez utiliser. Les quotas sont définis par des services Google Cloud tels que Cloud Vision.
- Les limites système sont des valeurs fixes qui ne peuvent pas être modifiées.
Google Cloud utilise des quotas pour garantir l'équité et réduire les pics d'utilisation et de disponibilité des ressources. Un quota limite la quantité de ressources Google Cloud que votre projet Google Cloud peut utiliser. Les quotas s'appliquent à différents types de ressources, y compris les composants matériels, logiciels et réseau. Par exemple, les quotas peuvent limiter le nombre d'appels d'API à un service, le nombre d'équilibreurs de charge utilisés simultanément par votre projet ou le nombre de projets que vous pouvez créer. Les quotas protègent la communauté des utilisateurs de Google Cloud en empêchant la surcharge des services. Les quotas vous aident également à gérer vos propres ressources Google Cloud.
Le système Cloud Quotas effectue les opérations suivantes :
- Surveille votre consommation de produits et services Google Cloud
- Limite votre consommation de ces ressources
- Permet de demander des modifications de la valeur du quota
Dans la plupart des cas, lorsque vous tentez d'utiliser plus d'une ressource que son quota ne le permet, le système bloque l'accès à la ressource et la tâche que vous essayez d'effectuer échoue.
Les quotas s'appliquent généralement au niveau du projet Google Cloud. Votre utilisation d'une ressource dans un projet n'affecte pas votre quota disponible dans un autre projet. Dans un projet Google Cloud, les quotas sont partagés entre toutes les applications et adresses IP.
Vous allez utiliser la console Google Cloud pour ajuster la plupart des quotas. Pour en savoir plus, consultez la section Demander un ajustement de quota.
Des limites système s'appliquent également aux ressources Vision. Les limites système ne peuvent pas être modifiées.
Types de quotas
Il existe trois types de quotas :
- Quota de requêtes
- Le quota comptabilise chaque requête envoyée au point de terminaison de l'API Vision.
- Quota de fonctionnalités
- Le quota comptabilise chaque image et chaque fichier envoyé au point de terminaison de l'API Vision.
- Sauf indication contraire, un quota qui a comme préfixe un nom de fonctionnalité est généralement un quota de fonctionnalités.
- Quota de traitements
- Le quota comptabilise chaque image et chaque fichier en cours de traitement par l'API Vision, sauf indication contraire explicite.
- Il est reconnaissable par la mention "en cours de traitement" dans son nom.
- Ce quota détermine le nombre maximal d'images ou de pages que l'API Vision traite simultanément pour les méthodes asynchrones. Les utilisateurs peuvent envoyer davantage que ce quota dans les méthodes asynchrones, mais les images ou pages qui dépassent ce quota ne sont pas traitées immédiatement. Les fichiers dépassant le quota sont ajoutés à une file d'attente afin d'être traités ultérieurement.
Voici les quotas d'utilisation actuels de l'API Vision (sous réserve de modification) :
| Quotas de l'API Vision | Type de quota | Valeur |
|---|---|---|
| Requêtes par minute (sauf pour les types de requêtes ci-dessous) | Quota de requêtes | 1 800 |
| Requêtes d'identification de célébrités par minute | Quota de requêtes | zéro |
| Requêtes de détection de thèmes par minute | Quota de fonctionnalités | 1 800 |
| Requêtes de détection de texte par minute | Quota de fonctionnalités | 1 800 |
| Annotation asynchrone d'images* (nombre d'images en cours de traitement) | Quota de traitements | 8 000 |
| Détection asynchrone de documents texte† (nombre de pages en cours de traitement) | Quota de traitements | 10 000 |
| * | Requêtes images:asyncBatchAnnotate |
| † | Requêtes files:asyncBatchAnnotate, fonctionnalité DOCUMENT_TEXT_DETECTION |
| Quota Product Search | Valeur |
|---|---|
| Requêtes par minute (sauf pour les types de requêtes ci-dessous) | 1 800 |
| Requêtes par lot, par jour | 300 |
| Requêtes d'écriture pour la gestion des ressources, par minute | 1 200 |
| Requêtes pour la gestion des ressources, par minute | 2 400 |
Ces limites s'appliquent à tous les projets de la console Google Cloud. Elles sont partagées entre toutes les applications et adresses IP associées à chacun des projets.
Il est possible de définir des quotas inférieurs par utilisateur dans Google Cloud Console.
Augmentation des quotas
Pour modifier les quotas dans la limite des valeurs maximales autorisées, accédez à la page Quotas de Google Cloud Console et sélectionnez Modifier les quotas. Pour demander une augmentation au-delà du quota maximal, modifiez le quota selon l'augmentation souhaitée. Insérez ensuite votre justification pour cette requête, puis envoyez votre mise à jour. Vous recevrez une notification confirmant la réception de votre requête. Vous pouvez être contacté pour fournir des informations supplémentaires. Une fois votre demande examinée, vous serez notifié de son approbation ou de son refus.
Généralement, chaque quota comporte des variantes "par projet et par utilisateur" et "par projet". Veuillez les modifier en fonction de votre configuration.
Lorsque vous demandez une augmentation du quota de fonctionnalités, tenez compte du quota global de requêtes et de la taille du lot prévue afin de respecter la condition suivante :
- Quota global de requêtes (requêtes par minute) * taille de votre lot >= quota de fonctionnalités après augmentation
Si vous ne respectez pas cette exigence, vous serez toujours limité par le quota de requêtes global.
Ce document présente les limites de contenu et les quotas de requêtes actuellement appliqués pour l'API Vision. Il sera mis à jour en cas de modifications de ces restrictions et limites
Limites
Les limites d'utilisation ci-dessous sont appliquées à l'API Vision :
| Limite de contenu | Valeur |
|---|---|
| Taille du fichier image | 20 Mo |
| Taille de l'objet de requête JSON | 10 Mo |
| Taille du fichier PDF | 1 GB |
Nombre d'images par requête images:annotate |
16 |
Nombre d'images par requête images:asyncBatchAnnotate |
2000 |
Pages par requête files:annotate |
5 |
Pages par requête files:asyncBatchAnnotate |
2000 |
Les images encodées en Base64 peuvent dépasser la limite de taille JSON, même si elles sont comprises dans la limite de la taille du fichier image. Les images plus volumineuses doivent être hébergées sur Cloud Storage ou sur une URL accessible publiquement. Notez que la taille de fichier des images encodées en Base64 peut être supérieure à celle du fichier image d'origine (d'environ 37 %, généralement).