Delen via


az batch job

Batch-taken beheren.

Opdracht

Name Description Type Status
az batch job create

Voeg een taak toe aan een Batch-account.

Kern GA
az batch job delete

Hiermee verwijdert u een taak uit een Batch-account.

Kern GA
az batch job disable

Schakel een Batch-taak uit.

Kern GA
az batch job enable

Schakel een Batch-taak in.

Kern GA
az batch job list

Een lijst weergeven van alle taken of taakplanningen in een Batch-account.

Kern GA
az batch job prep-release-status

Bekijk de status van batchtaakvoorbereidings- en releasetaken.

Kern GA
az batch job prep-release-status list

Geeft de uitvoeringsstatus van de taakvoorbereiding en taakrelease voor de opgegeven taak weer op de rekenknooppunten waarop de taak is uitgevoerd.

Kern GA
az batch job reset

Werk de eigenschappen van een Batch-taak bij. Niet-opgegeven eigenschappen die kunnen worden bijgewerkt, worden teruggezet naar de standaardwaarden.

Kern GA
az batch job set

Werk de eigenschappen van een Batch-taak bij. Als u een eigenschap in een subgroep bijwerkt, worden de niet-opgegeven eigenschappen van die groep opnieuw ingesteld.

Kern GA
az batch job show

Hiermee wordt informatie opgehaald over de opgegeven Batch-taak.

Kern GA
az batch job stop

Stop een actieve Batch-taak.

Kern GA
az batch job task-counts

Bekijk het aantal taken en sleuven in een Batch-taak en de bijbehorende statussen.

Kern GA
az batch job task-counts show

Hiermee haalt u het aantal taken voor de opgegeven taak op.

Kern GA

az batch job create

Voeg een taak toe aan een Batch-account.

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]

Voorbeelden

Maak een nieuwe taak die is gekoppeld aan een bestaande pool.

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

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Of taken in deze taak kunnen worden verschoven door andere taken met hoge prioriteit. Als de waarde is ingesteld op True, hebben andere taken met hoge prioriteit die naar het systeem worden verzonden voorrang en kunnen taken van deze taak opnieuw worden weergegeven. U kunt de allowTaskPreemption van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak. Waar als er een vlag aanwezig is.

--id

