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

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

AccessDeniedException

HTTP 狀態碼：403

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

解決方案：

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

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

BadCScoreException

HTTP 狀態碼：403

原因：您的帳戶未獲授權存取此模型

解決方案：

• 如需更多詳細資訊，請聯絡 AWS Support

FTUFormNotFilled

HTTP 狀態碼：404

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

解決方案：

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

IncompleteSignature

HTTP 狀態碼：400

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

解決方案：

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

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

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

InternalFailure

HTTP 狀態碼：500

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

解決方案：

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

• 如果問題仍然存在，請聯絡 AWS 支援中心，並提供請求的詳細資訊，以及您遇到的錯誤。

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 協議因基礎問題而失敗。

解決方案：

• 檢閱錯誤訊息並修復基礎問題。常見的基礎問題是無效的付款錯誤和受限的地理位置。

• 對於無效的付款錯誤，請在 Amazon Bedrock 中請求模型存取後，針對使用 AWS Marketplace 和 INVALID_PAYMENT_INSTRUMENT 的 AISPL 客戶檢閱信用卡和簽帳金融卡購買限制。 https://repost.aws/questions/QU0UOsutrWSSS4nOqgHcIUJg/invalid-payment-instrument-after-requesting-model-access-in-amazon-bedrock

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 以取得針對您特定使用案例量身打造的進一步協助和指引。