

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Solução de problemas dos códigos de erro da API do Amazon Bedrock
<a name="troubleshooting-api-error-codes"></a>

Esta seção fornece informações detalhadas sobre os erros comuns que você pode encontrar ao usar o Amazon Bedrock APIs, a causa do erro e a solução para resolvê-lo.

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

**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
<a name="ts-ftu-form"></a>

**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
<a name="ts-incomplete-signature"></a>

**Código de status HTTP: **400

**Causa:** A assinatura da solicitação não está em conformidade com os AWS padrões.

**Solução**:
+ Verifique se você está usando uma versão do AWS SDK compatível com o Amazon Bedrock.
+ Verifique se o ID da chave de AWS acesso e a chave secreta estão configurados corretamente.
+ Se você estiver assinando solicitações manualmente, sugerimos verificar novamente o processo de cálculo da assinatura.

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

**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 AWS recomendada de usar [novas tentativas com recuo exponencial](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html) e instabilidade aleatória para melhorar a confiabilidade.](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/)
+ Se o problema persistir, entre em contato com o [AWS Support Center](https://aws.amazon.com/support) e dê detalhes sobre a solicitação e o erro que você está encontrando.

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

**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](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_Operations.html).
+ Verifique se você está usando a maioria das up-to-date versões do AWS SDK ou da CLI.

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

**Código de status HTTP: **403

**Causa:** O certificado X.509 ou o ID da chave de AWS acesso fornecido não existe em nossos registros.

**Solução**:
+ Verifique se você está usando a ID da chave de AWS acesso correta.
+ Se você tiver criado chaves de acesso recentemente, verifique se está usando as novas credenciais, e não as anteriores.

## AWS O contrato do Marketplace falhou em 15 minutos
<a name="ts-mp-agreement-failed"></a>

**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 AWS Marketplace](https://aws-blogs-prod.amazon.com/awsmarketplace/restriction-on-credit-and-debit-card-purchases-for-aispl-customers-using-aws-marketplace/) e [INVALID\$1PAYMENT\$1INSTRUMENT](https://repost.aws/questions/QU0UOsutrWSSS4nOqgHcIUJg/invalid-payment-instrument-after-requesting-model-access-in-amazon-bedrock) após solicitar acesso ao modelo no Amazon Bedrock. .

## AWS Contrato do Marketplace pendente após 15 minutos
<a name="ts-mp-agreement-pending"></a>

**Código de status HTTP: **403

**Causa:** O Contrato do AWS Marketplace não foi bem-sucedido 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](https://aws.amazon.com/support) e dê detalhes sobre a solicitação e o erro que você está encontrando.

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

**Código de status HTTP: **403

**Causa:** sua conta não está autorizada a acessar o modelo em questão. Sua assinatura AWS do Marketplace para esse modelo ainda está sendo processada

**Solução**:
+ Tente novamente após 15 minutos.

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

**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
<a name="ts-request-expired"></a>

**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
<a name="ts-service-unavailable"></a>

**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 AWS recomendada de usar [novas tentativas com recuo exponencial](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html) e instabilidade aleatória para melhorar a confiabilidade.](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/)
+ Considere mudar para um diferente Região da AWS 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](https://docs.aws.amazon.com//bedrock/latest/userguide/cross-region-inference.html) para gerenciar perfeitamente picos de tráfego não planejados, utilizando computação em diferentes regiões. Regiões da AWS
+ Se você tiver requisitos de throughput elevados, sugerimos explorar o [throughput provisionado](https://docs.aws.amazon.com//bedrock/latest/userguide/prov-throughput.html) 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 ver 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](https://aws.amazon.com/support) para obter ajuda adicional e orientação personalizadas para o caso de uso específico.

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

**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](https://docs.aws.amazon.com/general/latest/gr/bedrock.html#limits_bedrock) para saber mais sobre os limites alocados à conta.
+ Sugerimos empregar a abordagem AWS recomendada de usar [novas tentativas com recuo exponencial](https://docs.aws.amazon.com//prescriptive-guidance/latest/cloud-design-patterns/retry-backoff.html). e instabilidade aleatória [para](https://aws.amazon.com/builders-library/timeouts-retries-and-backoff-with-jitter/) maior confiabilidade.
+ Se você tiver requisitos de throughput elevados, sugerimos explorar o [throughput provisionado](https://docs.aws.amazon.com//bedrock/latest/userguide/prov-throughput.html) para seu caso de uso.
+ Solicite um aumento de cota entrando em contato com o gerente da conta ou com o [AWS Support](https://aws.amazon.com/support) caso o tráfego de workload exceda as cotas da conta.

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

**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
<a name="ts-resource-not-found"></a>

**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](https://docs.aws.amazon.com//bedrock/latest/APIReference/API_ListFoundationModels.html)para saber mais sobre os modelos de fundação 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](https://aws.amazon.com/support) para obter ajuda adicional e orientação personalizadas ao caso de uso específico.

## Tempo limite de conexão ou redefinição ao ligar para o Amazon Bedrock APIs
<a name="ts-connection-timeout"></a>

**Sintoma:** as chamadas de API falham com redefinições ou tempos limite de conexão, especialmente para solicitações de longa duração, como streaming ou inferência estendida, quando o tráfego passa por gateways NAT, endpoints VPC ou balanceadores de carga de rede.

**Causa:** Gateways NAT, endpoints VPC de interface e balanceadores de carga de rede têm um tempo limite fixo de conexão ociosa de 350 segundos. Se uma conexão TCP permanecer inativa por mais tempo do que esse período, a conexão será interrompida. O cliente recebe um pacote TCP RST ou a solicitação expira.

**Solução**:

Ative o TCP keep-alive para enviar sondas periódicas que evitam que a conexão fique ociosa. Para obter mais informações, consulte [Implementação de conexões TCP de longa duração na rede VPC no blog AWS Networking](https://aws.amazon.com/blogs/networking-and-content-delivery/implementing-long-running-tcp-connections-within-vpc-networking/) & Content Delivery.

Se você continuar enfrentando problemas de conexão depois de ativar o TCP keep-alive, entre em contato com o [AWS Support](https://aws.amazon.com/support) para obter mais assistência.