az batch job

Správa úloh služby Batch

Příkazy

Name	Description	Typ	Stav
az batch job create	Přidejte úlohu do účtu Batch.	Jádro	GHANŠTINA
az batch job delete	Odstraní úlohu z účtu Batch.	Jádro	GHANŠTINA
az batch job disable	Zakažte úlohu Batch.	Jádro	GHANŠTINA
az batch job enable	Povolte úlohu Batch.	Jádro	GHANŠTINA
az batch job list	Vypište všechny úlohy nebo plán úlohy v účtu Batch.	Jádro	GHANŠTINA
az batch job prep-release-status	Zobrazte stav úkolů přípravy a uvolnění úloh služby Batch.	Jádro	GHANŠTINA
az batch job prep-release-status list	Vypíše stav spuštění úlohy přípravy úlohy a úlohy uvolnění úlohy pro zadanou úlohu ve výpočetních uzlech, ve kterých byla úloha spuštěna.	Jádro	GHANŠTINA
az batch job reset	Aktualizujte vlastnosti úlohy Batch. Nezadané vlastnosti, které je možné aktualizovat, se resetují na výchozí hodnoty.	Jádro	GHANŠTINA
az batch job set	Aktualizujte vlastnosti úlohy Batch. Aktualizace vlastnosti v podskupině resetuje nezadané vlastnosti této skupiny.	Jádro	GHANŠTINA
az batch job show	Získá informace o zadané úloze Batch.	Jádro	GHANŠTINA
az batch job stop	Zastavte spuštěnou úlohu Batch.	Jádro	GHANŠTINA
az batch job task-counts	Zobrazte počet úkolů a slotů v úloze Batch a jejich stavy.	Jádro	GHANŠTINA
az batch job task-counts show	Získá počet úkolů pro zadanou úlohu.	Jádro	GHANŠTINA

az batch job create

Přidejte úlohu do účtu Batch.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-application-package-references]
                    [--job-manager-task-command-line]
                    [--job-manager-task-environment-settings]
                    [--job-manager-task-id]
                    [--job-manager-task-resource-files]
                    [--job-max-task-retry-count]
                    [--job-max-wall-clock-time]
                    [--json-file]
                    [--max-parallel-tasks]
                    [--metadata]
                    [--on-all-tasks-complete]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

Příklady

Vytvořte novou úlohu přidruženou k existujícímu fondu.

az batch job create --id job1 --pool-id pool1

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Určuje, zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou. Pokud je hodnota nastavena na Hodnotu True, budou mít přednost jiné úlohy s vysokou prioritou odeslané do systému a budou moci znovu vytvořit frontu úkolů z této úlohy. Po vytvoření pomocí rozhraní API úlohy aktualizace můžete aktualizovat funkci allowTaskPreemption. True if flag present.

--id

Řetězec, který jednoznačně identifikuje úlohu v rámci účtu. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků. ID se zachovává a nerozlišuje malá a velká písmena (to znamená, že v rámci účtu nesmíte mít dvě ID, která se liší pouze v případě). Požadovaný.

--job-manager-task-application-package-references

Seznam balíčků aplikací, které služba Batch nasadí do výpočetního uzlu před spuštěním příkazového řádku. Balíčky aplikací se stáhnou a nasadí do sdíleného adresáře, ne do pracovního adresáře úlohy. Proto pokud odkazovaný balíček aplikace je již na výpočetním uzlu a je aktuální, pak se znovu nestáhnou; Použije se existující kopie výpočetního uzlu. Pokud odkazovaný balíček aplikace nelze nainstalovat, například protože balíček byl odstraněn nebo protože stahování selhalo, úloha selže. ID aplikací oddělených mezerami s volitelnou verzí ve formátu id[#version].

--job-manager-task-command-line

Příkazový řádek úlohy Správce úloh. Příkazový řádek se nespustí pod prostředím, a proto nemůže využívat funkce prostředí, jako je rozšíření proměnné prostředí. Pokud chcete tyto funkce využít, měli byste vyvolat prostředí na příkazovém řádku, například pomocí příkazu cmd /c MyCommand ve Windows nebo /bin/sh -c MyCommand v Linuxu. Pokud příkazový řádek odkazuje na cesty k souborům, měl by použít relativní cestu (relativní k pracovnímu adresáři úkolu) nebo použít proměnnou prostředí poskytovanou službou Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Požadovaný.

--job-manager-task-environment-settings

Seznam nastavení proměnných prostředí pro úlohu Správce úloh. Hodnoty oddělené mezerami ve formátu key=value

--job-manager-task-id

Řetězec, který jednoznačně identifikuje úlohu Správce úloh v rámci úlohy. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků. Požadovaný.

--job-manager-task-resource-files

Seznam souborů, které služba Batch stáhne do výpočetního uzlu před spuštěním příkazového řádku. Soubory uvedené v tomto prvku jsou umístěny v pracovním adresáři úkolu. Seznam souborů prostředků má maximální velikost. Při překročení maximální velikosti požadavek selže a kód chyby odpovědi bude RequestEntityTooLarge. Pokud k tomu dojde, musí být kolekce ResourceFiles zmenšena velikostí. Toho lze dosáhnout pomocí .zip souborů, balíčků aplikací nebo kontejnerů Dockeru. Odkazy na prostředky oddělené mezerami ve formátu filename=httpurl

--job-max-task-retry-count

Maximální počet opakování každého úkolu Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí každou úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohy. Pokud je maximální počet opakování -1, služba Batch opakuje úlohy bez omezení. Výchozí hodnota je 0 (žádné opakování).

--job-max-wall-clock-time

Maximální uplynulý čas, po který může úloha běžet, měřená od okamžiku vytvoření úlohy. Pokud se úloha nedokončí v rámci časového limitu, služba Batch ji ukončí a všechny úkoly, které jsou stále spuštěné. V tomto případě bude důvodem ukončení MaxWallClockTimeExpiry. Pokud tato vlastnost není zadána, neexistuje žádný časový limit, jak dlouho může úloha běžet. Očekávaný formát je doba trvání ISO-8601.

--json-file

Soubor obsahující specifikaci úlohy ve formátu JSON (formátovaný tak, aby odpovídal příslušnému textu rozhraní REST API). Pokud je tento parametr zadán, budou ignorovány všechny argumenty úlohy.

--max-parallel-tasks

Maximální počet úkolů, které lze pro úlohu spustit paralelně. Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadána. Pokud není zadáno, výchozí hodnota je -1, což znamená, že neexistuje žádný limit počtu úkolů, které lze spustit najednou. Po vytvoření můžete aktualizovat maxParallelTasks úlohy pomocí rozhraní API úlohy aktualizace.

--metadata

Seznam párů název-hodnota přidružených k úloze jako metadata Služba Batch nepřiřazuje metadatům žádný význam; je výhradně pro použití uživatelského kódu. Hodnoty oddělené mezerami ve formátu key=value

--on-all-tasks-complete

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. Všimněte si, že pokud úloha neobsahuje žádné úkoly, považují se všechny úkoly za dokončené. Tato možnost se proto nejčastěji používá s úkolem Správce úloh; Pokud chcete použít automatické ukončení úlohy bez Správce úloh, měli byste nejprve nastavit onAllTasksComplete na noaction a aktualizovat vlastnosti úlohy nastavit onAllTasksComplete ukončitjob po dokončení přidávání úkolů. Výchozí hodnota je noaction. Známé hodnoty jsou: "noaction" a "terminatejob".

--pool-id

ID existujícího fondu. Všechny úkoly úlohy budou spuštěny v zadaném fondu. Musíte zajistit, aby fond odkazovaný touto vlastností existoval. Pokud fond v době, kdy se služba Batch pokusí naplánovat úlohu, nebudou spuštěny žádné úkoly pro úlohu, dokud nevytváříte fond s tímto ID. Všimněte si, že služba Batch neodmítne žádost o úlohu; Úkoly se jednoduše nespustí, dokud fond neexistuje. Musíte zadat BUĎ ID fondu, nebo specifikaci automatického fondu, ale ne obojí.

--priority

Priorita úlohy. Hodnoty priority mohou být v rozsahu od -1000 do 1 000, přičemž -1000 nejnižší prioritou a 1000 nejvyšší prioritou. Výchozí hodnota je 0.

--required-slots

Počet slotů plánování, které úloha vyžaduje ke spuštění. Výchozí hodnota je 1. Úkol je možné naplánovat tak, aby běžel pouze na výpočetním uzlu, pokud má uzel k dispozici dostatek volných slotů plánování. U úloh s více instancemi není tato vlastnost podporována a nesmí být zadána.

--uses-task-dependencies

Určuje, zda úkoly v úloze mohou definovat závislosti na sobě navzájem. Výchozí hodnota je false. True if flag present.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az batch job delete

Odstraní úlohu z účtu Batch.

az batch job delete --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--yes]

Příklady

Odstraňte úlohu pomocí ID úlohy bez výzvy k potvrzení.

az batch job delete --job-id job1 --yes

Povinné parametry

--job-id

ID úlohy, kterou chcete odstranit. Požadovaný.

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--if-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.

--if-modified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--if-none-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

--if-unmodified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--yes -y

Nezotvádejte výzvu k potvrzení.

Default value: False

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az batch job disable

Zakažte úlohu Batch.

az batch job disable --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--disable-tasks]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--json-file]

Příklady

Zakažte úlohu a znovu vytvořte frontu všech spuštěných úkolů.

az batch job disable --job-id job1 --disable-tasks requeue

Povinné parametry

--job-id

ID úlohy, která se má zakázat. Požadovaný.

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--disable-tasks

Co dělat s aktivními úkoly přidruženými k úloze Požadovaný. Známé hodnoty jsou: "requeue", "terminate" a "wait".

--if-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.

--if-modified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--if-none-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

--if-unmodified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--json-file

Soubor obsahující specifikaci obsahu ve formátu JSON (formátovaný tak, aby odpovídal příslušnému textu rozhraní REST API). Pokud je tento parametr zadán, budou ignorovány všechny argumenty obsahu.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az batch job enable

Povolte úlohu Batch.

az batch job enable --job-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]

Příklady

Povolte úlohu.

az batch job enable --job-id job1

Povinné parametry

--job-id

ID úlohy, která se má povolit. Požadovaný.

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--if-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.

--if-modified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--if-none-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

--if-unmodified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az batch job list

Vypište všechny úlohy nebo plán úlohy v účtu Batch.

az batch job list [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--filter]
                  [--job-schedule-id]
                  [--select]

Příklady

Výpis všech úloh v účtu Batch

az batch job list

Zobrazení seznamu všech plánů úloh v účtu Batch

az batch job list --job-schedule-id jobschedule1

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch. Případně je potřeba nastavit pouze proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--expand

Klauzule $expand OData.

--filter

Klauzule $filter OData. Další informace o vytváření tohoto filtru naleznete v tématu https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

--job-schedule-id

ID plánu úlohy, ze kterého chcete získat seznam úloh. Pokud tento parametr vynecháte, zobrazí se seznam všech úloh v účtu.

--select

Klauzule $select OData.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az batch job reset

Aktualizujte vlastnosti úlohy Batch. Nezadané vlastnosti, které je možné aktualizovat, se resetují na výchozí hodnoty.

az batch job reset --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--allow-task-preemption]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--job-max-task-retry-count]
                   [--job-max-wall-clock-time]
                   [--json-file]
                   [--max-parallel-tasks]
                   [--metadata]
                   [--on-all-tasks-complete]
                   [--pool-id]
                   [--priority]

Příklady

Resetujte všechny vlastnosti úlohy s výjimkou priority.

az batch job reset --job-id job1 --priority 100

Povinné parametry

--job-id

ID úlohy, jejíž vlastnosti chcete aktualizovat. Požadovaný.

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Určuje, zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou. Pokud je hodnota nastavena na Hodnotu True, budou mít přednost jiné úlohy s vysokou prioritou odeslané do systému a budou moci znovu vytvořit frontu úkolů z této úlohy. Po vytvoření pomocí rozhraní API úlohy aktualizace můžete aktualizovat funkci allowTaskPreemption. True if flag present.

--if-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.

--if-modified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--if-none-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

--if-unmodified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--job-max-task-retry-count

Maximální počet opakování každého úkolu Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí každou úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohy. Pokud je maximální počet opakování -1, služba Batch opakuje úlohy bez omezení. Výchozí hodnota je 0 (žádné opakování).

--job-max-wall-clock-time

Maximální uplynulý čas, po který může úloha běžet, měřená od okamžiku vytvoření úlohy. Pokud se úloha nedokončí v rámci časového limitu, služba Batch ji ukončí a všechny úkoly, které jsou stále spuštěné. V tomto případě bude důvodem ukončení MaxWallClockTimeExpiry. Pokud tato vlastnost není zadána, neexistuje žádný časový limit, jak dlouho může úloha běžet. Očekávaný formát je doba trvání ISO-8601.

--json-file

Soubor obsahující specifikaci úlohy ve formátu JSON (formátovaný tak, aby odpovídal příslušnému textu rozhraní REST API). Pokud je tento parametr zadán, budou ignorovány všechny argumenty úlohy.

--max-parallel-tasks

Maximální počet úkolů, které lze pro úlohu spustit paralelně. Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadána. Pokud není zadáno, výchozí hodnota je -1, což znamená, že neexistuje žádný limit počtu úkolů, které lze spustit najednou. Po vytvoření můžete aktualizovat maxParallelTasks úlohy pomocí rozhraní API úlohy aktualizace.

--metadata

Seznam párů název-hodnota přidružených k úloze jako metadata Služba Batch nepřiřazuje metadatům žádný význam; je výhradně pro použití uživatelského kódu. Hodnoty oddělené mezerami ve formátu key=value

--on-all-tasks-complete

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. Výchozí hodnota je noaction. Známé hodnoty jsou: "noaction" a "terminatejob".

--pool-id

ID existujícího fondu. Všechny úkoly úlohy budou spuštěny v zadaném fondu. Musíte zajistit, aby fond odkazovaný touto vlastností existoval. Pokud fond v době, kdy se služba Batch pokusí naplánovat úlohu, nebudou spuštěny žádné úkoly pro úlohu, dokud nevytváříte fond s tímto ID. Všimněte si, že služba Batch neodmítne žádost o úlohu; Úkoly se jednoduše nespustí, dokud fond neexistuje. Musíte zadat BUĎ ID fondu, nebo specifikaci automatického fondu, ale ne obojí.

--priority

Priorita úlohy. Hodnoty priority mohou být v rozsahu od -1000 do 1 000, přičemž -1000 nejnižší prioritou a 1000 nejvyšší prioritou. Výchozí hodnota je 0.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az batch job set

Aktualizujte vlastnosti úlohy Batch. Aktualizace vlastnosti v podskupině resetuje nezadané vlastnosti této skupiny.

az batch job set --job-id
                 [--account-endpoint]
                 [--account-key]
                 [--account-name]
                 [--allow-task-preemption]
                 [--if-match]
                 [--if-modified-since]
                 [--if-none-match]
                 [--if-unmodified-since]
                 [--job-max-task-retry-count]
                 [--job-max-wall-clock-time]
                 [--json-file]
                 [--max-parallel-tasks]
                 [--metadata]
                 [--on-all-tasks-complete]
                 [--pool-id]
                 [--priority]

Příklady

Aktualizujte prioritu úlohy.

az batch job set --job-id job1 --priority 100

Povinné parametry

--job-id

ID úlohy, jejíž vlastnosti chcete aktualizovat. Požadovaný.

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Určuje, zda úkoly v této úloze mohou být zrušeny jinými úlohami s vysokou prioritou. Pokud je hodnota nastavena na Hodnotu True, budou mít přednost jiné úlohy s vysokou prioritou odeslané do systému a budou moci znovu vytvořit frontu úkolů z této úlohy. Po vytvoření pomocí rozhraní API úlohy aktualizace můžete aktualizovat funkci allowTaskPreemption. True if flag present.

--if-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.

--if-modified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--if-none-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

--if-unmodified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--job-max-task-retry-count

Maximální počet opakování každého úkolu Služba Batch opakuje úlohu, pokud je jeho ukončovací kód nenulový. Všimněte si, že tato hodnota konkrétně řídí počet opakování. Služba Batch zkusí každou úlohu jednou a může to zkusit znovu až do tohoto limitu. Pokud je například maximální počet opakování 3, služba Batch se pokusí úkol opakovat až 4krát (jeden počáteční pokus a 3 opakování). Pokud je maximální počet opakování 0, služba Batch neopakuje úlohy. Pokud je maximální počet opakování -1, služba Batch opakuje úlohy bez omezení. Výchozí hodnota je 0 (žádné opakování).

--job-max-wall-clock-time

Maximální uplynulý čas, po který může úloha běžet, měřená od okamžiku vytvoření úlohy. Pokud se úloha nedokončí v rámci časového limitu, služba Batch ji ukončí a všechny úkoly, které jsou stále spuštěné. V tomto případě bude důvodem ukončení MaxWallClockTimeExpiry. Pokud tato vlastnost není zadána, neexistuje žádný časový limit, jak dlouho může úloha běžet. Očekávaný formát je doba trvání ISO-8601.

--json-file

Soubor obsahující specifikaci úlohy ve formátu JSON (formátovaný tak, aby odpovídal příslušnému textu rozhraní REST API). Pokud je tento parametr zadán, budou ignorovány všechny argumenty úlohy.

--max-parallel-tasks

Maximální počet úkolů, které lze pro úlohu spustit paralelně. Hodnota maxParallelTasks musí být -1 nebo větší než 0, pokud je zadána. Pokud není zadáno, výchozí hodnota je -1, což znamená, že neexistuje žádný limit počtu úkolů, které lze spustit najednou. Po vytvoření můžete aktualizovat maxParallelTasks úlohy pomocí rozhraní API úlohy aktualizace.

--metadata

Seznam párů název-hodnota přidružených k úloze jako metadata Pokud je tato možnost vynechána, stávající metadata úlohy zůstanou beze změny. Hodnoty oddělené mezerami ve formátu key=value

--on-all-tasks-complete

Akce, kterou má služba Batch provést, když jsou všechny úkoly v úloze v dokončeném stavu. Pokud je vynecháno, chování dokončení zůstane beze změny. Nelze změnit hodnotu z terminatejob na noaction – to znamená, že jakmile zapnete automatické ukončení úlohy, nemůžete ji znovu vypnout. Pokud se to pokusíte provést, požadavek selže s chybovou odpovědí "neplatná hodnota vlastnosti"; Pokud voláte přímo rozhraní REST API, stavový kód HTTP je 400 (chybný požadavek). Známé hodnoty jsou: "noaction" a "terminatejob".

--pool-id

