Dela via


az batch job

Hantera Batch-jobb.

Kommandon

Name Description Typ Status
az batch job create

Lägg till ett jobb i ett Batch-konto.

Kärna GA
az batch job delete

Tar bort ett jobb från ett Batch-konto.

Kärna GA
az batch job disable

Inaktivera ett Batch-jobb.

Kärna GA
az batch job enable

Aktivera ett Batch-jobb.

Kärna GA
az batch job list

Visa en lista över alla jobb eller jobbscheman i ett Batch-konto.

Kärna GA
az batch job prep-release-status

Visa status för Batch-jobbförberedelser och versionsaktiviteter.

Kärna GA
az batch job prep-release-status list

Visar en lista över körningsstatusen för jobbförberedelse- och jobbfrisläppningsaktiviteten för det angivna jobbet över de beräkningsnoder där jobbet har körts.

Kärna GA
az batch job reset

Uppdatera egenskaperna för ett Batch-jobb. Ospecificerade egenskaper som kan uppdateras återställs till standardinställningarna.

Kärna GA
az batch job set

Uppdatera egenskaperna för ett Batch-jobb. Om du uppdaterar en egenskap i en undergrupp återställs de ospecificerade egenskaperna för gruppen.

Kärna GA
az batch job show

Hämtar information om det angivna Batch-jobbet.

Kärna GA
az batch job stop

Stoppa ett Batch-jobb som körs.

Kärna GA
az batch job task-counts

Visa antalet uppgifter och platser i ett Batch-jobb och deras tillstånd.

Kärna GA
az batch job task-counts show

Hämtar antalet aktiviteter för det angivna jobbet.

Kärna GA

az batch job create

Lägg till ett jobb i ett Batch-konto.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--job-manager-task-application-package-references]
                    [--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]
                    [--on-all-tasks-complete]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

Exempel

Skapa ett nytt jobb som är associerat med en befintlig pool.

az batch job create --id job1 --pool-id pool1

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.

--allow-task-preemption

Om Aktiviteter i det här jobbet kan föregripas av andra högprioriterade jobb. Om värdet är inställt på Sant prioriteras andra högprioriterande jobb som skickas till systemet och kan skicka aktiviteter från det här jobbet igen. Du kan uppdatera ett jobbs allowTaskPreemption när det har skapats med hjälp av API:et för uppdateringsjobbet. Sant om flaggan finns.

--id

En sträng som unikt identifierar jobbet i kontot. ID:t kan innehålla valfri kombination av alfanumeriska tecken, inklusive bindestreck och understreck, och får inte innehålla fler än 64 tecken. ID:t är skiftlägesbevarande och skiftlägesokänsligt (dvs. du kanske inte har två ID:n inom ett konto som endast skiljer sig åt från fall till fall). Krävs.

--job-manager-task-application-package-references

En lista över programpaket som Batch-tjänsten distribuerar till beräkningsnoden innan kommandoraden körs. Programpaket laddas ned och distribueras till en delad katalog, inte till arbetskatalogen Aktivitet. Om ett refererat programpaket redan finns på beräkningsnoden och är uppdaterat laddas det därför inte ned igen. den befintliga kopian på beräkningsnoden används. Om ett refererat programpaket inte kan installeras, till exempel på grund av att paketet har tagits bort eller eftersom nedladdningen misslyckades, misslyckas uppgiften. Utrymmesavgränsade program-ID:er med valfri version i formatet "id[#version]".

--job-manager-task-command-line

Kommandoraden för Job Manager-uppgiften. 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. Om kommandoraden refererar till filsökvägar bör den använda en relativ sökväg (i förhållande till arbetskatalogen Uppgift) eller använda miljövariabeln i Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Krävs.

--job-manager-task-environment-settings

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

--job-manager-task-id

En sträng som unikt identifierar jobbhanterarens uppgift i jobbet. ID:t kan innehålla valfri kombination av alfanumeriska tecken, inklusive bindestreck och understreck och får inte innehålla fler än 64 tecken. Krävs.

--job-manager-task-resource-files

En lista över filer som Batch-tjänsten laddar ned till beräkningsnoden innan du kör kommandoraden. Filer som visas under det här elementet finns i arbetskatalogen för aktiviteten. Det finns en maximal storlek för listan över resursfiler. När maxstorleken överskrids misslyckas begäran och svarsfelkoden requestEntityTooLarge. Om detta inträffar måste samlingen av ResourceFiles minskas i storlek. Detta kan uppnås med hjälp av .zip filer, programpaket eller Docker-containrar. Utrymmesavgränsade resursreferenser i filnamn=httpurl-format.

