Beheben der API-Fehlercodes von Amazon Bedrock - Amazon Bedrock

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:

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, um weitere Unterstützung und Anleitungen zu erhalten, die auf Ihren speziellen Anwendungsfall zugeschnitten sind.

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, um weitere Unterstützung und Anleitungen zu erhalten, die auf Ihren speziellen Anwendungsfall zugeschnitten sind.