Inizia con Azure Device Registry (anteprima)

Questo articolo descrive come configurare uno spazio dei nomi Registro Dispositivi Azure e collegare le istanze di hub IoT e del servizio Device Provisioning da cui dipende. Puoi creare nuove risorse, collegare un'istanza DPS esistente e le sue istanze hub IoT collegate, oppure collegare istanze hub IoT esistenti a una nuova istanza DPS.

Importante

L'integrazione di Azure Device Registry con hub IoT di Azure è in preview pubblica e non è raccomandata per carichi di lavoro in produzione. Vedi le Condizioni supplementari d'uso per le anteprime di Microsoft Azure per conoscere le condizioni legali applicabili alle funzionalità di Azure che sono in beta, in anteprima o non ancora rilasciate nella disponibilità generale.

Importante

Azure Device Registry, inclusa la gestione dei certificati, è gratuito durante l'anteprima. Le istanze hub IoT e Device Provisioning Service (DPS) che utilizzi vengono fatturate alle loro tariffe standard. Per dettagli, consulta hub IoT di Azure pricing.

Prerequisites

Una sottoscrizione di Azure attiva. Se non hai una sottoscrizione di Azure, crea un account gratuito.
I provider di risorse Microsoft.DeviceRegistry e Microsoft.Devices registrati nella tua sottoscrizione. Se si prevede di utilizzare gli aggiornamenti del software, registrare anche Microsoft.DeviceUpdate. Per le istruzioni, vedere Registrare un provider di risorse.
Permessi per creare gruppi di risorse, namespace Azure Device Registry, identità gestite, istanze hub IoT e istanze DPS nell'abbonamento target.
Autorizzazione a creare assegnazioni di ruolo. Ciò richiede un ruolo privilegiato, come Proprietario o Amministratore Accesso Utente nell'ambito appropriato.
Una regione supportata per Azure Device Registry, hub IoT e DPS. Tutte le nuove risorse vengono create nella stessa regione dello spazio di nomi.

Warning

Il collegamento di un'istanza di hub IoT o un'istanza di servizio Device Provisioning esistente a uno spazio dei nomi di Registro Dispositivi Azure è permanente e non può essere annullato. Ti viene chiesto di prendere atto di questo effetto quando selezioni una risorsa esistente.

Configurazione dell'interfaccia della riga di comando di Azure

Per utilizzare i passaggi della CLI sia in Bash che in PowerShell, installa la interfaccia della riga di comando di Azure. Poi accedi e installa o aggiorna la versione preview dell'estensione azure-iot :

az login
az extension add --upgrade --name azure-iot --allow-preview true

I passaggi della CLI utilizzano identità gestite assegnate dal sistema per il namespace e i servizi connessi.

Modi per iniziare

Puoi configurare Azure Device Registry in due modi:

Usa la configurazione guidata. Un'esperienza guidata che ti guida nella creazione o apertura di un namespace e nel collegamento dei servizi da cui dipende. Usa questo metodo per arrivare a uno spazio di nomi funzionante senza una conoscenza approfondita dei servizi sottostanti.
Collega i servizi individualmente. Un percorso passo dopo passo in cui apri un namespace e colleghi ogni servizio uno alla volta. Usa questo metodo quando vuoi il pieno controllo su ogni risorsa o devi aggiungere risorse a uno spazio di nomi esistente.

Entrambi i metodi producono lo stesso risultato: uno spazio di nomi con istanze hub IoT connesse e un'istanza DPS che puoi gestire tramite il piano di controllo Azure.

L'impostazione guidata è disponibile solo nel portale Azure. Quando colleghi i servizi individualmente, puoi usare il portale Azure o la interfaccia della riga di comando di Azure.

Usa la configurazione guidata

Puoi iniziare la configurazione guidata da una di queste posizioni nel portale Azure:

Dalla pagina Azure Device Registry, nella scheda Inizia, seleziona Avvia configurazione. Questo punto di ingresso crea un namespace come parte della configurazione.
Da uno spazio dei nomi Registro Dispositivi Azure esistente, nella scheda Introduzione. Questo punto di ingresso usa la sottoscrizione, il gruppo di risorse e l'area dello spazio dei nomi e vi aggiunge i servizi.

La configurazione guidata ti guida attraverso quattro passaggi: namespace ADR, Connettività, Funzionalità e Revisione + creazione.

1. namespace ADR

Nella pagina del namespace ADR:

Seleziona se creare un namespace o usare un namespace esistente.
Selezionare l’abbonamento di Azure.
Crea un gruppo di risorse o selezionane uno già esistente.
Inserisci un nome di namespace che contiene lettere minuscole, numeri e trattini. La configurazione guidata utilizza questo valore per suggerire nomi alle risorse che crea.
Scegliere un'area. Se prevedi di collegare istanze DPS esistenti o istanze hub IoT, seleziona la regione che contiene quelle istanze.

Se sei partito da uno spazio di nomi esistente, l'abbonamento, il gruppo di risorse e la regione sono già impostati e non possono essere cambiati.

2. Connettività

Nella pagina Connettività , scegli come si connettono i tuoi dispositivi. In base alla tua scelta, Azure utilizza o crea un'istanza DPS e una o più istanze hub IoT.

Seleziona Usa risorse esistentioppure Crea nuove risorse.

Se selezioni Crea nuove risorse, scegli un preset per le tue istanze hub IoT:

Preset	Devices	Connectivity	Telemetry	Risorse create
Distribuzione su piccola scala o in modalità pilota	Fino a circa 10.000	Collegamenti intermittenti	Volume di telemetria inferiore	Un'istanza hub IoT (S1) con un'unità
Distribuzione di produzione	10.000-100.000	Connettività mista	Capacità effettiva moderata	Due istanze hub IoT (S2) con cinque unità, per separare e scalare i carichi di lavoro
Distribuzione su larga scala o ad alto throughput	1,000,000+	Quasi sempre attivo	Volume di dati di telemetria elevato	Quattro istanze di hub IoT (S3) per throughput elevato e scaling orizzontale

I preset determinano quante istanze hub IoT vengono create e le collegano a un servizio di provisioning. Puoi personalizzare la configurazione ora e aggiungere altre istanze hub IoT dopo l'onboarding.

Se selezioni Usa risorse esistenti, scegli se collegare un DPS esistente collegato a istanze di hub IoT o istanze di hub IoT esistenti. In “Scegli una configurazione collegata”, seleziona una configurazione dalla lista. L'elenco viene filtrato per la regione dello spazio di nomi e appaiono solo le istanze hub IoT con accesso pubblico alla rete attivato.

Collegare un'istanza DPS esistente o un'istanza hub IoT allo spazio di nome è permanente.

3. Capacità

Nella pagina Funzionalità, scegli quali funzionalità abilitare. Azure imposta le risorse richieste in base alla tua selezione.

La gestione dei certificati è abilitata di default e utilizza un'autorità di certificazione root rilasciata da Microsoft. Puoi portare la tua autorità di certificazione o cambiarla in seguito.
Gli aggiornamenti software (anteprima) sono opzionali. Se lo abiliti, Azure crea un'istanza di aggiornamento software con una configurazione predefinita. Seleziona Configura per cambiare il nome dell'istanza prima di continuare. La regione dell'istanza corrisponde allo spazio dei nomi e non può essere modificata.

4. Rivedi + crea

Nella pagina Rivedi e crea, esamina il riepilogo dell'impatto, i dettagli dello spazio dei nomi, la configurazione della connettività e le funzionalità abilitate prima di inviare:

Un Riepilogo dell'impatto elenca i servizi aggiunti alla sottoscrizione e al gruppo di risorse.
Le risorse esistenti e quelle create per te sono sia etichettate nel blocco namespace che nel blocco di connettività. Seleziona l'icona della matita accanto a una risorsa per cambiare impostazioni come nome, SKU o limite di messaggi giornalieri prima di inviare.
Un avvertimento afferma che collegare questi servizi è un'azione irreversibile che può causare tempi di inattività per i servizi di gestione esistenti.

