O Cloud Endpoints é um sistema de gestão de APIs que ajuda a proteger, monitorizar, analisar e definir quotas nas suas APIs através da mesma infraestrutura que a Google usa para as suas próprias APIs. O Endpoints funciona com o proxy de serviço extensível (ESP) e o proxy de serviço extensível V2 (ESPv2) para fornecer gestão de APIs. Pode saber mais acerca dos pontos finais, do ESP e do ESPv2 em Acerca dos pontos finais.
Os pontos finais suportam a versão 2 da especificação OpenAPI (anteriormente conhecida como especificação Swagger), a norma da indústria para definir APIs REST. Se não conhece a especificação OpenAPI, consulte a vista geral da OpenAPI.
Este conjunto de documentação mostra como usar os Endpoints com a OpenAPI. Para ver documentação sobre as outras opções de pontos finais, consulte Todos os documentos de pontos finais.
Para começar, recomendamos o seguinte caminho através da documentação:
Para ver as funcionalidades do Endpoints em ação, faça o início rápido para o Cloud Endpoints, que usa scripts para implementar uma API de exemplo no ambiente flexível do App Engine.
Agora, tem de decidir que plataforma de computação quer usar para a sua API. Para ajudar a tomar essa decisão, consulte o artigo Escolher uma opção de computação e a secção Plataformas de computação suportadas abaixo.
Depois de decidir o back-end da sua API, siga um tutorial para a sua plataforma de computação preferida.
Plataformas de computação suportadas
Os pontos finais para a OpenAPI dependem do ESP ou do ESPv2 para a gestão de APIs. O ESP e o ESPv2 são projetos de código aberto e estão disponíveis para si das seguintes formas:
- Um contentor no Artifact Registry.
- Consulte as notas de lançamento do ESP para ver a imagem do Docker do ESP atual.
- Consulte as notas de lançamento do ESPv2 para ver a imagem Docker do ESPv2 atual.
- Código fonte no GitHub.
- Consulte o README do ESP para ver detalhes sobre a criação do ESP.
- Consulte o README do ESPv2 para ver detalhes sobre a criação do ESPv2.
Pode executar o contentor do ESP no seguinte:
- Ambiente flexível do App Engine
- Compute Engine
- Kubernetes, incluindo o Google Kubernetes Engine
- Um computador Linux ou macOS, ou outra plataforma
Pode executar o contentor do ESPv2 no seguinte:
- App Engine
- Funções do Cloud Run
- Cloud Run
- Knative Serving
- GKE
- Compute Engine
- Kubernetes
Para mais informações, consulte o artigo Acerca do Cloud Endpoints.
No ambiente flexível do App Engine, o ESP é implementado automaticamente para si quando adiciona algumas linhas ao ficheiro app.yaml. Para mais
informações, consulte o artigo Implementar a sua API e o
ESP. O ESPv2 não é compatível com o ambiente flexível do App Engine.
Para o ambiente de 1.ª geração do App Engine standard, tem de usar os Frameworks Endpoints. Se, em alternativa, implementar o contentor numa das opções de computação acima, pode usar um proxy para qualquer geração do tempo de execução padrão do App Engine.