Een tekenreeks waarmee de taak in het account uniek wordt geïdentificeerd. De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten. De id is niet hoofdlettergevoelig en niet hoofdlettergevoelig (u hebt mogelijk geen twee id's binnen een account die alleen per geval verschillen). Vereist.

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

Een lijst met toepassingspakketten die door de Batch-service worden geïmplementeerd in het rekenknooppunt voordat u de opdrachtregel uitvoert. Toepassingspakketten worden gedownload en geïmplementeerd in een gedeelde map, niet in de werkmap Taak. Als een toepassingspakket waarnaar wordt verwezen, zich al op het rekenknooppunt bevindt en up-to-date is, wordt het niet opnieuw gedownload; de bestaande kopie op het rekenknooppunt wordt gebruikt. Als een toepassingspakket waarnaar wordt verwezen, niet kan worden geïnstalleerd, bijvoorbeeld omdat het pakket is verwijderd of omdat het downloaden is mislukt, mislukt de taak. Toepassings-id's met optionele versie met de indeling id[#version].

--job-manager-task-command-line

De opdrachtregel van de jobbeheertaak. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als u van dergelijke functies wilt profiteren, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux. Als de opdrachtregel verwijst naar bestandspaden, moet deze een relatief pad gebruiken (ten opzichte van de werkmap Taak) of de door Batch geleverde omgevingsvariabele (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Vereist.

--job-manager-task-environment-settings

Een lijst met omgevingsvariabele-instellingen voor de taak Job Manager. Door spaties gescheiden waarden in de notatie 'key=value'.

--job-manager-task-id

Een tekenreeks die de Job Manager-taak uniek identificeert binnen de taak. De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens en mag niet meer dan 64 tekens bevatten. Vereist.

--job-manager-task-resource-files

Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak. Er is een maximale grootte voor de lijst met resourcebestanden. Wanneer de maximale grootte wordt overschreden, mislukt de aanvraag en is de antwoordfoutcode RequestEntityTooLarge. Als dit het geval is, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met behulp van .zip bestanden, toepassingspakketten of Docker-containers. Door spaties gescheiden bronverwijzingen in bestandsnaam=httpurl-indeling.

--job-max-task-retry-count

Het maximum aantal keren dat elke taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert elke taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch een taak maximaal 4 keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service taken niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service taken opnieuw zonder limiet. De standaardwaarde is 0 (geen nieuwe pogingen).

--job-max-wall-clock-time

De maximale verstreken tijd die de taak kan uitvoeren, gemeten vanaf het moment dat de taak wordt gemaakt. Als de taak niet binnen de tijdslimiet is voltooid, beëindigt de Batch-service deze en alle taken die nog steeds worden uitgevoerd. In dit geval is de beëindigingsreden MaxWallClockTimeExpiry. Als deze eigenschap niet is opgegeven, is er geen tijdslimiet voor hoe lang de taak kan worden uitgevoerd. Verwachte indeling is een ISO-8601-duur.

--json-file

Een bestand met de taakspecificatie in JSON (opgemaakt om overeen te komen met de respectieve REST API-hoofdtekst). Als deze parameter is opgegeven, worden alle taakargumenten genegeerd.

--max-parallel-tasks

Het maximum aantal taken dat parallel voor de taak kan worden uitgevoerd. De waarde van maxParallelTasks moet -1 of groter zijn dan 0, indien opgegeven. Als dit niet is opgegeven, is de standaardwaarde -1, wat betekent dat er geen limiet is voor het aantal taken dat tegelijk kan worden uitgevoerd. U kunt de maxParallelTasks van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak.

--metadata

Een lijst met naam-waardeparen die zijn gekoppeld aan de taak als metagegevens. De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. Door spaties gescheiden waarden in de notatie 'key=value'.

--on-all-tasks-complete

De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben. Houd er rekening mee dat als een taak geen taken bevat, alle taken als voltooid worden beschouwd. Deze optie wordt daarom meestal gebruikt met een Job Manager-taak; Als u automatische beëindiging van taken zonder Job Manager wilt gebruiken, moet u in eerste instantie opAllTasksComplete instellen op noaction en de eigenschappen van de taak bijwerken zodat deze opAllTasksComplete zijn ingesteld om de taak te beëindigen zodra u klaar bent met het toevoegen van taken. De standaardwaarde is noaction. Bekende waarden zijn: "noaction" en "terminatejob".

--pool-id

De id van een bestaande pool. Alle taken van de taak worden uitgevoerd in de opgegeven pool. U moet ervoor zorgen dat de pool waarnaar wordt verwezen door deze eigenschap bestaat. Als de pool niet bestaat op het moment dat de Batch-service een taak probeert te plannen, worden er geen taken voor de taak uitgevoerd totdat u een pool met die id maakt. Houd er rekening mee dat de Batch-service de taakaanvraag niet weigert; Taken worden pas uitgevoerd als de pool bestaat. U moet de pool-id of de specificatie van de automatische pool opgeven, maar niet beide.

--priority

De prioriteit van de taak. Prioriteitswaarden kunnen variëren van -1000 tot 1000, waarbij -1000 de laagste prioriteit is en 1000 de hoogste prioriteit is. De standaardwaarde is 0.

--required-slots

Het aantal planningssites dat de taak moet uitvoeren. De standaardwaarde is 1. Een taak kan alleen worden gepland om te worden uitgevoerd op een rekenknooppunt als het knooppunt voldoende vrije planningssites beschikbaar heeft. Voor taken met meerdere exemplaren wordt deze eigenschap niet ondersteund en mag deze niet worden opgegeven.

--uses-task-dependencies

Of taken in de taak afhankelijkheden op elkaar kunnen definiëren. De standaardwaarde is onwaar. Waar als er een vlag aanwezig is.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch job delete

Hiermee verwijdert u een taak uit een Batch-account.

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

Voorbeelden

Verwijder een taak met behulp van de taak-id zonder om bevestiging.

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

Vereiste parameters

--job-id

De id van de taak die moet worden verwijderd. Vereist.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--yes -y

Niet vragen om bevestiging.

Default value: False
Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch job disable

Schakel een Batch-taak uit.

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]

Voorbeelden

Schakel een taak uit en voer alle actieve taken opnieuw uit.

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

Vereiste parameters

--job-id

De id van de taak die moet worden uitgeschakeld. Vereist.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--disable-tasks

Wat u moet doen met actieve taken die aan de taak zijn gekoppeld. Vereist. Bekende waarden zijn: 'requeue', 'terminate' en 'wait'.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--json-file

Een bestand met de inhoudsspecificatie in JSON (opgemaakt om overeen te komen met de respectieve REST API-hoofdtekst). Als deze parameter is opgegeven, worden alle 'Inhoudsargumenten' genegeerd.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch job enable

Schakel een Batch-taak in.

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

Voorbeelden

Schakel een taak in.

az batch job enable --job-id job1

Vereiste parameters

--job-id

De id van de taak die moet worden ingeschakeld. Vereist.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch job list

Een lijst weergeven van alle taken of taakplanningen in een Batch-account.

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

Voorbeelden

Alle taken in een Batch-account weergeven

az batch job list

Alle taakplanningen in een Batch-account weergeven

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

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

De Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

De naam van het Batch-account. Alleen nodig Alternatief, ingesteld op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--expand

Een OData-$expand-component.

--filter

Een OData-$filter-component. Zie https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batchvoor meer informatie over het maken van dit filter.

--job-schedule-id

De id van de taakplanning waaruit u een lijst met taken wilt ophalen. Als u dit weglaat, worden alle taken in het account weergegeven.

--select

Een OData-$select-component.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch job reset

Werk de eigenschappen van een Batch-taak bij. Niet-opgegeven eigenschappen die kunnen worden bijgewerkt, worden teruggezet naar de standaardwaarden.

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]

