Delen via


az batch job

Notitie

Deze opdrachtgroep bevat opdrachten die zijn gedefinieerd in zowel Azure CLI als ten minste één extensie. Installeer elke extensie om te profiteren van de uitgebreide mogelijkheden. Meer informatie over extensies.

Batch-taken beheren.

Opdracht

Name Description Type Status
az batch job create

Voeg een taak toe aan een Batch-account.

Basis GA
az batch job create (azure-batch-cli-extensions extensie)

Voeg een taak en bijbehorende taken toe aan een Batch-account.

Toestel GA
az batch job delete

Hiermee verwijdert u een taak.

Basis GA
az batch job disable

Hiermee wordt de opgegeven taak uitgeschakeld, waardoor nieuwe taken niet kunnen worden uitgevoerd.

Basis GA
az batch job enable

Hiermee schakelt u de opgegeven taak in, zodat nieuwe taken kunnen worden uitgevoerd.

Basis GA
az batch job list

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

Basis GA
az batch job prep-release-status

Bekijk de status van batchtaakvoorbereidings- en releasetaken.

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

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

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

Basis GA
az batch job show

Hiermee wordt informatie opgehaald over de opgegeven taak.

Basis GA
az batch job stop

Stop een actieve Batch-taak.

Basis GA
az batch job task-counts

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

Basis GA
az batch job task-counts show

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

Basis 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-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]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--uses-task-dependencies]

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

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

--job-manager-task-command-line

Vereist. 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 gebruik wilt maken, 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).

--job-manager-task-environment-settings

Door spaties gescheiden waarden in de notatie 'key=value'.

--job-manager-task-id

Vereist. De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens en mag niet meer dan 64 tekens bevatten.

--job-manager-task-resource-files

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

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. Standaardwaarde: -1.

--metadata

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

--pool-id

De id van een bestaande pool. Alle taken van de taak worden uitgevoerd in de opgegeven pool.

--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 het 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 create (azure-batch-cli-extensions extensie)

Voeg een taak en bijbehorende taken toe aan een Batch-account.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--allow-task-preemption]
                    [--id]
                    [--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]
                    [--parameters]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--resource-group]
                    [--template]
                    [--uses-task-dependencies]

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

--id

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

--job-manager-task-command-line

De opdrachtregel van de taak Taakbeheer. 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 gebruik wilt maken, moet u de shell aanroepen op de opdrachtregel, bijvoorbeeld met 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux.

--job-manager-task-environment-settings

Een lijst met omgevingsvariabeleinstellingen voor de Taakbeheertaak. Door spaties gescheiden waarden in de notatie key=value.

--job-manager-task-id

Een tekenreeks die de Taakbeheer-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.

--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. Door ruimte 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 één keer en kan vervolgens opnieuw proberen 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 geen taken opnieuw uit. Als het maximumaantal nieuwe pogingen -1 is, probeert de Batch-service taken zonder limiet opnieuw uit te voeren. 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. Standaardwaarde: -1.

--metadata

De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode.

--parameters

Parameterwaarden voor een JSON-sjabloonbestand voor een Batch-taak. Kan alleen worden gebruikt met --template.

--pool-id

De id van een bestaande pool. Alle taken van de taak worden uitgevoerd in de opgegeven pool.

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

--resource-group

De resourcegroep van het Batch-account.

--template

Een JSON-sjabloonbestand voor batchtaken. Als deze parameter is opgegeven, worden alle andere parameters genegeerd.

--uses-task-dependencies

De vlag die bepaalt of deze taak taken met afhankelijkheden gebruikt. Waar als er een vlag aanwezig is.

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

Als u een taak verwijdert, worden ook alle taken verwijderd die deel uitmaken van die taak en alle taakstatistieken. Dit overschrijft ook de bewaarperiode voor taakgegevens; Als de taak taken bevat die nog steeds worden bewaard op rekenknooppunten, worden de werkmappen en alle inhoud van die taken verwijderd door de Batch-services. Wanneer een verwijdertaakaanvraag wordt ontvangen, stelt de Batch-service de taak in op de status Verwijderen. Alle updatebewerkingen voor een taak die de status Verwijderen heeft, mislukken met statuscode 409 (Conflict), met aanvullende informatie die aangeeft dat de taak wordt verwijderd.

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

