Condividi tramite


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

  • 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

Passaggi successivi