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

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 creatietijd van de Taak.

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.

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.

De ETag van de taak. Dit is een ondoorzichtige tekenreeks. Je kunt het gebruiken om te detecteren of de taak tussen verzoeken is veranderd. In het bijzonder kun je de ETag doorgeven bij het bijwerken van een Task om aan te geven dat je wijzigingen alleen van kracht mogen worden als niemand anders de Task in de tussentijd heeft aangepast.

Informatie over de uitvoering van 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 laatste gewijzigde tijd van de Taak.

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

Informatie over de rekenknoop waarop de taak draaide.

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.

De vorige staat van de Taak. Deze eigenschap wordt niet ingesteld als de Taak zich in zijn initiële actieve toestand bevindt.

Het moment waarop de Taak in zijn vorige staat kwam. Deze eigenschap wordt niet ingesteld als de Taak zich in zijn initiële actieve toestand bevindt.

Het aantal planningsslots dat de Taak nodig heeft 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 huidige staat van de Taak.

Het moment waarop de Task zijn huidige staat bereikte.

Statistieken over het gebruik van middelen voor de Taak.

De URL van de taak.

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