Solução de problemas dos códigos de erro da API do Amazon Bedrock - Amazon Bedrock

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:

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:

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 para obter ajuda adicional e orientação personalizadas para o caso de uso específico.

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:

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 para obter ajuda adicional e orientação personalizadas ao caso de uso específico.