ID existujícího fondu. Všechny úkoly úlohy budou spuštěny v zadaném fondu. Musíte zajistit, aby fond odkazovaný touto vlastností existoval. Pokud fond v době, kdy se služba Batch pokusí naplánovat úlohu, nebudou spuštěny žádné úkoly pro úlohu, dokud nevytváříte fond s tímto ID. Všimněte si, že služba Batch neodmítne žádost o úlohu; Úkoly se jednoduše nespustí, dokud fond neexistuje. Musíte zadat BUĎ ID fondu, nebo specifikaci automatického fondu, ale ne obojí.

--priority

Priorita úlohy. Hodnoty priority mohou být v rozsahu od -1000 do 1 000, přičemž -1000 nejnižší prioritou a 1000 nejvyšší prioritou. Pokud tuto hodnotu vynecháte, priorita úlohy zůstane beze změny.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az batch job show

Získá informace o zadané úloze Batch.

az batch job show --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--expand]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--select]

Příklady

Zobrazuje podrobnosti o úloze.

az batch job show --job-id job1

Povinné parametry

--job-id

ID úlohy. Požadovaný.

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--expand

Klauzule $expand OData.

--if-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.

--if-modified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--if-none-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

--if-unmodified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--select

Klauzule $select OData.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.

az batch job stop

Zastavte spuštěnou úlohu Batch.

Ukončete zadanou úlohu a označte ji jako dokončenou. Po přijetí žádosti o ukončení úlohy služba Batch nastaví úlohu na ukončovací stav. Služba Batch pak ukončí všechny spuštěné úlohy přidružené k úloze a spustí všechny požadované úlohy uvolnění úloh. Úloha se pak přesune do dokončeného stavu. Pokud jsou v úloze nějaké úkoly v aktivním stavu, zůstanou v aktivním stavu. Po ukončení úlohy nelze přidat nové úkoly a žádné zbývající aktivní úkoly nebudou naplánovány.

az batch job stop --job-id
                  [--account-endpoint]
                  [--account-key]
                  [--account-name]
                  [--if-match]
                  [--if-modified-since]
                  [--if-none-match]
                  [--if-unmodified-since]
                  [--terminate-reason]

Příklady

Zastavení úlohy a poskytnutí důvodu ukončení

az batch job stop --job-id job1 --terminate-reason "Completed workflow"

Povinné parametry

--job-id

ID úlohy, která se má ukončit. Požadovaný.

Volitelné parametry

--account-endpoint

Koncový bod služby Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ENDPOINT.

--account-key

Klíč účtu Batch. Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCESS_KEY.

--account-name

Název účtu Batch Případně můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--if-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě přesně odpovídají hodnotě určené klientem.

--if-modified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--if-none-match

Hodnota ETag přidružená k verzi prostředku známého klientovi. Operace se provede pouze v případě, že aktuální značky ETag prostředku ve službě neodpovídají hodnotě zadané klientem.

--if-unmodified-since

Časové razítko označující čas poslední změny prostředku známého klientovi. Operace bude provedena pouze v případě, že byl prostředek ve službě změněn od zadaného času.

--terminate-reason

Důvod ukončení.

Text, který se má zobrazit jako TerminateReason úlohy. Výchozí hodnota je UserTerminate.

Globální parametry

--debug

Zvyšte úroveň podrobností protokolování, aby se zobrazily všechny protokoly ladění.

--help -h

Zobrazte tuto zprávu nápovědy a ukončete ji.

--only-show-errors

Zobrazují se pouze chyby, potlačení upozornění.

--output -o

Výstupní formát

Přípustné hodnoty: json, jsonc, none, table, tsv, yaml, yamlc

Default value: json

--query

Řetězec dotazu JMESPath Další informace a příklady najdete v http://jmespath.org/.

--subscription

Název nebo ID předplatného Výchozí předplatné můžete nakonfigurovat pomocí az account set -s NAME_OR_ID.

--verbose

Zvyšte úroveň podrobností protokolování. K úplnému ladění protokolů použijte příkaz --debug.