Beheben der API-Fehlercodes von Amazon Bedrock
Dieser Abschnitt enthält detaillierte Informationen zu den häufigsten Fehlern, die bei der Verwendung von Amazon-Bedrock-APIs auftreten können, zur Ursache des Fehlers und zu dessen Lösung.
AccessDeniedException
HTTP-Statuscode: 403
Ursache: Sie verfügen nicht über die erforderlichen Berechtigungen, um die angefragte Aktion durchzuführen.
Lösung:
-
Überprüfen Sie, ob Ihr IAM-Benutzer oder Ihre IAM-Rolle über die erforderlichen Berechtigungen für die Aktion verfügt, die Sie versuchen auszuführen.
-
Wenn Sie temporäre Sicherheitsanmeldeinformationen verwenden, stellen Sie sicher, dass diese nicht abgelaufen sind.
FTUFormNotFilled
HTTP-Statuscode: 404
Ursache: Für dieses Konto wurden keine Details zum Modellanwendungsfall übermittelt.
Lösung:
-
Füllen Sie das Formular mit den Details zum Anthropic-Anwendungsfall aus, bevor Sie das Modell verwenden.
IncompleteSignature
HTTP-Statuscode: 400
Ursache: Die Anforderungssignatur entspricht nicht den AWS-Standards.
Lösung:
-
Stellen Sie sicher, dass Sie eine Version des AWS SDK verwenden, die Amazon Bedrock unterstützt.
-
Überprüfen Sie, ob Ihre AWS-Zugriffsschlüssel-ID und der geheime Schlüssel korrekt konfiguriert sind.
-
Wenn Sie Anforderungen manuell signieren, empfehlen wir Ihnen, Ihren Signaturberechnungsprozess noch einmal zu überprüfen.
InternalFailure
HTTP Status Code: 500
Ursache: Die Anforderungsverarbeitung ist aufgrund eines Serverfehlers fehlgeschlagen.
Lösung:
-
Wir empfehlen, den von AWS empfohlenen Ansatz zu verwenden, bei dem Wiederholungsversuche mit exponentiellem Backoff und zufälligem Jitter
eingesetzt werden, um die Zuverlässigkeit zu verbessern. -
Wenn das Problem weiterhin besteht, wenden Sie sich an das AWSSupport Center
und geben Sie Einzelheiten zu Ihrer Anforderung und dem aufgetretenen Fehler an.
InvalidAction
HTTP-Statuscode: 400
Ursache: Die angeforderte Aktion oder Operation ist ungültig.
Lösung:
-
Wir empfehlen, die Schreibweise und Formatierung des Aktionsnamens in Ihrer Anforderung zu überprüfen.
-
Stellen Sie sicher, dass der Aktionsaufruf von Amazon Bedrock unterstützt wird und korrekt dokumentiert ist, wie in der Referenz zur Amazon-Bedrock-API gezeigt.
-
Stellen Sie sicher, dass Sie die aktuelle Version des SDK oder der CLI von AWS verwenden.
InvalidClientTokenId
HTTP-Statuscode: 403
Ursache: Das angegebene X.509-Zertifikat oder die AWS-Zugriffsschlüssel-ID ist nicht in unseren Datensätzen vorhanden.
Lösung:
-
Stellen Sie sicher, dass Sie die richtige AWS-Zugriffsschlüssel-ID verwenden.
-
Wenn Sie kürzlich neue Zugriffsschlüssel erstellt haben, stellen Sie sicher, dass Sie die neuen Anmeldeinformationen und nicht die alten verwenden.
AWS-Marketplace-Vereinbarung innerhalb von 15 Minuten fehlgeschlagen
HTTP-Statuscode: 403
Ursache: Die AWS-Marketplace-Vereinbarung ist aufgrund eines zugrunde liegenden Problems fehlgeschlagen.
Lösung:
-
Überprüfen Sie die Fehlermeldung und beheben Sie das zugrunde liegende Problem. Häufige zugrunde liegende Probleme sind ungültige Zahlungsfehler und eingeschränkte Geolokalisierung.
-
Informationen zu ungültigen Zahlungsfehlern finden Sie unter Einschränkungen für Kredit- und Debitkartenkäufe für AISPL-Kunden, die AWS Marketplace
verwenden, und INVALID_PAYMENT_INSTRUMENT, nachdem Sie den Modellzugriff in Amazon Bedrock angefordert haben .
AWS-Marketplace-Vereinbarung steht nach 15 Minuten noch aus
HTTP-Statuscode: 403
Ursache: Die AWS-Marketplace-Vereinbarung war nicht erfolgreich und es sind 15 Minuten vergangen, seit die Anforderung erfolgt ist.
Lösung:
-
Wiederholen Sie die Anforderung alle 15 Minuten. Wenn das Problem weiterhin besteht, wenden Sie sich an das AWSSupport Center
und geben Sie Einzelheiten zu Ihrer Anforderung und dem aufgetretenen Fehler an.
MPAgreementBeingCreated
HTTP-Statuscode: 403
Ursache: Ihr Konto ist nicht berechtigt, auf dieses Modell zuzugreifen. Ihr AWS-Marketplace-Abonnement für dieses Modell wird noch bearbeitet.
Lösung:
-
Versuchen Sie es nach 15 Minuten erneut.
NotAuthorized
HTTP-Statuscode: 400
Ursache: Sie haben keine Berechtigung zum Ausführen dieser Aktion.
Lösung:
-
Überprüfen Sie Ihre IAM-Berechtigungen und stellen Sie sicher, dass Sie über die erforderlichen Rechte verfügen, um die angeforderte Aktion auf Amazon-Bedrock-Ressourcen durchzuführen.
-
Wenn Sie eine IAM-Rolle verwenden, stellen Sie sicher, dass die Rolle über die entsprechenden Berechtigungen und Vertrauensbeziehungen verfügt.
-
Suchen Sie nach Unternehmensrichtlinien oder SCP, die Ihren Zugriff einschränken könnten.
RequestExpired
HTTP-Statuscode: 400
Ursache: Die Anforderung ist aufgrund abgelaufener Zeitstempel nicht mehr gültig.
Lösung:
-
Stellen Sie sicher, dass Ihre Systemuhr korrekt mit einer zuverlässigen Zeitquelle synchronisiert ist.
-
Wenn Sie Anforderungen aus verschiedenen Zeitzonen senden, achten Sie auf mögliche Abweichungen bei den Zeitstempeln.
ServiceUnavailable
HTTP Status Code: 503
Ursache: Der Service kann die Anforderung vorübergehend nicht bearbeiten. 503-Fehler werden für die reguläre Drosselung verwendet.
Lösung:
-
Wir empfehlen, den von AWS empfohlenen Ansatz zu verwenden, bei dem Wiederholungsversuche mit exponentiellem Backoff und zufälligem Jitter
eingesetzt werden, um die Zuverlässigkeit zu verbessern. -
Falls das Problem in Ihrer aktuellen Region weiterhin besteht, sollten Sie in Erwägung ziehen, zu einer anderen AWS-Region zu wechseln. Verschiedene Regionen können unterschiedliche Auslastungs- und Verfügbarkeitsniveaus aufweisen.
-
Regionsübergreifende Inferenz verwenden ermöglicht es Ihnen, ungeplante Datenverkehrsspitzen problemlos zu bewältigen, indem Sie Rechenressourcen in verschiedenen AWS-Regionen nutzen.
-
Wenn Sie hohe Durchsatzanforderungen haben, empfehlen wir Ihnen, Bereitgestellter Durchsatz für Ihren Anwendungsfall zu untersuchen.
Best Practices
-
Stellen Sie sicher, dass Ihre Anwendung 503-Statuscodes in Ihrer Fehlerbehandlungs- und Wiederholungslogik angemessen verarbeiten kann.
-
Suchen Sie im AWS Service Health Dashboard nach angekündigten Problemen oder geplanten Wartungsarbeiten, die sich auf den Service auswirken könnten.
Wenn Sie häufig auf 503-Fehler stoßen oder diese Ihren Betrieb erheblich beeinträchtigen, wenden Sie sich bitte an den AWS Support
ThrottlingException
HTTP-Statuscode: 429
Ursache: Die Anforderung wurde abgelehnt, da die Kontokontingente für Amazon Bedrock überschritten wurden.
Lösung:
-
Überprüfen Sie die Amazon-Bedrock-Servicekontingente in der Konsole Amazon-Bedrock-Servicekontingente, um mehr über die Ihrem Konto zugewiesenen Limits zu erfahren.
-
Wir empfehlen, den von AWS empfohlenen Ansatz zu verwenden, bei dem Wiederholungsversuche mit exponentiellem Backoff und zufälligem Jitter
eingesetzt werden, um die Zuverlässigkeit zu verbessern. -
Wenn Sie hohe Durchsatzanforderungen haben, empfehlen wir Ihnen, Bereitgestellter Durchsatz für Ihren Anwendungsfall zu untersuchen.
-
Fordern Sie eine Kontingenterhöhung an, indem Sie sich an Ihren Account Manager oder den AWS Support
wenden, falls Ihr Workload-Datenverkehr Ihre Kontokontingente überschreitet.
ValidationError
HTTP-Statuscode: 400
Ursache: Die Eingabe erfüllt nicht die von Amazon Bedrock definierten Einschränkungen.
Lösung:
-
Überprüfen Sie die API-Dokumentation, um sicherzustellen, dass alle erforderlichen Parameter enthalten und korrekt formatiert sind.
-
Vergewissern Sie sich, dass Ihre Eingabewerte innerhalb der zulässigen Bereiche liegen oder den erwarteten Mustern entsprechen.
-
Wir empfehlen, alle spezifischen Validierungsregeln zu beachten, die in der API-Referenz für die von Ihnen verwendete Aktion aufgeführt sind.
ResourceNotFound
HTTP-Statuscode: 404
Ursache: Die angeforderte Ressource wurde nicht gefunden.
Lösung:
-
Überprüfen Sie die Richtigkeit der Modell-ID, des Endpunktnamens oder anderer Ressourcen-IDs in Ihrer Anforderung.
-
Implementieren Sie einen Fallback-Mechanismus, um alternative Modelle oder Endpunkte zu verwenden, wenn keine primäre Ressource gefunden wird.
Best Practices
-
Verwenden Sie ListFoundationModels, um mehr über die verfügbaren Amazon-Bedrock-Basismodelle zu erfahren, die Sie verwenden können.
-
Wir empfehlen, einen regelmäßigen Synchronisierungsprozess zu implementieren, um Ihren lokalen Ressourcenkatalog zu aktualisieren.
Wenn Sie nach dem Ausprobieren dieser Lösungen weiterhin Probleme haben, wenden Sie sich an den AWS Support