本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
本節提供有關使用 Amazon Bedrock APIs 時可能遇到的常見錯誤、錯誤原因以及解決錯誤的解決方案的詳細資訊。
AccessDeniedException
HTTP 狀態碼：400
原因：您沒有足夠的許可來執行請求的動作
解決方案：
-
確認您的 IAM 使用者或角色具有您嘗試之動作的必要許可
-
如果您使用的是臨時安全登入資料，請確保它們尚未過期
IncompleteSignature
HTTP 狀態碼：400
原因：請求簽章不符合 AWS 標準
解決方案：
-
確保您使用的是支援 Amazon Bedrock 的 AWS SDK 版本
-
確認您的 AWS 存取金鑰 ID 和私密金鑰已正確設定
-
如果您要手動簽署請求，建議您重新檢查您的簽章計算程序
InternalFailure
HTTP 狀態碼：500
原因：請求處理因伺服器錯誤而失敗
解決方案：
-
我們建議採用 AWS 建議的方法來使用具有指數退避和隨機抖動的重試，以提高可靠性。 https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/
-
如果問題仍然存在，請聯絡 AWS 支援中心
，並提供請求的詳細資訊，以及您遇到的錯誤。
InvalidAction
HTTP 狀態碼：400
原因：請求的動作或操作無效
解決方案：
-
我們建議您再次檢查請求中動作名稱的拼寫和格式
-
確認 Amazon Bedrock 支援動作呼叫，並已正確記錄，如 Amazon Bedrock API 參考所示
-
請確定您使用up-to-date的 AWS SDK 或 CLI
InvalidClientTokenId
HTTP 狀態碼：403
原因：提供的 X.509 憑證或 AWS 存取金鑰 ID 不存在於我們的記錄中
解決方案：
-
確認您使用的是正確的 AWS 存取金鑰 ID
-
如果您最近建立了新的存取金鑰，請確定您使用的是新的登入資料，而不是舊的登入資料
NotAuthorized
HTTP 狀態碼：400
原因：您沒有執行此動作的許可
解決方案：
-
檢閱您的 IAM 許可，並確保您擁有對 Amazon Bedrock 資源執行請求動作的必要權限
-
如果您使用的是 IAM 角色，請確認該角色具有適當的許可和信任關係
-
檢查是否有任何組織政策或服務控制政策可能限制您的存取
RequestExpired
HTTP 狀態碼：400
原因：由於時間戳記過期，請求不再有效
解決方案：
-
確保您的系統時鐘與可靠的時間來源正確同步
-
如果您從不同的時區提出請求，請注意潛在的時間戳記差異
ServiceUnavailable
HTTP 狀態碼：503
原因：服務暫時無法處理請求
解決方案：
-
我們建議採用 AWS 建議的方法來使用具有指數退避和隨機抖動的重試，以提高可靠性 https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/
-
如果問題仍存在您目前的區域中，請考慮切換至不同的 AWS 區域。不同的區域可能會有不同的負載和可用性層級
-
使用跨區域推論，透過跨不同 的運算，無縫管理意外流量爆增 AWS 區域
-
如果您有高輸送量需求，建議您針對使用案例探索佈建輸送量
最佳實務
-
確保您的應用程式可以在錯誤處理和重試邏輯中適當處理 503 個狀態碼
-
檢查 AWS Service Health Dashboard 是否有任何已宣布的問題或可能影響服務的排程維護。
如果您經常遇到 503 錯誤，或這些錯誤對您的操作造成重大影響，請聯絡 AWS Support
ThrottlingException
HTTP 狀態碼：429
原因：請求因超過 Amazon Bedrock 的帳戶配額而遭拒
解決方案：
-
在 Amazon Bedrock 服務配額主控台中檢查 Amazon Bedrock 服務配額，以了解分配給您帳戶的限制
-
我們建議採用 AWS 建議的方法來使用具有指數退避和隨機抖動的重試，以提高可靠性 https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/
-
如果您有高輸送量需求，建議您針對使用案例探索佈建輸送量
-
如果您的工作負載流量超過您的帳戶配額，請聯絡您的 帳戶管理員或 AWS Support
來請求增加配額
ValidationError
HTTP 狀態碼：400
原因：輸入無法滿足 Amazon Bedrock 指定的限制條件。
解決方案：
-
檢閱 API 文件，以確保所有必要的參數都已納入並正確格式化
-
檢查您的輸入值是否在允許的範圍內或符合預期的模式
-
我們建議您注意 API 參考中針對您正在使用的動作所提及的任何特定驗證規則
ResourceNotFound
HTTP 狀態碼：404
原因：找不到請求的資源
解決方案：
-
驗證請求中模型 ID、端點名稱或其他資源識別符的正確性
-
請實作備用機制，以便在找不到主要資源時使用替代模型或端點
最佳實務
-
使用 ListFoundationModels 了解您可以使用的可用 Amazon Bedrock 基礎模型
-
我們建議您實作定期同步程序，以更新本機資源目錄
如果您在嘗試這些解決方案後持續遇到問題，請聯絡 AWS Support
