Endpoints è un sistema di gestione delle API distribuito. Fornisce una console API, hosting, logging, monitoraggio e altre funzionalità per aiutarti a creare, condividere, gestire e proteggere le tue API. Questa pagina fornisce una panoramica di Cloud Endpoints per gRPC. Per informazioni sugli altri tipi di framework API supportati dagli endpoint, consulta Tutti la documentazione di Endpoints.
Endpoints è disponibile per l'utilizzo con Extensible Service Proxy (ESP) distribuito o Extensible Service Proxy V2 (ESPv2). Ciascun proxy fornisce supporto alle piattaforme descritte di seguito:
- App Engine flessibile (solo ESP)
- Google Kubernetes Engine (ESP o ESPv2)
- Compute Engine (ESP o ESPv2)
- Kubernetes (ESP o ESPv2)
- Standard App Engine (solo ESPv2)
- Cloud Functions (solo ESPv2)
- Cloud Run (solo ESPv2)
- Knative serving (solo ESPv2)
Endpoints con ESP
Endpoints utilizza l'Extensible Service Proxy (ESP) distribuito per fornire bassa latenza e prestazioni elevate per gestire anche le API più esigenti. ESP è un proxy di servizio basato su NGINX, quindi puoi avere la certezza che scala in base alle esigenze per gestire richieste simultanee alla tua API. ESP viene eseguito nel proprio container Docker per migliorare l'isolamento e la scalabilità e viene distribuito in Container Registry. Puoi utilizzarla con:
Endpoints con ESPv2
ESPv2 è un proxy scalabile e ad alte prestazioni basato su Envoy che viene eseguito davanti a un backend OpenAPI o gRPC API. ESPv2 supporta la versione 2 della specifica OpenAPI e delle specifiche gRPC. Puoi utilizzarla con:
Funzionalità di gestione dell'API Endpoints
Sia che utilizzi Endpoints con ESP o ESPv2, fornisce una serie di importanti funzionalità di gestione delle API per consentirti di sviluppare, monitorare e controllare l'accesso alle tue API.
Log e metriche
Endpoints utilizza Service Infrastructure per gestire le API e generare report su log e metriche. La maggior parte delle API Google Cloud utilizza la stessa infrastruttura. Puoi gestire e monitorare le API nella pagina Servizi endpoint della console Google Cloud.
Hosting API
Endpoints è ottimizzato per l'ambiente container Docker. Puoi ospitare la tua API ovunque sia supportato Docker, purché abbia accesso a internet a Google Cloud.
Sviluppo di un'API gRPC con Endpoints
Definisci un servizio API gRPC utilizzando i buffer di protocollo e implementalo in qualsiasi lingua supportata da gRPC.
Scrivi la configurazione del servizio API gRPC per Endpoints.
Generare la configurazione API runtime per l'API ed eseguirne il deployment in Service Management.
Esegui il deployment del server API.
Per ulteriori informazioni sull'utilizzo di gRPC con Endpoints, consulta Endpoint per le API gRPC e i relativi tutorial.
Controllo dell'accesso alle API
Endpoints consente di configurare l'API in modo che richieda una chiave API per qualsiasi chiamata e convalida la chiave API. Puoi utilizzare la console Google Cloud anche per condividere la tua API con altri sviluppatori, in modo che possano abilitare l'API e generare chiavi API per chiamarla.
Autenticazione degli utenti dell'API
Per la maggior parte delle chiamate API, ogni chiamata corrisponde a un utente. Mentre le chiavi API indicano quale app sta effettuando una chiamata alla tua API, il processo di autenticazione determina quale utente sta utilizzando l'app.
Tieni presente che il server API deve comunque decidere cosa può fare l'utente autenticato con l'API. Per ulteriori informazioni, consulta la guida di Google Cloud Auth.
Passaggi successivi
Acquisisci familiarità con i passaggi di deployment e guarda come funzionano le funzionalità di Endpoints con la Guida rapida per Endpoints, che utilizza gli script per il deployment di un'API di esempio in un backend flessibile di App Engine.
Scopri di più sull'utilizzo di Endpoints, consulta uno dei tutorial.