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
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
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.
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.
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].
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.
Een lijst met omgevingsvariabele-instellingen voor de taak Job Manager. Door spaties gescheiden waarden in de notatie 'key=value'.
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.
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.
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).
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.
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.
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.
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'.
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".
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.
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.
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.
Of taken in de taak afhankelijkheden op elkaar kunnen definiëren. De standaardwaarde is onwaar. Waar als er een vlag aanwezig is.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De id van de taak die moet worden verwijderd. Vereist.
Optionele parameters
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Niet vragen om bevestiging.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De id van de taak die moet worden uitgeschakeld. Vereist.
Optionele parameters
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
Wat u moet doen met actieve taken die aan de taak zijn gekoppeld. Vereist. Bekende waarden zijn: 'requeue', 'terminate' en 'wait'.
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.
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.
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.
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.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De id van de taak die moet worden ingeschakeld. Vereist.
Optionele parameters
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
De Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
De naam van het Batch-account. Alleen nodig Alternatief, ingesteld op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
Een OData-$expand-component.
Een OData-$filter-component. Zie https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batchvoor meer informatie over het maken van dit filter.
De id van de taakplanning waaruit u een lijst met taken wilt ophalen. Als u dit weglaat, worden alle taken in het account weergegeven.
Een OData-$select-component.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De id van de taak waarvan u de eigenschappen wilt bijwerken. Vereist.
Optionele parameters
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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'.
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".
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.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De id van de taak waarvan u de eigenschappen wilt bijwerken. Vereist.
Optionele parameters
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
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.
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).
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.
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.
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.
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'.
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".
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.
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
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De id van de taak. Vereist.
Optionele parameters
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
Een OData-$expand-component.
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.
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.
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.
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.
Een OData-$select-component.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
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
De id van de taak die moet worden beëindigd. Vereist.
Optionele parameters
Batch-service-eindpunt. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ENDPOINT.
Batch-accountsleutel. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCESS_KEY.
Batch-accountnaam. U kunt ook instellen op omgevingsvariabele: AZURE_BATCH_ACCOUNT.
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.
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.
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.
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.
Reden voor beëindiging.
De tekst die u wilt weergeven als de TerminateReason van de taak. De standaardwaarde is UserTerminate.
Globale parameters
Vergroot de uitgebreidheid van logboekregistratie om alle logboeken voor foutopsporing weer te geven.
Dit Help-bericht weergeven en afsluiten.
Alleen fouten weergeven, waarschuwingen onderdrukken.
Uitvoerindeling.
JMESPath-queryreeks. Zie http://jmespath.org/ voor meer informatie en voorbeelden.
Naam of id van abonnement. U kunt het standaardabonnement configureren met behulp van az account set -s NAME_OR_ID
.
Vergroot de uitgebreidheid van logboekregistratie. Gebruik --debug voor volledige foutopsporingslogboeken.