Cloud Endpoints è un sistema di gestione delle API che ti aiuta a proteggere, monitorare, analizzare e impostare quote sulle API utilizzando la stessa infrastruttura utilizzata da Google per le proprie API. Funziona con Extensible Service Proxy (ESP) ed Extensible Service Proxy V2 (ESPv2) per fornire la gestione delle API. Per saperne di più su Endpoints, ESP ed ESPv2, consulta Informazioni sugli endpoint.
Endpoints supporta la versione 2 della specifica OpenAPI (precedentemente nota come specifica Swagger), lo standard di settore per la definizione delle API REST. Se non hai dimestichezza con la specifica OpenAPI, consulta la pagina 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 questo percorso nella documentazione:
Per vedere le funzionalità di Endpoints in azione, segui la guida rapida per Cloud Endpoints, che utilizza gli script per eseguire il deployment di un'API di esempio nell'ambiente flessibile di App Engine.
Ora devi decidere quale piattaforma di computing vuoi utilizzare per l'API. Per aiutarti a prendere questa decisione, consulta la sezione Scegliere un'opzione di computing e la sezione Piattaforme di computing supportate di seguito.
Dopo aver scelto il backend per l'API, segui un tutorial per la tua piattaforma di calcolo preferita.
Piattaforme di computing supportate
Gli endpoint per OpenAPI dipendono 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 Google Container Registry.
- Consulta le note di rilascio di ESP per l'immagine Docker ESP attuale.
- Consulta le note di rilascio di ESPv2 per l'immagine Docker ESPv2 attuale.
- Codice sorgente in GitHub.
- Consulta il README ESP per i dettagli sulla creazione di ESP.
- Consulta il README DI ESPv2 per i dettagli 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 Functions
- Cloud Run
- Cloud Run for Anthos
- GKE
- Compute Engine
- Kubernetes
Per saperne di più, consulta Informazioni su Cloud Endpoints.
Nell'ambiente flessibile di App Engine, viene eseguito automaticamente il deployment dell'ESP quando aggiungi alcune righe al file app.yaml
. Per ulteriori
informazioni, consulta la pagina relativa al deployment di API ed
ESP. ESPv2 non supporta l'ambiente flessibile di App Engine.
Per l'ambiente di 1a generazione standard di App Engine, devi utilizzare Frameworks endpoint. Se invece esegui il deployment del container in una delle opzioni di computing riportate sopra, puoi eseguire il proxy per una delle due generazioni di runtime standard di App Engine.