Guias de instruções

Configurar e implementar uma API

• Configurar o Cloud Endpoints

  Explica como preparar o documento OpenAPI para implementação nos Endpoints.

• Implementar a configuração dos pontos finais

  Descreve como implementar um documento OpenAPI nos Endpoints.

• Implementar o back-end da API

  Explica como implementar o código de back-end da sua API e o Extensible Service Proxy (ESP).

• Implementação no Kubernetes

  Mostra como configurar e implementar os Endpoints no Kubernetes.

• Executar o ESP localmente ou noutra plataforma

  Mostra como configurar uma instância do ESP numa máquina local ou noutro fornecedor de nuvem.

• Comparar ficheiros de configuração

  Descreve o separador Histórico de implementação na página Endpoints > Serviços na Google Cloud consola e como comparar uma configuração de serviço implementada com a versão anterior.

• Obter o nome do serviço e o ID da configuração

  Descreve como obter o nome e o ID de configuração de um serviço gerido.

Resolução de problemas e monitorização

• Vista geral da resolução de problemas

  Fornece informações gerais de resolução de problemas e links para outras páginas com informações adicionais.

• Resolução de problemas de implementação da configuração dos pontos finais

  Descreve alguns erros que pode encontrar quando implementa a configuração dos Endpoints e como resolvê-los.

• Resolução de problemas de erros de resposta

  Descreve como resolver problemas de erros que recebe numa resposta de um pedido à sua API.

• Resolução de problemas de implementação do ambiente flexível do App Engine

  Fornece técnicas de resolução de problemas para implementações de Endpoints no ambiente flexível do App Engine.

• Resolução de problemas de implementação do Compute Engine

  Fornece técnicas de resolução de problemas para implementações de Endpoints no Compute Engine.

• Resolução de problemas de implementação do GKE

  Fornece técnicas de resolução de problemas para implementações de Endpoints no GKE.

• Resolução de problemas de validação de JWT

  Fornece informações de resolução de problemas se a validação JWT falhar e for devolvido um erro na resposta ao cliente.

• Monitorizar a sua API

  Descreve como monitorizar o estado das APIs através dos registos e das métricas que os pontos finais mantêm automaticamente.

• Rastrear a sua API

  Explica a taxa de amostragem de rastreios, como estimar o custo do Cloud Trace, como ver os rastreios na Google Cloud consola e como desativar a amostragem de rastreios.

DNS e SSL

• Validar um nome de domínio

  Mostra como validar a propriedade de um nome de domínio que serve uma API Google Cloud Endpoints.

• Publicar uma API a partir do seu nome de domínio

  Mostra como configurar o seu projeto para publicar pedidos de API.

• Configurar o DNS no domínio cloud.goog

  Mostra como configurar o DNS para serviços de Endpoints que usam o domínio cloud.goog, que é propriedade e gerido pela Google.

• Publicar várias APIs a partir de um domínio

  Mostra como executar várias APIs independentes no seu próprio domínio.

• Ativar SSL com SEP

  Mostra como ativar uma porta SSL para o serviço Endpoints implementado através do ESP.

• Ativar SSL com o ESPv2

  Mostra como ativar uma porta SSL para o seu serviço de Endpoints implementado através do ESPv2.

Autenticação e chaves da API

• Escolher um método de autenticação

  Apresenta uma vista geral e exemplos de utilização para cada método de autenticação suportado.

• Porquê e quando usar chaves da API

  Fornece informações gerais sobre as chaves da API e quando as usar.

• Usar o Firebase para autenticar utilizadores

  Mostra como configurar o seu documento OpenAPI para que o ESP valide os pedidos recebidos de clientes que usam o Firebase para autenticar os utilizadores.

• Usar o Auth0 para autenticar utilizadores

  Mostra como configurar o seu documento OpenAPI para que o ESP valide os pedidos recebidos de clientes que usam o Auth0 para autenticar os utilizadores.

• Usar tokens de ID Google para autenticar utilizadores

  Mostra como configurar o seu documento OpenAPI para que o ESP valide os pedidos recebidos de clientes que usam tokens de ID Google para autenticar os utilizadores.

• Usar um método personalizado para autenticar utilizadores

  Mostra como configurar o seu documento OpenAPI para que o ESP valide os pedidos recebidos de clientes que usam um fornecedor personalizado para autenticar os utilizadores.

• Autenticação entre serviços

  Mostra como autenticar chamadas de serviço para serviço.

• Restringir o acesso com chaves da API

  Mostra como impedir que aplicações e serviços de cliente não autorizados acedam à sua API.

Gerir o acesso à API

• Vista geral do acesso à API

  Descreve as opções de controlo de acesso à API disponíveis nos Endpoints.

• Controlar quem pode ativar a sua API

  Mostra como controlar quem pode ativar a sua API nos respetivos projetos. Google Cloud

• Ativar uma API no seu Google Cloud projeto

  Mostra como ativar uma API num Google Cloud projeto.

• Conceder e revogar o acesso à API

  Mostra como conceder diferentes níveis de acesso para que outros membros da equipa possam ajudar a gerir a API.

Gestão do ciclo de vida das APIs

• Vista geral da gestão do ciclo de vida da API

  Descreve as funcionalidades de controlo de versões da API Endpoints e fornece práticas recomendadas para o controlo de versões e a preparação da API Endpoints.

• Eliminar uma API e instâncias

  Mostra como eliminar uma API e encerrar instâncias que executam a API para evitar custos desnecessários.

• Restaurar um serviço gerido

  Mostra como restaurar um serviço gerido em caso de eliminação acidental.

Limitar pedidos de API (beta)

• Acerca das quotas

  Apresenta uma vista geral da funcionalidade principal fornecida pelas quotas.

• Configurar quotas

  Descreve como configurar quotas para a sua API.

• Substituir o limite de quota predefinido

  Descreve como definir um limite de quota diferente para um projeto de consumidor específico.

Personalizar o SEP

• Usar um nginx.conf personalizado no Google Kubernetes Engine

  Descreve como criar um ficheiro nginx.conf personalizado para implementar o ESP no GKE.

• Criar um nginx.conf personalizado para suportar CORS

  Mostra exemplos de como as opções CORS do ESP são escritas para nginx.conf como ponto de partida caso precise de personalizar o suporte CORS no ESP.

Guias de instruções de outros endpoints

• Migre para o ESPv2

• Frameworks do Cloud Endpoints para o ambiente padrão do App Engine: guias de instruções

• Guias de instruções do Cloud Endpoints para gRPC