Dela via

az batch task

  • Referens

Hantera Batch-uppgifter.

Kommandon

Name Description Typ Status
az batch task create

Skapa Batch-uppgifter.

 Kärna GA
az batch task delete

Tar bort en aktivitet från det angivna jobbet.

 Kärna GA
az batch task file

Hantera Batch-aktivitetsfiler.

 Kärna GA
az batch task file delete

Tar bort den angivna aktivitetsfilen från beräkningsnoden där aktiviteten kördes.

 Kärna GA
az batch task file download

Ladda ned innehållet i en Batch-aktivitetsfil.

 Kärna GA
az batch task file list

Visar filerna i en aktivitets katalog på dess beräkningsnod.

 Kärna GA
az batch task file show

Hämtar egenskaperna för den angivna aktivitetsfilen.

 Kärna GA
az batch task list

Visar en lista över alla aktiviteter som är associerade med det angivna jobbet.

 Kärna GA
az batch task reactivate

Reactivates en aktivitet, så att den kan köras igen även om antalet återförsök har förbrukats.

 Kärna GA
az batch task reset

Återställ egenskaperna för en Batch-uppgift.

 Kärna GA
az batch task show

Hämtar information om den angivna aktiviteten.

 Kärna GA
az batch task stop

Avslutar den angivna aktiviteten.

 Kärna GA
az batch task subtask

Hantera information om underuppgifter för en Batch-uppgift.

 Kärna GA
az batch task subtask list

Visar en lista över alla underaktiviteter som är associerade med den angivna aktiviteten för flera instanser.

 Kärna GA

az batch task create

Redigera

Skapa Batch-uppgifter.

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]

Exempel

Skapa en uppgift som ligger i viloläge i 1 minut.

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

Obligatoriska parametrar

--job-id

ID:t för jobbet som innehåller uppgiften.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckeln. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamnet. Behövs endast Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--affinity-id

Krävs. Du kan skicka affinityId för en nod för att ange att den här aktiviteten måste köras på beräkningsnoden. Observera att detta bara är en mjuk tillhörighet. Om målberäkningens nod är upptagen eller otillgänglig när aktiviteten schemaläggs schemaläggs aktiviteten någon annanstans.

--application-package-references

Den blankstegsavgränsade listan med ID:er som anger de programpaket som ska installeras. Utrymmesavgränsade program-ID:er med valfri version i formatet "id[#version]".

--command-line

Aktivitetens kommandorad. Kommandoraden körs inte under ett gränssnitt och kan därför inte dra nytta av gränssnittsfunktioner som miljövariabelexpansion. Om du vill dra nytta av sådana funktioner bör du anropa gränssnittet på kommandoraden, till exempel med hjälp av "cmd /c MyCommand" i Windows eller "/bin/sh -c MyCommand" i Linux.

--environment-settings

En lista över miljövariabelinställningar för uppgiften. Blankstegsavgränsade värden i formatet "key=value".

--json-file

Filen som innehåller de uppgifter som ska skapas i JSON(formaterad för att matcha REST API-begärandetexten). När du skickar flera uppgifter godkänner du antingen en matris med aktiviteter eller en TaskAddCollectionParamater. Om den här parametern anges ignoreras alla andra parametrar.

--max-task-retry-count

Det maximala antalet gånger som aktiviteten kan försökas igen. Batch-tjänsten försöker utföra en aktivitet igen om slutkoden inte är noll. Observera att det här värdet specifikt styr antalet återförsök för den körbara aktiviteten på grund av en icke-nollavslutskod. Batch-tjänsten provar uppgiften en gång och kan sedan försöka upp till den här gränsen igen. Om det maximala antalet återförsök till exempel är 3, försöker Batch aktiviteten upp till 4 gånger (ett första försök och 3 återförsök). Om det maximala antalet återförsök är 0 försöker Batch-tjänsten inte aktiviteten igen efter det första försöket. Om det maximala antalet återförsök är -1 försöker Batch-tjänsten aktiviteten utan begränsning igen, men detta rekommenderas inte för en startaktivitet eller någon aktivitet. Standardvärdet är 0 (inga återförsök).

