Sdílet prostřednictvím


az batch job

Poznámka

Tato skupina příkazů obsahuje příkazy, které jsou definované v Azure CLI i alespoň v jednom rozšíření. Nainstalujte každé rozšíření, abyste mohli využívat své rozšířené funkce. Přečtěte si další informace o rozšířeních.

Správa úloh služby Batch

Příkazy

Name Description Typ Stav
az batch job create

Přidejte úlohu do účtu Batch.

Základ GA
az batch job create (azure-batch-cli-extensions přípona)

Přidejte úlohu a přidružené úkoly do účtu Batch.

Rozšíření GA
az batch job delete

Odstraní úlohu.

Základ GA
az batch job disable

Zakáže zadanou úlohu a zabrání spuštění nových úkolů.

Základ GA
az batch job enable

Povolí zadanou úlohu a umožní spuštění nových úloh.

Základ GA
az batch job list

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

Základ GA
az batch job prep-release-status

Zobrazte stav úkolů přípravy a uvolnění úloh služby Batch.

Základ GA
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.

Základ GA
az batch job reset

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

Základ GA
az batch job set

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

Základ GA
az batch job show

Získá informace o zadané úloze.

Základ GA
az batch job stop

Zastavte spuštěnou úlohu Batch.

Základ GA
az batch job task-counts

Zobrazte počet úkolů a slotů v úloze Batch a jejich stavy.

Základ GA
az batch job task-counts show

Získá počet úkolů pro zadanou úlohu.

Základ GA

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-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]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

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

Požadováno. 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ě).

--job-manager-task-command-line

Požadováno. 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 -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í poskytnutou službou Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables).

--job-manager-task-environment-settings

Hodnoty oddělené mezerami ve formátu key=value

--job-manager-task-id

Požadováno. ID může obsahovat libovolnou kombinaci alfanumerických znaků včetně pomlček a podtržítka a nesmí obsahovat více než 64 znaků.

--job-manager-task-resource-files

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í souborů .zip, 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

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. Výchozí hodnota: -1 .

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

--pool-id

ID existujícího fondu. Všechny úkoly úlohy se spustí v zadaném fondu.

--priority

Priorita úlohy. Hodnoty priority mohou být v rozsahu od -1000 do 1000, přičemž nejnižší prioritou je -1000 a nejvyšší prioritou je 1000. 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í hodnotou je hodnota 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ší http://jmespath.org/ informace a příklady najdete v tématu.

--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 create (azure-batch-cli-extensions přípona)

Přidejte úlohu a přidružené úkoly do účtu Batch.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--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]
                    [--parameters]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--resource-group]
                    [--template]
                    [--uses-task-dependencies]

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.

--id

Požadováno. 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ě).

--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 -c MyCommand v Linuxu.

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

--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 se nacházejí v pracovním adresáři úkolu. 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 jednou vyzkouší jednotlivé úlohy 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 provést 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. Výchozí hodnota: -1 .

--metadata

Služba Batch nepřiřazuje metadatům žádný význam; je výhradně pro použití uživatelského kódu.

--parameters

Hodnoty parametrů pro soubor šablony JSON úlohy Batch Lze použít pouze se šablonou --template.

--pool-id

ID existujícího fondu. Všechny úkoly úlohy se spustí v zadaném fondu.

--priority

Priorita úlohy. Hodnoty priority mohou být v rozsahu od -1000 do 1000, přičemž nejnižší prioritou je -1000 a nejvyšší prioritou je 1000. 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.

--resource-group

Skupina prostředků účtu Batch.

--template

Soubor šablony JSON úlohy Batch. Pokud je tento parametr zadán, budou všechny ostatní parametry ignorovány.

--uses-task-dependencies

Příznak, který určuje, jestli tato úloha bude používat úkoly se závislostmi. True if flag present.

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ší http://jmespath.org/ informace a příklady najdete v tématu.

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

Odstraněním úlohy se odstraní také všechny úkoly, které jsou součástí dané úlohy, a všechny statistiky úlohy. Tím se také přepíše doba uchovávání dat úkolu; to znamená, že pokud úloha obsahuje úkoly, které jsou stále zachovány na výpočetních uzlech, služby Batch odstraní pracovní adresáře úkolů a veškerý jejich obsah. Po přijetí žádosti o odstranění úlohy služba Batch nastaví úlohu na stav odstranění. Všechny operace aktualizace úlohy, která je ve stavu odstranění, selžou se stavovým kódem 409 (Konflikt) s dalšími informacemi o tom, že úloha je odstraněna.

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

