Solução de problemas dos códigos de erro da API do Amazon Bedrock
Esta seção fornece informações detalhadas sobre os erros comuns que você pode encontrar ao usar as APIs do Amazon Bedrock, a causa do erro e a solução para resolvê-lo.
AccessDeniedException
Código de status HTTP: 403
Causa: você não tem permissões suficientes para realizar a ação solicitada
Solução:
-
Verifique se o usuário ou o perfil do IAM tem as permissões necessárias para a ação que você está tentando.
-
Se você usar credenciais de segurança temporárias, verifique se elas não expiraram.
FTUFormNotFilled
Código de status HTTP: 404
Causa: os detalhes do caso de uso do modelo não foram enviados para a conta em questão.
Solução:
-
Preencha o formulário de detalhes de caso de uso da Anthropic antes de usar o modelo.
IncompleteSignature
Código de status HTTP: 400
Causa: a assinatura da solicitação não está em conformidade com os padrões da AWS.
Solução:
-
Verifique se você está usando uma versão do SDK da AWS compatível com o Amazon Bedrock.
-
Verifique se o ID da chave de acesso e a chave secreta da AWS estão configurados corretamente.
-
Se você estiver assinando solicitações manualmente, sugerimos verificar novamente o processo de cálculo da assinatura.
InternalFailure
Código de status HTTP: 500
Causa: falha no processamento da solicitação por causa de um erro no servidor
Solução:
-
Sugerimos empregar a abordagem recomendada pela AWS de usar novas tentativas com recuo exponencial e variação
aleatória para aumentar a confiabilidade. -
Se o problema persistir, entre em contato com o AWS Support Center
e dê detalhes sobre a solicitação e o erro que você está encontrando.
InvalidAction
Código de status HTTP: 400
Causa: a ação ou a operação solicitada é inválida
Solução:
-
Sugerimos verificar novamente a ortografia e a formatação do nome da ação na solicitação.
-
Verifique se a chamada de ação é compatível com o Amazon Bedrock e está documentada corretamente, conforme mostrado na Referência de API do Amazon Bedrock.
-
Verifique se você está usando a versão mais atualizada da CLI ou do SDK da AWS.
InvalidClientTokenId
Código de status HTTP: 403
Causa: o certificado X.509 ou o ID da chave de acesso da AWS fornecido não existe em nossos registros.
Solução:
-
Verifique se você está usando o ID de chave de acesso correto da AWS.
-
Se você tiver criado chaves de acesso recentemente, verifique se está usando as novas credenciais, e não as anteriores.
AWS Marketplace Agreement Failed within 15 minutes
Código de status HTTP: 403
Causa: o contrato do AWS Marketplace falhou devido a um problema subjacente.
Solução:
-
Analise a mensagem de erro e corrija o problema subjacente. Os problemas subjacentes comuns são erro de pagamento inválido e localização geográfica restrita.
-
Em caso de erro de pagamento inválido, consulte Restrição de compras com cartão de crédito e débito para clientes da AISPL usando o AWS Marketplace
e INVALID_PAYMENT_INSTRUMENT depois de solicitar acesso ao modelo no Amazon Bedrock.
AWS Marketplace Agreement Pending after 15 minutes
Código de status HTTP: 403
Causa: o contrato do AWS Marketplace não foi gerado e já se passaram 15 minutos desde que a solicitação foi feita.
Solução:
-
Tente solicitar novamente a cada 15 minutos. Se o problema persistir, entre em contato com o AWS Support Center
e dê detalhes sobre a solicitação e o erro que você está encontrando.
MPAgreementBeingCreated
Código de status HTTP: 403
Causa: sua conta não está autorizada a acessar o modelo em questão. Sua assinatura do AWS Marketplace para esse modelo ainda está sendo processada.
Solução:
-
Tente novamente após 15 minutos.
NotAuthorized
Código de status HTTP: 400
Causa: você não tem permissão para realizar a ação.
Solução:
-
Analise as permissões do IAM e verifique se você tem os direitos necessários para realizar a ação solicitada em recursos do Amazon Bedrock.
-
Se você estiver usando um perfil do IAM, verifique se o perfil tem as permissões e relações de confiança indicadas.
-
Verifique se há políticas organizacionais ou políticas de controle de serviços que possam estar restringindo o acesso.
RequestExpired
Código de status HTTP: 400
Causa: a solicitação não é mais válida devido a carimbos de data/hora expirados.
Solução:
-
Verifique se o relógio do sistema está sincronizado corretamente com uma fonte de tempo confiável.
-
Se você estiver fazendo solicitações em fusos horários diferentes, saiba que pode haver discrepâncias no carimbo de data/hora.
ServiceUnavailable
Código de status HTTP: 503
Causa: o serviço está temporariamente impossibilitado de processar a solicitação. Os erros 503 são usados para controle de utilização regular.
Solução:
-
Sugerimos empregar a abordagem recomendada pela AWS de usar novas tentativas com recuo exponencial e variação
aleatória para aumentar a confiabilidade. -
Considere mudar para uma Região da AWS diferente se o problema persistir na sua região atual. Regiões diferentes podem ter níveis variados de carga e disponibilidade.
-
Use a inferência entre regiões para gerenciar perfeitamente picos de tráfego não planejados utilizando computação em diferentes Regiões da AWS.
-
Se você tiver requisitos de throughput elevados, sugerimos explorar o throughput provisionado para seu caso de uso.
Práticas recomendadas
-
Garanta que a aplicação possa processar códigos de status 503 da maneira devida na lógica de tratamento de erros e repetição.
-
Consulte o AWS Service Health Dashboard para saber se há problemas anunciados ou manutenções programadas que possam afetar o serviço.
Se você tiver erros 503 frequentes ou se eles afetarem significativamente as operações, entre em contato com o AWS Support
ThrottlingException
Código de status HTTP: 429
Causa: a solicitação foi negada porque as cotas da conta referentes ao Amazon Bedrock foram excedidas.
Solução:
-
Verifique as cotas de serviço do Amazon Bedrock no console de cotas de serviço do Amazon Bedrock para saber mais sobre os limites alocados à conta.
-
Sugerimos empregar a abordagem recomendada pela AWS de usar novas tentativas com recuo exponencial e variação
aleatória para aumentar a confiabilidade. -
Se você tiver requisitos de throughput elevados, sugerimos explorar o throughput provisionado para seu caso de uso.
-
Solicite um aumento de cota entrando em contato com o gerente da conta ou com o AWS Support
caso o tráfego de workload exceda as cotas da conta.
ValidationError
Código de status HTTP: 400
Causa: a entrada não atende às restrições especificadas pelo Amazon Bedrock.
Solução:
-
Analise a documentação da API para garantir que todos os parâmetros necessários sejam incluídos e formatados corretamente.
-
Verifique se os valores de entrada estão dentro dos intervalos permitidos ou estão em conformidade com os padrões esperados.
-
Sugerimos prestar atenção em todas as regras de validação específicas mencionadas na referência de API para a ação que você está usando.
ResourceNotFound
Código de status HTTP: 404
Causa: não foi possível encontrar o recurso solicitado.
Solução:
-
Verifique a exatidão do ID do modelo, do nome do endpoint ou de outros identificadores de recurso na solicitação.
-
Implemente um mecanismo de fallback para usar modelos ou endpoints alternativos quando um recurso primário não for encontrado.
Práticas recomendadas
-
Use ListFoundationModels para saber mais sobre os modelos de base do Amazon Bedrock disponíveis que você pode usar.
-
Sugerimos implementar um processo de sincronização periódica para atualizar o catálogo de recursos local.
Se você continuar enfrentando problemas depois de tentar essas soluções, entre em contato com o AWS Support