Note

Le informazioni sui costi stimati non vengono attualmente mostrate durante la configurazione.

Selezionare Invia. Dopo la fine della configurazione, la configurazione guidata apre il namespace, dove puoi visualizzare i servizi connessi nella scheda Connected Services.

Collega i servizi individualmente

Se vuoi il pieno controllo su ogni risorsa, collega i servizi a uno spazio di nomi uno alla volta invece di usare la configurazione guidata. Collega prima un'istanza DPS, poi una o più istanze hub IoT, e infine un'istanza opzionale di aggiornamento software. Questo metodo produce lo stesso risultato della configurazione guidata.

1. Creare o aprire un namespace

Crea uno spazio di nome Azure Device Registry o apri uno spazio di nomi esistente per aggiungervi servizi. Il namespace rappresenta il confine organizzativo e di sicurezza per i dispositivi e le risorse nella tua soluzione.

Apri il namespace e seleziona la scheda Servizi Connessi . Usa il menu + Connetti per aggiungere servizi uno alla volta.

I passaggi della CLI usano la sintassi Bash. link I comandi nei passaggi seguenti creano eventuali assegnazioni di ruolo mancanti tra il namespace e i servizi connessi. Se il tuo account non può creare assegnazioni di ruoli, un comando si ferma prima di cambiare il namespace e stampa i comandi che qualcuno con i permessi necessari deve eseguire.

Imposta i valori che i comandi riutilizzano. Sostituisci i segnaposto racchiusi tra parentesi angolari con i tuoi valori:

az account set --subscription "<subscription-id>"
RG="<resource-group>"
LOCATION="<region>"
NS="<namespace-name>"
DPS="<dps-name>"
HUB="<iot-hub-name>"
SU="<software-update-instance-name>"

Se stai creando risorse in un nuovo gruppo di risorse, crealo prima. Salta questo comando se stai usando un gruppo di risorse esistente.

az group create --name $RG --location $LOCATION

Crea uno spazio di nomi che utilizzi la sua identità gestita assegnata dal sistema per chiamare i servizi che connetti. Salta questo comando se stai usando uno spazio di nomi esistente.

az iot adr ns create --name $NS --resource-group $RG --location $LOCATION --outbound-system-assigned-mi true

I passaggi della CLI utilizzano la sintassi PowerShell. link I comandi nei passaggi seguenti creano eventuali assegnazioni di ruolo mancanti tra il namespace e i servizi connessi. Se il tuo account non può creare assegnazioni di ruoli, un comando si ferma prima di cambiare il namespace e stampa i comandi che qualcuno con i permessi necessari deve eseguire.

Imposta i valori che i comandi riutilizzano. Sostituisci i segnaposto racchiusi tra parentesi angolari con i tuoi valori:

az account set --subscription "<subscription-id>"
$RG = "<resource-group>"
$LOCATION = "<region>"
$NS = "<namespace-name>"
$DPS = "<dps-name>"
$HUB = "<iot-hub-name>"
$SU = "<software-update-instance-name>"

Se stai creando risorse in un nuovo gruppo di risorse, crealo prima. Salta questo comando se stai usando un gruppo di risorse esistente.

az group create --name $RG --location $LOCATION

Crea uno spazio di nomi che utilizzi la sua identità gestita assegnata dal sistema per chiamare i servizi che connetti. Salta questo comando se stai usando uno spazio di nomi esistente.

az iot adr ns create --name $NS --resource-group $RG --location $LOCATION --outbound-system-assigned-mi true

2. Collegare un'istanza di Device Provisioning Service

Seleziona + Connect>il Servizio di Provisioning dei Dispositivi (DPS), quindi scegli come connettere questo servizio:

Usa esistente: selezionare un'istanza del servizio Device Provisioning non connessa e le istanze di hub IoT collegati nell'area dello spazio dei nomi.
Crea nuovo: seleziona l'abbonamento e il gruppo risorse, e poi inserisci un nome per la nuova istanza DPS. La regione corrisponde al namespace e non può essere cambiata.

