Condividi tramite

az tsi event-source iothub

  • Riferimento

Nota

Questo riferimento fa parte dell'estensione timeseriesinsights per l'interfaccia della riga di comando di Azure (versione 2.50.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az tsi event-source iothub . Altre informazioni sulle estensioni.

Gestire l'origine eventi con timeseriesinsights sottogruppo iot-hub.

Comandi

Nome Descrizione Tipo Status
az tsi event-source iothub create

Creare un'origine evento nell'ambiente specificato.

 Estensione Disponibilità generale
az tsi event-source iothub update

Aggiornare un'origine evento nell'ambiente specificato.

 Estensione Disponibilità generale

az tsi event-source iothub create

Creare un'origine evento nell'ambiente specificato.

az tsi event-source iothub create --consumer-group-name
                                  --environment-name
                                  --event-source-name
                                  --event-source-resource-id
                                  --iot-hub-name
                                  --key-name
                                  --location
                                  --resource-group
                                  --shared-access-key
                                  [--local-timestamp]
                                  [--tags]
                                  [--timestamp-property-name]

Esempio

CreateIotHubEventSource

az tsi event-source iothub create -g "rg" --environment-name "env1" --name "eventsource" --consumer-group-name "consumer-group" --iot-hub-name "iothub" --location westus --key-name "key-name" --shared-access-key "someSecretvalue" --event-source-resource-id "resource-id"

Parametri necessari

--consumer-group-name

Nome del gruppo di consumer dell'hub iot che contiene le partizioni da cui verranno letti gli eventi.

--environment-name

Nome dell'ambiente Time Series Insights associato al gruppo di risorse specificato.

--event-source-name --name -n

Nome dell'origine evento Time Series Insights associata all'ambiente specificato.

--event-source-resource-id --resource-id

ID risorsa dell'origine evento in Azure Resource Manager.

--iot-hub-name

Nome dell'hub iot.

--key-name --shared-access-policy-name

Nome della chiave dei criteri di accesso condiviso che concede al servizio Time Series Insights l'accesso all'hub iot. Questa chiave dei criteri di accesso condiviso deve concedere le autorizzazioni di "connessione al servizio" all'hub iot.

--location -l

Posizione. Usare i valori ottenuti con az account list-locations. È possibile configurare la posizione predefinito con az configure --defaults location=<location>.

--resource-group -g

Nome del gruppo di risorse dell'ambiente. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--shared-access-key

Valore della chiave dei criteri di accesso condiviso che concede al servizio Time Series Insights l'accesso in lettura all'hub iot. Questa proprietà non viene visualizzata nelle risposte all'origine eventi.

Parametri facoltativi

--local-timestamp

Oggetto che rappresenta la proprietà timestamp locale. Contiene il formato del timestamp locale che deve essere usato e le informazioni corrispondenti sull'offset del fuso orario. Se non viene specificato un valore per localTimestamp o null, il timestamp locale non verrà inserito con gli eventi. Valore previsto: json-string/@json-file.

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--timestamp-property-name --ts-property-name

La proprietà di evento che verrà usata come timestamp dell'origine evento. Se non è specificato un valore per timestampPropertyName o se viene specificato null o una stringa vuota, verrà usata l'ora di creazione dell'evento.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--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

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

az tsi event-source iothub update

Aggiornare un'origine evento nell'ambiente specificato.

az tsi event-source iothub update [--environment-name]
                                  [--event-source-name]
                                  [--ids]
                                  [--local-timestamp]
                                  [--resource-group]
                                  [--shared-access-key]
                                  [--subscription]
                                  [--tags]
                                  [--timestamp-property-name]

Esempio

UpdateIotHubEventSource

az tsi event-source iothub update -g "rg" --environment-name "env1" --name "eventsource"  --timestamp-property-name timestampProp --shared-access-key "someSecretvalue" --tags test=tag

Parametri facoltativi

--environment-name

Nome dell'ambiente Time Series Insights associato al gruppo di risorse specificato.

--event-source-name --name -n

Nome dell'origine evento Time Series Insights associata all'ambiente specificato.

--ids

Uno o più ID della risorsa (delimitato da spazio). Deve essere un ID risorsa completo contenente tutte le informazioni degli argomenti "ID risorsa". È necessario specificare --ids o altri argomenti "ID risorsa".

--local-timestamp

Oggetto che rappresenta la proprietà timestamp locale. Contiene il formato del timestamp locale che deve essere usato e le informazioni corrispondenti sull'offset del fuso orario. Se non viene specificato un valore per localTimestamp o null, il timestamp locale non verrà inserito con gli eventi. Valore previsto: json-string/@json-file.

--resource-group -g

Nome del gruppo di risorse dell'ambiente. È possibile configurare il gruppo predefinito con az configure --defaults group=<name>.

--shared-access-key

Valore della chiave dei criteri di accesso condiviso che concede al servizio Time Series Insights l'accesso in lettura all'hub iot. Questa proprietà non viene visualizzata nelle risposte all'origine eventi.

--subscription

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

--tags

Tag separati da spazi: key[=value] [key[=value] ...]. Usare "" per cancellare i tag esistenti.

--timestamp-property-name --ts-property-name

La proprietà di evento che verrà usata come timestamp dell'origine evento. Se non è specificato un valore per timestampPropertyName o se viene specificato null o una stringa vuota, verrà usata l'ora di creazione dell'evento.

Parametri globali
--debug

Aumenta il livello di dettaglio della registrazione per mostrare tutti i log di debug.

--help -h

Visualizza questo messaggio della guida ed esce.

--only-show-errors

Mostra solo gli errori, eliminando gli avvisi.

--output -o

Formato di output.

Valori accettati: json, jsonc, none, table, tsv, yaml, yamlc
Valore predefinito: json
--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

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