BatchJobReleaseTask interface

Pakket:

@azure-rest/batch

Een jobreleasetaak die moet worden uitgevoerd op taakvoltooiing op elk rekenknooppunt waarop de taak is uitgevoerd. De jobreleasetaak wordt uitgevoerd wanneer de taak eindigt, vanwege een van de volgende: De gebruiker roept de Taak-API beëindigen aan of de Taak-API verwijderen terwijl de taak nog actief is, de maximale tijdslimiet voor de klok van de taak is bereikt en de taak nog steeds actief is, of de Job Manager-taak is voltooid en de taak is geconfigureerd om te beëindigen wanneer jobbeheer is voltooid. De jobreleasetaak wordt uitgevoerd op elk knooppunt waarop taken van de taak zijn uitgevoerd en de taakvoorbereidingstaak is uitgevoerd en voltooid. Als u een knooppunt opnieuw installeert nadat het de taakvoorbereidingstaak heeft uitgevoerd en de taak eindigt zonder verdere taken van de taak die op dat knooppunt wordt uitgevoerd (en dus de taakvoorbereidingstaak niet opnieuw wordt uitgevoerd), wordt de jobreleasetaak niet uitgevoerd op dat rekenknooppunt. Als een knooppunt opnieuw wordt opgestart terwijl de jobreleasetaak nog steeds wordt uitgevoerd, wordt de taak voor taakrelease opnieuw uitgevoerd wanneer het rekenknooppunt wordt gestart. De taak is pas gemarkeerd als voltooid als alle jobreleasetaken zijn voltooid. De jobreleasetaak wordt op de achtergrond uitgevoerd. Het neemt geen planningssite in beslag; Dat wil gezegd, het telt niet mee voor de limiet van taskSlotsPerNode die is opgegeven voor de pool.

Eigenschappen

commandLine	De opdrachtregel van de taak jobrelease. 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	De instellingen voor de container waaronder de jobreleasetaak wordt uitgevoerd. Wanneer dit is opgegeven, worden alle mappen recursief onder de AZ_BATCH_NODE_ROOT_DIR (de hoofdmap van Azure Batch-mappen op het knooppunt) toegewezen aan de container, worden alle omgevingsvariabelen van de taak toegewezen aan de container en wordt de opdrachtregel Taak uitgevoerd in de container. Bestanden die worden geproduceerd in de container buiten AZ_BATCH_NODE_ROOT_DIR worden mogelijk niet weergegeven op de hostschijf, wat betekent dat Batch-bestands-API's geen toegang hebben tot deze bestanden.
environmentSettings	Een lijst met omgevingsvariabeleinstellingen voor de taak voor taakrelease.
id	Een tekenreeks die de taak jobrelease 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. Als u deze eigenschap niet opgeeft, wijst de Batch-service een standaardwaarde van jobrelease toe. Er kan geen andere taak in de taak dezelfde id hebben als de taak voor het vrijgeven van de taak. Als u een taak met dezelfde id probeert in te dienen, weigert de Batch-service de aanvraag met foutcode TaskIdSameAsJobReleaseTask; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 409 (conflict).
maxWallClockTime	De maximale verstreken tijd die door de taakreleasetaak kan worden uitgevoerd op een bepaald rekenknooppunt, gemeten vanaf het moment dat de taak wordt gestart. Als de taak niet binnen de tijdslimiet is voltooid, beëindigt de Batch-service deze. De standaardwaarde is 15 minuten. U mag geen time-out opgeven die langer is dan 15 minuten. Als u dit wel doet, weigert de Batch-service deze met een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag).
resourceFiles	Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. 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. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak.
retentionTime	De minimale tijd voor het behouden van de taakmap voor de taakreleasetaak op het rekenknooppunt. Na deze tijd kan de Batch-service de map Taak en alle inhoud ervan verwijderen. De standaardwaarde is 7 dagen, d.w. de map Taak wordt 7 dagen bewaard, tenzij het rekenknooppunt wordt verwijderd of de taak wordt verwijderd.
userIdentity	De gebruikersidentiteit waaronder de jobreleasetaak wordt uitgevoerd. Als u dit weglaat, wordt de taak uitgevoerd als een niet-gebruiker met beheerdersrechten die uniek is voor de taak.

Eigenschapdetails

commandLine

De opdrachtregel van de taak jobrelease. 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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).

commandLine: string

Waarde van eigenschap

string

containerSettings

De instellingen voor de container waaronder de jobreleasetaak wordt uitgevoerd. Wanneer dit is opgegeven, worden alle mappen recursief onder de AZ_BATCH_NODE_ROOT_DIR (de hoofdmap van Azure Batch-mappen op het knooppunt) toegewezen aan de container, worden alle omgevingsvariabelen van de taak toegewezen aan de container en wordt de opdrachtregel Taak uitgevoerd in de container. Bestanden die worden geproduceerd in de container buiten AZ_BATCH_NODE_ROOT_DIR worden mogelijk niet weergegeven op de hostschijf, wat betekent dat Batch-bestands-API's geen toegang hebben tot deze bestanden.

containerSettings?: BatchTaskContainerSettings

Waarde van eigenschap

BatchTaskContainerSettings

environmentSettings

Een lijst met omgevingsvariabeleinstellingen voor de taak voor taakrelease.

environmentSettings?: EnvironmentSetting[]

Waarde van eigenschap

EnvironmentSetting[]

id

Een tekenreeks die de taak jobrelease 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. Als u deze eigenschap niet opgeeft, wijst de Batch-service een standaardwaarde van jobrelease toe. Er kan geen andere taak in de taak dezelfde id hebben als de taak voor het vrijgeven van de taak. Als u een taak met dezelfde id probeert in te dienen, weigert de Batch-service de aanvraag met foutcode TaskIdSameAsJobReleaseTask; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 409 (conflict).

id?: string

Waarde van eigenschap

string

maxWallClockTime

De maximale verstreken tijd die door de taakreleasetaak kan worden uitgevoerd op een bepaald rekenknooppunt, gemeten vanaf het moment dat de taak wordt gestart. Als de taak niet binnen de tijdslimiet is voltooid, beëindigt de Batch-service deze. De standaardwaarde is 15 minuten. U mag geen time-out opgeven die langer is dan 15 minuten. Als u dit wel doet, weigert de Batch-service deze met een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag).

maxWallClockTime?: string

Waarde van eigenschap

string

resourceFiles

Een lijst met bestanden die de Batch-service naar het rekenknooppunt downloadt voordat u de opdrachtregel uitvoert. 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. Bestanden die onder dit element worden vermeld, bevinden zich in de werkmap van de taak.

resourceFiles?: ResourceFile[]

Waarde van eigenschap

ResourceFile[]

retentionTime

De minimale tijd voor het behouden van de taakmap voor de taakreleasetaak op het rekenknooppunt. Na deze tijd kan de Batch-service de map Taak en alle inhoud ervan verwijderen. De standaardwaarde is 7 dagen, d.w. de map Taak wordt 7 dagen bewaard, tenzij het rekenknooppunt wordt verwijderd of de taak wordt verwijderd.

retentionTime?: string

Waarde van eigenschap

string

userIdentity

De gebruikersidentiteit waaronder de jobreleasetaak wordt uitgevoerd. Als u dit weglaat, wordt de taak uitgevoerd als een niet-gebruiker met beheerdersrechten die uniek is voor de taak.

userIdentity?: UserIdentity

Waarde van eigenschap

UserIdentity