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

# 對 Amazon Bedrock API 錯誤碼進行疑難排解
<a name="troubleshooting-api-error-codes"></a>

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

## AccessDeniedException
<a name="ts-access-denied"></a>

**HTTP 狀態碼：**403

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

**解決方案**：
+ 確認您的 IAM 使用者或角色具有您正嘗試動作的必要許可。
+ 如果您使用的是臨時安全憑證，請確保其尚未過期。

## FTUFormNotFilled
<a name="ts-ftu-form"></a>

**HTTP 狀態碼：**404

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

**解決方案**：
+ 使用模型之前，請先填寫 Anthropic 使用案例詳細資訊表單

## IncompleteSignature
<a name="ts-incomplete-signature"></a>

**HTTP 狀態碼：**400

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

**解決方案**：
+ 請確定您使用的是支援 Amazon Bedrock 的 AWS SDK 版本。
+ 確認您的 AWS 存取金鑰 ID 和私密金鑰已正確設定。
+ 如果您手動簽署請求，建議您重新檢查簽章計算程序。

## InternalFailure
<a name="ts-internal-failure"></a>

**HTTP 狀態碼：**500

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

**解決方案**：
+ 我們建議採用 AWS 建議的[重試方法，搭配指數退避](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html)和隨機[抖動](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/)來改善可靠性。
+ 如果問題仍然存在，請聯絡 [AWS 支援中心](https://aws.amazon.com/support)，並提供有關您的請求及所遇到錯誤的詳細資訊。

## InvalidAction
<a name="ts-invalid-action"></a>

**HTTP 狀態碼：**400

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

**解決方案**：
+ 建議您再次檢查請求中動作名稱的拼字和格式。
+ 確認動作呼叫受 Amazon Bedrock 支援，並已依照 [Amazon Bedrock API 參考](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_Operations.html)所示正確記錄下來。
+ 請確定您使用的是 SDK up-to-date。 AWS 

## InvalidClientTokenId
<a name="ts-invalid-client-token"></a>

**HTTP 狀態碼：**403

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

**解決方案**：
+ 確認您使用的是正確的 AWS 存取金鑰 ID。
+ 如果您最近建立了新的存取金鑰，請確定您使用的是新憑證，而不是舊憑證。

## AWS Marketplace 協議在 15 分鐘內失敗
<a name="ts-mp-agreement-failed"></a>

**HTTP 狀態碼：**403

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

**解決方案**：
+ 檢閱錯誤訊息並修復基礎問題。常見的基礎問題有無效付款錯誤和地理位置受限。
+ 對於無效的付款錯誤，請在 Amazon Bedrock 中請求模型存取後，針對[使用 AWS Marketplace 和 INVALID\$1PAYMENT\$1INSTRUMENT 的 AISPL 客戶檢閱信用卡和簽帳金融卡購買限制](https://aws-blogs-prod.amazon.com/awsmarketplace/restriction-on-credit-and-debit-card-purchases-for-aispl-customers-using-aws-marketplace/)。 [https://repost.aws/questions/QU0UOsutrWSSS4nOqgHcIUJg/invalid-payment-instrument-after-requesting-model-access-in-amazon-bedrock](https://repost.aws/questions/QU0UOsutrWSSS4nOqgHcIUJg/invalid-payment-instrument-after-requesting-model-access-in-amazon-bedrock)

## AWS 15 分鐘後待定的 Marketplace 協議
<a name="ts-mp-agreement-pending"></a>

**HTTP 狀態碼：**403

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

**解決方案**：
+ 每 15 分鐘再次嘗試請求。如果問題仍然存在，請聯絡 [AWS 支援中心](https://aws.amazon.com/support)，並提供有關您的請求及所遇到錯誤的詳細資訊。

## MPAgreementBeingCreated
<a name="ts-mp-agreement-created"></a>

**HTTP 狀態碼：**403

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

**解決方案**：
+ 15 分鐘後再試一次

## NotAuthorized
<a name="ts-not-authorized"></a>

**HTTP 狀態碼：**400

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

**解決方案**：
+ 檢閱您的 IAM 許可，並確保您擁有對 Amazon Bedrock 資源執行所請求動作的必要權限。
+ 如果您使用的是 IAM 角色，請確認該角色具有適當的許可和信任關係。
+ 檢查是否有任何組織政策或服務控制政策可能限制您的存取。

## RequestExpired
<a name="ts-request-expired"></a>

**HTTP 狀態碼：**400

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

**解決方案**：
+ 確保您的系統時鐘與可靠的時間來源正確同步。
+ 如果您從不同的時區提出請求，請注意時間戳記可能會有差異。

## ServiceUnavailable
<a name="ts-service-unavailable"></a>

**HTTP 狀態碼：**503

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

**解決方案**：
+ 我們建議採用 AWS 建議的[重試方法，搭配指數退避](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html)和隨機[抖動](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/)來改善可靠性。
+  AWS 區域 如果問題仍存在於您目前的區域中，請考慮切換至不同的 。不同的區域可能會有不同的負載和可用性層級。
+ [使用跨區域推論](https://docs.aws.amazon.com//bedrock/latest/userguide/cross-region-inference.html)，透過跨不同的運算來無縫管理意外流量暴增 AWS 區域。
+ 如果您有高輸送量需求，建議您針對使用案例探索[佈建輸送量](https://docs.aws.amazon.com//bedrock/latest/userguide/prov-throughput.html)。

**最佳實務**
+ 確保您的應用程式可以在錯誤處理和重試邏輯中會適當處理 503 狀態碼。
+ 檢查 AWS 服務運作狀態儀表板，了解可能影響服務的任何問題或排定的維護。

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

## ThrottlingException
<a name="ts-throttling-exception"></a>

**HTTP 狀態碼：**429

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

**解決方案**：
+ 檢查 [Amazon Bedrock 服務配額](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#limits_bedrock)主控台中的 Amazon Bedrock 服務配額，以了解分配給您帳戶的限制。
+ 我們建議採用 AWS 建議的方法來使用[具有指數退避的重試。](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html) 和隨機[抖動](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/)可提高可靠性。
+ 如果您有高輸送量需求，建議您針對使用案例探索[佈建輸送量](https://docs.aws.amazon.com//bedrock/latest/userguide/prov-throughput.html)。
+ 如果您的工作負載流量超過您的帳戶配額，請聯絡您的客戶經理或 [AWS Support](https://aws.amazon.com/support)，以請求提高配額。

## ValidationError
<a name="ts-validation-error"></a>

**HTTP 狀態碼：**400

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

**解決方案**：
+ 檢閱 API 文件，以確保所有必要參數皆已正確納入並格式化。
+ 檢查您的輸入值是否在允許的範圍內或符合預期的模式。
+ 對於您正在使用的動作，建議您注意 API 參考中提及的任何特定驗證規則。

## ResourceNotFound
<a name="ts-resource-not-found"></a>

**HTTP 狀態碼：**404

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

**解決方案**：
+ 驗證請求中模型 ID、端點名稱或其他資源識別碼的正確性。
+ 請實作後援機制，以便在找不到主要資源時使用替代模型或端點。

**最佳實務**
+ 使用 [ListFoundationModels](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_ListFoundationModels.html) 了解您可以使用的可用 Amazon Bedrock 基礎模型。
+ 建議您實作定期同步程序，以更新本機資源目錄。

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

## 呼叫 Amazon Bedrock APIs 時的連線逾時或重設
<a name="ts-connection-timeout"></a>

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

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

**解決方案**：

啟用 TCP 保持連線以傳送定期探查，防止連線閒置。如需詳細資訊，請參閱 AWS 網路與內容交付部落格中的在 [VPC 聯網中實作長時間執行的 TCP 連線](https://aws.amazon.com/blogs/networking-and-content-delivery/implementing-long-running-tcp-connections-within-vpc-networking/)。

如果您在啟用 TCP 保持連線後持續遇到連線問題，請聯絡 [AWS Support](https://aws.amazon.com/support) 以取得進一步協助。