Vereiste parameters

--job-id

De id van de taak die moet worden verwijderd.

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 niet 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 het 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

Hiermee wordt de opgegeven taak uitgeschakeld, waardoor nieuwe taken niet kunnen worden uitgevoerd.

De Batch-service verplaatst de taak onmiddellijk naar de uitschakelingsstatus. Batch gebruikt vervolgens de parameter disableTasks om te bepalen wat er moet worden gedaan met de taken die momenteel worden uitgevoerd. De taak blijft in de status uitschakelen totdat de uitschakeling is voltooid en alle taken zijn afgehandeld volgens de optie disableTasks; de taak wordt vervolgens verplaatst naar de uitgeschakelde status. Er worden geen nieuwe taken gestart onder de taak totdat deze teruggaat naar de actieve status. Als u een taak probeert uit te schakelen die zich in een andere status bevindt dan actief, uitschakelen of uitgeschakeld, mislukt de aanvraag met statuscode 409.

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]

Vereiste parameters

--job-id

De id van de taak die moet worden uitgeschakeld.

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

Mogelijke waarden zijn: 'requeue', 'terminate', '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 niet 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 het 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

Hiermee schakelt u de opgegeven taak in, zodat nieuwe taken kunnen worden uitgevoerd.

Wanneer u deze API aanroept, stelt de Batch-service een uitgeschakelde taak in op de inschakelingsstatus. Nadat de bewerking is voltooid, wordt de taak verplaatst naar de actieve status en wordt de planning van nieuwe taken onder de taak hervat. De Batch-service staat niet toe dat een taak langer dan 180 dagen actief blijft. Als u daarom een taak inschakelt die actieve taken bevat die meer dan 180 dagen geleden zijn toegevoegd, worden deze taken niet uitgevoerd.

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

Vereiste parameters

--job-id

De id van de taak die moet worden ingeschakeld.

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

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. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.

--expand

Een OData-$expand-component.

--filter

Een OData-$filter-component.

--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 het 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 {noaction, terminatejob}]
                   [--pool-id]
                   [--priority]

Vereiste parameters

--job-id

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

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

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 parameterspecificatie voor taakupdates 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. Standaardwaarde: -1.

--metadata

Als u dit weglaat, wordt de standaardwaarde van een lege lijst gebruikt; in feite worden alle bestaande metagegevens verwijderd. 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, wordt het voltooiingsgedrag ingesteld op noaction. Als de huidige waarde een beëindigingstaak is, is dit een fout omdat het voltooiingsgedrag van een taak mogelijk niet wordt gewijzigd van terminatejob in noaction. 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 en retourneert Batch statuscode 400 (Ongeldige aanvraag) en een foutbericht 'ongeldige eigenschapswaarde'. Als u dit element niet opgeeft in een PUT-aanvraag, is dit gelijk aan het doorgeven van noaction. Dit is een fout als de huidige waarde een beëindigingstaak is.

Geaccepteerde waarden: noaction, terminatejob
--pool-id

De id van een bestaande pool. Alle taken van de taak worden uitgevoerd in de opgegeven pool.

--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, wordt deze ingesteld op de standaardwaarde 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 het 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 {noaction, terminatejob}]
                 [--pool-id]
                 [--priority]

Vereiste parameters

--job-id

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

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. Geef 'true' of 'false' op om de eigenschap bij te werken.

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

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 parameterspecificatie van de taakpatch 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

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

Geaccepteerde waarden: noaction, terminatejob
--pool-id

De id van een bestaande pool. Alle taken van de taak worden uitgevoerd in de opgegeven pool.

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

Vereiste parameters

--job-id

De id van de taak.

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

Vereiste parameters

--job-id

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

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