Guide illustrative

Configurazione e deployment di un'API

• Configurazione di Cloud Endpoints

  Spiega come preparare il documento OpenAPI per il deployment su Endpoints.

• Eseguire il deployment della configurazione di Endpoints

  Descrive come eseguire il deployment di un documento OpenAPI su Endpoints.

• Esegui il deployment del backend dell'API

  Spiega come eseguire il deployment del codice backend dell'API e dell'Extensible Service Proxy (ESP).

• Distribuzione in Kubernetes

  Mostra come configurare ed eseguire il deployment di Endpoints su Kubernetes.

• Esecuzione di ESP in locale o su un'altra piattaforma

  Mostra come configurare un'istanza di ESP su una macchina locale o su un altro cloud provider.

• Confronto tra i file di configurazione

  Descrive la scheda Cronologia deployment nella pagina Endpoint > Servizi della console Google Cloud e spiega come confrontare la configurazione di un servizio di cui è stato eseguito il deployment con la versione precedente.

• Recupero del nome del servizio e dell'ID di configurazione

  Descrive come ottenere il nome e l'ID di configurazione di un servizio gestito.

Risoluzione dei problemi e monitoraggio

• Panoramica della risoluzione dei problemi

  Fornisce informazioni generali sulla risoluzione dei problemi e fornisce link ad altre pagine per ulteriori informazioni.

• Risoluzione dei problemi di deployment della configurazione degli endpoint

  Descrive alcuni errori che potresti riscontrare quando esegui il deployment della configurazione di Endpoints e come risolverli.

• Risoluzione dei problemi relativi agli errori di risposta

  Descrive come risolvere gli errori che ricevi in una risposta da una richiesta alla tua API.

• Risoluzione dei problemi di deployment nell'ambiente flessibile di App Engine

  Fornisce tecniche di risoluzione dei problemi per i deployment di Endpoints per i deployment nell'ambiente flessibile di App Engine.

• Risoluzione dei problemi di deployment su Compute Engine

  Fornisce tecniche di risoluzione dei problemi per i deployment di endpoint su Compute Engine.

• Risoluzione dei problemi di deployment GKE

  Fornisce tecniche di risoluzione dei problemi per i deployment di endpoint su GKE.

• Risoluzione dei problemi relativi alla convalida JWT

  Fornisce informazioni per la risoluzione dei problemi se la convalida JWT non va a buon fine e viene restituito un errore nella risposta al client.

• Monitoraggio dell'API

  Descrive come monitorare l'integrità delle API utilizzando i log e le metriche che Endpoints gestisce automaticamente per te.

• Tracciamento dell'API

  Spiega la frequenza di campionamento delle tracce, come stimare il costo di Cloud Trace, come visualizzare le tracce nella console Google Cloud e come disabilitare il campionamento delle tracce.

Portale Cloud Endpoints

• Panoramica del portale Endpoints

  Fornisce una panoramica del portale Endpoints e include un link al sito web dimostrativo del portale Endpoints.

• Introduzione all'utilizzo del portale Endpoints

  Descrive come creare un portale Endpoints e presenta l'interfaccia utente del portale Endpoints.

• Aggiornamento di SmartDocs

  Descrive la documentazione di riferimento dell'API SmartDocs, in che modo SmartDoc utilizza i campi del tuo documento OpenAPI per generare la documentazione dell'API e come rigenerare SmartDocumenti.

• Prova dell'API

  Descrive come configurare il portale in modo che gli utenti possano provare la tua API.

• Aggiunta della documentazione personalizzata

  Descrive come modificare la Guida introduttiva di esempio e come creare e visualizzare pagine di documentazione aggiuntive per il portale Endpoints.

• Sincronizzazione della documentazione personalizzata tramite un'API

  Descrive come utilizzare un'API per sincronizzare la documentazione personalizzata con il portale.

• Configurazione di un dominio personalizzato

  Descrive come configurare il portale Endpoints per l'utilizzo di un dominio personalizzato.

DNS e SSL

• Verificare un nome di dominio

  Mostra come verificare la proprietà di un nome di dominio che pubblica un'API Endpoints.

• Gestire un'API dal nome di dominio

  Mostra come configurare il progetto per gestire le richieste API.

