Cloud Endpoints per OpenAPI

Cloud Endpoints è un sistema di gestione delle API che ti aiuta a proteggere, monitorare, analizzare e impostare quote per le tue API utilizzando la stessa infrastruttura che Google utilizza per le proprie API. Endpoints funziona con Extensible Service Proxy (ESP) e con Extensible Service Proxy V2 (ESPv2) per fornire la gestione delle API. Per saperne di più su Endpoints, ESP ed ESPv2, consulta la sezione Informazioni su Endpoints.

Endpoints supporta le API descritte utilizzando OpenAPI 2.0 e OpenAPI 3.x della specifica OpenAPI (in precedenza la specifica Swagger) lo standard di settore per la definizione delle API REST.

Se non hai familiarità con la specifica OpenAPI, consulta la panoramica di OpenAPI. Per scoprire di più sulle versioni supportate, vedi Versioni OpenAPI supportate.

Questo insieme di documentazione mostra come utilizzare Endpoints con OpenAPI. Per la documentazione sulle altre opzioni di Endpoints, consulta Tutti i documenti di Endpoints.

Per iniziare, ti consigliamo di seguire questo percorso nella documentazione:

1. Per vedere le funzionalità di Endpoints in azione, segui la guida rapida per Cloud Endpoints, che utilizza script per eseguire il deployment di un'API di esempio nell'ambiente flessibile di App Engine.

2. Ora devi decidere quale piattaforma di computing vuoi utilizzare per la tua API. Per aiutarti a prendere questa decisione, consulta Scegliere un'opzione di calcolo e la sezione Piattaforme di calcolo supportate di seguito.

3. Dopo aver deciso il backend per l'API, segui un tutorial per la piattaforma di calcolo che preferisci.

Piattaforme di computing supportate

Endpoints per OpenAPI dipende da ESP o ESPv2 per la gestione delle API. Sia ESP che ESPv2 sono progetti open source e sono disponibili nei seguenti modi:

• Un container in Artifact Registry.
  • Consulta le note di rilascio di ESP per l'immagine Docker ESP corrente.
  • Consulta le note di rilascio di ESPv2 per l'immagine Docker ESPv2 corrente.
• Codice sorgente in GitHub.
  • Consulta il file README di ESP per informazioni dettagliate sulla creazione di ESP.
  • Consulta il file README di ESPv2 per informazioni dettagliate sulla creazione di ESPv2.

Puoi eseguire il container ESP su:

• Ambiente flessibile di App Engine
• Compute Engine
• Kubernetes, incluso Google Kubernetes Engine
• Un computer Linux o macOS o un'altra piattaforma

Puoi eseguire il container ESPv2 su:

• App Engine
• Cloud Run Functions
• Cloud Run
• Knative serving
• GKE
• Compute Engine
• Kubernetes

Per saperne di più, consulta Informazioni su Cloud Endpoints.

Nell'ambiente flessibile App Engine, ESP viene distribuito automaticamente quando aggiungi alcune righe al file app.yaml. Per saperne di più, consulta Deployment dell'API e dell'ESP. ESPv2 non supporta l'ambiente flessibile di App Engine.

Per l'ambiente standard di App Engine di prima generazione, devi utilizzare Endpoints Frameworks. Se invece esegui il deployment del container in una delle opzioni di calcolo precedenti, puoi eseguire il proxy in una delle generazioni dell'ambiente di runtime standard di App Engine.