對 Amazon Bedrock API 錯誤代碼進行故障診斷 - Amazon Bedrock
AccessDeniedExceptionIncompleteSignatureInternalFailureInvalidActionInvalidClientTokenIdNotAuthorizedRequestExpiredServiceUnavailableThrottlingExceptionValidationErrorResourceNotFound

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

對 Amazon Bedrock API 錯誤代碼進行故障診斷

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

AccessDeniedException

HTTP 狀態碼：400

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

解決方案：

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

  • 如果您使用的是臨時安全登入資料，請確保它們尚未過期

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

  • 如果您最近建立了新的存取金鑰，請確定您使用的是新的登入資料，而不是舊的登入資料

NotAuthorized

HTTP 狀態碼：400

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

解決方案：

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

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

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

RequestExpired

HTTP 狀態碼：400

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

解決方案：

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

  • 如果您提出來自不同時區的請求，請注意潛在的時間戳記差異

ServiceUnavailable

HTTP 狀態碼：503

原因：服務暫時無法處理請求

解決方案：

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

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

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

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

最佳實務

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

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

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

ThrottlingException

HTTP 狀態碼：429

原因：請求因超過 Amazon Bedrock 的帳戶配額而遭拒

解決方案：

ValidationError

HTTP 狀態碼：400

原因：輸入無法滿足 Amazon Bedrock 指定的限制條件。

解決方案：

  • 檢閱 API 文件，以確保所有必要參數都已包含並正確格式化

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

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

ResourceNotFound

HTTP 狀態碼：404

原因：找不到請求的資源

解決方案：

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

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

最佳實務

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

  • 我們建議您實作定期同步程序來更新本機資源目錄

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