--max-wall-clock-time

Om detta inte anges finns det ingen tidsgräns för hur länge aktiviteten kan köras.

--resource-files

En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan kommandoraden körs. Utrymmesavgränsade resursreferenser i filnamn=httpurl-format, där httpurl är en HTTP-URL med offentlig åtkomst eller en SAS-URL med läsåtkomst.

--retention-time

Standardvärdet är 7 dagar, dvs. Aktivitetskatalogen behålls i 7 dagar om inte beräkningsnoden tas bort eller jobbet tas bort.

--task-id

ID:t för uppgiften.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch task delete

Redigera

Tar bort en aktivitet från det angivna jobbet.

När en aktivitet tas bort tas alla filer i dess katalog på beräkningsnoden där den kördes också bort (oavsett kvarhållningstid). För aktiviteter med flera instanser tillämpas borttagningsåtgärden synkront på den primära aktiviteten. underaktiviteter och deras filer tas sedan bort asynkront i bakgrunden.

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]

Obligatoriska parametrar

--job-id

ID:t för jobbet som aktiviteten ska tas bort från. Krävs.

--task-id

ID:t för uppgiften som ska tas bort. Krävs.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--if-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten exakt matchar det värde som anges av klienten.

--if-modified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--if-none-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten inte matchar det värde som anges av klienten.

--if-unmodified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--yes -y

Fråga inte efter bekräftelse.

Standardvärde: False
Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch task list

Redigera

Visar en lista över alla aktiviteter som är associerade med det angivna jobbet.

Information om aktiviteter med flera instanser, till exempel affinityId, executionInfo och nodeInfo, refererar till den primära aktiviteten. Använd API:et för listunderaktiviteter för att hämta information om underaktiviteter.

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

Obligatoriska parametrar

--job-id

Jobbets ID. Krävs.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--expand

En OData-$expand-sats.

--filter

En OData-$filter-sats. Mer information om hur du skapar det här filtret finns i https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.

--select

En OData-$select-sats.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch task reactivate

Redigera

Reactivates en aktivitet, så att den kan köras igen även om antalet återförsök har förbrukats.

Återaktivering gör en aktivitet berättigad att försöka igen upp till det maximala antalet återförsök. Aktivitetens tillstånd ändras till aktiv. Eftersom aktiviteten inte längre är i slutfört tillstånd är all tidigare slutkod eller felinformation inte längre tillgänglig efter återaktivering. Varje gång en aktivitet återaktiveras återställs antalet återförsök till 0. Återaktiveringen misslyckas för aktiviteter som inte har slutförts eller som har slutförts tidigare (med slutkoden 0). Dessutom misslyckas det om jobbet har slutförts (eller avslutar eller tar bort).

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]

Obligatoriska parametrar

--job-id

ID:t för jobbet som innehåller uppgiften. Krävs.

--task-id

ID:t för uppgiften som ska återaktiveras. Krävs.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--if-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten exakt matchar det värde som anges av klienten.

--if-modified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--if-none-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten inte matchar det värde som anges av klienten.

--if-unmodified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch task reset

Redigera

Återställ egenskaperna för en Batch-uppgift.

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]

Exempel

Ange maximalt antal återförsök till 3 och återställ andra egenskaper till deras standardvärden

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

Obligatoriska parametrar

--job-id

ID:t för jobbet som innehåller uppgiften.

--task-id

ID:t för uppgiften som ska uppdateras.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckeln. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamnet. Behövs endast Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--if-match

Åtgärden utförs endast om resursens aktuella ETag exakt matchar det angivna värdet.

--if-modified-since

Åtgärden utförs endast om resursen har ändrats sedan den angivna tidsstämpeln.

--if-none-match

Åtgärden utförs inte bara om resursens aktuella ETag exakt matchar det angivna värdet.

