Creare un hub IoT usando l'interfaccia della riga di comando di Azure
Questo articolo illustra come creare un hub IoT usando l'interfaccia della riga di comando di Azure.
Prerequisiti
Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido per 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 con l'interfaccia della riga di comando di Azure.
Quando richiesto, installare l'estensione dell'interfaccia della riga di comando di Azure al primo uso. 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.
Quando si crea un hub IoT, è necessario crearlo in un gruppo di risorse. Usare un gruppo di risorse esistente o eseguire questo comando per creare un gruppo di risorse:
az group create --name {your resource group name} --location westus
Suggerimento
L'esempio precedente crea il gruppo di risorse nella località Stati Uniti occidentali. È possibile visualizzare un elenco di località disponibili eseguendo questo comando:
az account list-locations -o table
Creare un hub IoT
Usare l'interfaccia della riga di comando di Azure per creare un gruppo di risorse e quindi aggiungere un hub IoT.
Eseguire il seguente comando per creare un hub IoT nel gruppo di risorse, usando un nome globalmente univoco per l'hub IoT:
az iot hub create --name {your iot hub name} \
--resource-group {your resource group name} --sku S1
Importante
Dato che l'hub IoT sarà individuabile pubblicamente come endpoint DNS, evitare di includere nel nome informazioni personali o sensibili.
Il comando precedente crea un hub IoT nel piano tariffario S1 per cui viene addebitato l'addebito. Per altre informazioni, vedere Azure IoT Hub Prezzi.
Per altre informazioni sui comandi hub IoT di Azure, vedere l'articolo az iot hub
di riferimento.
Aggiornare l'hub IoT
È possibile modificare le impostazioni di un hub IoT esistente dopo la creazione. Ecco alcune proprietà che è possibile impostare per un hub IoT:
Prezzi e scalabilità: eseguire la migrazione a un livello diverso o impostare il numero di unità di hub IoT.
Filtro IP: specificare un intervallo di indirizzi IP che verranno accettati o rifiutati dall'hub IoT.
Proprietà: elenco di proprietà che è possibile copiare e usare altrove, ad esempio l'ID risorsa, il gruppo di risorse, la posizione e così via.
Per un elenco completo delle opzioni per aggiornare un hub IoT, vedere la pagina di riferimento dei comandi az iot hub update.
Registrare un nuovo dispositivo nell'hub IoT
In questa sezione si creerà un'identità del dispositivo nel registro delle identità dell'hub IoT. Un dispositivo non può connettersi a un hub a meno che non abbia una voce nel registro delle identità. Per altre informazioni, vedere Informazioni sul registro delle identità nell'hub IoT. Questa identità del dispositivo è IoT Edge abilitata.
Eseguire il comando seguente per creare un'identità del dispositivo. Usare il nome dell'hub IoT e creare un nuovo nome ID dispositivo al posto di {iothub_name}
e {device_id}
. Questo comando crea un'identità del dispositivo con autorizzazione predefinita (chiave privata condivisa).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
Il risultato è una stampa JSON che include le chiavi e altre informazioni.
In alternativa, sono disponibili diverse opzioni per registrare un dispositivo usando diversi tipi di autorizzazione. Per esplorare le opzioni, vedere Esempi nella pagina di riferimento az iot hub device-identity .
Rimuovere un hub IoT
Esistono vari comandi per eliminare una singola risorsa, ad esempio un hub IoT.
Per eliminare un hub IoT, eseguire il comando seguente:
az iot hub delete --name {your iot hub name} -\
-resource-group {your resource group name}
Passaggi successivi
Altre informazioni sui comandi disponibili nell'estensione Microsoft Azure IoT per l'interfaccia della riga di comando di Azure: