az batch task

Správa úkolů služby Batch

Příkazy

Name	Description	Typ	Stav
az batch task create	Vytváření úkolů služby Batch	Jádro	GHANŠTINA
az batch task delete	Odstraní úkol ze zadané úlohy.	Jádro	GHANŠTINA
az batch task file	Správa souborů úkolů služby Batch	Jádro	GHANŠTINA
az batch task file delete	Odstraní zadaný soubor úlohy z výpočetního uzlu, na kterém byl úkol spuštěn.	Jádro	GHANŠTINA
az batch task file download	Stáhněte si obsah souboru úkolu Batch.	Jádro	GHANŠTINA
az batch task file list	Zobrazí seznam souborů v adresáři úlohy na výpočetním uzlu.	Jádro	GHANŠTINA
az batch task file show	Získá vlastnosti zadaného souboru úlohy.	Jádro	GHANŠTINA
az batch task list	Zobrazí seznam všech úkolů přidružených k zadané úloze.	Jádro	GHANŠTINA
az batch task reactivate	Znovu aktivuje úlohu, což jí umožní spustit znovu, i když byl jeho počet opakování vyčerpán.	Jádro	GHANŠTINA
az batch task reset	Resetujte vlastnosti úlohy Batch.	Jádro	GHANŠTINA
az batch task show	Získá informace o zadaném úkolu.	Jádro	GHANŠTINA
az batch task stop	Ukončí zadaný úkol.	Jádro	GHANŠTINA
az batch task subtask	Správa informací dílčích úkolů služby Batch	Jádro	GHANŠTINA
az batch task subtask list	Zobrazí seznam všech dílčích úkolů přidružených k zadané úloze s více instancemi.	Jádro	GHANŠTINA

az batch task create

Vytváření úkolů služby Batch

az batch task create --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--affinity-id]
                     [--application-package-references]
                     [--command-line]
                     [--environment-settings]
                     [--json-file]
                     [--max-task-retry-count]
                     [--max-wall-clock-time]
                     [--resource-files]
                     [--retention-time]
                     [--task-id]

Příklady

Vytvořte úlohu, která spí po dobu 1 minuty.

az batch task create --task-id task1 --job-id job1 --command-line "sleep 60"

Povinné parametry

--job-id

ID úlohy obsahující úkol.

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.

--affinity-id

Požadovaný. Id spřažení uzlu můžete předat, aby bylo možné označit, že tento úkol musí běžet na tomto výpočetním uzlu. Všimněte si, že se jedná jen o měkké spřažení. Pokud je cílový výpočetní uzel zaneprázdněný nebo nedostupný v době, kdy je úkol naplánován, bude úkol naplánován jinde.

--application-package-references

Seznam ID oddělených mezerami určující balíčky aplikací, které se mají nainstalovat. ID aplikací oddělených mezerami s volitelnou verzí ve formátu id[#version].

--command-line

Příkazový řádek úkolu. 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.

--environment-settings

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

--json-file

Soubor obsahující úlohy, které se mají vytvořit ve formátu JSON (formátované tak, aby odpovídalo textu požadavku rozhraní REST API). Při odesílání více úkolů přijímá pole úkolů nebo TaskAddCollectionParamater. Pokud je tento parametr zadán, budou všechny ostatní parametry ignorovány.

--max-task-retry-count

Maximální počet opakování ú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í spustitelného souboru úlohy kvůli nenulovém ukončovacímu kódu. Služba Batch zkusí ú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 úlohu po prvním pokusu. Pokud je maximální počet opakování -1, služba Batch opakuje úkol bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (žádné opakování).

--max-wall-clock-time

Pokud není zadaný, neexistuje žádný časový limit, jak dlouho může úloha běžet.

--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. Odkazy na prostředky oddělené mezerami ve formátu filename=httpurl, přičemž httpurl je libovolná adresa URL HTTP s veřejným přístupem nebo adresa URL SAS s přístupem pro čtení.

--retention-time

Výchozí hodnota je 7 dní, tj. adresář úloh se zachovají po dobu 7 dnů, pokud se neodebere výpočetní uzel nebo se úloha odstraní.

--task-id

ID úkolu.

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

Odstraní úkol ze zadané úlohy.

Při odstranění úlohy se odstraní také všechny soubory v jeho adresáři na výpočetním uzlu, na kterém byl spuštěný (bez ohledu na dobu uchovávání informací). V případě úloh s více instancemi se operace odstranit úlohu použije synchronně na primární úlohu; dílčí úkoly a jejich soubory se pak asynchronně odstraní na pozadí.

az batch task delete --job-id
                     --task-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, ze které chcete úkol odstranit. Požadovaný.

--task-id

ID úkolu, který 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 task list

Zobrazí seznam všech úkolů přidružených k zadané úloze.

Informace o úlohách s více instancemi, jako jsou spřaženíId, executionInfo a nodeInfo, odkazují na primární úlohu. Pomocí rozhraní API dílčích úkolů seznamu můžete načíst informace o dílčích úkolůch.

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

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.

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

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

Znovu aktivuje úlohu, což jí umožní spustit znovu, i když byl jeho počet opakování vyčerpán.

Opětovná aktivace způsobí, že úkol bude způsobilý k opětovnému pokusu až do maximálního počtu opakování. Stav úkolu se změní na aktivní. Vzhledem k tomu, že úloha už není v dokončeném stavu, po opětovné aktivaci už nebudou k dispozici žádné předchozí informace o ukončení nebo chybě. Pokaždé, když je úkol znovu aktivován, se jeho počet opakování resetuje na 0. Opětovná aktivace selže pro úlohy, které nejsou dokončeny nebo které byly úspěšně dokončeny (s ukončovacím kódem 0). Kromě toho se nezdaří, pokud se úloha dokončila (nebo ukončuje nebo odstraňuje).

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

Povinné parametry

--job-id

ID úlohy obsahující úkol. Požadovaný.

--task-id

ID úlohy, která se má znovu aktivovat. 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 task reset

Resetujte vlastnosti úlohy Batch.

az batch task reset --job-id
                    --task-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--json-file]
                    [--max-task-retry-count]
                    [--max-wall-clock-time]
                    [--retention-time]