--job-max-task-retry-count

Det maximala antalet gånger varje aktivitet kan göras om. 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. Batch-tjänsten provar varje aktivitet 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 en aktivitet 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 inte Batch-tjänsten uppgifter igen. Om det maximala antalet återförsök är -1 försöker Batch-tjänsten aktiviteter utan begränsning. Standardvärdet är 0 (inga återförsök).

--job-max-wall-clock-time

Den maximala förflutna tiden som jobbet kan köras, mätt från den tidpunkt då jobbet skapas. Om jobbet inte slutförs inom tidsgränsen avslutar Batch-tjänsten det och alla aktiviteter som fortfarande körs. I det här fallet är uppsägningsorsaken MaxWallClockTimeExpiry. Om den här egenskapen inte har angetts finns det ingen tidsgräns för hur länge jobbet kan köras. Förväntat format är en ISO-8601-varaktighet.

--json-file

En fil som innehåller jobbspecifikationen i JSON (formaterad för att matcha respektive REST API-brödtext). Om den här parametern anges ignoreras alla jobbargument.

--max-parallel-tasks

Det maximala antalet aktiviteter som kan köras parallellt för jobbet. Värdet för maxParallelTasks måste vara -1 eller större än 0 om det anges. Om det inte anges är standardvärdet -1, vilket innebär att det inte finns någon gräns för antalet aktiviteter som kan köras samtidigt. Du kan uppdatera ett jobbs maxParallelTasks när det har skapats med api:et för uppdateringsjobbet.

--metadata

En lista över namn/värde-par som är associerade med jobbet som metadata. Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod. Blankstegsavgränsade värden i formatet "key=value".

--on-all-tasks-complete

Den åtgärd som Batch-tjänsten ska vidta när alla uppgifter i jobbet är i slutfört tillstånd. Observera att om ett jobb inte innehåller några aktiviteter anses alla aktiviteter vara slutförda. Det här alternativet används därför oftast med en Job Manager-uppgift. Om du vill använda automatisk jobbavslut utan jobbhanterare bör du först ange onAllTasksComplete till noaction och uppdatera jobbegenskaperna för att ställa in onAllTasksComplete så att det avslutas när du har lagt till Uppgifter. Standardvärdet är noaction. Kända värden är: "noaction" och "terminatejob".

--pool-id

ID för en befintlig pool. Alla uppgifter i jobbet körs på den angivna poolen. Du måste se till att poolen som refereras av den här egenskapen finns. Om poolen inte finns när Batch-tjänsten försöker schemalägga ett jobb körs inga aktiviteter för jobbet förrän du skapar en pool med det ID:t. Observera att Batch-tjänsten inte avvisar jobbbegäran. Det kommer helt enkelt inte att köra uppgifter förrän poolen finns. Du måste ange antingen pool-ID eller den automatiska poolspecifikationen, men inte båda.

--priority

Jobbets prioritet. Prioritetsvärden kan variera från -1000 till 1 000, där -1000 är den lägsta prioriteten och 1 000 som högsta prioritet. Standardvärdet är 0.

--required-slots

Antalet schemaläggningsplatser som aktiviteten kräver för att köras. Standardvärdet är 1. En aktivitet kan bara schemaläggas att köras på en beräkningsnod om noden har tillräckligt med lediga schemaläggningsplatser tillgängliga. För aktiviteter med flera instanser stöds inte den här egenskapen och får inte anges.

--uses-task-dependencies

Om Uppgifter i jobbet kan definiera beroenden för varandra. Standardvärdet är falskt. Sant om flaggan finns.

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

Tar bort ett jobb från ett Batch-konto.

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

Exempel

Ta bort ett jobb med hjälp av jobb-ID:t utan att fråga efter bekräftelse.

az batch job delete --job-id job1 --yes

Obligatoriska parametrar

--job-id

ID:t för jobbet 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 job disable

Inaktivera ett Batch-jobb.

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]
                     [--json-file]

Exempel

Inaktivera ett jobb och skicka eventuella aktiviteter som körs på nytt.

az batch job disable --job-id job1 --disable-tasks requeue

Obligatoriska parametrar

--job-id

ID för jobbet som ska inaktiveras. 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.

--disable-tasks

Vad du ska göra med aktiva aktiviteter som är associerade med jobbet. Krävs. Kända värden är: "requeue", "terminate" och "wait".

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

--json-file

En fil som innehåller innehållsspecifikationen i JSON (formaterad för att matcha respektive REST API-brödtext). Om den här parametern anges ignoreras alla "innehållsargument".

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

Aktivera ett Batch-jobb.

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

Exempel

