Directives et quotas dans Amazon Rekognition

Les sections suivantes fournissent les consignes et les quotas qui s’appliquent à l’utilisation d’Amazon Rekognition. Il existe deux types de quotas. Les quotas définis tels que la taille maximale de l’image ne peuvent pas être modifiés. Les quotas par défaut répertoriés sur la page Service Quotas AWS peuvent être modifiés en suivant la procédure décrite dans la section Quotas par défaut.

Régions prises en charge

Pour obtenir la liste des AWS régions dans lesquelles Amazon Rekognition est disponible, consultez la section Régions et points de terminaison AWS dans le manuel Amazon Web Services General Reference.

Définition des quotas.

Voici une liste de limitations pour Amazon Rekognition qui ne peuvent pas être modifiées. Pour plus d’informations sur les limites pouvant être modifiées comme les transactions par seconde (TPS), consultez Quotas par défaut.

Pour connaître les limites des étiquettes personnalisées Amazon Rekognition, consultez les directives et quotas dans les étiquettes personnalisées Amazon Rekognition.

Image Amazon Rekognition

• La taille maximale de l’image stockée sous la forme d’un objet Amazon S3 est limitée à 15 Mo.

• La taille maximale de l’image DetectModerationLabels est de 10 000 pixels en largeur et en hauteur.

• La taille maximale de l’image DetectLabels est de 10 000 pixels en largeur et en hauteur.

• Pour qu’un visage soit détecté, sa taille doit être supérieure à 40 x 40 pixels dans une image de 1920 x 1080 pixels. Des images avec des dimensions supérieures à 1920 x 1080 pixels auront besoin d’une taille de visage minimum plus grande proportionnellement.

• La taille d’image minimale est de 80 pixels pour la hauteur et la largeur. La taille d’image minimale de DetectProtectiveEquipment est de 64 pixels pour la hauteur et la largeur.

• La taille maximale de l’image de DetectProtectiveEquipment est de 4 096 pixels en largeur et en hauteur.

• Pour qu’elle soit détectée par DetectProtectiveEquipment, une personne ne doit pas être inférieure à 100x100 pixels dans une image de 800x1 300. Des images avec des dimensions supérieures à 800x1 300 pixels auront besoin d’une taille de personne minimum plus grande proportionnellement.

• La taille maximale des images en tant qu’octets bruts transmis comme paramètre à une API est de 5 Mo. La limite est de 4 Mo pour l’API DetectProtectiveEquipment.

• Amazon Rekognition prend en charge les formats d’image PNG et JPEG. Ainsi, les images que vous fournissez comme entrées des différentes opérations d’API, telles que DetectLabels et IndexFaces, doivent être dans l’un des formats pris en charge.

• Le nombre maximal de vecteurs de visages que vous pouvez stocker dans une même collection de visages est de 20 millions.

• Le nombre maximal de vecteurs d’utilisateurs que vous pouvez stocker dans une même collection de visages est de 10 millions.

• Le nombre maximal de correspondances de vecteurs de visages que l’API de recherche renvoie est 4 096.

• Le nombre maximal de correspondances de vecteurs d’utilisateurs que l’API de recherche renvoie est 4 096.

• DetectText peut détecter jusqu’à 100 mots dans une image.

• DetectProtectiveEquipment peut détecter les équipements de protection individuelle sur un maximum de 15 personnes.

Pour plus d’informations sur les bonnes pratiques en matière d’images et de comparaison faciale, consultez Bonnes pratiques pour les capteurs, images d’entrée et vidéos.

Analyse globale des images Amazon Rekognition

• Amazon Rekognition Image Bulk Analysis peut analyser des lots d'images d'une taille maximale de 10 000 images.

• Amazon Rekognition Image Bulk Analysis prend en charge les manifestes d'entrée d'une taille maximale de 50 Mo.

Vidéo stockée par Vidéo Amazon Rekognition

• Vidéo Amazon Rekognition peut analyser des vidéos stockées d’une taille maximale de 10 Go.

• Vidéo Amazon Rekognition peut analyser des vidéos stockées d’une longueur de 6 heures maximum.

• Vidéo Amazon Rekognition prend en charge au maximum 20 tâches simultanées par compte.

• Les vidéos stockées doivent être encodées à l’aide du codec H.264. Les formats de fichier pris en charge sont MPEG-4 et MOV.

• Toute API Vidéo Amazon Rekognition qui analyse les données audio ne prend en charge que les codecs audio AAC.

• La durée de vie (TTL) pour les jetons de pagination est de 24 heures. Les jetons de pagination sont dans le champ NextToken renvoyé par les opérations Get telles que GetLabeldetection.

Vidéo en streaming Vidéo Amazon Rekognition

• Un flux d’entrée vidéo Kinesis ne peut être associé qu’à un seul processeur de flux Vidéo Amazon Rekognition.

• Un flux de sortie de données Kinesis ne peut être associé qu’à un seul processeur de flux Vidéo Amazon Rekognition.

• Le flux d’entrée vidéo Kinesis et le flux de sortie de données Kinesis associés à un processeur de flux Vidéo Amazon Rekognition ne peuvent pas être partagés par plusieurs processeurs.

• Toute API Vidéo Amazon Rekognition qui analyse les données audio ne prend en charge que les codecs audio ACC.

Quotas par défaut

