az batch job

Batch-taken beheren.

Opdracht

az batch job all-statistics

Bekijk de statistieken van alle taken onder een Batch-account.

az batch job all-statistics show

Statistische gegevens over levensduursamenvatting voor alle taken in een Batch-account.

az batch job create

Voeg een taak toe aan een Batch-account.

az batch job delete

Hiermee verwijdert u een taak.

az batch job disable

Hiermee schakelt u de opgegeven taak uit, waardoor nieuwe taken niet kunnen worden uitgevoerd.

az batch job enable

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

az batch job list

Een lijst met alle jobs of jobplanningen in een Batch-account.

az batch job prep-release-status

Bekijk de status van batchvoorbereidings- en releasetaken.

az batch job prep-release-status list

Geeft de uitvoeringsstatus weer van de jobvoorbereidings- en jobversietaak voor de opgegeven taak op de rekenknooppunten waarop de taak is uitgevoerd.

az batch job reset

Werk de eigenschappen van een Batch-taak bij. Niet-gespecificeerde eigenschappen die kunnen worden bijgewerkt, worden opnieuw ingesteld op de standaardwaarden.

az batch job set

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

az batch job show

Hiermee haalt u informatie op over de opgegeven taak.

az batch job stop

Hiermee beëindigt u de opgegeven taak en markeert u deze als voltooid.

az batch job task-counts

Bekijk het aantal taken en sleuven in een Batch-job en hun staat.

az batch job task-counts show

Hiermee haalt u het aantal taken voor de opgegeven taak.

az batch job create

Voeg een taak toe aan een Batch-account.

az batch job create [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--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]
                    [--metadata]
                    [--pool-id]
                    [--priority]
                    [--required-slots]
                    [--subscription]
                    [--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.

--id

Vereist. Een tekenreeks die de taak uniek identificeert binnen het account. De id kan een combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepingstekens en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten. De id is case-preserving en niet-case-niet-gevoelig (dat wil zeggen, u hebt mogelijk geen twee id's binnen een account die alleen per geval verschillen).

--job-manager-task-command-line

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

--job-manager-task-environment-settings

Een lijst met instellingen voor omgevingsvariabelen voor de jobbeheertaak. Door spaties gescheiden waarden in de notatie 'sleutel=waarde'.

--job-manager-task-id

Vereist. Een tekenreeks die de Job Manager-taak binnen de taak op unieke manier identificeert. De id kan een combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepingstekens en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten.

--job-manager-task-resource-files

Een lijst met bestanden die de Batch-service downloadt naar het reken knooppunt voordat de opdrachtregel wordt uitgevoerd. 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 wordt de antwoordfoutcode RequestEntityTooLarge. Als dit het geval is, moet de verzameling ResourceFiles worden verkleind. Dit kan worden bereikt met .zip bestanden, toepassingspakketten of Docker-containers. Door spaties gescheiden resourceverwijzingen in bestandsnaam=httpurl-indeling.

--job-max-task-retry-count

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

--job-max-wall-clock-time

De maximale verstreken tijd die de taak mag uitvoeren, gemeten vanaf het moment dat de taak wordt gemaakt. Als de job 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 mag worden uitgevoerd. De verwachte indeling is een ISO-8601-duur.

--json-file

Een bestand met de taakspecificatie in JSON (opgemaakt volgens de REST API body). Als deze parameter is opgegeven, worden alle taakargumenten genegeerd.

--metadata

Een lijst met naam-waardeparen die als metagegevens aan de taak zijn gekoppeld. 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 'sleutel=waarde'.

--pool-id

De id van een bestaande pool. Alle taken van de job worden uitgevoerd op de opgegeven pool.

--priority

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

--required-slots

Het aantal planningssleuven dat de taak moet uitvoeren. De standaardwaarde is 1. Een taak kan alleen worden gepland om te worden uitgevoerd op een reken knooppunt als het knooppunt voldoende vrije planningssleuven beschikbaar heeft. Voor taken met meerdere instanties moet dit 1 zijn.

--subscription

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

--uses-task-dependencies

Of taken in de job afhankelijkheden van elkaar kunnen definiëren. De standaardwaarde is false. Waar als de vlag aanwezig is.

az batch job delete

Hiermee verwijdert u een taak.

Als u een job verwijdert, worden ook alle taken verwijderd die deel uitmaken van die job en alle jobstatistieken. Dit overschrijven ook de bewaarperiode voor taakgegevens; Dat wil zeggen dat als de job taken bevat die nog steeds worden bewaard op rekenknooppunten, de Batch-services de werkdirecties en alle inhoud van deze taken verwijderen. Wanneer een aanvraag voor het verwijderen van een taak 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]
                    [--subscription]
                    [--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 laatste wijziging aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource in de service sinds de opgegeven tijd is gewijzigd.

--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 overeen komt met de waarde die is opgegeven door de client.

--if-unmodified-since

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

--subscription

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

--yes -y

Niet vragen om bevestiging.

az batch job disable

Hiermee schakelt u de opgegeven taak uit, waardoor nieuwe taken niet kunnen worden uitgevoerd.

De Batch-service verplaatst de taak onmiddellijk naar de status uitschakelen. Batch gebruikt vervolgens de parameter disableTasks om te bepalen wat er moet worden gedaan met de taken die momenteel worden uitgevoerd voor de job. De taak blijft in de status uitschakelen totdat de bewerking uitschakelen is voltooid en alle taken zijn afgehandeld volgens de disableTasks optie; de taak wordt vervolgens verplaatst naar de uitgeschakelde status. Er worden geen nieuwe taken gestart onder de taak totdat deze weer actief is. Als u een taak probeert uit te schakelen die zich in een andere status 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 {requeue, terminate, wait}]
                     [--if-match]
                     [--if-modified-since]
                     [--if-none-match]
                     [--if-unmodified-since]
                     [--subscription]

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

Wat te doen met actieve taken die zijn gekoppeld aan de job.

geaccepteerde waarden: 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 laatste wijziging aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource in de service sinds de opgegeven tijd is gewijzigd.

--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 overeen komt met de waarde die is opgegeven door de client.

--if-unmodified-since

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

--subscription

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

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 status Inschakelen. Nadat deze bewerking is voltooid, wordt de taak verplaatst naar de status actief 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. Dus als u een taak inschakelen met actieve taken 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]
                    [--subscription]

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 laatste wijziging aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource in de service sinds de opgegeven tijd is gewijzigd.