Selezionare Salva.

Puoi collegare solo un'istanza DPS a un namespace. L'istanza DPS necessita di un'identità gestita assegnata dal sistema.

Usa un'istanza DPS esistente, oppure creane una nuova nella regione dello spazio dei nomi:

az iot dps create --name $DPS --resource-group $RG --location $LOCATION --system-assigned-mi

Ottieni l'ID risorsa dell'istanza DPS e collegalo al namespace:

DPS_ID=$(az iot dps show --name $DPS --resource-group $RG --query id --output tsv)
az iot adr ns link dps add --name primary-dps --ns $NS --resource-group $RG --dps-id $DPS_ID --system-assigned-mi true

Puoi collegare solo un'istanza DPS a un namespace. L'istanza DPS necessita di un'identità gestita assegnata dal sistema.

Usa un'istanza DPS esistente, oppure creane una nuova nella regione dello spazio dei nomi:

az iot dps create --name $DPS --resource-group $RG --location $LOCATION --system-assigned-mi

Ottieni l'ID risorsa dell'istanza DPS e collegalo al namespace:

$DPS_ID = az iot dps show --name $DPS --resource-group $RG --query id --output tsv
az iot adr ns link dps add --name primary-dps --ns $NS --resource-group $RG --dps-id $DPS_ID --system-assigned-mi true

3. Connettere un'istanza di hub IoT

Seleziona + Connect>hub IoT, e poi scegli come collegare questo servizio:

Usa l'esistente: collega un'istanza hub IoT esistente.
Crea nuovo: seleziona l'abbonamento e il gruppo risorse, poi inserisci nome, SKU e limite giornaliero di messaggi per la nuova istanza hub IoT. La regione corrisponde al namespace e non può essere cambiata.

Quando colleghi un'istanza hub IoT esistente, riconosci che collegarla allo spazio di nomi è permanente.

Invia la configurazione per collegare l'istanza hub IoT al namespace.

Per prima cosa, collega l'istanza DPS prima di collegare un'istanza hub IoT. Il comando fallisce se il namespace non ha un'istanza DPS collegata. L'istanza hub IoT deve utilizzare uno SKU di livello standard, come S1, e avere un'identità gestita assegnata dal sistema.

Usa un'istanza hub IoT esistente, oppure creane una nuova nella regione del namespace:

az iot hub create --name $HUB --resource-group $RG --location $LOCATION --sku S1 --system-assigned-mi

Ottieni l'ID della risorsa dell'istanza di hub IoT e collegalo al namespace:

HUB_ID=$(az iot hub show --name $HUB --resource-group $RG --query id --output tsv)
az iot adr ns link hub add --name primary-hub --ns $NS --resource-group $RG --hub-id $HUB_ID --system-assigned-mi true

Per collegare più istanze hub IoT, ripeti questi passaggi con un'istanza hub IoT diversa e un nome unico dell'endpoint.

Usa un'istanza hub IoT esistente, oppure creane una nuova nella regione del namespace:

az iot hub create --name $HUB --resource-group $RG --location $LOCATION --sku S1 --system-assigned-mi

Ottieni l'ID della risorsa dell'istanza di hub IoT e collegalo al namespace:

$HUB_ID = az iot hub show --name $HUB --resource-group $RG --query id --output tsv
az iot adr ns link hub add --name primary-hub --ns $NS --resource-group $RG --hub-id $HUB_ID --system-assigned-mi true

Per collegare più istanze hub IoT, ripeti questi passaggi con un'istanza hub IoT diversa e un nome unico dell'endpoint.

4. Connettere gli aggiornamenti software (facoltativo)

Seleziona + Connect>aggiornamenti software, e poi inserisci un nome per la nuova istanza di aggiornamento software. L'abbonamento, il gruppo di risorse e la regione corrispondono allo spazio dei nomi e non possono essere cambiati.

Invia la configurazione per creare e collegare l'istanza di aggiornamento software.

Solo un'istanza di aggiornamento software può connettersi a un namespace.

Crea un'istanza di aggiornamento software con un'identità gestita assegnata dal sistema:

