Esegui il deployment delle API Cloud Endpoints su API Gateway

Cloud Endpoints è un sistema di gestione delle API che ti aiuta a proteggere, monitorare, analizzare e impostare le quote per le tue API. Endpoints utilizza Extensible Service Proxy (ESP) o Extensible Service Proxy V2 (ESPv2) per ospitare le tue API.

Quando utilizzi Endpoints, hai tre opzioni per definire l'API:

Sviluppare API con API Gateway

Sia Endpoints che API Gateway supportano le API descritte utilizzando la specifica OpenAPI, OpenAPI 2.0 o OpenAPI 3.x. Se hai utilizzato OpenAPI per definire le tue API Endpoints, significa che puoi anche eseguire il deployment delle tue API Endpoints su API Gateway.

Esegui il deployment delle specifiche OpenAPI di Endpoints su API Gateway

API Gateway supporta lo stesso formato e le stesse opzioni di definizione della specifica OpenAPI supportati da Cloud Endpoints per OpenAPI. Ciò significa che puoi utilizzare le stesse definizioni di sicurezza, quota e altre dalle specifiche OpenAPI di Endpoints per definire un'API in API Gateway.

L'unica differenza tra Endpoints e API Gateway è il modo in cui elaborano la proprietà host nella definizione della specifica OpenAPI:

  • In Endpoints, imposta la proprietà host sulla parte del nome host dell'URL creato quando hai eseguito il deployment di ESP o ESPv2, dove ESP o ESPv2 è il servizio utilizzato per ospitare l'API Endpoints.
  • In API Gateway, ometti host o impostalo sul nome DNS dell'API di cui è stato eseguito il deployment. I provider di API spesso lo impostano sul nome DNS quando condividono la specifica OpenAPI con i loro consumer di API. Tuttavia, API Gateway non applica il valore della proprietà host.

Ad esempio, di seguito è riportata una parte di una definizione OpenAPI utilizzata da Endpoints per definire un'API per accedere a un servizio di backend di cui è stato eseguito il deployment su Cloud Run Functions:

OpenAPI 2.0

swagger: '2.0'
info:
  title: Cloud Endpoints + GCF
  description: Sample API on Cloud Endpoints with a Google Cloud Functions backend
  version: 1.0.0
host: HOST
schemes:
  - https
  ...

OpenAPI 3.x

openapi: 3.0.4
info:
  title: Cloud Endpoints + GCF
  description: Sample API on Cloud Endpoints with a Google Cloud Functions backend
  version: 1.0.0
servers:
- url: https://HOST
  x-google-endpoint: {}
...

Per saperne di più sulla creazione della specifica OpenAPI per la definizione dell'API, consulta la panoramica di OpenAPI.

Passaggi successivi