Povinné parametry

--job-id

ID úlohy, kterou chcete odstranit.

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 se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.

--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ší http://jmespath.org/ informace a příklady najdete v tématu.

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

Zakáže zadanou úlohu a zabrání spuštění nových úkolů.

Služba Batch okamžitě přesune úlohu do stavu zakázání. Batch pak pomocí parametru disableTasks určí, co dělat s aktuálně spuštěnými úkoly úlohy. Úloha zůstane ve stavu zakázání, dokud se operace zakázání nedokončí a všechny úkoly byly vyřešeny podle možnosti disableTasks; Úloha se pak přesune do zakázaného stavu. Pod úlohou nejsou spuštěny žádné nové úkoly, dokud se nepřesune zpět do aktivního stavu. Pokud se pokusíte zakázat úlohu, která je v jiném stavu než aktivní, zakázání nebo zakázána, požadavek selže se stavovým kódem 409.

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]

Povinné parametry

--job-id

ID úlohy, která se má zakázat.

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

Mezi možné hodnoty patří: 'requeue', 'terminate', '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 se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.

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ší http://jmespath.org/ informace a příklady najdete v tématu.

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

Povolí zadanou úlohu a umožní spuštění nových úloh.

Při volání tohoto rozhraní API služba Batch nastaví zakázanou úlohu na stav povolení. Po dokončení této operace se úloha přesune do aktivního stavu a plánování nových úkolů v rámci úlohy se obnoví. Služba Batch neumožňuje, aby úloha zůstala v aktivním stavu po dobu delší než 180 dnů. Pokud tedy povolíte úlohu obsahující aktivní úkoly, které byly přidány před více než 180 dny, tyto úkoly nebudou spuštěny.

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

Povinné parametry

--job-id

ID úlohy, která se má povolit.

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 se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.

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ší http://jmespath.org/ informace a příklady najdete v tématu.

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

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.

--filter

Klauzule $filter OData.

--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ší http://jmespath.org/ informace a příklady najdete v tématu.

--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 {noaction, terminatejob}]
                   [--pool-id]
                   [--priority]

Povinné parametry

--job-id

ID úlohy, jejíž vlastnosti chcete aktualizovat.

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 se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.

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

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 parametru aktualizace ú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. Výchozí hodnota: -1 .

--metadata

Pokud tento parametr vynecháte, vezme výchozí hodnotu prázdného seznamu; v důsledku toho se odstraní všechna existující metadata. 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í je nastaveno na noaction. Pokud je aktuální hodnota terminatejob, jedná se o chybu, protože chování dokončení úlohy nemusí být změněno z terminatejob na noaction. 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 a Batch vrátí stavový kód 400 (Chybný požadavek) a chybovou odpověď "neplatná hodnota vlastnosti". Pokud tento prvek v požadavku PUT nezadáte, odpovídá předání noaction. Jedná se o chybu, pokud je aktuální hodnota ukončena.

Přípustné hodnoty: noaction, terminatejob
--pool-id

ID existujícího fondu. Všechny úkoly úlohy se spustí v zadaném fondu.

--priority

Priorita úlohy. Hodnoty priority mohou být v rozsahu od -1000 do 1000, přičemž nejnižší prioritou je -1000 a nejvyšší prioritou je 1000. Pokud tuto hodnotu vynecháte, nastaví se na výchozí hodnotu 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ší http://jmespath.org/ informace a příklady najdete v tématu.

--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 {noaction, terminatejob}]
                 [--pool-id]
                 [--priority]

Povinné parametry

--job-id

ID úlohy, jejíž vlastnosti chcete aktualizovat.

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. Zadáním hodnoty true nebo false aktualizujte vlastnost.

--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 se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.

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

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 parametru opravy ú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

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

Přípustné hodnoty: noaction, terminatejob
--pool-id

ID existujícího fondu. Všechny úkoly úlohy se spustí v zadaném fondu.

--priority

Priorita úlohy. Hodnoty priority mohou být v rozsahu od -1000 do 1000, přičemž nejnižší prioritou je -1000 a nejvyšší prioritou je 1000. 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ší http://jmespath.org/ informace a příklady najdete v tématu.

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

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]

Povinné parametry

--job-id

ID úlohy.

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 se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.

--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ší http://jmespath.org/ informace a příklady najdete v tématu.

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

Povinné parametry

--job-id

ID úlohy, která se má ukončit.

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 se provede pouze v případě, že se prostředek ve službě od zadaného času nezměnil.

--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ší http://jmespath.org/ informace a příklady najdete v tématu.

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