Příklady

Nastavte maximální počet opakování na 3 a resetujte další vlastnosti na výchozí hodnoty.

az batch task reset --task-id task1 --job-id job1 --max-task-retry-count 3

Povinné parametry

--job-id

ID úlohy obsahující úkol.

--task-id

ID úlohy, která se má 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ě je potřeba nastavit pouze proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--if-match

Operace se provede pouze v případě, že aktuální značky ETag prostředku přesně odpovídají zadané hodnotě.

--if-modified-since

Operace se provede pouze v případě, že byl prostředek změněn od zadaného časového razítka.

--if-none-match

Operace nebude provedena pouze v případě, že aktuální značky ETag prostředku přesně odpovídají zadané hodnotě.

--if-unmodified-since

Operace nebude provedena pouze v případě, že byl prostředek změněn od zadaného časového razítka.

--json-file

Soubor obsahující specifikaci parametru vlastností aktualizace fondu ve formátu JSON (formátovaný tak, aby odpovídal textu požadavku rozhraní REST API). Pokud je tento parametr zadán, budou ignorovány všechny argumenty parametru Vlastnosti aktualizace fondu.

--max-task-retry-count

Maximální počet opakování ú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í spustitelného souboru úlohy kvůli nenulovém ukončovacímu kódu. Služba Batch zkusí ú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 úlohu po prvním pokusu. Pokud je maximální počet opakování -1, služba Batch opakuje úkol bez omezení, ale nedoporučuje se to pro spouštěcí úkol ani žádný úkol. Výchozí hodnota je 0 (žádné opakování).

--max-wall-clock-time

Pokud není zadaný, neexistuje žádný časový limit, jak dlouho může úloha běžet. Očekávaný formát je doba trvání ISO-8601.

--retention-time

Výchozí hodnota je 7 dní, tj. adresář úloh se zachovají po dobu 7 dnů, pokud se neodebere výpočetní uzel nebo se úloha odstraní. Očekávaný formát je doba trvání ISO-8601.

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

Získá informace o zadaném úkolu.

Informace o úlohách s více instancemi, jako jsou spřaženíId, executionInfo a nodeInfo, odkazují na primární úlohu. Pomocí rozhraní API dílčích úkolů seznamu můžete načíst informace o dílčích úkolůch.

az batch task show --job-id
                   --task-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, která obsahuje úkol. Požadovaný.

--task-id

ID úkolu, o které chcete získat informace. 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 task stop

Ukončí zadaný úkol.

Po ukončení úkolu se přesune do dokončeného stavu. U úloh s více instancemi se operace ukončení úlohy vztahuje synchronně na primární úlohu; dílčí úkoly se pak asynchronně ukončí na pozadí.

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

Povinné parametry

--job-id

ID úlohy obsahující úkol. Požadovaný.

--task-id

ID úkolu, 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.

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.