Voorbeelden

Stel alle taakeigenschappen opnieuw in, behalve prioriteit.

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

Vereiste parameters

--job-id

De id van de taak waarvan u de eigenschappen wilt bijwerken. Vereist.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Of taken in deze taak kunnen worden verschoven door andere taken met hoge prioriteit. Als de waarde is ingesteld op True, hebben andere taken met hoge prioriteit die naar het systeem worden verzonden voorrang en kunnen taken van deze taak opnieuw worden weergegeven. U kunt de allowTaskPreemption van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak. Waar als er een vlag aanwezig is.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--job-max-task-retry-count

Het maximum aantal keren dat elke taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert elke taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch een taak maximaal 4 keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service taken niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service taken opnieuw zonder limiet. De standaardwaarde is 0 (geen nieuwe pogingen).

--job-max-wall-clock-time

De maximale verstreken tijd die de taak kan uitvoeren, gemeten vanaf het moment dat de taak wordt gemaakt. Als de taak niet binnen de tijdslimiet is voltooid, beëindigt de Batch-service deze en alle taken die nog steeds worden uitgevoerd. In dit geval is de beëindigingsreden MaxWallClockTimeExpiry. Als deze eigenschap niet is opgegeven, is er geen tijdslimiet voor hoe lang de taak kan worden uitgevoerd. Verwachte indeling is een ISO-8601-duur.

--json-file

Een bestand met de taakspecificatie in JSON (opgemaakt om overeen te komen met de respectieve REST API-hoofdtekst). Als deze parameter is opgegeven, worden alle taakargumenten genegeerd.

--max-parallel-tasks

Het maximum aantal taken dat parallel voor de taak kan worden uitgevoerd. De waarde van maxParallelTasks moet -1 of groter zijn dan 0, indien opgegeven. Als dit niet is opgegeven, is de standaardwaarde -1, wat betekent dat er geen limiet is voor het aantal taken dat tegelijk kan worden uitgevoerd. U kunt de maxParallelTasks van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak.