--if-unmodified-since

Åtgärden utförs inte bara om resursen har ändrats sedan den angivna tidsstämpeln.

--json-file

Filen som innehåller parameterspecifikationen för pooluppdateringsegenskaper i JSON(formaterad för att matcha REST API-begärandetexten). Om den här parametern anges ignoreras alla "Parameterargument för pooluppdateringsegenskaper".

--max-task-retry-count

Det maximala antalet gånger som aktiviteten kan försökas igen. Batch-tjänsten försöker utföra en aktivitet igen om slutkoden inte är noll. Observera att det här värdet specifikt styr antalet återförsök för den körbara aktiviteten på grund av en icke-nollavslutskod. Batch-tjänsten provar uppgiften en gång och kan sedan försöka upp till den här gränsen igen. Om det maximala antalet återförsök till exempel är 3, försöker Batch aktiviteten upp till 4 gånger (ett första försök och 3 återförsök). Om det maximala antalet återförsök är 0 försöker Batch-tjänsten inte aktiviteten igen efter det första försöket. Om det maximala antalet återförsök är -1 försöker Batch-tjänsten aktiviteten utan begränsning igen, men detta rekommenderas inte för en startaktivitet eller någon aktivitet. Standardvärdet är 0 (inga återförsök).

--max-wall-clock-time

Om detta inte anges finns det ingen tidsgräns för hur länge aktiviteten kan köras. Förväntat format är en ISO-8601-varaktighet.

--retention-time

Standardvärdet är 7 dagar, dvs. Aktivitetskatalogen behålls i 7 dagar om inte beräkningsnoden tas bort eller jobbet tas bort. Förväntat format är en ISO-8601-varaktighet.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch task show

Redigera

Hämtar information om den angivna aktiviteten.

Information om aktiviteter med flera instanser, till exempel affinityId, executionInfo och nodeInfo, refererar till den primära aktiviteten. Använd API:et för listunderaktiviteter för att hämta information om underaktiviteter.

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]

Obligatoriska parametrar

--job-id

ID:t för jobbet som innehåller uppgiften. Krävs.

--task-id

ID:t för uppgiften för att få information om. Krävs.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--expand

En OData-$expand-sats.

--if-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten exakt matchar det värde som anges av klienten.

--if-modified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--if-none-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten inte matchar det värde som anges av klienten.

--if-unmodified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--select

En OData-$select-sats.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.

az batch task stop

Redigera

Avslutar den angivna aktiviteten.

När aktiviteten har avslutats flyttas den till slutfört tillstånd. För aktiviteter med flera instanser gäller åtgärden Avsluta aktivitet synkront för den primära aktiviteten. underaktiviteter avslutas sedan asynkront i bakgrunden.

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]

Obligatoriska parametrar

--job-id

ID:t för jobbet som innehåller uppgiften. Krävs.

--task-id

ID:t för uppgiften som ska avslutas. Krävs.

Valfria parametrar

--account-endpoint

Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.

--account-key

Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.

--if-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten exakt matchar det värde som anges av klienten.

--if-modified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

--if-none-match

Ett ETag-värde som är associerat med den version av resursen som är känd för klienten. Åtgärden utförs endast om resursens aktuella ETag på tjänsten inte matchar det värde som anges av klienten.

--if-unmodified-since

En tidsstämpel som anger den senaste ändrade tiden för resursen som är känd för klienten. Åtgärden utförs endast om resursen i tjänsten har ändrats sedan den angivna tiden.

Globala parametrar
--debug

Öka loggningsverositeten för att visa alla felsökningsloggar.

--help -h

Visa det här hjälpmeddelandet och avsluta.

--only-show-errors

Visa bara fel och ignorera varningar.

--output -o

Utdataformat.

Godkända värden: json, jsonc, none, table, tsv, yaml, yamlc
Standardvärde: json
--query

JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.

--subscription

Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID.

--verbose

Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.