Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
SI APPLICA A: A consumo | Developer | Basic | Standard | Premium
Questa guida introduttiva descrive i passaggi per la creazione di una nuova istanza di Gestione API usando i comandi dell'interfaccia della riga di comando di Azure. Dopo aver creato un'istanza di , è possibile usare l'interfaccia della riga di comando di Azure per attività di gestione comuni, ad esempio l'importazione di API nell'istanza di Gestione API.
Gestione API di Azure consente alle organizzazioni di pubblicare API in sviluppatori esterni, partner e interni per sbloccare il potenziale dei propri 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 la Gestione delle API, creare e gestire gateway API moderni per i servizi back-end esistenti ospitati ovunque.
Se non si ha un account Azure, creare un account gratuito prima di iniziare.
È possibile utilizzare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Introduzione ad Azure Cloud Shell.
Se preferisci eseguire localmente i comandi di riferimento della CLI, installa l'Azure CLI. Se si esegue 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 usi un'installazione locale, accedi all'interfaccia della riga di comando di Azure usando il comando az login. Per completare il processo di autenticazione, seguire i passaggi visualizzati nel terminale. Per altre opzioni di accesso, vedere Eseguire l'autenticazione ad Azure con l'interfaccia della riga di comando di Azure.
Quando ti viene richiesto, installa l'estensione Azure CLI al primo utilizzo. Per altre informazioni sulle estensioni, vedere Usare e gestire le estensioni con l'interfaccia della riga di comando di Azure.
Esegui az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, avviare az upgrade.
- Questo articolo richiede la versione 2.11.1 o successiva dell'interfaccia della riga di comando di Azure. Se si usa Azure Cloud Shell, la versione più recente è già installata.
Le istanze di Gestione API di Azure, come 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.
Creare prima di tutto un gruppo di risorse denominato myResourceGroup nella posizione Stati Uniti centrali con il comando az group create seguente:
az group create --name myResourceGroup --location centralus
Ora che si dispone di un gruppo di risorse, è possibile creare un'istanza di Gestione API. Crearne uno usando il comando az apim create e specificare un nome del servizio e i dettagli dell'editore. Il nome del servizio deve essere univoco all'interno di Azure.
Nell'esempio seguente viene usato myapim per il nome del servizio. Aggiornare il nome a un valore univoco. Aggiornare anche il nome dell'organizzazione dell'autore dell'API e l'indirizzo di posta elettronica per ricevere le 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 è destinato all'uso in produzione. Per altre informazioni sul ridimensionamento dei livelli di Gestione API, vedere l'articolo relativo all'aggiornamento e alla scalabilità.
Suggerimento
La creazione e l'attivazione di un servizio Gestione API in questo livello possono richiedere da 30 a 40 minuti. Il comando precedente usa l'opzione --no-wait in modo che il comando restituisca immediatamente 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 è simile al seguente, mostrando 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 è Online e l'istanza del servizio ha un indirizzo gateway e un indirizzo IP pubblico. Per il momento, questi indirizzi non espongono alcun contenuto. Per 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
Quando l'istanza del servizio Gestione API è online, è possibile usarla. Iniziare con l'esercitazione per importare e pubblicare la prima API.
È possibile usare il comando az group delete per rimuovere il gruppo di risorse e l'istanza del servizio Gestione API quando non sono necessari.
az group delete --name myResourceGroup