Résolution des codes d'APIerreur Amazon Bedrock

Cette section fournit des informations détaillées sur les erreurs courantes que vous pouvez rencontrer lors de l'utilisation d'Amazon BedrockAPIs, la cause de l'erreur et la solution pour la résoudre.

AccessDeniedException

HTTPCode de statut : 400

Cause : Vous ne disposez pas des autorisations suffisantes pour effectuer l'action demandée

Solution :

• Vérifiez que votre IAM utilisateur ou votre rôle dispose des autorisations nécessaires pour l'action que vous tentez

• Si vous utilisez des informations d'identification de sécurité temporaires, assurez-vous qu'elles n'ont pas expiré

IncompleteSignature

HTTPCode de statut : 400

Cause : La signature de la demande n'est pas conforme aux AWS normes

Solution :

• Assurez-vous d'utiliser une AWS SDK version compatible avec Amazon Bedrock

• Vérifiez que votre identifiant de clé d' AWS accès et votre clé secrète sont correctement configurés

• Si vous signez des demandes manuellement, nous vous suggérons de vérifier votre processus de calcul de signature

InternalFailure

HTTPCode de statut : 500

Cause : Le traitement de la demande a échoué en raison d'une erreur du serveur

Solution :

• Nous suggérons d'utiliser l'approche AWS recommandée consistant à utiliser de nouvelles tentatives avec un recul exponentiel et une instabilité aléatoire pour améliorer la fiabilité.

• Si le problème persiste, veuillez contacter le AWS Support Center et fournir des informations sur votre demande et l'erreur que vous rencontrez.

InvalidAction

HTTPCode de statut : 400

Cause : L'action ou l'opération demandée n'est pas valide

Solution :

• Nous vous suggérons de vérifier l'orthographe et le formatage du nom de l'action dans votre demande

• Vérifiez que l'appel à l'action est pris en charge par Amazon Bedrock et qu'il est correctement documenté, comme indiqué dans Amazon API Bedrock Reference

• Assurez-vous d'utiliser la up-to-date version la plus complète du AWS SDK ou CLI

InvalidClientTokenId

HTTPCode de statut : 403

Cause : Le certificat X.509 ou AWS l'ID de clé d'accès fourni n'existe pas dans nos dossiers

Solution :

• Vérifiez que vous utilisez le bon identifiant de clé AWS d'accès

• Si vous avez récemment créé de nouvelles clés d'accès, assurez-vous d'utiliser les nouvelles informations d'identification et non les anciennes

NotAuthorized

HTTPCode de statut : 400

Cause : Vous n'êtes pas autorisé à effectuer cette action

Solution :

• Vérifiez vos IAM autorisations et assurez-vous que vous disposez des droits nécessaires pour effectuer l'action demandée sur les ressources Amazon Bedrock

• Si vous utilisez un IAM rôle, vérifiez qu'il dispose des autorisations et des relations de confiance appropriées

• Vérifiez les politiques organisationnelles ou les politiques de contrôle des services susceptibles de restreindre votre accès

RequestExpired

HTTPCode de statut : 400

Cause : La demande n'est plus valide en raison de l'expiration des horodatages

Solution :

• Assurez-vous que l'horloge de votre système est correctement synchronisée avec une source de temps fiable

• Si vous faites des demandes depuis des fuseaux horaires différents, soyez conscient des éventuels écarts d'horodatage

ServiceUnavailable

HTTPCode de statut : 503

Cause : Le service est temporairement incapable de traiter la demande

Solution :

• Nous vous suggérons d'utiliser l'approche AWS recommandée consistant à utiliser de nouvelles tentatives avec un recul exponentiel et une instabilité aléatoire pour améliorer la fiabilité

• Envisagez de changer de AWS région si le problème persiste dans votre région actuelle. Les niveaux de charge et de disponibilité peuvent varier d'une région à l'autre

• Utilisez l'inférence entre régions pour gérer de manière fluide les pics de trafic imprévus en utilisant le calcul sur différents Régions AWS

• Si vous avez des exigences de débit élevées, nous vous suggérons d'explorer le débit provisionné pour votre cas d'utilisation

Bonnes pratiques

• Assurez-vous que votre application peut gérer les codes d'état 503 de manière appropriée dans votre logique de gestion des erreurs et de nouvelle tentative

• Consultez le AWS Service Health Dashboard pour tout problème annoncé ou toute maintenance planifiée susceptible d'affecter le service.

Si vous rencontrez fréquemment des erreurs 503 ou si elles ont un impact significatif sur vos opérations, veuillez contacter le AWS Support pour obtenir une assistance supplémentaire et des conseils adaptés à votre cas d'utilisation spécifique

ThrottlingException

HTTPCode de statut : 429

Cause : La demande a été refusée en raison du dépassement des quotas de compte pour Amazon Bedrock

Solution :

• Consultez les quotas de service Amazon Bedrock dans la console AWS Service Quotas pour en savoir plus sur les limites attribuées à votre compte

• Nous vous suggérons d'utiliser l'approche AWS recommandée consistant à utiliser de nouvelles tentatives avec un recul exponentiel et une instabilité aléatoire pour améliorer la fiabilité

• Si vous avez des exigences de débit élevées, nous vous suggérons d'explorer le débit provisionné pour votre cas d'utilisation

• Demandez une augmentation de quota en contactant votre responsable de compte ou le AWS Support si le trafic de votre charge de travail dépasse les quotas de votre compte

ValidationError

HTTPCode de statut : 400

Cause : L'entrée ne répond pas aux contraintes spécifiées par Amazon Bedrock.

Solution :

• Consultez la API documentation pour vous assurer que tous les paramètres requis sont inclus et formatés correctement

• Vérifiez que vos valeurs d'entrée se situent dans les plages autorisées ou qu'elles sont conformes aux modèles attendus

• Nous vous suggérons de prêter attention aux règles de validation spécifiques mentionnées dans la API référence de l'action que vous utilisez

ResourceNotFound

HTTPCode de statut : 404

Cause : La ressource demandée est introuvable

Solution :

• Vérifiez l'exactitude de l'ID du modèle, du nom du point de terminaison ou d'autres identifiants de ressource dans votre demande

• Veuillez implémenter un mécanisme de secours pour utiliser des modèles ou des points de terminaison alternatifs lorsqu'une ressource principale n'est pas trouvée

Bonnes pratiques

• ListFoundationModelsÀ utiliser pour en savoir plus sur les modèles de fondations Amazon Bedrock disponibles que vous pouvez utiliser

• Nous vous suggérons de mettre en œuvre un processus de synchronisation périodique pour mettre à jour votre catalogue de ressources local

Si vous continuez à rencontrer des problèmes après avoir essayé ces solutions, contactez le AWS Support pour obtenir une assistance supplémentaire et des conseils adaptés à votre cas d'utilisation spécifique