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

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]

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ě můžete nastavit proměnnou prostředí: AZURE_BATCH_ACCOUNT.

--affinity-id

Požadováno. 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 -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ší 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 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.

--task-id

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

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://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks.

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

--task-id

ID úlohy, která se má znovu aktivovat.

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

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

--json-file

Soubor obsahující specifikaci omezení 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 omezení.

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

--task-id

ID úkolu, o které chcete získat informace.

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

--task-id

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

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.