對 Amazon Bedrock API 錯誤碼進行疑難排解 - Amazon Bedrock
AccessDeniedExceptionFTUFormNotFilledIncompleteSignatureInternalFailureInvalidActionInvalidClientTokenIdAWS Marketplace 協議在 15 分鐘內失敗AWS 15 分鐘後待定的 Marketplace 協議MPAgreementBeingCreatedNotAuthorizedRequestExpiredServiceUnavailableThrottlingExceptionValidationErrorResourceNotFound呼叫 Amazon Bedrock APIs 時的連線逾時或重設

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

對 Amazon Bedrock API 錯誤碼進行疑難排解

本節提供有關使用 Amazon Bedrock API 時可能遇到的常見錯誤、錯誤原因及錯誤解決方案的詳細資訊。

AccessDeniedException

HTTP 狀態碼：403

原因：您沒有足夠的許可來執行請求的動作。

解決方案：

  • 確認您的 IAM 使用者或角色具有您正嘗試動作的必要許可。

  • 如果您使用的是臨時安全憑證，請確保其尚未過期。

FTUFormNotFilled

HTTP 狀態碼：404

原因：尚未為此帳戶提交模型使用案例詳細資訊

解決方案：

  • 使用模型之前，請先填寫 Anthropic 使用案例詳細資訊表單

IncompleteSignature

HTTP 狀態碼：400

原因：請求簽章不符合 AWS 標準。

解決方案：

  • 請確定您使用的是支援 Amazon Bedrock 的 AWS SDK 版本。

  • 確認您的 AWS 存取金鑰 ID 和私密金鑰已正確設定。

  • 如果您手動簽署請求，建議您重新檢查簽章計算程序。

InternalFailure

HTTP 狀態碼：500

原因：請求處理因伺服器錯誤而失敗

解決方案：

InvalidAction

HTTP 狀態碼：400

原因：請求的動作或操作無效。

解決方案：

  • 建議您再次檢查請求中動作名稱的拼字和格式。

  • 確認動作呼叫受 Amazon Bedrock 支援，並已依照 Amazon Bedrock API 參考所示正確記錄下來。

  • 請確定您使用的是 SDK up-to-date。 AWS

InvalidClientTokenId

HTTP 狀態碼：403

原因：提供的 X.509 憑證或 AWS 存取金鑰 ID 不存在於我們的記錄中。

解決方案：

  • 確認您使用的是正確的 AWS 存取金鑰 ID。

  • 如果您最近建立了新的存取金鑰，請確定您使用的是新憑證，而不是舊憑證。

AWS Marketplace 協議在 15 分鐘內失敗

HTTP 狀態碼：403

原因： AWS Marketplace 協議因基礎問題而失敗。

解決方案：

AWS 15 分鐘後待定的 Marketplace 協議

HTTP 狀態碼：403

原因： AWS Market Marketplace 協議未成功，且自提出請求以來已經過 15 分鐘。

解決方案：

  • 每 15 分鐘再次嘗試請求。如果問題仍然存在，請聯絡 AWS 支援中心，並提供有關您的請求及所遇到錯誤的詳細資訊。

MPAgreementBeingCreated

HTTP 狀態碼：403

原因：您的帳戶未獲授權存取此模型。此模型的 AWS Marketplace 訂閱仍在處理中

解決方案：

  • 15 分鐘後再試一次

NotAuthorized

HTTP 狀態碼：400

原因：您沒有執行此動作的許可。

解決方案：

  • 檢閱您的 IAM 許可，並確保您擁有對 Amazon Bedrock 資源執行所請求動作的必要權限。

  • 如果您使用的是 IAM 角色，請確認該角色具有適當的許可和信任關係。

  • 檢查是否有任何組織政策或服務控制政策可能限制您的存取。

RequestExpired

HTTP 狀態碼：400

原因：由於時間戳記過期，請求不再有效。

解決方案：

  • 確保您的系統時鐘與可靠的時間來源正確同步。

  • 如果您從不同的時區提出請求，請注意時間戳記可能會有差異。

ServiceUnavailable

HTTP 狀態碼：503

原因：服務暫時無法處理請求。一般限流會使用 503 錯誤。

解決方案：

  • 我們建議採用 AWS 建議的重試方法，搭配指數退避和隨機抖動來改善可靠性。

  • AWS 區域 如果問題仍存在於您目前的區域中，請考慮切換至不同的 。不同的區域可能會有不同的負載和可用性層級。

  • 使用跨區域推論，透過跨不同的運算來無縫管理意外流量暴增 AWS 區域。

  • 如果您有高輸送量需求，建議您針對使用案例探索佈建輸送量。

最佳實務

  • 確保您的應用程式可以在錯誤處理和重試邏輯中會適當處理 503 狀態碼。

  • 檢查 AWS 服務運作狀態儀表板，了解可能影響服務的任何問題或排定的維護。

如果您經常遇到 503 錯誤，或這些錯誤對您的操作造成重大影響，請聯絡 AWS Support 以取得針對您特定使用案例量身打造的進一步協助和指引。

ThrottlingException

HTTP 狀態碼：429

原因：由於超過 Amazon Bedrock 的帳戶配額，請求遭拒。

解決方案：

  • 檢查 Amazon Bedrock 服務配額主控台中的 Amazon Bedrock 服務配額，以了解分配給您帳戶的限制。

  • 我們建議採用 AWS 建議的方法來使用具有指數退避的重試。 和隨機抖動可提高可靠性。

  • 如果您有高輸送量需求，建議您針對使用案例探索佈建輸送量。

  • 如果您的工作負載流量超過您的帳戶配額，請聯絡您的客戶經理或 AWS Support，以請求提高配額。

ValidationError

HTTP 狀態碼：400

原因：輸入不符合 Amazon Bedrock 指定的限制條件。

解決方案：

  • 檢閱 API 文件，以確保所有必要參數皆已正確納入並格式化。

  • 檢查您的輸入值是否在允許的範圍內或符合預期的模式。

  • 對於您正在使用的動作，建議您注意 API 參考中提及的任何特定驗證規則。

ResourceNotFound

HTTP 狀態碼：404

原因：找不到請求的資源。

解決方案：

  • 驗證請求中模型 ID、端點名稱或其他資源識別碼的正確性。

  • 請實作後援機制，以便在找不到主要資源時使用替代模型或端點。

最佳實務

  • 使用 ListFoundationModels 了解您可以使用的可用 Amazon Bedrock 基礎模型。

  • 建議您實作定期同步程序，以更新本機資源目錄。

如果您在嘗試過這些解決方案後仍遇到問題，請聯絡 AWS Support 以取得針對您特定使用案例量身打造的進一步協助和指引。

呼叫 Amazon Bedrock APIs 時的連線逾時或重設

徵狀：當流量通過 NAT 閘道、VPC 端點或 Network Load Balancer 時，API 呼叫會因連線重設或逾時而失敗，特別是對於串流或延伸推論等長時間執行的請求。

原因：NAT 閘道、介面 VPC 端點和 Network Load Balancer 的固定閒置連線逾時為 350 秒。如果 TCP 連線保持閒置超過此期間，則會捨棄連線。用戶端會收到 TCP RST 封包或請求逾時。

解決方案：

啟用 TCP 保持連線以傳送定期探查，防止連線閒置。如需詳細資訊，請參閱 AWS 網路與內容交付部落格中的在 VPC 聯網中實作長時間執行的 TCP 連線。

如果您在啟用 TCP 保持連線後持續遇到連線問題，請聯絡 AWS Support 以取得進一步協助。