Richtlinien und Kontingente in Amazon Rekognition

Die folgenden Abschnitte enthalten Richtlinien und Kontingente bei der Verwendung von Amazon Rekognition. Es gibt zwei Arten von Kontingenten. Festgelegte Kontingente, wie die maximale Bildgröße, können nicht geändert werden. Die auf der Seite AWS Service Quotas aufgeführten Standardkontingente können geändert werden, indem Sie das im Abschnitt Standardkontingente beschriebene Verfahren befolgen.

Unterstützte -Regionen

Eine Liste der AWS Regionen, in denen Amazon Rekognition verfügbar ist, finden Sie unter AWS-Regionen und -Endpunkte in der Allgemeinen Amazon Web Services-Referenz.

Festgelegte Kontingente

Im Folgenden finden Sie eine Liste von Limits in Amazon Rekognition, die nicht geändert werden können. Informationen über Limits, die Sie ändern können, wie z. B. Limits für Transaktionen pro Sekunde (TPS), finden Sie unter Standardkontingente.

Die Beschränkungen für Amazon Rekognition Custom Labels finden Sie unter Richtlinien und Kontingente in Amazon Rekognition Custom Labels.

Amazon Rekognition Image

• Die Bildgröße für die Speicherung als Amazon-S3-Objekt ist auf 15 MB begrenzt.

• Die maximale Bildgröße für DetectModerationLabels beträgt 10.000 Pixel sowohl für die Breite als auch für die Höhe.

• Die maximale Bildgröße für DetectLabels beträgt 10.000 Pixel sowohl für die Breite als auch für die Höhe.

• Um erkannt zu werden, darf ein Gesicht nicht kleiner sein als 40 x 40 Pixel in einem Bild mit 1920 x 1080 Pixeln. Bilder mit Maßen über 1920 x 1080 Pixeln benötigen proportional eine höhere Mindestgröße für das Gesicht.

• Die Mindestbildgröße für Höhe und Breite ist 80 Pixel. Die Mindestbildgröße für DetectProtectiveEquipment für Höhe und Breite ist 64 Pixel.

• Die maximale Bildgröße für DetectProtectiveEquipment beträgt 4.096 Pixel sowohl für die Breite als auch für die Höhe.

• Um von DetectProtectiveEquipment erkannt zu werden, darf eine Person nicht kleiner als 100x100 Pixel in einem Bild mit 800x1300 sein. Bilder mit Maßen über 800x1300 Pixeln benötigen proportional eine höhere Mindestgröße für die Person.

• Die maximale Bildgröße für unformatierte Bytes, die als Parameter an eine API übermittelt werden, ist 5 MB. Das Limit für die DetectProtectiveEquipment-API beträgt 4 MB.

• Amazon Rekognition unterstützt die Bildformate PNG und JPEG. Genauer gesagt: Die Bilder, die Sie als Eingabe für verschiedene API-Operationen wie DetectLabels und IndexFaces bereitstellen, müssen in einem der unterstützten Formate vorliegen.

• Die maximale Anzahl von Gesichtsvektoren, die Sie in einer einzelnen Gesichtersammlung speichern können, ist 20 Millionen.

• Die maximale Anzahl von Benutzervektoren, die Sie in einer einzelnen Gesichtssammlung speichern können, beträgt standardmäßig 10 Millionen.

• Die maximale Anzahl an übereinstimmenden Gesichtsvektoren, die die Such-API zurückgibt, ist 4.096.

• Die maximale Anzahl an übereinstimmenden Benutzervektoren, die die Such-API zurückgibt, ist 4.096.

• DetectText kann bis zu 100 Wörter in ein Bild erkennen.

• DetectProtectiveEquipment kann persönliche Schutzausrüstung von bis zu 15 Personen erkennen.

Informationen zu bewährten Methoden für Bilder und den Gesichtsvergleich finden Sie unter Bewährte Methoden für Sensoren, Eingabebilder und Videos.

Massenanalyse von Amazon Rekognition Image

• Amazon Rekognition Image Bulk Analysis kann Bildstapel mit einer Größe von bis zu 10 000 Bildern analysieren.

• Amazon Rekognition Image Bulk Analysis unterstützt Eingabemanifeste mit einer Größe von bis zu 50MB.