La liste des quotas par défaut est disponible sur Service Quotas AWS. Ces limites par défaut peuvent être modifiées. Pour demander une augmentation de votre limite, créez une demande. Pour connaître vos limites de quotas actuelles (valeurs de quota appliquées), consultez Amazon Rekognition Service Quotas. Pour consulter l’historique de votre utilisation du TPS pour les API Image Amazon Rekognition, consultez la page Amazon Rekognition Service Quotas et choisissez une opération d’API spécifique pour voir l’historique de cette opération.

Rubriques

• Calculer la modification de quota TPS
• Bonnes pratiques relatives aux quotas TPS
• Créez un dossier pour modifier les quotas TPS

Calculer la modification de quota TPS

Quelle est la nouvelle limite que vous demandez ? Les transactions par seconde (TPS) sont particulièrement pertinentes au pic de charge de travail attendu. Il est important de comprendre le nombre maximal d’appels d’API simultanés au pic d’une charge de travail et le temps de réponse (5 à 15 secondes). Veuillez noter que 5 secondes devraient être le minimum. En voici deux exemples ci-dessous :

• Exemple 1 : Le nombre maximum d'utilisateurs simultanés de l'authentification faciale (CompareFaces API) que j'attends au début de mon heure de pointe est de 1 000. Ces réponses sont réparties sur une période de 10 secondes. Par conséquent, le TPS requis est de 100 (1000/10) pour l' CompareFaces API dans ma région concernée.

• Exemple 2 : Le nombre maximum d'appels de détection d'objets (DetectLabels API) simultanés attendus au début de mon heure de pointe est de 250. Ces réponses sont réparties sur une période de 5 secondes. Par conséquent, le TPS requis est de 50 (250/5) pour l' DetectLabels API dans ma région concernée.

Bonnes pratiques relatives aux quotas TPS

Les bonnes pratiques recommandées pour les transactions par seconde (TPS) incluent la réduction du trafic en pointe, la configuration des nouvelles tentatives et la configuration du backoff exponentiel et de l’instabilité de l'ombre.

1. Circulation fluide et pointue. Les pics de trafic affectent le débit. Pour obtenir un débit maximal pour les transactions allouées par seconde (TPS), utilisez une architecture sans serveur de mise en file d’attente ou un autre mécanisme pour « fluidifier » le trafic afin qu’il soit plus cohérent. Pour obtenir des exemples de code et des références pour le traitement d’images et de vidéos à grande échelle sans serveur avec Rekognition, consultez la section Traitement d’images et de vidéos à grande échelle avec Amazon Rekognition.

2. Configurez de nouvelles tentatives. Suivez les instructions de la section Gestion des erreurs pour configurer des erreurs qui les autorisent.

3. Backoff exponentiel et instabilité de l'ombre. La configuration d’un backoff exponentiel et d’une instabilité de l’ombre lors de la configuration des nouvelles tentatives vous permet d’améliorer le débit réalisable. Consultez la section Rétentatives d'erreur et recul exponentiel. AWS

Créez un dossier pour modifier les quotas TPS

Pour créer un dossier, rendez-vous sur Créer une demande et répondez aux questions suivantes :

• Avez-vous mis en œuvre le Bonnes pratiques relatives aux quotas TPS pour atténuer vos pics de trafic et configurer les nouvelles tentatives, le backoff exponentiel et l’instabilité de l’ombre ?

• Avez-vous calculé le changement de quota TPS dont vous avez besoin ? Si ce n’est pas le cas, voyez Calculer la modification de quota TPS.

• Avez-vous vérifié l’historique de votre utilisation du TPS afin de prévoir avec plus de précision vos besoins futurs ? Pour consulter l’historique de votre utilisation du TPS, consultez la page Amazon Rekognition Service Quotas.

• Quel est votre cas d’utilisation ?

• Quelles API prévoyez-vous d’utiliser ?

• Dans quelles régions prévoyez-vous d’utiliser ces API ?

• Êtes-vous en mesure de répartir la charge sur plusieurs régions ?

• Combien d’images traitez-vous par jour ?

• Combien de temps comptez-vous maintenir ce volume (s’agit-il d’un pic ponctuel ou continu) ?

• Comment êtes-vous bloqué par la limite par défaut ? Consultez le tableau d’exceptions suivant pour confirmer le scénario que vous rencontrez.

  Code d’erreur	Exception	Message	Qu’est-ce que cela signifie ?	Est-il possible de réessayer ?
  Code d’état HTTP 400	ProvisionedThroughputExceededException	Provisioned Rate exceeded.	Indique une limitation. Vous pouvez réessayer ou évaluer une demande d’augmentation de limite.	Oui
  Code d’état HTTP 400	ThrottlingException	Ralentir ; augmentation soudaine du taux de demandes.	Il se peut que vous envoyiez un trafic important et que vous soyez confronté à une limitation. Vous devez façonner le trafic et le rendre plus fluide et plus cohérent. Configurez ensuite des tentatives supplémentaires. Consultez les bonnes pratiques.	Oui
  Code d’état HTTP 5xx	ThrottlingException (HTTP 500)	Service non disponible	Indique que le backend augmente pour prendre en charge l’action. Vous devez réessayer la demande.	Oui

  Pour une compréhension détaillée des codes d’erreur, consultez Gestion des erreurs.

Note

Ces limites dépendent de la région dans laquelle vous vous trouvez. Le fait de présenter un argument en faveur de la modification d’une limite a une incidence sur l’opération d’API que vous demandez, dans la région où vous la demandez. Les autres opérations et régions de l’API ne sont pas affectées.