az batch task
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
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
ID:t för jobbet som innehåller uppgiften.
Valfria parametrar
Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.
Batch-kontonyckeln. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.
Batch-kontonamnet. Behövs endast Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCOUNT.
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.
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]".
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.
En lista över miljövariabelinställningar för uppgiften. Blankstegsavgränsade värden i formatet "key=value".
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.
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).
Om detta inte anges finns det ingen tidsgräns för hur länge aktiviteten kan köras.
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.
Standardvärdet är 7 dagar, dvs. Aktivitetskatalogen behålls i 7 dagar om inte beräkningsnoden tas bort eller jobbet tas bort.
ID:t för uppgiften.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az batch task delete
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
ID:t för jobbet som aktiviteten ska tas bort från. Krävs.
ID:t för uppgiften som ska tas bort. Krävs.
Valfria parametrar
Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.
Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.
Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Fråga inte efter bekräftelse.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az batch task list
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
Jobbets ID. Krävs.
Valfria parametrar
Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.
Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.
Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.
En OData-$expand-sats.
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.
En OData-$select-sats.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az batch task reactivate
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
ID:t för jobbet som innehåller uppgiften. Krävs.
ID:t för uppgiften som ska återaktiveras. Krävs.
Valfria parametrar
Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.
Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.
Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az batch task reset
Å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
ID:t för jobbet som innehåller uppgiften.
ID:t för uppgiften som ska uppdateras.
Valfria parametrar
Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.
Batch-kontonyckeln. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.
Batch-kontonamnet. Behövs endast Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCOUNT.
Åtgärden utförs endast om resursens aktuella ETag exakt matchar det angivna värdet.
Åtgärden utförs endast om resursen har ändrats sedan den angivna tidsstämpeln.
Åtgärden utförs inte bara om resursens aktuella ETag exakt matchar det angivna värdet.
Åtgärden utförs inte bara om resursen har ändrats sedan den angivna tidsstämpeln.
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".
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).
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.
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
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az batch task show
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
ID:t för jobbet som innehåller uppgiften. Krävs.
ID:t för uppgiften för att få information om. Krävs.
Valfria parametrar
Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.
Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.
Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.
En OData-$expand-sats.
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.
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.
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.
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.
En OData-$select-sats.
Globala parametrar
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.
az batch task stop
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
ID:t för jobbet som innehåller uppgiften. Krävs.
ID:t för uppgiften som ska avslutas. Krävs.
Valfria parametrar
Batch-tjänstslutpunkt. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ENDPOINT.
Batch-kontonyckel. Alternativt kan du ange efter miljövariabel: AZURE_BATCH_ACCESS_KEY.
Batch-kontonamn. Du kan också ange efter miljövariabel: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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
Öka loggningsverositeten för att visa alla felsökningsloggar.
Visa det här hjälpmeddelandet och avsluta.
Visa bara fel och ignorera varningar.
Utdataformat.
JMESPath-frågesträng. Mer information och exempel finns i http://jmespath.org/.
Namn eller ID för prenumeration. Du kan konfigurera standardprenumerationen med hjälp av az account set -s NAME_OR_ID
.
Öka loggningsverbositeten. Använd --debug för fullständiga felsökningsloggar.