az batch task

Batch-taken beheren.

Opdracht

az batch task create

Batch-taken maken.

az batch task delete

Hiermee verwijdert u een taak van de opgegeven taak.

az batch task file

Batch-taakbestanden beheren.

az batch task file delete

Hiermee verwijdert u het opgegeven taakbestand uit het reken knooppunt waar de taak is uitvoeren.

az batch task file download

Download de inhoud van een Batch-taakbestand.

az batch task file list

Geeft een lijst van de bestanden in de map van een taak op het reken knooppunt.

az batch task file show

Hiermee haalt u de eigenschappen van het opgegeven taakbestand.

az batch task list

Een lijst met alle taken die zijn gekoppeld aan de opgegeven job.

az batch task reactivate

Een taak opnieuw activeren, zodat deze opnieuw kan worden uitgevoerd, zelfs als het aantal nieuwe poging is uitgeput.

az batch task reset

Stel de eigenschappen van een Batch-taak opnieuw in.

az batch task show

Hiermee haalt u informatie op over de opgegeven taak.

az batch task stop

Hiermee wordt de opgegeven taak beëindigd.

az batch task subtask

Subtaken van een Batch-taak beheren.

az batch task subtask list

Een lijst met alle subtaken die zijn gekoppeld aan de opgegeven taak met meerdere exemplaren.

az batch task create

Batch-taken maken.

az batch task create --job-id
                     [--account-endpoint]
                     [--account-key]
                     [--account-name]
                     [--affinity-id]
                     [--application-package-references]
                     [--command-line]
                     [--environment-settings]
                     [--json-file]
                     [--max-task-retry-count]
                     [--max-wall-clock-time]
                     [--resource-files]
                     [--retention-time]
                     [--subscription]
                     [--task-id]

Vereiste parameters

--job-id

De id van de taak die de taak bevat.

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.

--affinity-id

Vereist. Een ondoorzichtige tekenreeks die de locatie vertegenwoordigt van een reken knooppunt of een taak die eerder is uitgevoerd. U kunt de affiniteits-id van een knooppunt doorgeven om aan te geven dat deze taak moet worden uitgevoerd op dat reken-knooppunt. Houd er rekening mee dat dit slechts een zachte affiniteit is. Als het doelreken-knooppunt bezet is of niet beschikbaar is op het moment dat de taak is gepland, wordt de taak elders gepland.

--application-package-references

De lijst met door spaties gescheiden lijst met ID's waarin de toepassingspakketten worden opgegeven die moeten worden geïnstalleerd. Door ruimte gescheiden toepassings-id's met optionele versie in de indeling 'id[#version]'.

--command-line

De opdrachtregel van de taak. 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 aanroepen op de opdrachtregel, bijvoorbeeld met behulp van 'cmd /c MyCommand' in Windows of '/bin/sh -c MyCommand' in Linux.

--environment-settings

Een lijst met instellingen voor omgevingsvariabelen voor de taak. Door spaties gescheiden waarden in de notatie 'key=value'.

--json-file

Het bestand met de te maken taak(en) in JSON (opgemaakt om overeen te komen met REST API aanvraag body). Wanneer u meerdere taken indient, accepteert een matrix van taken of een TaskAddCollectionParamater. Als deze parameter is opgegeven, worden alle andere parameters genegeerd.

--max-task-retry-count

Het maximum aantal keren dat de 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 met deze waarde specifiek het aantal nieuwe stappen voor het uitvoerbare taakbare bestand wordt bepaald vanwege een andere exitcode dan een andere uitvoercode. De Batch-service probeert de taak eenmaal uit en kan deze limiet vervolgens opnieuw proberen te overschrijden. Als het maximum aantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal vier keer (één eerste poging en drie nieuwe pogingen). Als het maximum aantal nieuwe pogingen 0 is, probeert de Batch-service de taak niet opnieuw na de eerste poging. Als het maximum aantal nieuwe poging -1 is, wordt de Taak zonder limiet opnieuw door de Batch-service opnieuw proberen.

--max-wall-clock-time

De maximale verstreken tijd die de taak kan worden uitgevoerd, gemeten vanaf het moment dat de taak wordt gestart. Als de taak niet binnen de tijdslimiet is voltooid, wordt deze door de Batch-service beëindigd. Als dit niet is opgegeven, is er geen tijdslimiet voor hoe lang de taak kan worden uitgevoerd.

--resource-files

Een lijst met bestanden die de Batch-service downloadt naar het reken-knooppunt voordat de opdrachtregel wordt uitgevoerd. Door ruimte gescheiden resourceverwijzingen in bestandsnaam=httpurl-indeling, met httpurl een HTTP-URL met openbare toegang of een SAS-URL met leestoegang.

--retention-time

De minimale tijd die nodig is om de taakmap te behouden op het reken knooppunt waar deze is uitgevoerd, vanaf het moment dat de uitvoering is voltooid. Na deze tijd kan de Batch-service de map Taak en alle inhoud ervan verwijderen. De standaardwaarde is 7 dagen, dat wil zeggen dat de taakmap 7 dagen wordt bewaard, tenzij het reken knooppunt wordt verwijderd of de taak wordt verwijderd.

--subscription

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

--task-id

De id van de taak.

az batch task delete

Hiermee verwijdert u een taak van de opgegeven taak.

Wanneer een taak wordt verwijderd, worden alle bestanden in de map op het reken knooppunt waar deze taak is uitvoeren ook verwijderd (ongeacht de bewaartijd). Voor taken met meerdere exemplaren wordt de bewerking Taak verwijderen synchroon toegepast op de primaire taak; subtaken en hun bestanden worden vervolgens asynchroon op de achtergrond verwijderd.

