Guida al gateway API QuickStart

Se gli utenti e i gruppi idonei per creare e accedere al gateway API e alle risorse di rete non esistono già:

1. Collegarsi alla console come amministratore della tenancy.
2. Aprire il menu di navigazione e selezionare Identità e sicurezza. In Identità, selezionare Domini.

3. Selezionare un dominio e, nella scheda Gestione utenti, creare un nuovo gruppo selezionando Crea gruppo nella sezione Gruppi.

4. Nella scheda Gestione utenti, creare un nuovo utente selezionando Crea nella sezione Utenti.

5. Nella scheda Gestione utenti aggiungere un utente a un gruppo selezionando il nome del gruppo nella sezione Gruppi, selezionando la scheda Utenti, quindi selezionando Assegna utente a gruppo.

Per ulteriori informazioni, vedere istruzioni dettagliate.

Se un compartimento adatto in cui creare le risorse e le risorse di rete del gateway API non esiste già:

1. Collegarsi alla console come amministratore della tenancy.
2. Aprire il menu di navigazione e selezionare Identità e sicurezza. In Identità selezionare Compartimenti.

3. Selezionare Crea compartimento.

Per ulteriori informazioni, vedere istruzioni dettagliate.

Per garantire l'alta disponibilità, puoi creare gateway API solo nelle subnet regionali (non nelle subnet specifiche di AD). Se una VCN appropriata con una subnet regionale pubblica in cui creare le risorse di rete non esiste già:

Per ulteriori informazioni, vedere istruzioni dettagliate.

Se uno o più sviluppatori API non sono amministratori della tenancy:

1. Collegarsi alla console come amministratore della tenancy.
2. Aprire il menu di navigazione e selezionare Identità e sicurezza. In Identità selezionare Criteri.

3. Creare criteri per concedere agli sviluppatori API l'accesso:

   1. Creare un criterio con un'istruzione criterio per consentire agli sviluppatori API di accedere alle risorse correlate al gateway API. Selezionare Crea criterio, specificare un nome e una descrizione per il nuovo criterio e selezionare il compartimento proprietario delle risorse correlate al gateway API. Utilizzare l'Editor manuale di Policy Builder per immettere la seguente istruzione di criterio, quindi selezionare Crea:

      Allow group <group-name> to manage api-gateway-family in compartment <compartment-name>

   2. Creare un criterio con un'istruzione criterio per consentire agli sviluppatori API di accedere alle risorse di rete. Selezionare Crea criterio, specificare un nome e una descrizione per il nuovo criterio e selezionare il compartimento proprietario delle risorse di rete da utilizzare con il gateway API. Utilizzare l'Editor manuale di Policy Builder per immettere la seguente istruzione di criterio, quindi selezionare Crea:

      Allow group <group-name> to manage virtual-network-family in compartment <compartment-name>

   Nota: i criteri sopra riportati sono sufficienti per consentire la creazione di una distribuzione API con un backend HTTP, come suggerito nella presente Guida di QuickStart. È possibile immettere criteri aggiuntivi (come descritto nella documentazione) per consentire agli sviluppatori di API di creare distribuzioni API con funzioni OCI Functions come backend e per consentire ai gateway API di eseguire l'autenticazione con un server cache per recuperare i dati di risposta inseriti nella cache.

Per ulteriori informazioni, vedere istruzioni dettagliate.

1. Accedere alla console come sviluppatore di API Gateway, aprire il menu di navigazione e selezionare Developer Services. In Gestione API selezionare Gateway.
2. Selezionare Crea gateway e specificare:
   • un nome per il nuovo gateway, ad esempio acme-api-gateway
   • il nome del compartimento in cui creare le risorse del gateway API
   • il tipo di nuovo gateway come pubblico;
   • il nome della VCN da utilizzare con il gateway API
   • il nome della subnet regionale pubblica nella VCN
   
3. Selezionare Crea.

   Una volta creato, il nuovo gateway API viene visualizzato come attivo nella lista della pagina Gateway.

Per ulteriori informazioni, vedere istruzioni dettagliate.

1. Nella pagina della lista Gateways nella console selezionare il nome del gateway API creato in precedenza.
2. Nella scheda Distribuzioni selezionare Crea distribuzione.

3. Nella pagina Informazioni di base specificare quanto segue.

   • un nome per la nuova distribuzione API, ad esempio acme-api-deployment
   • un prefisso di percorso da aggiungere al percorso di ogni instradamento contenuto nella distribuzione API, ad esempio /v1
   • compartimento in cui creare la nuova distribuzione API

4. Selezionare Successivo per visualizzare la pagina Autenticazione. Selezionare quindi Successivo per visualizzare la pagina Cicli, selezionare Aggiungi instradamento e specificare:

   • un percorso, ad esempio /hello
   • un metodo accettato dal servizio backend, ad esempio GET
   • il tipo di servizio backend e i dettagli associati. Per comodità, aggiungere un singolo backend, specificare il tipo HTTP e immettere un'API pubblica come URL del backend (ad esempio https://api.weather.gov).

5. Selezionare Crea per creare l'instradamento. Selezionare Successivo per esaminare i dettagli immessi per la nuova distribuzione API, quindi selezionare Crea per crearla.

   Una volta creata, la nuova distribuzione API viene visualizzata come Attiva nella lista delle distribuzioni API.

6. Quando la distribuzione dell'API è attiva, passare al task successivo.

Per ulteriori informazioni, consulta le istruzioni dettagliate.

1. Nella scheda Distribuzioni della pagina dei dettagli del gateway API, selezionare la nuova distribuzione API appena creata e selezionare Copia accanto all'endpoint della nuova distribuzione API appena creata per copiare l'endpoint.

2. Aprire una finestra di terminale e chiamare l'API immettendo:

   curl -k -X GET <deployment-endpoint>

   dove <deployment-endpoint> è l'endpoint copiato nel passo precedente. Ad esempio, https://lak...sjd.apigateway.us-phoenix-1.oci.customer-oci.com/v1/hello

Complimenti. Hai appena creato il tuo primo gateway API e la prima distribuzione API e hai chiamato la tua prima API utilizzando il servizio gateway API.

Per ulteriori informazioni, vedere istruzioni dettagliate.

Dopo aver creato, distribuito e chiamato una funzione API, scopri come:

• gestione dei gateway API e delle distribuzioni API (vedere Elenco dei gateway API, Aggiornamento di un gateway API, Eliminazione di un gateway API)
• limitazione del numero di richieste (vedere Limitazione del numero di richieste ai backend di API Gateway)
• aggiunta del supporto CORS (vedere Aggiunta del supporto CORS alle distribuzioni API)
• aggiunta di risposte alle scorte (vedere Aggiunta di risposte alle scorte come backend di API Gateway)
• conferma dell'identità e delle autorizzazioni del chiamante API (vedere Aggiunta di autenticazione e autorizzazione alle distribuzioni API)

Procedura completata.