Esercizio - Creare un'API back-end

15 minuti

In questo esercizio viene illustrato come eseguire le azioni seguenti:

Creare un'istanza di Gestione API
Importare un'API
Configurare le impostazioni di back-end
Testare l'API

Prerequisiti

Un account Azure con una sottoscrizione attiva. Se non è ancora disponibile alcuna sottoscrizione, è possibile registrarsi per una valutazione gratuita all'indirizzo https://azure.com/free.

Accedere al portale di Azure e aprire Cloud Shell.
Dopo l'apertura della shell, assicurarsi che sia selezionato l'ambiente Bash.

Creare un'istanza di Gestione API

Impostare alcune variabili per i comandi dell'interfaccia della riga di comando da usare per ridurre la quantità di digitazioni. Sostituire <myLocation> con un'area significativa per l'utente. Il nome di Gestioni API deve essere un nome univoco globale e lo script seguente genera una stringa casuale. Sostituire <myEmail> con un indirizzo di posta elettronica a cui è possibile accedere.
```
myApiName=az204-apim-$RANDOM
myLocation=<myLocation>
myEmail=<myEmail>
```
Crea un gruppo di risorse. I comandi seguenti creeranno un gruppo di risorse denominato az204-apim-rg.
```
az group create --name az204-apim-rg --location $myLocation
```
Creare un'istanza di Gestione API. Il comando az apim create viene usato per creare l'istanza. L'opzione --sku-name Consumption viene usata per velocizzare il processo per la procedura dettagliata.
```
az apim create -n $myApiName \
    --location $myLocation \
    --publisher-email $myEmail  \
    --resource-group az204-apim-rg \
    --publisher-name AZ204-APIM-Exercise \
    --sku-name Consumption 
```
Nota

L'operazione deve essere completata in circa cinque minuti.

Importare un'API back-end

Questa sezione illustra come importare e pubblicare un'API back-end Specifica OpenAPI.

Nel portale di Azure cercare e selezionare Servizi Gestione API.
Nella schermata Gestione API selezionare l'istanza di Gestione API creata.
Nel riquadro di spostamento del servizio Gestione API, in API, selezionare API.

Selezionare OpenAPI dall'elenco e scegliere Full nella finestra popup.

Finestra di dialogo OpenAPI. I campi sono descritti in dettaglio nella tabella seguente.

Utilizzare i valori della tabella seguente per compilare il modulo. È possibile lasciare in tutti i campi non indicati il valore predefinito.

Impostazione	valore	Descrizione
Specifica OpenAPI	`https://bigconference.azurewebsites.net/`	Fa riferimento al servizio che implementa l'API, le richieste vengono inoltrate a questo indirizzo. La maggior parte delle informazioni necessarie nel modulo viene popolata automaticamente dopo l'immissione.
Nome visualizzato	API Big Conference	Questo nome viene visualizzato nel portale per sviluppatori.
Nome	api-big-conference	Fornisce un nome univoco per l'API.
Descrizione	Popolato automaticamente	Fornisce una descrizione facoltativa dell'API.

Seleziona Crea.

Configurare le impostazioni dell'API

Viene creata la l'API Big Conference. Configurare le impostazioni dell'API.

Selezionare Impostazioni nel pannello a destra.
Verificare che https://bigconference.azurewebsites.net/ si trovi nel campo URL del servizio Web.
Deselezionare la casella di controllo La sottoscrizione è obbligatoria.
Seleziona Salva.

Testare l'API

Ora che l'API è stata importata e configurata è il momento di testarla.

Selezionare Verifica.
Selezionare Speakers_Get. Nella pagina vengono visualizzati i Parametri di query e le Intestazioni, se presenti.
Selezionare Invia.

Il back-end risponde con 200 OK e alcuni dati.

Pulire le risorse di Azure

Al termine della creazione delle risorse in questo esercizio, è possibile usare il comando seguente per eliminare il gruppo di risorse e tutte le risorse correlate.

az group delete --name az204-apim-rg