Inizia a utilizzare API Gateway e l'hub API

Questo tutorial mostra come connettere API Gateway all'hub API per consentire la pubblicazione senza problemi dei metadati API dal tuo progetto API Gateway all'hub API.

In questo tutorial utilizzerai la console Google Cloud .

Elenco attività

Utilizza il seguente elenco di attività mentre segui il tutorial. Tutte le attività sono necessarie per connettere API Gateway all'hub API.

1. Esegui i passaggi preliminari descritti in Prima di iniziare.

2. Esegui il deployment di un'API in API Gateway.

3. Collega il tuo progetto API Gateway all'hub API.

4. Visualizza l'API Gateway API nell'hub API.

5. Evita che al tuo account Google Cloud vengano addebitati costi. Vedi Esegui la pulizia.

Prima di iniziare

Prima di iniziare, assicurati di aver completato i seguenti passaggi preliminari:

1. Configura API Gateway nel tuo progetto.

2. Configura l'hub API nel progetto host.

Configura API Gateway nel tuo progetto

Per configurare API Gateway nel tuo progetto:

1. Nella console Google Cloud , vai alla pagina API Gateway.

   Vai ad API Gateway

   Nota: se non prevedi di conservare le risorse che crei in questo tutorial, crea un nuovo progetto invece di selezionarne uno esistente. Una volta completata questa procedura, puoi eliminare il progetto e tutte le relative risorse.

2. API Gateway richiede l'abilitazione dei seguenti servizi Google:

   Nome	Titolo
   apigateway.googleapis.com	API API Gateway
   servicemanagement.googleapis.com	API Service Management
   servicecontrol.googleapis.com	API Service Control

   Se non hai attivato in precedenza questi servizi per il progetto selezionato, ti viene chiesto di farlo.

3. Verifica che la fatturazione sia abilitata per il tuo progetto.

   Scopri come attivare la fatturazione

Configura l'hub API nel progetto host

1. Crea o seleziona un Google Cloud progetto da utilizzare come progetto host.

   Un progetto host è un progetto Google Cloud nella tua organizzazione Google Cloud che designi come progetto consumer per tutte le risorse dell'hub API. È possibile eseguire il provisioning di una singola istanza dell'hub API per progetto host.

   Per fornire un rilevamento centralizzato delle API in tutti i tuoi gateway API, ti consigliamo di utilizzare un progetto host dedicato per l'istanza dell'hub API e di collegare più progetti API Gateway, denominati progetti di runtime, all'istanza dell'hub API.

   Se è già stato eseguito il provisioning di un'istanza dell'hub API nella tua Google Cloud organizzazione o cartella, ti consigliamo di saltare questo passaggio e di collegare il tuo progetto API Gateway all'istanza dell'hub API esistente.

2. Concedi i ruoli Identity and Access Management (IAM) necessari per connettere API Gateway all'hub API.

3. Esegui il provisioning dell'hub API nel tuo progetto host.

Esegui il deployment di un'API su API Gateway

Completa la guida rapida di API Gateway per eseguire il deployment di un servizio Cloud Run "hello world" e creare un gateway che rimandi a quel servizio.

Ad esempio, l'API helloworld viene implementata nel gateway API helloworld-gateway, come mostrato nella pagina Gateway della console Google Cloud .

Collega il tuo progetto API Gateway all'hub API

Per collegare il tuo progetto API Gateway all'hub API:

1. Nella console Google Cloud , vai alla pagina Hub API.

   Vai all'hub API

2. Seleziona il progetto host dell'hub API nel menu a discesa.
3. Fai clic su Impostazioni nel menu di navigazione a sinistra per aprire la pagina Impostazioni.
4. Vai alla scheda Associazioni di progetto.
5. Fai clic su Collega progetto di runtime.
   Viene visualizzato il riquadro Seleziona una risorsa.
6. Fai clic sul progetto Google Cloud in cui viene eseguito il provisioning di API Gateway.
7. Nel riquadro Impostazioni di associazione del progetto, seleziona API Gateway e qualsiasi altro asset API che vuoi importare automaticamente.
8. Fai clic su Salva.

Il progetto di runtime è collegato e visualizzato nell'elenco dei progetti di runtime collegati nella console Google Cloud .

Ad esempio:

Per abilitare l'importazione dati in tempo reale, l'hub API crea un'istanza del plug-in API Gateway per il progetto di runtime collegato quando selezioni l'importazione degli asset API Gateway. Puoi visualizzare questa istanza del plug-in nella colonna Plug-in associati della pagina Associazioni di progetto.

Visualizzare l'API API Gateway nell'hub API

Per visualizzare l'API API Gateway nell'hub API:

1. Nella console Google Cloud , vai alla pagina API in API Hub.

   Vai all'hub API

2. Individua l'API "hello world" di cui hai eseguito il deployment in API Gateway.

   Se necessario, seleziona Gateway: API Gateway nel menu a discesa Filtro per visualizzare solo le API API Gateway.

   Ad esempio:

   

3. Fai clic sull'API per visualizzare maggiori dettagli, inclusi i metadati dell'API.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, puoi:

• Eliminare il gateway
• Eliminare l'API

In alternativa, puoi anche eliminare i Google Cloud progetti utilizzati per questo tutorial.

Passaggi successivi

• Scopri di più su API Gateway
• Scopri di più su come centralizzare le API utilizzando l'hub API.