Gespeichertes Video von Amazon Rekognition Video

• Amazon Rekognition Video kann gespeicherte Videos mit einer Größe von bis zu 10 GB analysieren.

• Amazon Rekognition Video kann gespeicherte Videos von bis zu 6 Stunden Länge analysieren.

• Amazon Rekognition Video unterstützt maximal 20 gleichzeitige Aufträge pro Konto.

• Gespeicherte Videos müssen mit dem H.264-Codec codiert sein. Die unterstützten Dateiformate sind MPEG-4 und MOV.

• Jede Amazon-Rekognition-Video-API, die Audiodaten analysiert, unterstützt nur AAC-Audiocodecs.

• Die Gültigkeitsdauer (Time to Live, TTL) für Paginierungs-Token beträgt 24 Stunden. Paginierungs-Token befinden sich im NextToken-Feld, das von Get-Operationen wie GetLabeldetection zurückgegeben wird.

Streaming-Video von Amazon Rekognition Video

• Ein Kinesis-Video-Eingabestrom kann maximal einem Amazon-Rekognition-Video-Stromprozessor zugeordnet werden.

• Ein Kinesis-Data-Ausgabestrom kann maximal einem Amazon-Rekognition-Video-Stromprozessor zugeordnet werden.

• Der Kinesis-Video-Eingabestrom und der Kinesis-Data-Ausgabestrom können einem Amazon-Rekognition-Video-Stromprozessor zugeordnet werden, jedoch nicht zwischen mehreren Prozessoren geteilt werden.

• Jede Amazon-Rekognition-Video-API, die Audiodaten analysiert, unterstützt nur ACC-Audiocodecs.

Standardkontingente

Eine Liste der Standardkontingente finden Sie unter AWS Service Quotas. Diese Standardlimits können geändert werden. Um eine Erhöhung des Limits zu beantragen, erstellen Sie einen Fall. Ihre aktuellen Kontingentlimits (angewandte Kontingentwerte) finden Sie unter Amazon Rekognition Service Quotas. Um Ihren TPS-Nutzungsverlauf für Amazon-Rekognition-Image-APIs einzusehen, besuchen Sie die Seite Amazon Rekognition Service Quotas und wählen Sie eine bestimmten API-Operation aus, um den Verlauf für diese Operation zu sehen.

Themen

• Berechnen der TPS-Kontingentänderung
• Bewährte Methoden für TPS-Kontingente
• Erstellen Sie einen Fall, um TPS-Kontingente zu ändern

Berechnen der TPS-Kontingentänderung

Was ist das neue Limit, das Sie beantragen? Transaktionen pro Sekunde (TPS) sind auf dem Höhepunkt einer zu erwartenden Workload am relevantesten. Es ist wichtig, die maximale Anzahl gleichzeitiger API-Aufrufe zu Spitzenzeiten einer Workload und die Antwortzeit (5–15 Sekunden) zu kennen. Bitte beachten Sie, dass mindestens 5 Sekunden erforderlich sind. Nachfolgend finden Sie zwei Beispiele:

• Beispiel 1: Die maximale Anzahl gleichzeitiger Benutzer der Gesichtsauthentifizierung (CompareFaces API), die ich zu Beginn meiner arbeitsreichsten Stunde erwarte, beträgt 1 000. Diese Antworten werden über einen Zeitraum von 10 Sekunden verteilt. Daher ist der erforderliche TPS 100 (1000/10) für die CompareFaces API in meiner relevanten Region.

• Beispiel 2: Die maximale Anzahl gleichzeitiger Objekterkennungs-(DetectLabels API)-Aufrufe, die zu Beginn meiner arbeitsreichsten Stunde erwartet werden, beträgt 250. Diese Antworten werden über einen Zeitraum von 5 Sekunden verteilt. Daher ist der erforderliche TPS 50 (250/5) für die DetectLabels API in meiner relevanten Region.

Bewährte Methoden für TPS-Kontingente

Zu den empfohlenen bewährten Methoden für Transaktionen pro Sekunde (TPS) gehören die Glättung von hohem Datenverkehr, die Konfiguration von Wiederholungsversuchen und die Konfiguration von exponentiellem Backoff und Jitter.

