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 utilizzata da Google per le proprie API. Endpoints funziona con Extensible Service Proxy (ESP) ed Extensible Service Proxy V2 (ESPv2) per fornire la gestione delle API. Puoi scoprire di più su Endpoints, ESP ed ESPv2 in Informazioni su Endpoints.
Endpoints supporta la versione 2 della specifica OpenAPI (in precedenza nota come 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.
Questo set di documentazione mostra come utilizzare Endpoints con OpenAPI. Per la documentazione sulle altre opzioni di Endpoints, consulta la documentazione di tutti gli endpoint.
Per iniziare, ti consigliamo di seguire il seguente percorso nella documentazione:
Per vedere le funzionalità di Endpoints in azione, consulta la guida rapida per Cloud Endpoints, che utilizza script per eseguire il deployment di un'API di esempio nell'ambiente flessibile di App Engine.
Ora devi decidere quale piattaforma di calcolo utilizzare per la tua API. Per aiutarti a prendere questa decisione, consulta la sezione Scegliere un'opzione di calcolo e la sezione Piattaforme di calcolo supportate di seguito.
Dopo aver scelto il backend per la tua API, segui un tutorial per la piattaforma di calcolo che preferisci.
Piattaforme di calcolo 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 contenitore 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.
- Per informazioni dettagliate sulla creazione di ESP, consulta il file README di ESP.
- Per informazioni dettagliate sulla creazione di ESPv2, consulta il file README di ESPv2.
Puoi eseguire il contenitore ESP su quanto segue:
- Ambiente flessibile di App Engine
- Compute Engine
- Kubernetes, incluso Google Kubernetes Engine
- Un computer Linux o macOS o un'altra piattaforma
Puoi eseguire il contenitore ESPv2 su quanto segue:
- App Engine
- Funzioni Cloud Run
- Cloud Run
- Knative serving
- GKE
- Compute Engine
- Kubernetes
Per saperne di più, consulta Informazioni su Cloud Endpoints.
Nell'ambiente flessibile App Engine, ESP viene eseguito automaticamente se aggiungi alcune righe al file app.yaml. Per ulteriori informazioni, vedi Eseguire il deployment dell'API e dell'ESP. ESPv2 non supporta l'ambiente flessibile di App Engine.
Per l'ambiente standard di App Engine di 1ª generazione, devi utilizzare i Framework Endpoints. Se invece esegui il deployment del contenitore in una delle opzioni di calcolo sopra indicate, puoi eseguire il proxy per entrambe le generazioni del runtime standard di App Engine.