az iot adr ns su instance create --name $SU --resource-group $RG --location $LOCATION --system-assigned-mi true

Ottieni l'ID risorsa dell'istanza e collegalo allo spazio di nomi:

SU_ID=$(az iot adr ns su instance show --name $SU --resource-group $RG --query id --output tsv)
az iot adr ns link su add --name primary-su --ns $NS --resource-group $RG --su-id $SU_ID --system-assigned-mi true

Solo un'istanza di aggiornamento software può connettersi a un namespace.

Crea un'istanza di aggiornamento software con un'identità gestita assegnata dal sistema:

az iot adr ns su instance create --name $SU --resource-group $RG --location $LOCATION --system-assigned-mi true

Ottieni l'ID risorsa dell'istanza e collegalo allo spazio di nomi:

$SU_ID = az iot adr ns su instance show --name $SU --resource-group $RG --query id --output tsv
az iot adr ns link su add --name primary-su --ns $NS --resource-group $RG --su-id $SU_ID --system-assigned-mi true

5. Verifica le risorse collegate

Nella scheda Servizi connessi dello spazio dei nomi, verificare che le risorse connesse mostrino uno stato Integrità pari a Disponibile e uno Stato configurazione pari a Operazione riuscita. Il tuo namespace è pronto quando tutti i servizi di cui hai bisogno appaiono come connessi.

Elenca i servizi collegati e conferma che ognuno di essi riporti un linkingState di Succeeded:

az iot adr ns link dps list --ns $NS --resource-group $RG
az iot adr ns link hub list --ns $NS --resource-group $RG

Se hai collegato un'istanza di aggiornamento software, verifica anche quella connessione:

az iot adr ns link su list --ns $NS --resource-group $RG

Se un comando link add viene restituito prima che il collegamento termini, usare az iot adr ns link wait per attendere che tutti i collegamenti configurati abbiano esito positivo:

az iot adr ns link wait --ns $NS --resource-group $RG

Elenca i servizi collegati e conferma che ognuno di essi riporti un linkingState di Succeeded:

az iot adr ns link dps list --ns $NS --resource-group $RG
az iot adr ns link hub list --ns $NS --resource-group $RG

Se hai collegato un'istanza di aggiornamento software, verifica anche quella connessione:

az iot adr ns link su list --ns $NS --resource-group $RG

Se un comando link add viene restituito prima che il collegamento termini, usare az iot adr ns link wait per attendere che tutti i collegamenti configurati abbiano esito positivo:

az iot adr ns link wait --ns $NS --resource-group $RG

Denominazione delle risorse

La configurazione guidata suggerisce i nomi delle risorse basandosi sul nome dello spazio dei nomi. Puoi cambiare i nomi suggeriti prima di inviarli.

Ad esempio, se il nome dello spazio di nomi è contoso-devices, la configurazione guidata suggerisce i seguenti nomi:

Resource	Modello di nome suggerito	Example
spazio dei nomi del Registro di sistema dei dispositivi Azure	`<namespace-name>`	`contoso-devices`
Istanza dell'hub IoT	`<namespace-name>-hub-<number>`	`contoso-devices-hub-1`
Servizio di provisioning di dispositivi	`<namespace-name>-provisioning`	`contoso-devices-provisioning`
Istanza di aggiornamento software	`<namespace-name>-su`	`contoso-devices-su`

Gestisci le risorse connesse

La connessione dei servizi a uno spazio dei nomi non sostituisce le relative esperienze di gestione individuali. Per modificare le impostazioni di un'istanza hub IoT, apri l'istanza nel portale Azure. Per cambiare le impostazioni DPS, apri l'istanza DPS nel portale Azure.

Passaggi successivi

Scopri come pianificare i namespace del Registro dei Dispositivi Azure.
Scopri la gestione dei certificati in Azure Device Registry.
Scopri l'integrazione di Azure Device Registry con hub IoT di Azure.

Commenti e suggerimenti

Questa pagina è stata utile?

Ultimo aggiornamento: 2026-10-23