Aktivera ett jobb.

az batch job enable --job-id job1

Obligatoriska parametrar

--job-id

ID för jobbet som ska aktiveras. 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 job list

Visa en lista över alla jobb eller jobbscheman i ett Batch-konto.

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

Exempel

Visa en lista över alla jobb i ett Batch-konto

az batch job list

Visa en lista över alla jobbscheman i ett Batch-konto

az batch job list --job-schedule-id jobschedule1

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.

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

--job-schedule-id

ID för jobbschemat som du vill hämta en lista över jobb från. Om det utelämnas visas alla jobb i kontot.

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

Uppdatera egenskaperna för ett Batch-jobb. Ospecificerade egenskaper som kan uppdateras återställs till standardinställningarna.

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]
                   [--pool-id]
                   [--priority]

Exempel

Återställ alla jobbegenskaper utom prioritet.

az batch job reset --job-id job1 --priority 100

Obligatoriska parametrar

--job-id

ID för jobbet vars egenskaper du vill uppdatera. 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.

--allow-task-preemption

Om Aktiviteter i det här jobbet kan föregripas av andra högprioriterade jobb. Om värdet är inställt på Sant prioriteras andra högprioriterande jobb som skickas till systemet och kan skicka aktiviteter från det här jobbet igen. Du kan uppdatera ett jobbs allowTaskPreemption när det har skapats med hjälp av API:et för uppdateringsjobbet. Sant om flaggan finns.

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

--job-max-task-retry-count

Det maximala antalet gånger varje aktivitet kan göras om. 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. Batch-tjänsten provar varje aktivitet 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 en aktivitet 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 inte Batch-tjänsten uppgifter igen. Om det maximala antalet återförsök är -1 försöker Batch-tjänsten aktiviteter utan begränsning. Standardvärdet är 0 (inga återförsök).

--job-max-wall-clock-time

Den maximala förflutna tiden som jobbet kan köras, mätt från den tidpunkt då jobbet skapas. Om jobbet inte slutförs inom tidsgränsen avslutar Batch-tjänsten det och alla aktiviteter som fortfarande körs. I det här fallet är uppsägningsorsaken MaxWallClockTimeExpiry. Om den här egenskapen inte har angetts finns det ingen tidsgräns för hur länge jobbet kan köras. Förväntat format är en ISO-8601-varaktighet.

--json-file

En fil som innehåller jobbspecifikationen i JSON (formaterad för att matcha respektive REST API-brödtext). Om den här parametern anges ignoreras alla jobbargument.

--max-parallel-tasks

Det maximala antalet aktiviteter som kan köras parallellt för jobbet. Värdet för maxParallelTasks måste vara -1 eller större än 0 om det anges. Om det inte anges är standardvärdet -1, vilket innebär att det inte finns någon gräns för antalet aktiviteter som kan köras samtidigt. Du kan uppdatera ett jobbs maxParallelTasks när det har skapats med api:et för uppdateringsjobbet.

--metadata

En lista över namn/värde-par som är associerade med jobbet som metadata. Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod. Blankstegsavgränsade värden i formatet "key=value".

--on-all-tasks-complete

Den åtgärd som Batch-tjänsten ska vidta när alla uppgifter i jobbet är i slutfört tillstånd. Standardvärdet är noaction. Kända värden är: "noaction" och "terminatejob".

--pool-id

ID för en befintlig pool. Alla uppgifter i jobbet körs på den angivna poolen. Du måste se till att poolen som refereras av den här egenskapen finns. Om poolen inte finns när Batch-tjänsten försöker schemalägga ett jobb körs inga aktiviteter för jobbet förrän du skapar en pool med det ID:t. Observera att Batch-tjänsten inte avvisar jobbbegäran. Det kommer helt enkelt inte att köra uppgifter förrän poolen finns. Du måste ange antingen pool-ID eller den automatiska poolspecifikationen, men inte båda.

--priority

Jobbets prioritet. Prioritetsvärden kan variera från -1000 till 1 000, där -1000 är den lägsta prioriteten och 1 000 som högsta prioritet. Standardvärdet är 0.

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

Uppdatera egenskaperna för ett Batch-jobb. Om du uppdaterar en egenskap i en undergrupp återställs de ospecificerade egenskaperna för gruppen.

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]
                 [--pool-id]
                 [--priority]

Exempel

Uppdatera jobbprioritet.

az batch job set --job-id job1 --priority 100

Obligatoriska parametrar

--job-id

ID för jobbet vars egenskaper du vill uppdatera. 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.

--allow-task-preemption

