Esercizio - Creare un gateway API

  • 10 minuti

In questo esercizio verrà distribuita un'API Web di esempio e si configurerà un gateway API. In un'unità successiva si pubblica l'API Web nel gateway.

Nell'esempio del calzaturificio, NorthWind Shoes ha deciso di condividere un'API di inventario con i partner. Questa API consente ai partner di accedere alle informazioni sull'inventario e sui prodotti.

Importante

Per eseguire questo esercizio è necessario disporre di una propria sottoscrizione di Azure e questo potrebbe comportare dei costi. Se non hai ancora una sottoscrizione di Azure, crea un account gratuito prima di iniziare.

Distribuire l'API Web ShoeCompany

È stata sviluppata un'app .NET Core che genera informazioni sull'inventario e sui prodotti. L'app include Swashbuckle per generare la documentazione di OpenAPI Swagger.

Per risparmiare tempo, si inizierà eseguendo uno script per ospitare l'API RESTful in Azure. Lo script esegue le operazioni seguenti:

  • Crea un piano di servizio app di Azure nel livello gratuito.
  • Crea un'API Web all'interno di un servizio app Azure, configurata per la distribuzione Git da un repository locale.
  • Imposta le credenziali di distribuzione a livello di account per l'app.
  • Configura Git in locale.
  • Distribuisce l'API Web nell'istanza di servizio app.

  1. Accedi al portale di Azure.

  2. Nella barra delle applicazioni di Azure selezionare l'icona Cloud Shell per aprire Azure Cloud Shell.

    Screenshot of Cloud Shell icon in taskbar.

  3. Eseguire il comando git seguente in Cloud Shell per clonare il repository GitHub e scaricare il codice sorgente per l'app.

    git clone https://github.com/MicrosoftDocs/mslearn-publish-manage-apis-with-azure-api-management.git

  4. Al termine dell'operazione, aprire la cartella del repository locale ed elencarne il contenuto eseguendo i comandi seguenti.

    cd mslearn-publish-manage-apis-with-azure-api-management
ls -l

    Uno dei file è setup.sh. Come suggerisce il nome, è lo script eseguito per configurare l'API di test.

  5. Immettere il comando seguente per eseguire lo script. Genera un'app Web pubblica che espone un'interfaccia OpenAPI.

    bash setup.sh

    L'esecuzione dello script richiede circa un minuto. Durante la distribuzione, tutte le dipendenze necessarie per l'esecuzione dell'app vengono installate automaticamente nel servizio app remoto. L'output elenca tutte le operazioni. Al termine dello script, le ultime due righe sono gli URL usati per testare la distribuzione dell'app.

  6. Per verificare che l'app sia stata distribuita correttamente, copiare il primo URL (URL Swagger) da Cloud Shell e incollarlo in una nuova scheda del browser.

    Il browser dovrebbe visualizzare l'interfaccia utente di Swagger per l'app e dichiarare gli endpoint RESTful seguenti:

    • api/inventory genera un elenco di prodotti e il numero in magazzino.
    • api/inventory/{productid} restituisce il numero in magazzino per l'ID prodotto specificato (un numero intero).
    • api/Products genera un elenco di prodotti.
    • api/Products/{productid} restituisce i dettagli per l'ID prodotto specificato.

    Overview of API management.

  7. Copiare infine il secondo URL (URL JSON di Swagger) dall'output di Cloud Shell e salvarlo da qualche parte, ad esempio in Blocco note. Questo URL è necessario nell'esercizio successivo.

Distribuire un gateway API

L'attività finale di questo esercizio consiste nel creare un gateway API nel portale di Azure. Nell'esercizio successivo si usa questo gateway per pubblicare l'API.

  1. Accedi al portale di Azure.

  2. Nei servizi di Azure o dalla home page selezionare Crea una risorsa. Viene visualizzato il riquadro Crea una risorsa.

  3. Nel menu della risorsa selezionare Integrazione e quindi, nei risultati, selezionare Gestione API. Verrà visualizzato il riquadro Crea servizio Gestione API.

  4. Nella scheda Informazioni di base immettere i valori indicati di seguito per ogni impostazione.

    Impostazione Valore
    Dettagli di progetto
    Subscription Selezionare la propria sottoscrizione.
    Gruppo di risorse Selezionare un gruppo di risorse nuovo o esistente. Un gruppo di risorse è un contenitore logico in cui risiedono le risorse correlate per una soluzione di Azure.
    Dettagli istanza
    Area Selezionare un'area disponibile.
    Nome della risorsa apim-NorthWindShoes<random number>, sostituendo random number con la propria serie di numeri per assicurarsi che il nome sia univoco a livello globale.
    Nome organizzazione NorthWindShoes. Nome dell'organizzazione da usare nel portale per sviluppatori e per le notifiche di posta elettronica. Il portale per sviluppatori e le notifiche non sono disponibili in tutti i livelli di servizio.
    Indirizzo di posta elettronica dell'amministratore Indirizzo di posta elettronica per ricevere tutte le notifiche di sistema.
    Piano tariffario Consumption

    Nota

    Il livello A consumo offre una distribuzione rapida per il test e prevede un modello tariffario con pagamento in base al consumo. L'esperienza complessiva di Gestione API è molto simile a quella degli altri piani tariffari.

  5. Selezionare Rivedi e crea per convalidare le impostazioni.

  6. Al termine della convalida selezionare Crea. Il completamento della distribuzione può richiedere alcuni minuti.

  7. Al termine della distribuzione, l'istanza di Gestione API è elencata nelle risorse di Azure. Selezionare Vai alla risorsa per visualizzare il riquadro per il servizio Gestione API.