az iot central scheduled-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 scheduled-job . Altre informazioni sulle estensioni.

Gestire e configurare il processo di pianificazione di IoT Central.

Comandi

Nome	Descrizione	Tipo	Status
az iot central scheduled-job create	Creare un processo pianificato in base all'ID.	Estensione	Disponibilità generale
az iot central scheduled-job delete	Eliminare un processo pianificato esistente in base all'ID.	Estensione	Disponibilità generale
az iot central scheduled-job list	Ottenere l'elenco delle definizioni di processi pianificate in un'applicazione.	Estensione	Disponibilità generale
az iot central scheduled-job list-runs	Ottenere l'elenco delle istanze di processo per una definizione di processo pianificata.	Estensione	Disponibilità generale
az iot central scheduled-job show	Ottenere informazioni dettagliate su un processo pianificato in base all'ID.	Estensione	Disponibilità generale
az iot central scheduled-job update	Aggiornare un processo pianificato in base all'ID.	Estensione	Disponibilità generale

az iot central scheduled-job create

Creare un processo pianificato in base all'ID.

--schedule e --content possono essere inline json o percorso di file.

az iot central scheduled-job create --app-id
                                    --content
                                    --group-id
                                    --id
                                    --schedule
                                    [--api-version {2022-06-30-preview, 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 di pianificazione con nome

az iot central scheduled-job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {displayName} --schedule {jobScheduleJSONPatch} --content {jobDataJSONPath}

Creare un processo pianificato con nome e configurazione batch.

az iot central scheduled-job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {displayName} --schedule	{jobScheduleJSONPatch} --content {jobDataJSONPath} --batch {jobBatchValue} --batch-type {jobBatchType}

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

az iot central scheduled-job create --app-id {appid} --job-id {jobId} --group-id {groupId} --job-name {displayName} --schedule	{jobScheduleJSONPatch} --content {jobDataJSONPath} --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. Il corpo della richiesta deve contenere una matrice di JobData.

--group-id -g

ID del gruppo di dispositivi in cui eseguire il processo.

--id --job-id

Identificatore univoco per il processo pianificato.

--schedule

Pianificazione in corrispondenza della quale eseguire il processo. Specificare il percorso del file JSON o del codice JSON non elaborato.

Parametri facoltativi

--api-version --av

Deprecato

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

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 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 scheduled-job delete

Eliminare un processo pianificato esistente in base all'ID.

az iot central scheduled-job delete --app-id
                                    --id
                                    [--api-version {2022-06-30-preview, 2022-07-31}]
                                    [--central-api-uri]
                                    [--token]

Esempio

Eliminare un processo pianificato esistente in base all'ID

az iot central scheduled-job delete --app-id {appid} --id {scheduledJobId}

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.

--id --job-id

Identificatore univoco per il processo pianificato.

Parametri facoltativi

--api-version --av

Deprecato

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

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 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 scheduled-job list

Ottenere l'elenco delle definizioni di processi pianificate in un'applicazione.

az iot central scheduled-job list --app-id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--token]

Esempio

Ottenere l'elenco delle definizioni di processi pianificati in un'applicazione

az iot central scheduled-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.

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 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 scheduled-job list-runs

Ottenere l'elenco delle istanze di processo per una definizione di processo pianificata.

az iot central scheduled-job list-runs --app-id
                                       --id
                                       [--api-version {2022-06-30-preview, 2022-07-31}]
                                       [--central-api-uri]
                                       [--token]

Esempio

Ottenere l'elenco di istanze di processi per una definizione di processo pianificata

az iot central scheduled-job list-runs --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.

--id --job-id

Identificatore univoco per il processo pianificato.

Parametri facoltativi

--api-version --av

Deprecato

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

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 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 scheduled-job show

Ottenere informazioni dettagliate su un processo pianificato in base all'ID.

az iot central scheduled-job show --app-id
                                  --id
                                  [--api-version {2022-06-30-preview, 2022-07-31}]
                                  [--central-api-uri]
                                  [--token]

Esempio

Ottenere informazioni dettagliate su un processo pianificato in base all'ID

az iot central scheduled-job show --app-id {appid} --id {scheduledJobId}

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.

--id --job-id

Identificatore univoco per il processo pianificato.

Parametri facoltativi

--api-version --av

Deprecato

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

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 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 scheduled-job update

Aggiornare un processo pianificato in base all'ID.

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

Esempio

Aggiornare un processo di pianificazione con il nome

az iot central scheduled-job update --app-id {appid} --job-id {jobId} --job-name {displayName}

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.

--id --job-id

Identificatore univoco per il processo pianificato.

Parametri facoltativi

--api-version --av

Deprecato

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

Questo parametro di comando è stato deprecato e verrà ignorato. Nella versione futura verranno supportate solo le API IoT Central dalla versione disponibile a livello generale più recente. Se un'API non è ancora disponibile a livello generale, verrà chiamata la versione di anteprima più recente.

Valori accettati: 2022-06-30-preview, 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.

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

--content -k

Definizione dei dati del processo. Specificare il percorso del file JSON o del codice JSON non elaborato. Il corpo della richiesta deve contenere una matrice di JobData.

--desc --description

Descrizione dettagliata del processo.

--group-id -g

ID del gruppo di dispositivi in cui eseguire il processo.

--job-name

Nome visualizzato del processo.

--schedule

Pianificazione in corrispondenza della quale eseguire il processo. Specificare il percorso del file JSON o del codice JSON non elaborato.

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