--metadata

Een lijst met naam-waardeparen die zijn gekoppeld aan de taak als metagegevens. De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. Door spaties gescheiden waarden in de notatie 'key=value'.

--on-all-tasks-complete

De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben. De standaardwaarde is noaction. Bekende waarden zijn: "noaction" en "terminatejob".

--pool-id

De id van een bestaande pool. Alle taken van de taak worden uitgevoerd in de opgegeven pool. U moet ervoor zorgen dat de pool waarnaar wordt verwezen door deze eigenschap bestaat. Als de pool niet bestaat op het moment dat de Batch-service een taak probeert te plannen, worden er geen taken voor de taak uitgevoerd totdat u een pool met die id maakt. Houd er rekening mee dat de Batch-service de taakaanvraag niet weigert; Taken worden pas uitgevoerd als de pool bestaat. U moet de pool-id of de specificatie van de automatische pool opgeven, maar niet beide.

--priority

De prioriteit van de taak. Prioriteitswaarden kunnen variëren van -1000 tot 1000, waarbij -1000 de laagste prioriteit is en 1000 de hoogste prioriteit is. De standaardwaarde is 0.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch job set

Werk de eigenschappen van een Batch-taak bij. Als u een eigenschap in een subgroep bijwerkt, worden de niet-opgegeven eigenschappen van die groep opnieuw ingesteld.

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]

Voorbeelden

Taakprioriteit bijwerken.

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

Vereiste parameters

--job-id

De id van de taak waarvan u de eigenschappen wilt bijwerken. Vereist.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--allow-task-preemption

Of taken in deze taak kunnen worden verschoven door andere taken met hoge prioriteit. Als de waarde is ingesteld op True, hebben andere taken met hoge prioriteit die naar het systeem worden verzonden voorrang en kunnen taken van deze taak opnieuw worden weergegeven. U kunt de allowTaskPreemption van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak. Waar als er een vlag aanwezig is.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--job-max-task-retry-count

Het maximum aantal keren dat elke taak opnieuw kan worden geprobeerd. De Batch-service probeert een taak opnieuw uit te voeren als de afsluitcode niet-nul is. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe pogingen bepaalt. De Batch-service probeert elke taak eenmaal uit en probeert vervolgens opnieuw tot deze limiet. Als het maximumaantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch een taak maximaal 4 keer (één eerste poging en drie nieuwe pogingen). Als het maximumaantal nieuwe pogingen 0 is, voert de Batch-service taken niet opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service taken opnieuw zonder limiet. De standaardwaarde is 0 (geen nieuwe pogingen).

--job-max-wall-clock-time

De maximale verstreken tijd die de taak kan uitvoeren, gemeten vanaf het moment dat de taak wordt gemaakt. Als de taak niet binnen de tijdslimiet is voltooid, beëindigt de Batch-service deze en alle taken die nog steeds worden uitgevoerd. In dit geval is de beëindigingsreden MaxWallClockTimeExpiry. Als deze eigenschap niet is opgegeven, is er geen tijdslimiet voor hoe lang de taak kan worden uitgevoerd. Verwachte indeling is een ISO-8601-duur.

--json-file

Een bestand met de taakspecificatie in JSON (opgemaakt om overeen te komen met de respectieve REST API-hoofdtekst). Als deze parameter is opgegeven, worden alle taakargumenten genegeerd.

--max-parallel-tasks

Het maximum aantal taken dat parallel voor de taak kan worden uitgevoerd. De waarde van maxParallelTasks moet -1 of groter zijn dan 0, indien opgegeven. Als dit niet is opgegeven, is de standaardwaarde -1, wat betekent dat er geen limiet is voor het aantal taken dat tegelijk kan worden uitgevoerd. U kunt de maxParallelTasks van een taak bijwerken nadat deze is gemaakt met behulp van de api voor de updatetaak.

