az iot ops live-data
Note
Questo riferimento fa parte dell'estensione azure-iot-ops per l'interfaccia della riga di comando di Azure (versione 2.70.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot ops live-data . Altre informazioni sulle estensioni.
Questo gruppo di comandi è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Configurazione dell'infrastruttura dati dinamica per un'istanza di operazioni IoT.
Richiede un runtime di anteprima. Abilita richiede un runtime pronto; mostrare e disabilitare rimangono disponibili per la diagnosi e la pulizia dei runtime di anteprima non integri.
Comandi
| Nome | Descrizione | Tipo | Status |
|---|---|---|---|
| az iot ops live-data disable |
Disabilitare i dati live per un'istanza di operazioni IoT. |
Extension | Preview |
| az iot ops live-data enable |
Abilitare i dati attivi per un'istanza di operazioni IoT. |
Extension | Preview |
| az iot ops live-data show |
Visualizzare la configurazione dei dati live per un'istanza di operazioni IoT. |
Extension | Preview |
az iot ops live-data disable
Il gruppo di comandi 'iot ops live-data' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Disabilitare i dati live per un'istanza di operazioni IoT.
Rimuove il profilo del flusso di dati dedicato, l'endpoint del flusso di dati EG e lo spazio degli argomenti di osservabilità, quindi rimuove la voce dell'endpoint di osservabilità dell'istanza dallo spazio dei nomi Registro dispositivi per ultimo in modo che una disabilitazione interrotta possa essere eseguita di nuovo in modo sicuro. Mantiene il flag abilitato per l'osservabilità a livello di spazio dei nomi e le voci dell'endpoint appartenenti ad altre istanze, anche quando la voce di questa istanza è l'ultima rimossa. Gli ID risorsa della posizione personalizzata corrispondono senza distinzione tra maiuscole e minuscole.
La pulizia continua per le risorse di proprietà dell'istanza se manca il riferimento ADR o lo spazio dei nomi. Se lo spazio dei nomi di Griglia di eventi non può essere individuato, un avviso identifica lo spazio degli argomenti che potrebbe richiedere la pulizia manuale.
Le assegnazioni di ruolo gestite con ambito dello spazio dei nomi di Griglia di eventi vengono mantenute; Le assegnazioni di identità gestite con ambito spazio-spazio vengono rimosse insieme allo spazio dell'argomento. Le assegnazioni di lettore create per --user-object-ids sono sempre con ambito nello spazio dei nomi Registro dispositivi, non sono interessate da --ra-scope e vengono mantenute. Usare gli ID di assegnazione restituiti da abilita se è necessaria la pulizia esplicita.
az iot ops live-data disable --instance
--resource-group
[--acquire-policy-token]
[--change-reference]
[--no-progress {false, true}]
[--yes {false, true}]
Esempio
Disabilitare i dati live per un'istanza di .
az iot ops live-data disable --instance myinstance -g myresourcegroup
Disabilitare i dati in tempo reale senza una richiesta di conferma.
az iot ops live-data disable --instance myinstance -g myresourcegroup --yes
Parametri necessari
Nome dell'istanza di IoT Operations.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
ID riferimento di modifica correlato per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
Disabilitare la rappresentazione visiva del lavoro.
| Proprietà | Valore |
|---|---|
| Valori accettati: | false, true |
Confermare [y]es senza una richiesta. Utile per scenari di integrazione continua e automazione.
| Proprietà | Valore |
|---|---|
| Valori accettati: | false, true |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az iot ops live-data enable
Il gruppo di comandi 'iot ops live-data' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Abilitare i dati attivi per un'istanza di operazioni IoT.
Effettua il provisioning e configura l'infrastruttura condivisa a livello di istanza necessaria per i dati live in tre domini:
- Spazio dei nomi di Griglia di eventi: spazio degli argomenti di osservabilità.
- Istanza di operazioni IoT: un profilo di flusso di dati dedicato e un endpoint del flusso di dati MQTT di EG.
- Spazio dei nomi del Registro di sistema dispositivi: l'identità in uscita e la voce dell'endpoint di osservabilità per istanza (con chiave dal percorso personalizzato dell'istanza).
Il comando è idempotente. L'esecuzione di nuovo converge allo stato desiderato senza sovrascrivere voci non correlate. Imposta l'osservabilità dello spazio dei nomi abilitata su true e aggiunge la voce dell'endpoint di osservabilità dell'istanza. L'abilitazione per istanza è determinata da tale voce e dalla configurazione delle risorse di supporto, non dal flag a livello di spazio dei nomi. I prerequisiti di AdR vengono convalidati prima della creazione delle risorse. I modelli di argomento dei dati attivi esistenti e le impostazioni del profilo del flusso di dati vengono riconciliati in caso di riabilitazione. L'identità in uscita DIR è a livello di spazio dei nomi. Se altri endpoint osservabili o di gestione condividono lo spazio dei nomi, riutilizzarne l'identità esistente; la modifica viene rifiutata per evitare di interrompere tali endpoint.
Per impostazione predefinita, le assegnazioni di ruolo (Event Grid TopicSpaces Publisher per l'identità dell'istanza e il Sottoscrittore per l'identità dello spazio dei nomi ADR) vengono create nell'ambito dello spazio dei nomi griglia di eventi. Usare --ra-scope topic-space per le assegnazioni con privilegi minimi con ambito nello spazio degli argomenti o --skip-ra per ignorare la creazione dell'assegnazione di ruolo.
Usare --user-object-ids per concedere lettore direttamente a uno o più utenti Microsoft Entra dal tenant delle risorse nell'ambito dello spazio dei nomi Registro dispositivi. Queste assegnazioni sono additive, idempotenti, non interessate da --ra-scope e mantenute in caso di disabilitazione. Il comando restituisce gli ID di assegnazione per la pulizia esplicita. --skip-ra ha la precedenza e ignora queste assegnazioni. Le singole assegnazioni utente sono necessarie durante l'anteprima pubblica quando l'autorizzazione basata su gruppo non è disponibile.
az iot ops live-data enable --eg-resource-id
--instance
--resource-group
[--acquire-policy-token]
[--adr-role-ids]
[--change-reference]
[--mi-user-assigned]
[--no-progress {false, true}]
[--ops-role-ids]
[--ra-scope {namespace, topic-space}]
[--skip-ra {false, true}]
[--user-object-ids]
Esempio
Abilitare Live Data usando un'identità gestita assegnata dal sistema e i ruoli predefiniti.
az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID
Abilitare Live Data usando un'identità gestita assegnata dall'utente per l'autenticazione in uscita.
az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --mi-user-assigned $UA_MI_RESOURCE_ID
Abilitare Dati attivi con privilegi minimi, assegnazioni di ruolo con ambito di argomento con ambito spazio.
az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --ra-scope topic-space
Abilitare Live Data e concedere il ruolo Lettore direttamente agli utenti di Microsoft Entra.
az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --user-object-ids $USER_OBJECT_ID_1 $USER_OBJECT_ID_2
Abilitare Dati attivi e ignorare le assegnazioni di ruolo.
az iot ops live-data enable --instance myinstance -g myresourcegroup --eg-resource-id $EG_NAMESPACE_RESOURCE_ID --skip-ra
Parametri necessari
ID risorsa ARM dello spazio dei nomi di Griglia di eventi.
Nome dell'istanza di IoT Operations.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
ID ruolo personalizzati per l'identità dello spazio dei nomi DIR (Sottoscrittore) rispetto allo spazio dei nomi EG. Impostazione predefinita: 'Event Grid TopicSpaces Subscriber'.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Role Assignment Arguments |
ID riferimento di modifica correlato per questa operazione di risorsa.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Global Policy Arguments |
ID risorsa identità gestita assegnata dall'utente per l'endpoint del flusso di dati EG e l'identità in uscita dello spazio dei nomi ADR. Impostazione predefinita: identità gestita assegnata dal sistema.
Disabilitare la rappresentazione visiva del lavoro.
| Proprietà | Valore |
|---|---|
| Valori accettati: | false, true |
ID ruolo personalizzati per l'identità dell'istanza di AIO (Publisher) rispetto allo spazio dei nomi EG. Impostazione predefinita: 'Event Grid TopicSpaces Publisher'.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Role Assignment Arguments |
Ambito per le assegnazioni di ruolo di Griglia di eventi. 'namespace' (impostazione predefinita) assegna allo spazio dei nomi EG e viene mantenuto in caso di disabilitazione; 'topic-space' assegna alla risorsa spazio argomenti (privilegio minimo) e viene rimosso con lo spazio dell'argomento in caso di disabilitazione.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Role Assignment Arguments |
| Valori accettati: | namespace, topic-space |
Quando viene usato il passaggio di assegnazione di ruolo dell'operazione verrà ignorato.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Role Assignment Arguments |
| Valori accettati: | false, true |
Microsoft Entra ID oggetto utente dal tenant della risorsa per concedere lettore nello spazio dei nomi Registro di sistema del dispositivo. Le assegnazioni sono additivi e mantenute in caso di disabilitazione. Ignorato quando viene usato --skip-ra.
| Proprietà | Valore |
|---|---|
| Gruppo di parametri: | Role Assignment Arguments |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
az iot ops live-data show
Il gruppo di comandi 'iot ops live-data' è in anteprima e in fase di sviluppo. Livelli di riferimento e supporto: https://aka.ms/CLI_refstatus
Visualizzare la configurazione dei dati live per un'istanza di operazioni IoT.
Segnala la configurazione dei dati live e lo stato della risorsa nello spazio dei nomi del Registro di sistema dispositivi, nella griglia di eventi e nelle risorse del flusso di dati operazioni IoT. Il flag abilitato di primo livello è true solo quando è presente l'immissione dell'endpoint di osservabilità dell'istanza e tutte le risorse di supporto sono presenti. Il flag abilitato per l'osservabilità a livello di spazio dei nomi viene segnalato per informazioni e non determina l'abilitazione per istanza. I modelli di argomento, le impostazioni del profilo dedicato e il tipo di endpoint, l'host, l'autenticazione, il prefisso ID client e la modalità TLS devono corrispondere anche alla configurazione dei dati live. Lo stato dell'endpoint include un flag configurato. Per l'autenticazione assegnata dall'utente, la verifica legge anche gli ID client e tenant dell'identità gestita a cui si fa riferimento. Lo stato dello spazio dei nomi del Registro di sistema dispositivi include userReaderAssignments con ID entità e assegnazione per le assegnazioni dirette degli utenti nell'ambito dello spazio dei nomi, incluse le assegnazioni create all'esterno dell'abilitazione dei dati attivi. Le assegnazioni ereditate e di gruppo vengono escluse. La lettura di questo elenco richiede Microsoft. Autorizzazione/ruoloAssegnazioni/lettura; gli errori di autorizzazione o di servizio vengono visualizzati anziché segnalati come elenco vuoto.
az iot ops live-data show --instance
--resource-group
[--no-progress {false, true}]
Esempio
Visualizzare la configurazione dei dati live per un'istanza di .
az iot ops live-data show --instance myinstance -g myresourcegroup
Parametri necessari
Nome dell'istanza di IoT Operations.
Nome del gruppo di risorse. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.
Parametri facoltativi
I seguenti parametri sono facoltativi, ma a seconda del contesto, uno o più di questi potrebbero diventare necessari per l'esecuzione corretta del comando.
Disabilitare la rappresentazione visiva del lavoro.
| Proprietà | Valore |
|---|---|
| Valori accettati: | false, true |
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |
Formato dell'output.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | json |
| Valori accettati: | json, jsonc, none, table, tsv, yaml, yamlc |
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.
| Proprietà | Valore |
|---|---|
| Valore predefinito: | False |