--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 overeen komt met de waarde die is opgegeven door de client.

--if-unmodified-since

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

--subscription

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

az batch job list

Een lijst met alle jobs of jobplanningen in een Batch-account.

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

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 het taakschema van waaruit u een lijst met taken wilt op halen. Als u dit wegwerkt, worden alle taken in het account vermeld.

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en plakken na de parameter --query tussen dubbele aanhalingstekens om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--select

Een OData $select component.

--subscription

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

az batch job reset

Werk de eigenschappen van een Batch-taak bij. Niet-gespecificeerde eigenschappen die kunnen worden bijgewerkt, worden opnieuw ingesteld op de standaardwaarden.

az batch job reset --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--if-match]
                   [--if-modified-since]
                   [--if-none-match]
                   [--if-unmodified-since]
                   [--job-max-task-retry-count]
                   [--job-max-wall-clock-time]
                   [--json-file]
                   [--metadata]
                   [--on-all-tasks-complete {noaction, terminatejob}]
                   [--pool-id]
                   [--priority]
                   [--subscription]

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.

--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 laatste wijziging aangeeft van de resource die bekend is bij de client. De bewerking wordt alleen uitgevoerd als de resource in de service sinds de opgegeven tijd is gewijzigd.

--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 overeen komt met de waarde die is opgegeven door de client.

--if-unmodified-since

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

--job-max-task-retry-count

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

--job-max-wall-clock-time

De maximale verstreken tijd die de taak mag uitvoeren, gemeten vanaf het moment dat de taak wordt gemaakt. Als de job 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 mag worden uitgevoerd. De verwachte indeling is een ISO-8601-duur.

--json-file

Een bestand met de parameterspecificatie voor het bijwerken van de taak in JSON (opgemaakt volgens de REST API body). Als deze parameter is opgegeven, worden alle taakargumenten genegeerd.

--metadata

Een lijst met naam-waardeparen die als metagegevens aan de taak zijn gekoppeld. Als u dit weggelaten, wordt de standaardwaarde van een lege lijst gebruikt; alle bestaande metagegevens worden verwijderd. Door spaties gescheiden waarden in de notatie 'sleutel=waarde'.

--on-all-tasks-complete

De actie die de Batch-service moet uitvoeren wanneer alle taken in de job de status Voltooid hebben. Als u dit weggelaten, wordt het voltooiingsgedrag ingesteld op noaction. Als de huidige waarde terminatejob is, is dit een fout omdat het voltooiingsgedrag van een taak niet kan worden gewijzigd van terminatejob in noaction. U mag de waarde niet wijzigen van terminatejob in noaction, dat wil zeggen dat wanneer u automatische beëindiging van de taak hebt ingeschakeld, u deze niet opnieuw kunt uitschakelen. Als u dit probeert te doen, mislukt de aanvraag en retourneert Batch statuscode 400 (Ongeldige aanvraag) en een foutbericht over een ongeldige eigenschapswaarde. Als u dit element niet opgeeft in een PUT-aanvraag, is dit gelijk aan het doorgeven van een noaction. Dit is een fout als de huidige waarde terminatejob is.