• Configurazione del DNS nel dominio cloud.goog

  Mostra come configurare i servizi DNS per Endpoints che utilizzano il dominio cloud.goog, di proprietà e gestito da Google.

• Gestione di più API da un dominio

  Mostra come eseguire più API indipendenti sul tuo dominio.

• Abilitazione di SSL con ESP

  Mostra come abilitare una porta SSL per il servizio Endpoints di cui hai eseguito il deployment tramite ESP.

• Abilitazione di SSL con ESPv2

  Mostra come abilitare una porta SSL per il servizio Endpoints di cui hai eseguito il deployment tramite ESPv2.

Autenticazione e chiavi API

• Scelta di un metodo di autenticazione

  Fornisce una panoramica e casi d'uso di esempio per ogni metodo di autenticazione supportato.

• Perché e quando utilizzare le chiavi API

  Fornisce informazioni di base sulle chiavi API e su quando utilizzarle.

• Utilizzo di Firebase per autenticare gli utenti

  Mostra come configurare il tuo documento OpenAPI in modo che ESP convalidi le richieste in arrivo dai client utilizzando Firebase per autenticare gli utenti.

• Utilizzo di Auth0 per autenticare gli utenti

  Mostra come configurare il documento OpenAPI in modo che ESP convalidi le richieste in entrata dai client utilizzando Auth0 per autenticare gli utenti.

• Utilizzo di token ID Google personalizzati per autenticare gli utenti

  Mostra come configurare il tuo documento OpenAPI in modo che ESP convalidi le richieste in arrivo dai client utilizzando i token ID Google per autenticare gli utenti.

• Utilizzare un metodo personalizzato per autenticare gli utenti

  Mostra come configurare il tuo documento OpenAPI in modo che ESP convalidi le richieste in arrivo dai client utilizzando un provider personalizzato per autenticare gli utenti.

• Autenticazione tra servizi

  Mostra come autenticare le chiamate da servizio a servizio.

• Limitazione dell'accesso con le chiavi API

  Mostra come impedire ad applicazioni client e servizi non autorizzati di accedere alla tua API.

Gestione dell'accesso all'API

• Panoramica dell'accesso all'API

  Descrive le opzioni di controllo dell'accesso API disponibili in Endpoints.

• Controllare chi può abilitare l'API

  Mostra come controllare chi può abilitare la tua API nei propri progetti Google Cloud.

• Abilitazione di un'API nel progetto Google Cloud

  Mostra come abilitare un'API in un progetto Google Cloud.

• Concessione e revoca dell'accesso all'API

  Mostra come concedere diversi livelli di accesso in modo che altri membri del team possano aiutarti a gestire l'API.

Gestione del ciclo di vita delle API

• Panoramica della gestione del ciclo di vita delle API

  Descrive le funzionalità di controllo delle versioni dell'API Endpoints e fornisce le best practice per il controllo delle versioni e la gestione temporanea dell'API Endpoints.

• Eliminazione di un'API e delle istanze

  Mostra come eliminare un'API e arrestare le istanze che eseguono l'API per evitare costi inutili.

• Ripristino di un servizio gestito

  Mostra come ripristinare un servizio gestito in caso di eliminazione accidentale.

Limitazione delle richieste API (beta)

• Informazioni sulle quote

  Fornisce una panoramica delle funzionalità principali fornite dalle quote.

• Configurazione delle quote

  Descrive come configurare le quote per l'API.

• Override del limite di quota predefinito

  Descrive come impostare un limite di quota diverso per un progetto consumer specifico.

Personalizzazione di ESP

• Utilizzo di un'istanza nginx.conf personalizzata su Google Kubernetes Engine

  Descrive come creare un file nginx.conf personalizzato per il deployment di ESP in GKE.

• Creazione di un elemento nginx.conf personalizzato per supportare CORS

  Mostra esempi di come le opzioni CORS ESP vengono scritte in nginx.conf come punto di partenza nel caso in cui sia necessario personalizzare il supporto CORS in ESP.

Altre guide illustrative di Endpoints

• Eseguire la migrazione a ESPv2

• Guide illustrative di Cloud Endpoints Frameworks per l'ambiente standard di App Engine

• Guide illustrative di Cloud Endpoints per gRPC