Amazon Bedrock API エラーコードのトラブルシューティング - Amazon Bedrock

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Amazon Bedrock API エラーコードのトラブルシューティング

このセクションでは、Amazon Bedrock API を使用する際に発生する可能性のある一般的なエラー、エラーの原因、およびエラーを解決するためのソリューションについて詳しく説明します。

AccessDeniedException

HTTP ステータスコード: 403

原因: リクエストされたアクションを実行するための十分なアクセス許可がありません。

解決策:

  • IAM ユーザーまたはロールが、実行しようとしているアクションに必要なアクセス許可を持っていることを確認します。

  • 一時的なセキュリティ認証情報を使用している場合は、有効期限が切れていないことを確認してください。

FTUFormNotFilled

HTTP ステータスコード: 404

原因: このアカウントのモデルユースケースの詳細が送信されていません

解決策:

  • モデルを使用する前に、Anthropic ユースケースの詳細フォームに記入してください。

IncompleteSignature

HTTP ステータスコード: 400

原因: リクエスト署名がAWS標準に準拠していません。

解決策:

  • Amazon Bedrock をサポートする AWSSDK バージョンを使用していることを確認します。

  • AWSアクセスキー ID とシークレットキーが正しく設定されていることを確認します。

  • リクエストに手動で署名する場合は、署名の計算プロセスを再確認することをお勧めします。

InternalFailure

HTTP ステータスコード: 500

原因: サーバーエラーによりリクエスト処理が失敗しました

解決策:

InvalidAction

HTTP ステータスコード: 400

原因: リクエストされたアクション、またはオペレーションは無効です。

解決策:

  • リクエスト内のアクション名のスペルとフォーマットを再確認することをお勧めします。

  • アクションの呼び出しが Amazon Bedrock でサポートされており、Amazon Bedrock API リファレンスで示されているように正しく文書化されていることを確認します。

  • AWSSDK または CLI up-to-dateを使用していることを確認します。

無効なクライアントトークンID

HTTP ステータスコード: 403

原因: 指定された X.509 証明書またはAWSアクセスキー ID がレコードに存在しません。

解決策:

  • 正しいAWSアクセスキー ID を使用していることを確認します。

  • 最近新しいアクセスキーを作成した場合は、古い認証情報ではなく、新しい認証情報を使用していることを確認してください。

AWSMarketplace 契約が 15 分以内に失敗

HTTP ステータスコード: 403

原因: 根本的な問題により AWSMarketplace 契約が失敗しました。

解決策:

AWS15 分後に保留中の Marketplace 契約

HTTP ステータスコード: 403

原因: AWSMarketplace 契約は成功せず、リクエストが作成されてから 15 分が経過しています。

解決策:

  • 15 分ごとにリクエストを再試行します。問題が解決しない場合は、AWS サポートセンターに連絡して、リクエストの詳細と発生しているエラーをお知らせください。

MPAgreementBeingCreated

HTTP ステータスコード: 403

原因: アカウントには、このモデルにアクセスする権限がありません。このモデルの AWSMarketplace サブスクリプションはまだ処理中です

解決策:

  • 15 分後に再試行します

NotAuthorized

HTTP ステータスコード: 400

原因: このアクションを実行するためのアクセス許可がありません。

解決策:

  • IAM アクセス許可を確認し、Amazon Bedrock リソースでリクエストされたアクションを実行するために必要な権限があることを確認します。

  • IAM ロールを使用している場合は、ロールに適切なアクセス許可と信頼関係があることを確認します。

  • アクセスを制限している可能性のある組織ポリシーまたはサービスコントロールポリシーがないか確認します。

RequestExpired

HTTP ステータスコード: 400

原因: タイムスタンプの有効期限が切れたため、リクエストが無効になりました。

解決策:

  • システムクロックが信頼できるタイムソースと正しく同期されていることを確認します。

  • 異なるタイムゾーンからリクエストを行う場合は、タイムスタンプの不一致に注意してください。

ServiceUnavailable

HTTP ステータスコード: 503

原因: サービスは一時的にリクエストを処理できません。503 エラーは通常のスロットリングに使用されます。

解決策:

ベストプラクティス

  • エラー処理と再試行ロジックで、アプリケーションが 503 ステータスコードを適切に処理できることを確認します。

  • Service Health Dashboard で、AWSサービスに影響を与える可能性のある発表された問題やスケジュールされたメンテナンスを確認します。

503 のエラーが頻繁に発生する場合、またはそれが業務に大きな影響を与える場合は、AWS サポートに連絡して、特定のユースケースに合わせたサポートとガイダンスを受けてください。

ThrottlingException

HTTP ステータスコード: 429

原因: Amazon Bedrock のアカウントクォータを超えたため、リクエストが拒否されました。

解決策:

ValidationError

HTTP ステータスコード: 400

原因: 入力が、Amazon Bedrock で指定された制約を満たしていません。

解決策:

  • API ドキュメントを確認して、必要なパラメータがすべて含まれ、正しくフォーマットされていることを確認します。

  • 入力値が許容範囲内にあるか、期待されるパターンに準拠していることを確認します。

  • 使用しているアクションの API リファレンスに記載されている特定の検証ルールに注意を払うことをお勧めします。

ResourceNotFound

HTTP ステータスコード: 404

原因: リクエストされたリソースが見つかりませんでした。

解決策:

  • リクエスト内のモデル ID、エンドポイント名、またはその他のリソース識別子が正しいことを確認します。

  • 主なリソースが見つからない場合は、代替モデルまたはエンドポイントを使用するフォールバックメカニズムを実装してください。

ベストプラクティス

  • ListFoundationModels を使用して、使用可能な Amazon Bedrock 基盤モデルについて確認します。

  • ローカルリソースカタログを更新するには、定期的な同期プロセスの実装をお勧めします。

これらのソリューションを試した後も問題が続く場合は、AWS サポートに連絡し、特定のユースケースに合わせたサポートとガイダンスを受けてください。