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 | GA |
az iot central job get-devices |
Ottenere gli stati del dispositivo del processo. |
Estensione | GA |
az iot central job list |
Ottenere l'elenco dei processi per un'applicazione IoT Central. |
Estensione | GA |
az iot central job rerun |
Eseguire di nuovo un processo in tutti i dispositivi non riusciti. |
Estensione | GA |
az iot central job resume |
Riprendere un processo arrestato. |
Estensione | GA |
az iot central job show |
Ottenere i dettagli di un processo in base all'ID. |
Estensione | GA |
az iot central job stop |
Arrestare un processo in esecuzione. |
Estensione | GA |
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
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.
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:[{Dati processo JSON}]. Il corpo della richiesta deve contenere una matrice di JobData.
ID del gruppo di dispositivi in cui eseguire il processo.
Identificatore univoco per il processo.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Versione dell'API per l'operazione richiesta.
Numero o percentuale di dispositivi in cui viene eseguita l'invio in batch.
Specificare se l'invio in batch viene eseguito su un numero di dispositivi o una percentuale del totale.
Numero o percentuale di dispositivi in cui viene applicata la soglia di annullamento.
Indica se la soglia di annullamento si applica per batch o al processo complessivo.
Specificare se la soglia di annullamento viene applicata per un numero di dispositivi o una percentuale del totale.
Suffisso DNS di IoT Central associato all'applicazione.
Descrizione dettagliata del processo.
Nome visualizzato del processo.
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. Scopri di più su https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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.
Identificatore univoco per il processo.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Versione dell'API per l'operazione richiesta.
Suffisso DNS di IoT Central associato all'applicazione.
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. Scopri di più su https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Versione dell'API per l'operazione richiesta.
Suffisso DNS di IoT Central associato all'applicazione.
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. Scopri di più su https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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.
Identificatore univoco per il processo.
Identificatore univoco per la riesecuzione.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Versione dell'API per l'operazione richiesta.
Suffisso DNS di IoT Central associato all'applicazione.
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. Scopri di più su https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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.
Identificatore univoco per il processo.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Versione dell'API per l'operazione richiesta.
Suffisso DNS di IoT Central associato all'applicazione.
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. Scopri di più su https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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.
Identificatore univoco per il processo.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Versione dell'API per l'operazione richiesta.
Suffisso DNS di IoT Central associato all'applicazione.
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. Scopri di più su https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare 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
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.
Identificatore univoco per il processo.
Parametri facoltativi
L'argomento 'api_version' è stato deprecato e verrà rimosso in una versione futura.
Versione dell'API per l'operazione richiesta.
Suffisso DNS di IoT Central associato all'applicazione.
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. Scopri di più su https://aka.ms/iotcentraldocsapi.
Parametri globali
Aumentare la verbosità dei log per visualizzare tutti i log di debug.
Mostra questo messaggio Guida, esci.
Mostra solo gli errori, eliminando gli avvisi.
Formato dell'output.
Stringa di query JMESPath. Per altre informazioni ed esempi, vedere http://jmespath.org/.
Nome o ID della sottoscrizione. È possibile configurare la posizione predefinito usando az account set -s NAME_OR_ID
.
Aumentare il livello di dettaglio della registrazione. Usare --debug per log di debug completi.