az batch task delete --job-id
                     --task-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 van waaruit de taak moet worden verwijderd.

--task-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 het tijdstip aangeeft waarop de resource voor het laatst is gewijzigd en 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 het tijdstip aangeeft waarop de resource voor het laatst is gewijzigd en 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 .

--yes -y

Niet vragen om bevestiging.

az batch task list

Een lijst met alle taken die zijn gekoppeld aan de opgegeven job.

Voor taken met meerdere exemplaren verwijzen gegevens zoals affinityId, executionInfo en nodeInfo naar de primaire taak. Gebruik de lijstsubtaken-API om informatie over subtaken op te halen.

az batch task list --job-id
                   [--account-endpoint]
                   [--account-key]
                   [--account-name]
                   [--expand]
                   [--filter]
                   [--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.

--filter

Een OData $filter-component. Zie voor meer informatie over het maken van dit https://docs.microsoft.com/en-us/rest/api/batchservice/odata-filters-in-batch#list-tasks filter.

--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 task reactivate

Een taak opnieuw activeren, zodat deze opnieuw kan worden uitgevoerd, zelfs als het aantal nieuwe poging is uitgeput.

Bij opnieuw activeren komt een taak in aanmerking om opnieuw te worden proberen, tot het maximale aantal nieuwe pogingen. De status van de taak is gewijzigd in actief. Omdat de taak niet langer de status Voltooid heeft, zijn eerdere afsluitende code of foutinformatie niet meer beschikbaar na het opnieuw activeren. Telkens als een taak opnieuw wordt geactiveerd, wordt het aantal nieuwe poging opnieuw ingesteld op 0. Opnieuw activeren mislukt voor taken die niet zijn voltooid of die eerder zijn voltooid (met een afsluitende code van 0). Bovendien mislukt dit als de taak is voltooid (of wordt beëindigd of verwijderd).

az batch task reactivate --job-id
                         --task-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 de taak bevat.

--task-id

De id van de taak die opnieuw moet worden geactiveerd.

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

Stel de eigenschappen van een Batch-taak opnieuw in.

az batch task reset --job-id
                    --task-id
                    [--account-endpoint]
                    [--account-key]
                    [--account-name]
                    [--if-match]
                    [--if-modified-since]
                    [--if-none-match]
                    [--if-unmodified-since]
                    [--json-file]
                    [--max-task-retry-count]
                    [--max-wall-clock-time]
                    [--retention-time]
                    [--subscription]

Vereiste parameters

--job-id

De id van de taak die de taak bevat.

--task-id

De id van de taak die moet worden bijgewerkt.

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.

--json-file

Een bestand met de specificatie van beperkingen in JSON (opgemaakt volgens de REST API body). Als deze parameter is opgegeven, worden alle 'beperkingenargumenten' genegeerd.

--max-task-retry-count

Het maximum aantal keren dat de taak opnieuw kan worden gedaan. De Batch-service wordt opnieuw een taak als de afsluiten code is niet van dezelfde. Houd er rekening mee dat deze waarde specifiek het aantal nieuwe stappen voor het uitvoerbare taakuitvoerbare bestand als gevolg van een niet-zero exit-code bepaalt. De Batch-service probeert de taak eenmaal en kan vervolgens opnieuw proberen deze limiet te overschrijden. Als het maximum aantal nieuwe pogingen bijvoorbeeld 3 is, probeert Batch de taak maximaal vier keer (één eerste poging en drie nieuwe pogingen). Als het maximum aantal nieuwe pogingen 0 is, probeert de Batch-service de taak na de eerste poging niet opnieuw uit te voeren. Als het maximum aantal nieuwe poging -1 is, wordt de Taak zonder limiet opnieuw door de Batch-service opnieuw onder de werkbalk onder de 2000 bereikt.

--max-wall-clock-time

De maximale verstreken tijd die de taak kan worden uitgevoerd, gemeten vanaf het moment dat de taak wordt gestart. Als de taak niet binnen de tijdslimiet is voltooid, wordt deze door de Batch-service beëindigd. Als dit niet is opgegeven, is er geen tijdslimiet voor hoe lang de taak kan worden uitgevoerd. De verwachte indeling is een ISO-8601-duur.

--retention-time

De minimale tijd die nodig is om de taakmap te bewaren op het reken knooppunt waar deze is uitgevoerd, vanaf het moment dat de uitvoering is voltooid. Na deze tijd kan de Batch-service de map Taak en alle inhoud ervan verwijderen. De standaardwaarde is 7 dagen, dat wil zeggen dat de map Taak 7 dagen wordt bewaard, tenzij het reken knooppunt wordt verwijderd of de taak wordt verwijderd. De verwachte indeling is een ISO-8601-duur.

--subscription

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

az batch task show

Hiermee haalt u informatie op over de opgegeven taak.

Voor taken met meerdere exemplaren verwijst informatie zoals affinityId, executionInfo en nodeInfo naar de primaire taak. Gebruik de api list subtasks om informatie over subtaken op te halen.

az batch task show --job-id
                   --task-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 die de taak bevat.

--task-id

De id van de taak om informatie over op te halen.

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

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

Hiermee wordt de opgegeven taak beëindigd.

Wanneer de taak is beëindigd, wordt deze verplaatst naar de status Voltooid. Voor taken met meerdere exemplaren wordt de bewerking Taak beëindigen synchroon toegepast op de primaire taak; subtaken worden vervolgens asynchroon op de achtergrond beëindigd.

az batch task stop --job-id
                   --task-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 de taak bevat.

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