Documentação do Oracle Cloud Infrastructure

Erros HTTP-5xx quando a implantação de API é criada com sucesso, mas as solicitações falham

Descubra como diagnosticar e solucionar erros HTTP-5xx quando uma implantação de API é criada com sucesso com o serviço API Gateway, mas as solicitações falham.

Depois de criar uma implantação de API com sucesso, você poderá encontrar erros HTTP-5xx ao chamá-la.

A chamada da implantação de API falha com um erro HTTP-5xx, e um erro "falha ao fazer parsing da cadeia de certificados pem" é gerado para o log

Ao chamar uma implantação de API que tenha o TLS mútuo ativado, talvez você veja a solicitação falhar com um erro HTTP-5xx e a seguinte saída de erro no log:
failed to parse pem cert chain

Esse erro ocorre quando o bundle de CAs personalizado no armazenamento confiável do gateway de API que hospeda a implantação de API não está no formato correto.

Para resolver esse problema, certifique-se de que o bundle de CAs personalizado no armazenamento confiável do gateway de API esteja no formato correto. Para obter mais informações, consulte Adicionando suporte a mTLS a Implantações de API.

A chamada da implantação de API falha com um erro HTTP-5xx, e um erro "Pacote de CAs do Cliente não presente" é gerado para o log

Ao chamar uma implantação de API que tenha o TLS mútuo ativado, talvez você veja a solicitação falhar com um erro HTTP-5xx e a seguinte saída de erro no log:

Client CA Bundle not present.

Esse erro ocorre quando pelo menos uma implantação de API ativada por mTLS é implantada em um gateway de API, mas um pacote de CAs personalizado não foi adicionado ao armazenamento confiável do gateway de API.

Para resolver esse problema, execute um dos seguintes procedimentos:

  • Exclua todas as implantações de API ativadas por mTLS do gateway de API.
  • Edite todas as implantações de API ativadas por mTLS no gateway de API para desativar o suporte a mTLS.
  • Adicione um bundle de CAs personalizado ao armazenamento confiável do gateway de API.

Para obter mais informações, consulte Adicionando suporte a mTLS a Implantações de API.

A chamada da implantação de API falha com um erro HTTP-5xx, e um erro "Erro na verificação do certificado do cliente" é gerado para o log

Ao chamar uma implantação de API que tenha o TLS mútuo ativado, talvez você veja a solicitação falhar com um erro HTTP-5xx e a seguinte saída de erro no log:

Error in client certificate verification.

Este erro ocorre quando o bundle de CAs personalizado adicionado ao armazenamento confiável do gateway de API tem um formato inválido. O log contém informações adicionais sobre a solicitação com falha.

Para resolver esse problema, certifique-se de que o bundle de CAs personalizado adicionado ao armazenamento confiável do gateway de API esteja no formato correto. Use informações de rastreamento do log para corrigir esse erro. Para obter mais informações, consulte Adicionando suporte a mTLS a Implantações de API.

Falha ao chamar a implantação de API com uma mensagem "Serviço Indisponível" e um erro 503

Ao chamar uma implantação de API, talvez você veja a solicitação falhar com um erro HTTP-503 e a seguinte mensagem de erro:

Service Unavailable.

A mensagem indica que o Gateway de API não pode tratar a solicitação no momento, possivelmente por causa da capacidade insuficiente.

Observe o seguinte:

  • Se você continuar a ver esse erro, considere configurar clientes de API para aumentar o intervalo de tempo entre as chamadas de implantação de API (talvez usando uma técnica padrão como backoff exponencial jittered para adicionar um grau de aleatoriedade ao intervalo).
  • Se o número de erros HTTP-503 estiver afetando negativamente o desempenho da solicitação/resposta e for operacionalmente inaceitável aumentar o intervalo de tempo entre as chamadas de API, Entre em Contato Conosco e solicite um aumento na capacidade de CPU alocada. Quando você entrar em contato conosco, forneça o OCID do gateway de API, um período durante o qual uma taxa de throughput de solicitação alta foi tratada com sucesso e a taxa de throughput de destino que você deseja atingir. Consideramos consultas para aumentos de capacidade de CPU caso a caso.
  • Se a mensagem for exibida quando uma implantação de API for chamada como resultado de uma ação acionada por um evento, tentativas adicionais de chamar a implantação de API serão repetidas automaticamente até que a implantação de API seja chamada com sucesso. Nenhuma intervenção de sua parte é necessária.
  • Se você configurar alarmes que são acionados por respostas de erro de implantação de API contendo 503 códigos de erro, poderá ver várias notificações para as quais nenhuma intervenção de sua parte é necessária.
  • Se a mensagem continuar a aparecer após um período prolongado, Entre em Contato Conosco para obter assistência.