Todos os produtos
Search
Central de documentação

API Gateway:Solucionar erros D504CO

Última atualização: Jun 27, 2026

Os erros D504CO indicam que o API Gateway não conseguiu se conectar ao serviço de backend. Cada suberro aponta para um modo de falha específico. Identifique a mensagem exata na resposta e siga as etapas correspondentes.

Falha na conexão com o serviço de backend 'Timeout connecting to 172.X.X.1:80'

Causa: O API Gateway não alcançou o serviço de backend dentro do tempo permitido.

Solução: Verifique os itens abaixo nesta ordem:

  • Verifique se a URL do serviço de backend está correta.

  • Se o serviço de backend for executado em uma instância do Elastic Compute Service (ECS), verifique as regras do grupo de segurança. Adicione o endereço IP de saída do API Gateway à lista de permissões para permitir o tráfego de entrada proveniente do API Gateway.

  • Confira se o serviço de backend possui lista de permissões ou de bloqueios que impeça o acesso do API Gateway, se a aplicação de backend está em execução e se algum firewall no servidor de backend rejeita conexões do API Gateway.

  • Se o serviço de backend estiver em uma Virtual Private Cloud (VPC) e o tráfego cruzar regiões ou vier de um data center on-premises pela Cloud Enterprise Network (CEN), configure a rota de retorno. Para mais detalhes, consulte Acesso a serviços em nuvem.

Falha na conexão com o serviço de backend 'Connection is closed'

Causa: O serviço de backend enviou um pacote FIN para encerrar a conexão antes que o API Gateway concluísse o processamento da requisição.

Solução: Esse problema foi resolvido em agosto de 2023. O API Gateway agora tenta reconectar automaticamente ao receber um pacote FIN do serviço de backend. Se sua instância dedicada foi adquirida antes de agosto de 2023, envie um ticket para solicitar a atualização da instância para a versão corrigida.

Falha na conexão com o serviço de backend 'Connection refused'

Causa: O serviço de backend rejeitou ativamente a solicitação de conexão do API Gateway.

Solução: Analise as configurações e os logs do serviço de backend para identificar o motivo da recusa das conexões.

Falha na conexão com o serviço de backend 'Connection lease request time out'

Causa: O API Gateway esgotou todas as conexões disponíveis no pool de conexões de saída antes de atribuir uma conexão à requisição.

Solução: Faça upgrade da instância do API Gateway para um tipo com pool de conexões maior. Para consultar os tipos de instância disponíveis e os tamanhos dos pools de conexão, veja Tipos de instância.

Nota

As conexões persistentes HTTP transmitem dados serialmente: o remetente precisa aguardar o reconhecimento de cada requisição antes de enviar a próxima. Planeje o tamanho do pool de conexões de saída com base no tempo de resposta do backend e na taxa de RPS (requisições por segundo) esperada.

Por exemplo, uma instância api.s1.small possui um pool de 1.200 conexões. Se o backend levar um segundo para responder a cada requisição, essa instância suporta até 1.200 RPS de saída. Requisições que ultrapassarem esse limite ficam em fila por até 500 milissegundos. Caso uma requisição na fila não seja despachada dentro dessa janela, o API Gateway retorna o erro Connection lease request time out ao cliente.