Avvio rapido: creare una nuova istanza di Gestione API di Azure usando PowerShell
SI APPLICA A: Consumo | Sviluppatore | Basic | Standard | Premium
In questa guida introduttiva si crea una nuova istanza di Gestione API usando i cmdlet di Azure PowerShell. Dopo aver creato un'istanza, è possibile usare i cmdlet di Azure PowerShell per azioni 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
- Se si sceglie di usare Azure PowerShell in locale:
- Installare la versione più recente del modulo Az di PowerShell.
- Connettersi all'account Azure con il cmdlet Connect-AzAccount.
- Se si sceglie di usare Azure Cloud Shell:
- Vedere Panoramica di Azure Cloud Shell per altre informazioni.
Crea gruppo di risorse
Creare un gruppo di risorse di Azure con New-AzResourceGroup. Un gruppo di risorse è un contenitore logico in cui vengono distribuite e gestite le risorse di Azure.
Il comando seguente crea un gruppo di risorse denominato myResourceGroup nella posizione Stati Uniti occidentali (WestUS):
New-AzResourceGroup -Name myResourceGroup -Location WestUS
Creare un'istanza di Gestione API
Ora che si dispone di un gruppo di risorse, è possibile creare un'istanza del servizio Gestione API. Crearne una usando New-AzApiManagement 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 dell'amministratore per la ricezione delle notifiche.
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 sui livelli di Gestione API, vedere Confronto basato sulle funzionalità dei livelli di Gestione API di Azure.
Suggerimento
Si tratta di un’azione a esecuzione prolungata. Possono essere necessari da 30 a 40 minuti per creare e attivare un servizio Gestione API in questo livello.
New-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup" `
-Location "West US" -Organization "Contoso" -AdminEmail "admin@contoso.com"
Dopo che il comando ha completato l'azione, eseguire Get-AzApiManagement per visualizzare le proprietà del servizio Gestione API di Azure. Dopo l'attivazione, ProvisioningState indica che l’operazione è stata completata e l'istanza presenta diversi URL associati. Ad esempio:
Get-AzApiManagement -Name "myapim" -ResourceGroupName "myResourceGroup"
Output di esempio:
PublicIPAddresses : {203.0.113.1}
PrivateIPAddresses :
Id : /subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/myResourceGroup/providers/Microsoft.ApiManagement/service/myapim
Name : myapim
Location : West US
Sku : Developer
Capacity : 1
CreatedTimeUtc : 9/9/2022 9:07:43 PM
ProvisioningState : Succeeded
RuntimeUrl : https://myapim.azure-api.net
RuntimeRegionalUrl : https://myapi-westus-01.regional.azure-api.net
PortalUrl : https://myapim.portal.azure-api.net
DeveloperPortalUrl : https://myapim.developer.azure-api.net
ManagementApiUrl : https://myapim.management.azure-api.net
ScmUrl : https://myapim.scm.azure-api.net
PublisherEmail : admin@contoso.com
OrganizationName : Contoso
NotificationSenderEmail : apimgmt-noreply@mail.windowsazure.com
VirtualNetwork :
VpnType : None
PortalCustomHostnameConfiguration :
ProxyCustomHostnameConfiguration : {myapim.azure-api.net}
ManagementCustomHostnameConfiguration :
ScmCustomHostnameConfiguration :
DeveloperPortalHostnameConfiguration :
SystemCertificates :
Tags : {}
AdditionalRegions : {}
SslSetting : Microsoft.Azure.Commands.ApiManagement.Models.PsApiManagementSslSetting
Identity :
EnableClientCertificate :
EnableClientCertificate :
Zone :
DisableGateway : False
MinimalControlPlaneApiVersion :
PublicIpAddressId :
PlatformVersion : stv2
PublicNetworkAccess : Enabled
PrivateEndpointConnections :
ResourceGroupName : myResourceGroup
Una volta completata la distribuzione, è possibile iniziare a usare l'istanza del servizio Gestione API. Cominciare con l'esercitazione per importare e pubblicare la prima API.
Pulire le risorse
Quando non servono più, è possibile usare il comando Remove-AzResourceGroup per rimuovere il gruppo di risorse e tutte le risorse correlate.
Remove-AzResourceGroup -Name myResourceGroup