Avvio rapido: creare una nuova istanza di Gestione API di Azure usando l’interfaccia della riga di comando di Azure
SI APPLICA A: Consumo | Sviluppatore | Basic | Standard | Premium
Questo argomento di avvio rapido descrive i passaggi per la creazione di una nuova istanza di Gestione API tramite i comandi dell’interfaccia della riga di comando di Azure. Dopo aver creato un'istanza, è possibile usare l’interfaccia della riga di comando di Azure per attività di gestione comuni, come l'importazione di API nell'istanza di Gestione API.
Gestione API di Azure consente alle organizzazioni di pubblicare API per consentire a sviluppatori esterni, partner e interni di sfruttare tutte le potenzialità dei rispettivi dati e servizi. Gestione API fornisce le competenze fondamentali per assicurare un programma API di successo attraverso il coinvolgimento degli sviluppatori, informazioni aziendali approfondite, strumenti di analisi, sicurezza e protezione. Con Gestione API è possibile creare e gestire gateway API moderni per servizi back-end esistenti ospitati ovunque.
Se non si ha una sottoscrizione di Azure, creare un account Azure gratuito prima di iniziare.
Prerequisiti
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere la Avvio rapido di Bash in Azure Cloud Shell.
Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.
Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.
Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.
Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.
- Questo articolo richiede la versione2.11.1 o successiva dell'interfaccia della riga di comando di Azure. Se si usa Azure Cloud Shell, la versione più recente è già installata.
Creare un gruppo di risorse
Le istanze di Gestione API di Azure, analogamente a tutte le risorse di Azure, devono essere distribuite in un gruppo di risorse. I gruppi di risorse consentono di organizzare e gestire le risorse di Azure correlate.
Per iniziare, creare un gruppo di risorse denominato myResourceGroup nell'area Stati Uniti centrali (centralus) con il comando az group create seguente:
az group create --name myResourceGroup --location centralus
Creare un'istanza di Gestione API
Ora che si dispone di un gruppo di risorse, è possibile creare un'istanza di Gestione API. Crearne una usando il comando az apim create e specificare un nome di servizio e i dettagli del server di pubblicazione. Il nome del servizio deve essere univoco in Azure.
Nell'esempio seguente viene usato come nome di servizio myapim. Aggiornarlo con un valore univoco. Aggiornare anche il nome dell'organizzazione del server di pubblicazione dell'API e l'indirizzo di posta elettronica per la ricezione delle notifiche.
az apim create --name myapim --resource-group myResourceGroup \
--publisher-name Contoso --publisher-email admin@contoso.com \
--no-wait
Per impostazione predefinita, il comando crea l'istanza nel livello Developer, un'opzione economica per valutare Gestione API di Azure. Questo livello non è disponibile per la produzione. Per altre informazioni sulla scalabilità dei livelli di Gestione API, vedere upgrade and scale (Aggiornare e ridimensionare).
Suggerimento
Possono essere necessari da 30 a 40 minuti per creare e attivare un servizio Gestione API in questo livello. Il comando precedente usa l'opzione --no-wait in modo che il comando restituisca immediatamente il controllo mentre viene creato il servizio.
Controllare lo stato della distribuzione eseguendo il comando az apim show:
az apim show --name myapim --resource-group myResourceGroup --output table
Inizialmente l'output ha un aspetto simile a quanto al seguente e riporta lo stato Activating:
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- -------------- ----------- ------------ ---------- --------- -------
myapim myResourceGroup Central US Activating Developer 1
Dopo l'attivazione, lo stato diventa Online e l'istanza del servizio presenta un indirizzo gateway e un indirizzo IP pubblico. Per il momento, questi indirizzi non espongono alcun contenuto. Ad esempio:
NAME RESOURCE GROUP LOCATION GATEWAY ADDR PUBLIC IP PRIVATE IP STATUS TIER UNITS
----------- ---------------- ---------- --------------------------------- ------------ ------------ -------- --------- -------
myapim myResourceGroup Central US https://myapim.azure-api.net 203.0.113.1 Online Developer 1
Nel momento in cui l'istanza del servizio Gestione API è online, è possibile iniziare a usarla. Cominciare con l'esercitazione per importare e pubblicare la prima API.
Pulire le risorse
È possibile usare il comando az group delete per rimuovere il gruppo di risorse e l’istanza del servizio di Gestione API quando non sono necessari.
az group delete --name myResourceGroup