1. Reibungsloser hoher Datenverkehr. Hoher Datenverkehr beeinträchtigt den Durchsatz. Um den maximalen Durchsatz für die zugewiesenen Transaktionen pro Sekunde (TPS) zu erreichen, verwenden Sie eine serverlose Warteschlangenarchitektur oder einen anderen Mechanismus, um den Datenverkehr zu „glätten“, sodass er konsistenter ist. Codebeispiele und Referenzen für die serverlose groß angelegte Bild- und Videoverarbeitung mit Rekognition finden Sie unter Bild- und Videoverarbeitung im großen Maßstab mit Amazon Rekognition.

2. Konfigurieren Sie Wiederholungsversuche. Folgen Sie den Richtlinien unter Fehlerbehandlung, um Wiederholungsversuche für die Fehler zu konfigurieren, die sie zulassen.

3. Konfigurieren Sie exponentielles Backoff und Jitter. Durch die Konfiguration von exponentiellem Backoff und Jitter bei der Konfiguration von Wiederholungsversuchen können Sie den erreichbaren Durchsatz verbessern. Weitere Informationen finden Sie unter Wiederholversuche bei Fehlern und exponentielles Backoff in AWS.

Erstellen Sie einen Fall, um TPS-Kontingente zu ändern

Um einen Fall zu erstellen, gehen Sie zu Fall erstellen und beantworten Sie die folgenden Fragen:

• Haben Sie die Bewährte Methoden für TPS-Kontingente implementiert, um Ihre Datenverkehrsspitzen zu glätten und Wiederholungsversuche, exponentiellen Backoff und Jitter zu konfigurieren?

• Haben Sie die Änderung des TPS-Kontingents berechnet, die Sie benötigen? Falls nicht, siehe Berechnen der TPS-Kontingentänderung.

• Haben Sie Ihre TPS-Nutzungshistorie überprüft, um Ihren künftigen Bedarf genauer vorhersagen zu können? Ihren TPS-Nutzungsverlauf finden Sie auf der Seite Amazon Rekognition Service Quotas.

• Was ist Ihr Anwendungsfall?

• Welche APIs möchten Sie verwenden?

• In welchen Regionen möchten Sie diese APIs verwenden?

• Können Sie die Last auf mehrere Regionen verteilen?

• Wie viele Bilder verarbeiten Sie täglich?

• Wie lange wird dieses Volumen voraussichtlich aufrechterhalten (handelt es sich um einen einmaligen Anstieg oder um einen andauernden Anstieg)?

• Wie werden Sie durch das Standardlimit blockiert? Sehen Sie sich die folgende Ausnahmetabelle an, um zu überprüfen, auf welches Szenario Sie stoßen.

  Fehlercode	Exception	Fehlermeldung	Was bedeutet das?	Kann es erneut getestet werden?
  HTTP-Statuscode 400	ProvisionedThroughputExceededException	Provisioned Rate exceeded.	Zeigt Drosselung an. Sie können eine Anforderung zur Erhöhung des Limits erneut versuchen oder auswerten.	Ja
  HTTP-Statuscode 400	ThrottlingException	Verlangsamung; plötzlicher Anstieg der Anforderungsgeschwindigkeit.	Möglicherweise senden Sie spitzen Datenverkehr und stoßen auf Drosselung. Sie sollten den Datenverkehr flüssiger und konsistenter gestalten. Konfigurieren Sie dann zusätzliche Wiederholungen. Siehe bewährte Methoden.	Ja
  HTTP-Statuscode 5xx	ThrottlingException (HTTP 500)	Service nicht verfügbar	Zeigt an, dass das Backend hochskaliert wird, um die Aktion zu unterstützen. Sie sollten die Anforderung wiederholen.	Ja

  Ein detailliertes Verständnis der Fehlercodes finden Sie unter Fehlerbehandlung.

Anmerkung

Diese Grenzwerte hängen von der Region ab, in der Sie sich befinden. Wenn Sie einen Fall zum Ändern eines Limits erstellen, wirkt sich die von Ihnen angeforderte API-Operation in der Region aus, in der Sie sie anfordern. Andere API-Operationen und Regionen sind nicht betroffen.