--metadata

Een lijst met naam-waardeparen die zijn gekoppeld aan de taak als metagegevens. Als u dit weglaat, blijven de bestaande taakmetagegevens ongewijzigd. Door spaties gescheiden waarden in de notatie 'key=value'.

--on-all-tasks-complete

De actie die de Batch-service moet uitvoeren wanneer alle taken in de taak de status Voltooid hebben. Als u dit weglaat, blijft het voltooiingsgedrag ongewijzigd. U mag de waarde van de beëindigingstaak niet wijzigen in noaction, dat wil zeggen, wanneer u automatische beëindiging van de taak hebt ingeschakeld, kunt u deze niet opnieuw uitschakelen. Als u dit probeert te doen, mislukt de aanvraag met het foutbericht 'ongeldige eigenschapswaarde'. als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). Bekende waarden zijn: "noaction" en "terminatejob".

--pool-id

De id van een bestaande pool. Alle taken van de taak worden uitgevoerd in de opgegeven pool. U moet ervoor zorgen dat de pool waarnaar wordt verwezen door deze eigenschap bestaat. Als de pool niet bestaat op het moment dat de Batch-service een taak probeert te plannen, worden er geen taken voor de taak uitgevoerd totdat u een pool met die id maakt. Houd er rekening mee dat de Batch-service de taakaanvraag niet weigert; Taken worden pas uitgevoerd als de pool bestaat. U moet de pool-id of de specificatie van de automatische pool opgeven, maar niet beide.

--priority

De prioriteit van de taak. Prioriteitswaarden kunnen variëren van -1000 tot 1000, waarbij -1000 de laagste prioriteit is en 1000 de hoogste prioriteit is. Als u dit weglaat, blijft de prioriteit van de taak ongewijzigd.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch job show

Hiermee wordt informatie opgehaald over de opgegeven Batch-taak.

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]

Voorbeelden

Geeft informatie weer over een taak.

az batch job show --job-id job1

Vereiste parameters

--job-id

De id van de taak. Vereist.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--expand

Een OData-$expand-component.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--select

Een OData-$select-component.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.

az batch job stop

Stop een actieve Batch-taak.

Beëindig de opgegeven taak en markeer deze als voltooid. Wanneer een aanvraag voor een beëindigingstaak wordt ontvangen, stelt de Batch-service de taak in op de eindstatus. De Batch-service beëindigt vervolgens alle actieve taken die aan de taak zijn gekoppeld en voert eventuele vereiste taakreleasetaken uit. Vervolgens wordt de taak verplaatst naar de voltooide status. Als er taken in de taak in de actieve status staan, blijven ze actief. Zodra een taak is beëindigd, kunnen er geen nieuwe taken worden toegevoegd en worden alle resterende actieve taken niet gepland.

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]

Voorbeelden

Een taak stoppen en een beëindigingsreden geven

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

Vereiste parameters

--job-id

De id van de taak die moet worden beëindigd. Vereist.

Optionele parameters

--account-endpoint

Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.

--account-key

Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.

--account-name

Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--if-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service exact overeenkomt met de waarde die is opgegeven door de client.

--if-modified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--if-none-match

Een ETag-waarde die is gekoppeld aan de versie van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de huidige ETag van de resource op de service niet overeenkomt met de waarde die is opgegeven door de client.

--if-unmodified-since

Een tijdstempel die de laatst gewijzigde tijd aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource op de service is gewijzigd sinds de opgegeven tijd.

--terminate-reason

Reden voor beëindiging.

De tekst die u wilt weergeven als de TerminateReason van de taak. De standaardwaarde is UserTerminate.

Globale parameters
--debug

Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.

--help -h

Dit Help-bericht weergeven en afsluiten.

--only-show-errors

Alleen fouten weergeven, waarschuwingen onderdrukken.

--output -o

Uitvoerindeling.

Geaccepteerde waarden: json, jsonc, none, table, tsv, yaml, yamlc
Default value: json
--query

JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.

--subscription

Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID.

--verbose

Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.