Documentação do Oracle Cloud Infrastructure

Solucionando Problemas do Serviço API Gateway

Descubra como solucionar problemas com o API Gateway e possíveis soluções para problemas comuns.

Este tópico aborda problemas comuns relacionados ao serviço API Gateway e como você pode resolvê-los.

Os problemas deste tópico estão organizados nas seguintes categorias amplas:

Consulte também Guias de Solução de Problemas para o Serviço API Gateway.

Problemas ao criar gateways de API

Mensagem ou descrição de erro Mais informações
A criação de um novo gateway de API é paralisada com um estado Criando ou então falha. A criação de um novo gateway de API é paralisada com um estado Criando ou então falha
VNIC attachment failed due to the limit for number of private IP addresses for this subnet A criação de um novo gateway de API retorna uma mensagem "VNIC failed due to the limit for number of private IP addresses for this subnet"
The limit for number of private IP addresses for this subnet has been exceeded A criação de um novo gateway de API retorna uma mensagem "The limit for number of private IP addresses for this subnet has been exceeded"
The limit for number of public IP addresses for this compartment has been exceeded A criação de um novo gateway de API pública retorna uma mensagem "The limit for number of public IP addresses for this compartment has been exceeded"
Work request was cancelled A criação de um novo gateway de API retorna uma mensagem "Work request was cancelled"
An unexpected error occurred. Contact Oracle Support for assistance. A criação de um novo gateway de API retorna um "Erro inesperado. Entre em contato com o Oracle Support para obter ajuda"
Unknown resource <subnet-ocid>, make sure subnet exists, the user can access the subnet and it is in the same region where the gateway will be created A criação de um novo gateway de API retorna uma mensagem "Unknown resource <subnet-ocid>, make sure subnet exists,..." e um erro 400

Consulte também Guias de Solução de Problemas para Criar Gateways de API.

Problemas ao criar implantações de API

Erros relacionados ao bloqueio de implantações de API:

Mensagem ou descrição de erro Mais informações
A criação de uma nova implantação de API é interrompida com o estado Criando ou então falha. A criação de uma nova implantação de API é interrompida com o estado Criando ou então falha

Erros de HTTP-4xx "Bad request" relacionados à configuração de mTLS:

Mensagem ou descrição de erro Mais informações
Cannot enable mutual TLS because custom CA Bundles are not added to the Gateway. Please add a custom CA Bundle and try again. A criação de uma nova implantação de API falha com "Não é possível ativar o TLS mútuo porque Pacotes de CAs personalizados não são adicionados ao Gateway. Adicione um Pacote de CA personalizado e tente novamente." mensagem
Duplicate SAN or CN values passed in input. Falha na criação de uma nova implantação de API com a mensagem "Duplicar valores SAN ou CN informados na entrada"
Too many value, must not have more than 10 values. A criação de uma nova implantação de API falha com a mensagem "Muito valor, não deve ter mais de 10 valores"
Length of SAN or CN string should be less than 256 characters. Falha na criação de uma nova implantação de API com a mensagem "O tamanho da string SAN ou CN deve ter menos de 256 caracteres"
Invalid format for SAN or CN. Falha na criação de uma nova implantação de API com "Formato inválido para SAN ou CN"

Consulte também Guias de Solução de Problemas para Criação de Implantações de API.

Problemas ao chamar APIs

Use logs do API Gateway para revisar informações de chamada. O serviço Oracle Cloud Infrastructure Logging é a opção padrão e recomendada para acessar, pesquisar e armazenar logs do Serviço API Gateway. Para obter mais informações, consulte Adicionando Registro em Log a Implantações de API.

Use as mensagens de erro dos logs e as informações abaixo para resolver problemas de chamada.

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

Mensagem ou descrição de erro Mais informações
failed to parse pem cert chain, mostrado no log. 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
Client CA Bundle not present, mostrado no log. 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
Error in client certificate verification, mostrado no log. 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
503: Service Unavailable Falha ao chamar a implantação de API com uma mensagem "Serviço Indisponível" e um erro 503

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

Mensagem ou descrição de erro Mais informações
Client certificate is invalid for this gateway., mostrado no log. A chamada da implantação de API falha com um erro HTTP-4xx, e um erro "O certificado do cliente é inválido para este gateway" é gerado para o log
SAN validation failure, mostrado no log. A chamada da implantação de API falha com um erro HTTP-4xx, e um erro "falha de validação de SAN" é gerado para o log

Erros diversos ao chamar APIs

Mensagem ou descrição de erro Mais informações
Base 64 Certificate Size greater than 8KB, mostrado no log. A chamada da implantação de API foi bem-sucedida, mas uma advertência "Tamanho do Certificado Base 64 maior que 8 KB" foi gerada no log

Consulte também Guias de Solução de Problemas para Chamadas de APIs.

Problemas que afetam os gateways de API

Mensagem ou descrição de erro Mais informações
A modificação de uma tag definida faz com que um gateway de API digite um estado de falha. A modificação de uma tag definida faz com que um gateway de API digite um estado de falha

Consulte também Guias de Solução de Problemas para Problemas do Serviço API Gateway.