Cloud Endpoints è un sistema di gestione delle API che consente di proteggere, monitorare analizzare e impostare quote sulle API utilizzando la stessa infrastruttura utilizzata da Google per le proprie API. Endpoints funziona con Extensible Service come proxy (ESP) ed Extensible Service Proxy V2 (ESPv2) per che forniscono la gestione delle API. Puoi trovare ulteriori informazioni su Endpoints, ESP ed ESPv2 in Informazioni Endpoint.
Endpoint supporta la versione 2 di Specifica OpenAPI (noto in precedenza come specifica Swagger): lo standard di settore per la definizione di REST su quelle di livello inferiore. Se non hai dimestichezza con la specifica OpenAPI, vedi Panoramica di OpenAPI.
Questa documentazione mostra come utilizzare Endpoints con OpenAPI. Per documentazione sulle altre opzioni di Endpoints, consulta Tutti i documenti di Endpoints.
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 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 Scelta di un'opzione di computing. e consulta la sezione Piattaforme di computing supportate di seguito.
Dopo aver deciso il backend per l'API, segui una tutorial per ciò che preferisci di computing.
Piattaforme di computing supportate
Endpoints per OpenAPI dipende da ESP o ESPv2 per la gestione delle API. Sia ESP sia 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 la l'immagine Docker ESP attuale.
- Consulta le note di rilascio di ESPv2 per conoscere l'immagine Docker ESPv2 attuale.
- Codice sorgente in GitHub.
- Consulta la pagina ESP README per i dettagli sulla creazione di un ESP.
- Vedi il file README di ESPv2 per i dettagli sulla creazione di ESPv2.
Puoi eseguire il container ESP su questi elementi:
- Ambiente flessibile di App Engine
- Compute Engine
- Kubernetes, compreso Google Kubernetes Engine
- Un computer Linux o macOS o un'altra piattaforma
Puoi eseguire il container ESPv2 su quanto segue:
- App Engine
- Cloud Functions
- Cloud Run
- Knative serving
- GKE
- Compute Engine
- Kubernetes
Per ulteriori informazioni, consulta Informazioni su Cloud Endpoints.
Nell'ambiente flessibile di App Engine, ESP è
automaticamente il deployment quando aggiungi alcune righe
app.yaml. Per ulteriori informazioni
consulta la sezione Deployment dell'API
ESP. ESPv2 non supporta l'ambiente flessibile di App Engine.
Per l'ambiente standard di generazione 1 di App Engine, devi utilizzare gli Endpoint Framework. Se invece di eseguire il deployment del container in una delle opzioni di computing riportate sopra, puoi eseguire il proxy a entrambe le generazioni di runtime standard di App Engine.