geaccepteerde waarden: noaction, terminatejob
--pool-id

De id van een bestaande pool. Alle taken van de job worden uitgevoerd op de opgegeven pool.

--priority

De prioriteit van de taak. Prioriteitswaarden kunnen variëren van -1000 tot 1000, met -1000 de laagste prioriteit en 1000 de hoogste prioriteit. Als u dit weggelaten, wordt deze ingesteld op de standaardwaarde 0.

--subscription

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

az batch job set

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

az batch job set --job-id
                 [--account-endpoint]
                 [--account-key]
                 [--account-name]
                 [--if-match]
                 [--if-modified-since]
                 [--if-none-match]
                 [--if-unmodified-since]
                 [--job-max-task-retry-count]
                 [--job-max-wall-clock-time]
                 [--json-file]
                 [--metadata]
                 [--on-all-tasks-complete {noaction, terminatejob}]
                 [--pool-id]
                 [--priority]
                 [--subscription]

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.

--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 laatste wijziging 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 overeen komt met de waarde die is opgegeven door de client.

--if-unmodified-since

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

--job-max-task-retry-count

Het maximum aantal keren dat elke taak opnieuw kan worden gedaan. De Batch-service wordt opnieuw een taak als de afsluitende code is niet-van-andere. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe proberen bepaalt. De Batch-service probeert elke taak eenmaal uit en kan vervolgens opnieuw proberen deze limiet te overschrijden. Als het maximum aantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch maximaal 4 keer een taak uit te voeren (één eerste poging en drie nieuwe pogingen). Als het maximum aantal nieuwe opdrachten 0 is, worden taken niet opnieuw uitgevoerd door de Batch-service. Als het maximum aantal nieuwe poging -1 is, worden taken zonder limiet opnieuw uitgevoerd door de Batch-service. De standaardwaarde is 0 (geen nieuwe proberen).

--job-max-wall-clock-time

De maximale verstreken tijd die de taak mag uitvoeren, gemeten vanaf het moment dat de taak wordt gemaakt. Als de job 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 mag worden uitgevoerd. De 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 REST API body). Als deze parameter is opgegeven, worden alle 'taakargumenten' genegeerd.

--metadata

Een lijst met naam-waardeparen die als metagegevens aan de taak zijn gekoppeld. Als u dit weggelaten, blijven de bestaande metagegevens van de taak 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 job de status Voltooid hebben. Als u dit weggelaten, blijft het voltooiingsgedrag ongewijzigd. U mag de waarde niet wijzigen van terminatejob 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 aanroept, is de HTTP-statuscode 400 (Slechte aanvraag).

geaccepteerde waarden: noaction, terminatejob
--pool-id

De id van een bestaande pool. Alle taken van de job worden uitgevoerd op de opgegeven pool.

--priority

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

--subscription

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

az batch job show

Hiermee haalt u informatie op 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]
                  [--query-examples]
                  [--select]
                  [--subscription]

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 laatste wijziging 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 overeen komt met de waarde die is opgegeven door de client.

--if-unmodified-since

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

--query-examples

JMESPath-tekenreeks voor u aanbevelen. U kunt een van de query's kopiëren en deze na de parameter --query tussen dubbele aanhalingstekens plakken om de resultaten te bekijken. U kunt een of meer positionele trefwoorden toevoegen, zodat we suggesties kunnen geven op basis van deze sleutelwoorden.

--select

Een OData $select-component.

--subscription

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

az batch job stop

Hiermee beëindigt u de opgegeven taak en markeert u deze als voltooid.

Wanneer een aanvraag voor het beëindigen van de taak wordt ontvangen, stelt de Batch-service de taak in op de eindtoestand. De Batch-service beëindigt vervolgens alle taken die worden uitgevoerd die aan de job zijn gekoppeld en voert alle vereiste job-releasetaken uit. Vervolgens wordt de taak verplaatst naar de status Voltooid. Als er taken in de job zijn met de status Actief, blijven ze actief. Zodra een job is beëindigd, kunnen er geen nieuwe taken meer worden toegevoegd en worden 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]
                  [--subscription]
                  [--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 laatste wijziging 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 overeen komt met de waarde die is opgegeven door de client.

--if-unmodified-since

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

--subscription

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

--terminate-reason

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