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

Anteprima

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

--instance -i -n

Nome dell'istanza di IoT Operations.

--resource-group -g

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.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Proprietà Valore
Valori accettati: false, true
--yes -y

Confermare [y]es senza una richiesta. Utile per scenari di integrazione continua e automazione.

Proprietà Valore
Valori accettati: false, true
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

Anteprima

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

--eg-resource-id

ID risorsa ARM dello spazio dei nomi di Griglia di eventi.

--instance -i -n

Nome dell'istanza di IoT Operations.

--resource-group -g

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.

--acquire-policy-token

Acquisizione automatica di un token Criteri di Azure per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--adr-role-ids

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
--change-reference

ID riferimento di modifica correlato per questa operazione di risorsa.

Proprietà Valore
Gruppo di parametri: Global Policy Arguments
--mi-user-assigned

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.

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Proprietà Valore
Valori accettati: false, true
--ops-role-ids

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
--ra-scope

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
--skip-ra

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
--user-object-ids

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
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

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

Anteprima

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

--instance -i -n

Nome dell'istanza di IoT Operations.

--resource-group -g

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.

--no-progress

Disabilitare la rappresentazione visiva del lavoro.

Proprietà Valore
Valori accettati: false, true
Parametri globali
--debug

Aumentare la verbosità dei log per visualizzare tutti i log di debug.

Proprietà Valore
Valore predefinito: False
--help -h

Mostra questo messaggio Guida, esci.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

Proprietà Valore
Valore predefinito: False
--output -o

Formato dell'output.

Proprietà Valore
Valore predefinito: json
Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
--query

Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.

--subscription

Nome o ID della sottoscrizione. È possibile configurare la sottoscrizione predefinita usando az account set -s NAME_OR_ID.

--verbose

Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.

Proprietà Valore
Valore predefinito: False