Esta página fornece informações gerais de resolução de problemas e links para outras páginas com informações adicionais.
Erros na implementação da configuração do Cloud Endpoints
Se recebeu uma mensagem de erro do comando gcloud endpoints services deploy, consulte o artigo
Resolução de problemas da implementação da configuração dos pontos finais
para obter informações sobre a resolução de problemas do erro.
Erros ao implementar o back-end da API
A implementação da sua API e do Extensible Service Proxy (ESP) num Google Cloud back-end depende da plataforma. Consulte os seguintes guias de resolução de problemas para mais informações:
Erros de resposta
Quando envia um pedido para a sua API e recebe uma resposta de erro, consulte o artigo Resolução de problemas de erros de resposta para obter informações sobre a resolução de problemas do erro.
A verificar os serviços necessários
A verificar os serviços necessários
No mínimo, os pontos finais e o ESP requerem a ativação dos seguintes serviços Google:| Nome | Título |
|---|---|
servicemanagement.googleapis.com |
Service Management API |
servicecontrol.googleapis.com |
Service Control API |
Na maioria dos casos, o comando gcloud endpoints services deploy ativa estes serviços obrigatórios. No entanto, o comando gcloud é concluído com êxito, mas não ativa os serviços necessários nas seguintes circunstâncias:
Se usou uma aplicação de terceiros, como o Terraform, e não incluiu estes serviços.
Implementou a configuração do Endpoints numGoogle Cloud projeto existente no qual estes serviços foram explicitamente desativados.
Use o seguinte comando para confirmar que os serviços necessários estão ativados:
gcloud services list
Se não vir os serviços necessários listados, ative-os:
gcloud services enable servicemanagement.googleapis.com
gcloud services enable servicecontrol.googleapis.comAtive também o serviço Endpoints:
gcloud services enable ENDPOINTS_SERVICE_NAME
Para determinar o ENDPOINTS_SERVICE_NAME, pode:
Após implementar a configuração do Endpoints, aceda à página Endpoints na Cloud Console. A lista de ENDPOINTS_SERVICE_NAME possíveis é apresentada na coluna Nome do serviço.
Para a OpenAPI, o ENDPOINTS_SERVICE_NAME é o que especificou no campo
hostda sua especificação OpenAPI. Para o gRPC, o ENDPOINTS_SERVICE_NAME é o que especificou no camponameda sua configuração de pontos finais gRPC.
Para mais informações sobre os comandos gcloud, consulte os
serviços gcloud.
A verificar as autorizações necessárias
A instância que executa o proxy de serviço extensível requer autorizações para chamar o Service Management e o ServiceControl.
Para o ESP implementado no Cloud Run, consulte o tutorial de criação de uma nova imagem do ESPv2 no Cloud Run para ver detalhes.
Para o ESP implementado no Compute Engine, consulte o artigo Verificar as autorizações necessárias no tutorial do Compute Engine para ver detalhes.
Para o ESP implementado no GKE, consulte o artigo Verificar as autorizações necessárias no tutorial do GKE para ver detalhes.
Verificar informações de depuração
A execução da CLI do Google Cloud com verbosidade de depuração ajuda na depuração.
gcloud --verbosity=debug COMMAND
Este comando faz com que a CLI do Google Cloud imprima um registo detalhado do erro. Consoante o comando que está a ser executado, o resultado pode incluir informações de pedido e resposta do servidor.
Ativar um serviço
Pode verificar se um serviço está ativado através de gcloud.
gcloud services list
Para apresentar a configuração de um serviço específico, use o seguinte comando:
gcloud endpoints services describe SERVICE_NAME
O proxy OAuth falha, mas os pedidos são aprovados
Certifique-se de que existe uma secção authentication com a sua definição de OAuth no ficheiro de configuração da API gRPC. Está disponível um ficheiro de configuração de exemplo no exemplo da livraria no GitHub.