Guida introduttiva: Creare e distribuire una risorsa di Azure AI Health Insights (INTERFACCIA della riga di comando)
Questa guida introduttiva fornisce istruzioni dettagliate per creare una risorsa e distribuire un modello. È possibile creare risorse in Azure in diversi modi:
- Ilportale di Azure
- API REST, interfaccia della riga di comando di Azure, PowerShell o librerie client
- Modelli di Azure Resource Manager
In questo articolo vengono esaminati esempi per la creazione e la distribuzione di risorse con l'interfaccia della riga di comando di Azure.
Prerequisiti
- Una sottoscrizione di Azure.
- Interfaccia della riga di comando di Azure. Per altre informazioni, vedere Come installare l'interfaccia della riga di comando di Azure.
Accedere all'interfaccia della riga di comando di Azure
Accedere all'interfaccia della riga di comando di Azure o selezionare Apri CloudShell nei passaggi seguenti.
Creare un gruppo di risorse di Azure
Per creare una risorsa di Azure Health Insights, è necessario un gruppo di risorse di Azure. Quando si crea una nuova risorsa tramite l'interfaccia della riga di comando di Azure, è anche possibile creare un nuovo gruppo di risorse o indicare ad Azure di usare un gruppo esistente. L'esempio seguente illustra come creare un nuovo gruppo di risorse denominato HealthInsightsResourceGroup con il comando az group create . Il gruppo di risorse viene creato nella località Stati Uniti orientali.
az group create \
--name HealthInsightsResourceGroup \
--location eastus
Creare una risorsa
Usare il comando az cognitiveservices account create per creare una risorsa di Azure Health Insights nel gruppo di risorse. Nell'esempio seguente viene creata una risorsa denominata HealthInsightsResource nel gruppo di risorse HealthInsightsResourceGroup . Quando si prova l'esempio, aggiornare il codice per usare i valori desiderati per il gruppo di risorse e il nome della risorsa, insieme all'ID sottoscrizione di Azure.
az cognitiveservices account create \
--name HealthInsightsResource \
--resource-group HealthInsightsResourceGroup \
--kind HealthInsights \
--sku F0 \
--location eastus \
--custom-domain healthinsightsresource \
--subscription <subscriptionID>
Recuperare informazioni sulla risorsa
Dopo aver creato la risorsa, è possibile usare comandi diversi per trovare informazioni utili sull'istanza di Azure Health Insights. Gli esempi seguenti illustrano come recuperare l'URL di base dell'endpoint dell'API REST e le chiavi di accesso per la nuova risorsa.
Ottenere l'URL dell'endpoint
Usare il comando az cognitiveservices account show per recuperare l'URL di base dell'endpoint DELL'API REST per la risorsa. In questo esempio l'output del comando viene diretto tramite il processore JSON jq per individuare il .properties.endpoint
valore.
Quando si prova l'esempio, aggiornare il codice per usare i valori per il gruppo di risorse e la risorsa.
az cognitiveservices account show \
--name HealthInsightsResource \
--resource-group HealthInsightsResourceGroup \
| jq -r .properties.endpoint
Ottenere la chiave API primaria
Per recuperare le chiavi di accesso per la risorsa, usare il comando az cognitiveservices account keys list . In questo esempio l'output del comando viene diretto tramite il processore JSON jq per individuare il .key1
valore.
Quando si prova l'esempio, aggiornare il codice per usare i valori per il gruppo di risorse e la risorsa.
az cognitiveservices account keys list \
--name HealthInsightsResource \
--resource-group HealthInsightsResourceGroup \
| jq -r .key1
Eliminare una risorsa o un gruppo di risorse
Se si vuole eseguire la pulizia dopo questi esercizi, è possibile rimuovere la risorsa di Azure Health Insights eliminando la risorsa tramite l'interfaccia della riga di comando di Azure.
Per rimuovere la risorsa, usare il comando az cognitiveservices account delete . Quando si esegue questo comando, assicurarsi di aggiornare il codice di esempio per usare i valori per il gruppo di risorse e la risorsa.
az cognitiveservices account delete \
--name HealthInsightsResource \
--resource-group HealthInsightsResourceGroup
È anche possibile eliminare il gruppo di risorse. Se si sceglie di eliminare il gruppo di risorse, vengono eliminate anche tutte le risorse contenute nel gruppo. Quando si esegue questo comando, assicurarsi di aggiornare il codice di esempio per usare i valori per il gruppo di risorse.
az group delete \
--name HealthInsightsResourceGroup