BatchTaskCreateOptions interface

Een localiteitstip die door de batchservice kan worden gebruikt om een Compute Node te selecteren waarop de nieuwe Taak wordt gestart.

Een lijst van pakketten die de batchservice zal uitrollen naar de Compute Node voordat de opdrachtregel wordt uitgevoerd. Applicatiepakketten worden gedownload en uitgezonden naar een gedeelde map, niet naar de Task-werkmap. Daarom, als een referentiepakket al op de Node staat en up-to-date is, wordt het niet opnieuw gedownload; de bestaande kopie op de Compute Node wordt gebruikt. Als een referentiepakket niet kan worden geïnstalleerd, bijvoorbeeld omdat het pakket is verwijderd of omdat de download mislukte, faalt de taak.

De commandoregel van de Taak. Voor multi-instance Tasks wordt de commandoregel uitgevoerd als de primaire Taak, nadat de primaire Taak en alle subtaken de coördinatiecommandoregel hebben uitgevoerd. De opdrachtregel wordt niet uitgevoerd onder een shell en kan daarom niet profiteren van shell-functies zoals uitbreiding van omgevingsvariabelen. Als je van zulke functies wilt profiteren, moet je de shell aanroepen in 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://dotnet.territoriali.olinfo.it/azure/batch/batch-compute-node-environment-variables).

De uitvoeringsbeperkingen die op deze taak van toepassing zijn. Als je geen beperkingen specificeert, is maxTaskRetryCount de maxTaskRetryCount die voor de Job is gespecificeerd, is maxWallClockTime oneindig, en is retentionTime 7 dagen.

De instellingen voor de container waaronder de taak draait. Als de Pool die deze taak uitvoert containerConfiguration heeft ingesteld, moet dit ook worden ingesteld. Als de pool die deze taak uitvoert geen containerConfiguration heeft ingesteld, mag dit niet worden ingesteld. Wanneer dit wordt gespecificeerd, worden alle directories recursief onder de AZ_BATCH_NODE_ROOT_DIR (de wortel van Azure Batch directories op de node) in de container gemapt, worden alle Task-omgevingsvariabelen in de container gemapt en wordt de Task-commandoregel uitgevoerd in de container. Bestanden die buiten AZ_BATCH_NODE_ROOT_DIR in de container worden geproduceerd, worden mogelijk niet teruggespiegeld naar de hostdisk, wat betekent dat Batch-bestands-API's geen toegang tot die bestanden hebben.

De taken waarop deze taak afhangt. Deze taak wordt pas ingepland nadat alle taken waarop hij afhankelijk is succesvol zijn voltooid. Als een van die taken faalt en hun aantal herpogingen opmaakt, wordt deze taak nooit gepland. Als de Job usesTaskDependencies niet op true heeft gezet, en dit element aanwezig is, mislukt het verzoek met de foutcode TaskDependenciesNotSpecificifiedOnJob.

Een weergavenaam voor de Taak. De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024.

Een lijst met instellingen voor omgevingsvariabelen voor de Taak.

Hoe de Batch-service zou moeten reageren wanneer de taak is voltooid.

Een string die de Taak binnen de Taak uniek identificeert. De id kan elke combinatie van alfanumerieke tekens bevatten, inclusief afbreekstreepjes en onderstrepingstekens, en mag niet meer dan 64 tekens bevatten. De ID is hoofdletters behoudend en hoofdletter-ongevoelig (dat wil zeggen, je mag niet twee ID's binnen een Job hebben die alleen per case verschillen).

Een object dat aangeeft dat de taak een multi-instance Task is, en bevat informatie over hoe de multi-instance Task moet worden uitgevoerd.

Een lijst van bestanden die de Batch-service zal uploaden vanaf de Compute Node nadat de opdrachtregel is uitgevoerd. Voor multi-instance taken worden de bestanden alleen geüpload vanaf de Compute Node waarop de primaire Task wordt uitgevoerd.

Het aantal planningsslots dat de Taak nodig had om uit te voeren. De standaardwaarde is één. Een Task kan alleen worden gepland om op een compute-node te draaien als de node genoeg vrije planningsslots beschikbaar heeft. Voor multi-instance taken moet dit 1 zijn.

Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. Voor multi-instance taken worden de resourcebestanden alleen gedownload naar de Compute Node waarop de primaire Task wordt uitgevoerd. 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.

De gebruikersidentiteit waaronder de taak draait. Als deze wordt weggelaten, draait de taak als een niet-administratieve gebruiker die uniek is voor de taak.