Amazon Bedrock API 错误代码故障排除 - Amazon Bedrock
AccessDeniedException错误的CScore异常FTUFormNotFilledIncompleteSignatureInternalFailureInvalidActionInvalidClientTokenIdAWS Marketplace 协议在 15 分钟内失败AWS Marketplace 协议在 15 分钟后待定MPAgreementBeingCreatedNotAuthorizedRequestExpiredServiceUnavailableThrottlingExceptionValidationErrorResourceNotFound

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

Amazon Bedrock API 错误代码故障排除

本节提供有关您在使用 Amazon Bedrock APIs 时可能遇到的常见错误、错误原因以及解决错误的解决方案的详细信息。

AccessDeniedException

HTTP 状态代码：403

原因：您没有足够的权限来执行请求的操作。

解决方案：

  • 验证您的 IAM 用户或角色是否具有执行您正在尝试的操作所需的权限。

  • 如果您使用的是临时安全证书，请确保它们尚未过期。

错误的CScore异常

HTTP 状态代码：403

原因：您的账户无权访问此模型

解决方案：

  • 如需更多详情，请联系 Su AWS pport

FTUFormNotFilled

HTTP 状态代码：404

原因：尚未提交该账户的模型用例详情

解决方案：

  • 在Anthropic使用模型之前，请填写用例详细信息表

IncompleteSignature

HTTP 状态代码：400

原因：请求签名不符合 AWS 标准。

解决方案：

  • 确保您使用的是支持 Amazon Bedrock 的 AWS SDK 版本。

  • 确认您的 AWS 访问密钥 ID 和私有密钥配置正确。

  • 如果您要手动签署请求，我们建议您仔细检查您的签名计算流程。

InternalFailure

HTTP 状态代码：500

原因：由于服务器错误，请求处理失败

解决方案：

  • 我们建议采用 AWS 推荐的方法，即使用指数退避和随机抖动的重试，以提高可靠性。

  • 如果问题仍然存在，请联系 AWS Support Center，并提供有关您的请求和遇到的错误的详细信息。

InvalidAction

HTTP 状态代码：400

原因：所请求的操作无效

解决方案：

  • 我们建议您仔细检查请求中操作名称的拼写和格式。

  • 验证 Amazon Bedrock 是否支持操作调用，并且记录正确，如亚马逊 Bedrock API 参考中所示。

  • 确保您使用的是最新 up-to-date版本的 AWS SDK 或 CLI。

InvalidClientTokenId

HTTP 状态代码：403

原因：我们的记录中不存在提供的 X.509 证书或 AWS 访问密钥 ID。

解决方案：

  • 确认您使用的是正确的 AWS 访问密钥 ID。

  • 如果您最近创建了新的访问密钥，请确保您使用的是新证书，而不是旧证书。

AWS Marketplace 协议在 15 分钟内失败

HTTP 状态代码：403

原因：由于潜在问题， AWS Marketplace 协议失败。

解决方案：

AWS Marketplace 协议在 15 分钟后待定

HTTP 状态代码：403

原因： AWS Marketplace 协议未成功，自提出请求以来已经 15 分钟了。

解决方案：

  • 每 15 分钟重试一次请求。如果问题仍然存在，请联系 AWS Support Center，并提供有关您的请求和遇到的错误的详细信息。

MPAgreementBeingCreated

HTTP 状态代码：403

原因：您的账户无权访问此模型。您对该型号的 AWS Marketplace 订阅仍在处理中

解决方案：

  • 15 分钟后重试

NotAuthorized

HTTP 状态代码：400

原因：您无权执行此操作。

解决方案：

  • 查看您的 IAM 权限，并确保您拥有必要的权限对 Amazon Bedrock 资源执行所要求的操作。

  • 如果您使用的是 IAM 角色，请验证该角色是否具有适当的权限和信任关系。

  • 检查是否存在任何可能限制您访问权限的组织策略或服务控制策略。

RequestExpired

HTTP 状态代码：400

原因：由于时间戳已过期，请求已失效。

解决方案：

  • 确保您的系统时钟与可靠的时间源正确同步。

  • 如果您从不同的时区发出请求，请注意可能存在的时间戳差异。

ServiceUnavailable

HTTP 状态代码：503

原因：服务暂时无法处理请求。503 错误用于常规限制。

解决方案：

  • 我们建议采用 AWS 推荐的方法，即使用指数退避和随机抖动的重试，以提高可靠性。

  • AWS 区域 如果问题在您当前的地区仍然存在，请考虑切换到其他区域。不同地区的负载水平和可用性可能各不相同。

  • 使用跨区域推理，通过利用跨区域的计算来无缝管理计划外的流量爆发。 AWS 区域

  • 如果您的吞吐量要求很高，我们建议您根据自己的用例探索预配置吞吐量。

最佳实践

  • 确保您的应用程序能够在错误处理和重试逻辑中正确处理 503 状态码。

  • 查看 S AWS ervice Health Dashboard 中是否存在任何可能影响服务的已宣布问题或定期维护。

如果您经常出现 503 错误，或者这些错误严重影响了您的运营，请联系 Su AWS pp ort，以获取针对您的特定用例量身定制的进一步帮助和指导。

ThrottlingException

HTTP 状态代码：429

原因：由于超出了 Amazon Bedrock 的账户配额，请求被拒绝。

解决方案：

  • 在 Amazon Bedrock 服务配额控制台中查看 Amazon Bedrock 服务配额，了解分配给您的账户的限制。

  • 我们建议采用 AWS 推荐的方法，即使用指数退避的重试。 以及随机抖动以提高可靠性。

  • 如果您的吞吐量要求很高，我们建议您根据自己的用例探索预配置吞吐量。

  • 如果您的工作负载流量超过账户配额，请联系您的客户经理或 Su AWS pp ort，申请增加配额。

ValidationError

HTTP 状态代码：400

原因：输入未能满足 Amazon Bedrock 指定的约束条件。

解决方案：

  • 查看 API 文档，确保包含所有必需的参数并正确格式化。

  • 检查您的输入值是否在允许的范围之内或符合预期的模式。

  • 我们建议您注意您正在使用的操作的 API 参考中提及的任何特定验证规则。

ResourceNotFound

HTTP 状态代码：404

原因：找不到请求的资源。

解决方案：

  • 验证请求中型号 ID、端点名称或其他资源标识符的正确性。

  • 请实现回退机制，以便在找不到主要资源时使用替代模型或端点。

最佳实践

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

  • 我们建议实施定期同步过程来更新您的本地资源目录。

如果您在尝试这些解决方案后仍然遇到问题，请联系 Suppor AWS t 以获取针对您的特定用例量身定制的进一步帮助和指导。