az iot central job

Nota

Questo riferimento fa parte dell'estensione azure-iot per l'interfaccia della riga di comando di Azure (versione 2.46.0 o successiva). L'estensione installerà automaticamente la prima volta che si esegue un comando az iot central job . Altre informazioni sulle estensioni.

Gestire e configurare i processi per un'applicazione IoT Central.

Comandi

Nome	Descrizione	Tipo	Status
az iot central job create	Creare ed eseguire un processo tramite la relativa definizione di processo.	Estensione	Disponibilità generale
az iot central job get-devices	Ottenere gli stati del dispositivo del processo.	Estensione	Disponibilità generale
az iot central job list	Ottenere l'elenco dei processi per un'applicazione IoT Central.	Estensione	Disponibilità generale
az iot central job rerun	Eseguire di nuovo un processo in tutti i dispositivi non riusciti.	Estensione	Disponibilità generale
az iot central job resume	Riprendere un processo arrestato.	Estensione	Disponibilità generale
az iot central job show	Ottenere i dettagli di un processo in base all'ID.	Estensione	Disponibilità generale
az iot central job stop	Arrestare un processo in esecuzione.	Estensione	Disponibilità generale

az iot central job create

Creare ed eseguire un processo tramite la relativa definizione di processo.

az iot central job create --app-id
                          --content
                          --group-id
                          --job-id
                          [--api-version {2022-07-31}]
                          [--batch]
                          [--batch-type {number, percentage}]
                          [--cancellation-threshold]
                          [--cancellation-threshold-batch]
                          [--cancellation-threshold-type {number, percentage}]
                          [--central-api-uri]
                          [--desc]
                          [--job-name]
                          [--token]

Esempio

Creare un processo con nome

az iot central job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {jobName} --content {creationJSONPath}

Creare un processo con nome e configurazione batch.

az iot central job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {jobName} --content {creationJSONPath} --batch {jobBatchValue} --batch-type {jobBatchType}

Creare un processo con la configurazione del nome e della soglia di annullamento senza batch.

az iot central job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {jobName} --content {creationJSONPath} --cancellation-threshold {jobCancellationThresholdValue} --cancellation-threshold-type {jobCancellationThresholdType} --description {jobDesc}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--content -k

Definizione dei dati del processo. Specificare il percorso del file JSON o del codice JSON non elaborato. [Esempio di percorso file:./path/to/file.json] [Esempio di JSON stringaficato:[{}]. Il corpo della richiesta deve contenere una matrice di JobData.

--group-id -g

ID del gruppo di dispositivi in cui eseguire il processo.

--job-id -j

Identificatore univoco per il processo.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Versione dell'API per l'operazione richiesta.

Valori accettati: 2022-07-31

Valore predefinito: 2022-07-31

--batch -b

Numero o percentuale di dispositivi in cui viene eseguita l'invio in batch.

--batch-type --bt

Specificare se l'invio in batch viene eseguito su un numero di dispositivi o una percentuale del totale.

Valori accettati: number, percentage

Valore predefinito: number

--cancellation-threshold --cth

Numero o percentuale di dispositivi in cui viene applicata la soglia di annullamento.

--cancellation-threshold-batch --ctb

Indica se la soglia di annullamento si applica per batch o al processo complessivo.

Valore predefinito: number

--cancellation-threshold-type --ctt

Specificare se la soglia di annullamento viene applicata per un numero di dispositivi o una percentuale del totale.

Valori accettati: number, percentage

Valore predefinito: number

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--desc --description

Descrizione dettagliata del processo.

--job-name

Nome visualizzato del processo.

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 iot central job get-devices

Ottenere gli stati del dispositivo del processo.

az iot central job get-devices --app-id
                               --job-id
                               [--api-version {2022-07-31}]
                               [--central-api-uri]
                               [--token]

Esempio

Ottenere l'elenco dei singoli stati del dispositivo in base all'ID processo

az iot central job get-devices --app-id {appid} --job-id {jobId}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--job-id -j

Identificatore univoco per il processo.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Versione dell'API per l'operazione richiesta.

Valori accettati: 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 iot central job list

Ottenere l'elenco dei processi per un'applicazione IoT Central.

az iot central job list --app-id
                        [--api-version {2022-07-31}]
                        [--central-api-uri]
                        [--token]

Esempio

Elencare i processi in un'applicazione

az iot central job list --app-id {appid}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Versione dell'API per l'operazione richiesta.

Valori accettati: 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 iot central job rerun

Eseguire di nuovo un processo in tutti i dispositivi non riusciti.

az iot central job rerun --app-id
                         --job-id
                         --rerun-id
                         [--api-version {2022-07-31}]
                         [--central-api-uri]
                         [--token]

Esempio

Rieseguire un processo

az iot central job rerun --app-id {appid} --job-id {jobId} --rerun-id {rerunId}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--job-id -j

Identificatore univoco per il processo.

--rerun-id

Identificatore univoco per la riesecuzione.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Versione dell'API per l'operazione richiesta.

Valori accettati: 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 iot central job resume

Riprendere un processo arrestato.

az iot central job resume --app-id
                          --job-id
                          [--api-version {2022-07-31}]
                          [--central-api-uri]
                          [--token]

Esempio

Riprendere un processo

az iot central job resume --app-id {appid} --job-id {jobId}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--job-id -j

Identificatore univoco per il processo.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Versione dell'API per l'operazione richiesta.

Valori accettati: 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 iot central job show

Ottenere i dettagli di un processo in base all'ID.

az iot central job show --app-id
                        --job-id
                        [--api-version {2022-07-31}]
                        [--central-api-uri]
                        [--token]

Esempio

Ottenere i dettagli del processo

az iot central job show --app-id {appid} --job-id {jobId}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--job-id -j

Identificatore univoco per il processo.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Versione dell'API per l'operazione richiesta.

Valori accettati: 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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 iot central job stop

Arrestare un processo in esecuzione.

az iot central job stop --app-id
                        --job-id
                        [--api-version {2022-07-31}]
                        [--central-api-uri]
                        [--token]

Esempio

Arrestare un processo

az iot central job stop --app-id {appid} --job-id {jobId}

Parametri necessari

--app-id -n

ID app dell'app IoT Central che si vuole gestire. È possibile trovare l'ID app nella pagina "Informazioni" per l'applicazione nel menu della Guida.

--job-id -j

Identificatore univoco per il processo.

Parametri facoltativi

--api-version --av

Deprecato

L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.

Versione dell'API per l'operazione richiesta.

Valori accettati: 2022-07-31

Valore predefinito: 2022-07-31

--central-api-uri --central-dns-suffix

Suffisso DNS di IoT Central associato all'applicazione.

Valore predefinito: azureiotcentral.com

--token

Se si preferisce inviare la richiesta senza eseguire l'autenticazione nell'interfaccia della riga di comando di Azure, è possibile specificare un token utente valido per autenticare la richiesta. È necessario specificare il tipo di chiave come parte della richiesta. Per ulteriori informazioni, vedi https://aka.ms/iotcentraldocsapi.

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.