Om Aktiviteter i det här jobbet kan föregripas av andra högprioriterade jobb. Om värdet är inställt på Sant prioriteras andra högprioriterande jobb som skickas till systemet och kan skicka aktiviteter från det här jobbet igen. Du kan uppdatera ett jobbs allowTaskPreemption när det har skapats med hjälp av API:et för uppdateringsjobbet. Sant om flaggan finns.

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

--job-max-task-retry-count

Det maximala antalet gånger varje aktivitet kan göras om. 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. Batch-tjänsten provar varje aktivitet 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 en aktivitet 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 inte Batch-tjänsten uppgifter igen. Om det maximala antalet återförsök är -1 försöker Batch-tjänsten aktiviteter utan begränsning. Standardvärdet är 0 (inga återförsök).

--job-max-wall-clock-time

Den maximala förflutna tiden som jobbet kan köras, mätt från den tidpunkt då jobbet skapas. Om jobbet inte slutförs inom tidsgränsen avslutar Batch-tjänsten det och alla aktiviteter som fortfarande körs. I det här fallet är uppsägningsorsaken MaxWallClockTimeExpiry. Om den här egenskapen inte har angetts finns det ingen tidsgräns för hur länge jobbet kan köras. Förväntat format är en ISO-8601-varaktighet.

--json-file

En fil som innehåller jobbspecifikationen i JSON (formaterad för att matcha respektive REST API-brödtext). Om den här parametern anges ignoreras alla jobbargument.

--max-parallel-tasks

Det maximala antalet aktiviteter som kan köras parallellt för jobbet. Värdet för maxParallelTasks måste vara -1 eller större än 0 om det anges. Om det inte anges är standardvärdet -1, vilket innebär att det inte finns någon gräns för antalet aktiviteter som kan köras samtidigt. Du kan uppdatera ett jobbs maxParallelTasks när det har skapats med api:et för uppdateringsjobbet.

--metadata

En lista över namn/värde-par som är associerade med jobbet som metadata. Om de utelämnas lämnas befintliga jobbmetadata oförändrade. Blankstegsavgränsade värden i formatet "key=value".

--on-all-tasks-complete

Den åtgärd som Batch-tjänsten ska vidta när alla uppgifter i jobbet är i slutfört tillstånd. Om det utelämnas lämnas slutförandebeteendet oförändrat. Du kanske inte ändrar värdet från avslutningsjobb till noaction – det vill säga när du har aktiverat automatisk jobbavslut kan du inte inaktivera det igen. Om du försöker göra detta misslyckas begäran med felmeddelandet "ogiltigt egenskapsvärde". Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran). Kända värden är: "noaction" och "terminatejob".

--pool-id

ID för en befintlig pool. Alla uppgifter i jobbet körs på den angivna poolen. Du måste se till att poolen som refereras av den här egenskapen finns. Om poolen inte finns när Batch-tjänsten försöker schemalägga ett jobb körs inga aktiviteter för jobbet förrän du skapar en pool med det ID:t. Observera att Batch-tjänsten inte avvisar jobbbegäran. Det kommer helt enkelt inte att köra uppgifter förrän poolen finns. Du måste ange antingen pool-ID eller den automatiska poolspecifikationen, men inte båda.

--priority

Jobbets prioritet. Prioritetsvärden kan variera från -1000 till 1 000, där -1000 är den lägsta prioriteten och 1 000 som högsta prioritet. Om det utelämnas lämnas jobbets prioritet oförändrad.

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

Hämtar information om det angivna Batch-jobbet.

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]

Exempel

Visar information om ett jobb.

az batch job show --job-id job1

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.

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

Stoppa ett Batch-jobb som körs.

Avsluta det angivna jobbet och markera det som slutfört. När en begäran om att avsluta jobb tas emot anger Batch-tjänsten jobbet till sluttillståndet. Batch-tjänsten avslutar sedan alla aktiviteter som körs som är associerade med jobbet och kör alla nödvändiga uppgifter för jobbpubliceringen. Sedan flyttas jobbet till slutfört tillstånd. Om det finns några uppgifter i jobbet i aktivt tillstånd förblir de i aktivt tillstånd. När ett jobb har avslutats går det inte att lägga till nya aktiviteter och eventuella återstående aktiva aktiviteter schemaläggs inte.

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]

Exempel

Stoppa ett jobb och ange en uppsägningsorsak

az batch job stop --job-id job1 --terminate-reason "Completed workflow"

Obligatoriska parametrar

--job-id

ID:t för jobbet 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.

--terminate-reason

Uppsägningsorsak.

Texten som du vill ska visas som jobbets TerminateReason. Standardvärdet är "UserTerminate".

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.