BatchClient class
Clientklasse voor toegang tot Azure Batch-service.
Constructors
| Batch |
Methoden
| create |
De Batch-service ondersteunt twee manieren om het werk dat als onderdeel van een Job wordt uitgevoerd te controleren. In de eerste benadering specificeert de gebruiker een Taakbeheertaak. De Batch-service start deze taak wanneer hij klaar is om de taak te starten. De Taakbeheer-taak beheert alle andere taken die onder deze taak draaien, door gebruik te maken van de Taak-API's. In de tweede benadering bestuurt de gebruiker direct de uitvoering van taken onder een actieve taak, door gebruik te maken van de Taak-API's. Let ook op: bij het benoemen van banen moet je gevoelige informatie vermijden zoals gebruikersnamen of geheime projectnamen. Deze informatie kan voorkomen in telemetrielogboeken die toegankelijk zijn voor Microsoft Ondersteuning-ingenieurs. |
| create |
Maakt een taakschema aan voor het opgegeven account. |
| create |
Je kunt een gebruikersaccount alleen toevoegen aan een Compute Node als deze in de idle of running state is. Voordat je op afstand kunt inloggen op een Compute Node, moet je toegangspoorten configureren voor SSH en RDP. Zie https://dotnet.territoriali.olinfo.it/azure/batch/pool-endpoint-configuration voor meer informatie |
| create |
Vermijd bij het benoemen van groepen gevoelige informatie, zoals gebruikersnamen of geheime projectnamen. Deze informatie kan voorkomen in telemetrielogboeken die toegankelijk zijn voor Microsoft Ondersteuning-ingenieurs. |
| create |
De maximale levensduur van een taak van optelling tot voltooiing is 180 dagen. Als een taak niet binnen 180 dagen na toevoeging is voltooid, wordt deze door de batchservice beëindigd en blijft hij in de staat waarin hij zich op dat moment bevond. |
| create |
Let op dat elke taak een unieke ID moet hebben. De batchservice kan de resultaten voor elke taak niet in dezelfde volgorde teruggeven als wanneer de taken in dit verzoek zijn ingediend. Als de server uitvalt of de verbinding wordt gesloten tijdens het verzoek, kan het verzoek gedeeltelijk of volledig zijn verwerkt, of helemaal niet. In zulke gevallen dient de gebruiker het verzoek opnieuw te sturen. Let op: het is aan de gebruiker om fouten correct te behandelen bij het opnieuw uitsturen van een verzoek. Je moet bijvoorbeeld dezelfde Taak-ID's gebruiken tijdens een herpoging, zodat als de vorige operatie slaagde, de herpoging niet onverwacht extra taken aanmaakt. Als het antwoord taken bevat die niet zijn toegevoegd, kan een client het verzoek opnieuw proberen. Bij een herhaling is het het meest efficiënt om alleen taken opnieuw in te dienen die niet zijn toegevoegd, en taken die bij de eerste poging succesvol zijn toegevoegd, weg te laten. De maximale levensduur van een taak van optelling tot voltooiing is 180 dagen. Als een taak niet binnen 180 dagen na toevoeging is voltooid, wordt deze door de batchservice beëindigd en blijft hij in de staat waarin hij zich op dat moment bevond. |
| deallocate |
U kunt de toewijzing van een rekenknooppunt alleen ongedaan maken als het een niet-actieve of actieve status heeft. |
| delete |
Het verwijderen van een taak verwijdert ook alle taken die deel uitmaken van die taak, evenals alle taakstatistieken. Dit overschrijft ook de retentieperiode voor taakgegevens; dat wil zeggen, als de Job taken bevat die nog steeds op Compute Nodes worden bewaard, verwijdert de Batch-services de werkmappen van die Tasks en al hun inhoud. Wanneer een Verwijder-taakverzoek wordt ontvangen, zet de Batch-service de Taak op de verwijderingsstatus. Alle updatebewerkingen op een taak die in verwijderingstoestand is, falen met statuscode 409 (Conflict), met aanvullende informatie die aangeeft dat de taak wordt verwijderd. |
| delete |
Wanneer u een taakplanning verwijdert, worden ook alle taken en taken onder die planning verwijderd. Wanneer taken worden verwijderd, worden alle bestanden in hun werkmappen op de rekenknooppunten ook verwijderd (de bewaarperiode wordt genegeerd). De taakplanningsstatistieken zijn niet meer toegankelijk zodra de taakplanning is verwijderd, hoewel ze nog steeds worden meegeteld bij de levensduur van het account. |
| delete |
Hiermee verwijdert u het opgegeven bestand uit het rekenknooppunt. |
| delete |
U kunt een gebruikersaccount alleen verwijderen naar een rekenknooppunt wanneer het inactief of actief is. Voordat je op afstand kunt inloggen op een Compute Node, moet je toegangspoorten configureren voor SSH en RDP. Zie https://dotnet.territoriali.olinfo.it/azure/batch/pool-endpoint-configuration voor meer informatie |
| delete |
Wanneer u aanvraagt dat een pool wordt verwijderd, vinden de volgende acties plaats: de poolstatus is ingesteld op verwijderen; eventuele lopende groottebewerkingen in de pool worden gestopt; de Batch-service begint de grootte van de pool te wijzigen in nul rekenknooppunten; alle taken die op bestaande rekenknooppunten worden uitgevoerd, worden beëindigd en opnieuw in de wachtrij gezet (alsof een bewerking voor het wijzigen van de grootte van de pool is aangevraagd met de standaardoptie voor opnieuw weergeven); ten slotte wordt de pool uit het systeem verwijderd. Omdat taken opnieuw worden uitgevoerd, kan de gebruiker deze taken opnieuw uitvoeren door de taak bij te werken om een andere pool te bereiken. De taken kunnen vervolgens worden uitgevoerd op de nieuwe pool. Als u het requeuegedrag wilt overschrijven, moet u het formaat van de pool expliciet aanroepen om de pool te verkleinen tot nul voordat u de pool verwijdert. Als u een Update-, Patch- of Delete-API aanroept in een pool met de status Verwijderen, mislukt deze met HTTP-statuscode 409 met foutcode PoolBeingDeleted. |
| delete |
Wanneer een taak wordt verwijderd, worden alle bestanden in de map op het rekenknooppunt waarop deze is uitgevoerd ook verwijderd (ongeacht de bewaartijd). Voor taken met meerdere exemplaren wordt de verwijdertaak synchroon toegepast op de primaire taak; subtaken en hun bestanden worden vervolgens asynchroon op de achtergrond verwijderd. |
| delete |
Hiermee verwijdert u het opgegeven taakbestand uit het rekenknooppunt waar de taak is uitgevoerd. |
| disable |
De Batch Service verplaatst de Job onmiddellijk naar de uitschakelende staat. Batch gebruikt vervolgens de disableTasks-parameter om te bepalen wat er moet gebeuren met de momenteel draaiende taken van de taak. De Job blijft in de deactiveringstoestand totdat de uitschakelingsoperatie is voltooid en alle taken zijn afgehandeld volgens de disableTasks-optie; de baan verplaatst zich vervolgens naar de toestand van een ongeschiktheid. Er worden geen nieuwe taken gestart onder de Job totdat deze weer actief wordt. Als je probeert een taak uit te schakelen die in een andere staat is dan actief, uitgeschakeld of uitgeschakeld, mislukt het verzoek met statuscode 409. |
| disable |
Er worden geen nieuwe taken gemaakt totdat de taakplanning opnieuw is ingeschakeld. |
| disable |
Je kunt taakplanning op een rekenknoop alleen uitschakelen als de huidige planningsstatus is ingeschakeld. |
| disable |
Hiermee schakelt u automatisch schalen voor een pool uit. |
| enable |
Wanneer je deze API aanroept, zet de Batch-service een uitgeschakelde taak in de ingeschakelde status. Nadat deze operatie is voltooid, gaat de Taak over naar de actieve staat en wordt het plannen van nieuwe taken onder de Taak hervat. De Batch-service staat niet toe dat een Taak langer dan 180 dagen actief blijft. Dus als je een taak inschakelt met actieve taken die meer dan 180 dagen geleden zijn toegevoegd, zullen die taken niet draaien. |
| enable |
Hiermee schakelt u een taakplanning in. |
| enable |
Je kunt taakplanning op een Compute Node alleen inschakelen als de huidige planningsstatus is uitgeschakeld |
| enable |
U kunt automatisch schalen voor een pool niet inschakelen als er een bewerking voor het wijzigen van de grootte van de pool wordt uitgevoerd. Als automatisch schalen van de pool momenteel is uitgeschakeld, moet u een geldige formule voor automatische schaalaanpassing opgeven als onderdeel van de aanvraag. Als automatisch schalen van de pool al is ingeschakeld, kunt u een nieuwe formule voor automatische schaalaanpassing en/of een nieuw evaluatie-interval opgeven. U kunt deze API niet meer dan één keer per 30 seconden aanroepen voor dezelfde pool. |
| evaluate |
Deze API is voornamelijk bedoeld voor het valideren van een formule voor automatisch schalen, omdat het resultaat eenvoudigweg wordt geretourneerd zonder de formule toe te passen op de pool. De pool moet automatisch schalen hebben ingeschakeld om een formule te kunnen evalueren. |
| get |
Deze bewerking levert alleen applicaties en versies terug die beschikbaar zijn voor gebruik op rekenknooppunten; dat wil zeggen, die gebruikt kan worden in een Package-referentie. Voor beheerdersinformatie over applicaties en versies die nog niet beschikbaar zijn voor Compute Nodes, gebruik het Azure-portaal of de Azure Resource Manager API. |
| get |
Krijgt informatie over de opgegeven functie. |
| get |
Krijgt informatie over het opgegeven werkrooster. |
| get |
Taakaantallen bieden een telling van de taken per actieve, actieve of voltooide taakstatus en een aantal taken dat is geslaagd of mislukt. Taken in de voorbereidingsstatus worden meegeteld als actief. Houd er rekening mee dat de geretourneerde getallen mogelijk niet altijd up-to-date zijn. Als u exact aantal taken nodig hebt, gebruikt u een lijstquery. |
| get |
Hiermee wordt informatie opgehaald over het opgegeven rekenknooppunt. |
| get |
Krijgt informatie over de gespecificeerde Compute Node Extension. |
| get |
Geeft de inhoud van het opgegeven Compute Node-bestand terug. |
| get |
Hiermee haalt u de eigenschappen van het opgegeven rekenknooppuntbestand op. |
| get |
Voordat je op afstand kunt inloggen op een Compute Node met de remote login-instellingen, moet je een gebruikersaccount aanmaken op de Compute Node en toegangspoorten configureren voor SSH en RDP. Zie https://dotnet.territoriali.olinfo.it/azure/batch/pool-endpoint-configuration voor meer informatie |
| get |
Hiermee wordt informatie opgehaald over de opgegeven pool. |
| get |
Voor multi-instance taken verwijzen informatie zoals affinityId, executionInfo en nodeInfo naar de primaire taak. Gebruik de list subtasks API om informatie over subtaken op te halen. |
| get |
Geeft de inhoud van het opgegeven Taakbestand terug. |
| get |
Hiermee haalt u de eigenschappen van het opgegeven taakbestand op. |
| job |
Controleert of het opgegeven werkrooster bestaat. |
| list |
Deze bewerking levert alleen applicaties en versies terug die beschikbaar zijn voor gebruik op rekenknooppunten; dat wil zeggen, die gebruikt kan worden in een Package-referentie. Voor beheerdersinformatie over applicaties en versies die nog niet beschikbaar zijn voor Compute Nodes, gebruik het Azure-portaal of de Azure Resource Manager API. |
| list |
Deze API retourneert de taakstatus jobvoorbereiding en jobreleasetaak op alle rekenknooppunten waarop de taakvoorbereiding of jobreleasetaak is uitgevoerd. Dit omvat rekenknooppunten die sindsdien uit de pool zijn verwijderd. Als deze API wordt aangeroepen op een taak die geen jobvoorbereidingstaak of jobreleasetaak heeft, retourneert de Batch-service HTTP-statuscode 409 (Conflict) met een foutcode van JobPreparationTaskNotSpecified. |
| list |
Geeft alle banen in het opgegeven account weer op. |
| list |
Geeft alle taakschema's in het opgegeven account weer op. |
| list |
Geeft een lijst van de Jobs die zijn aangemaakt onder het gespecificeerde Job Schedule. |
| list |
Geeft een lijst van de extensies van de Compute Nodes in de opgegeven pool. |
| list |
Bevat alle bestanden in taakmappen op het opgegeven rekenknooppunt. |
| list |
Geeft een lijst weer van de rekenknooppunten in de opgegeven pool. |
| list |
Hiermee haalt u het aantal rekenknooppunten in elke status op, gegroepeerd op pool. Houd er rekening mee dat de geretourneerde getallen mogelijk niet altijd up-to-date zijn. Als u exact aantal knooppunten nodig hebt, gebruikt u een lijstquery. |
| list |
Een lijst met alle pools in het opgegeven account. |
| list |
Als u geen $filter component met inbegrip van een poolId opgeeft, bevat het antwoord alle pools die in het account aanwezig zijn in het tijdsbereik van de geretourneerde aggregatie-intervallen. Als u geen $filter component opgeeft, inclusief een startTime of endTime, worden deze filters standaard ingesteld op de begin- en eindtijden van het laatste aggregatie-interval dat momenteel beschikbaar is; Dat wil gezegd, alleen het laatste aggregatie-interval wordt geretourneerd. |
| list |
Als de taak geen taak met meerdere exemplaren is, retourneert dit een lege verzameling. |
| list |
Een lijst met alle installatiekopieën van virtuele machines die worden ondersteund door de Azure Batch-service. |
| list |
Geeft een lijst weer van de bestanden in de map van een taak op het rekenknooppunt. |
| list |
Voor multi-instance taken verwijzen informatie zoals affinityId, executionInfo en nodeInfo naar de primaire taak. Gebruik de list subtasks API om informatie over subtaken op te halen. |
| pool |
Krijgt de basiseigenschappen van een Pool. |
| reactivate |
Door opnieuw te activeren kan een taak opnieuw worden geprobeerd tot het maximumaantal nieuwe pogingen. De status van de taak wordt gewijzigd in actief. Omdat de taak niet langer de status Voltooid heeft, zijn eventuele eerdere afsluitcode of foutinformatie niet meer beschikbaar na opnieuw activeren. Telkens wanneer een taak opnieuw wordt geactiveerd, wordt het aantal nieuwe pogingen opnieuw ingesteld op 0. Opnieuw activeren mislukt voor taken die niet zijn voltooid of die eerder zijn voltooid (met een afsluitcode van 0). Bovendien mislukt het als de taak is voltooid (of wordt beëindigd of verwijderd). |
| reboot |
U kunt een rekenknooppunt alleen opnieuw opstarten als het een niet-actieve of actieve status heeft. |
| reimage |
U kunt het besturingssysteem alleen opnieuw installeren op een rekenknooppunt als het een niet-actieve of actieve status heeft. Deze API kan alleen worden aangeroepen op pools die zijn aangemaakt met de cloud service configuratie-eigenschap. |
| remove |
Deze bewerking kan alleen worden uitgevoerd wanneer de toewijzingsstatus van de pool stabiel is. Wanneer deze bewerking wordt uitgevoerd, verandert de toewijzingsstatus van constant in het wijzigen van de grootte. Elke aanvraag kan maximaal 100 knooppunten verwijderen. |
| replace |
Dit vervangt volledig alle up-dateerbare eigenschappen van de Job. Als bijvoorbeeld de Job beperkingen heeft en als constraints niet met dit verzoek zijn gespecificeerd, zal de batchservice de bestaande constraints verwijderen. |
| replace |
Dit vervangt volledig alle up-dateerbare eigenschappen van het Job Schedule. Als bijvoorbeeld de schedule-eigenschap niet bij dit verzoek is gespecificeerd, verwijdert de Batch-service de bestaande schedule. Wijzigingen in een taakschema hebben alleen invloed op taken die door het schema zijn aangemaakt nadat de update heeft plaatsgevonden; momenteel lopende banen zijn onaangetast. |
| replace |
Deze bewerking vervangt alle updateerbare eigenschappen van het Account. Als bijvoorbeeld het expiryTime-element niet wordt gespecificeerd, wordt de huidige waarde vervangen door de standaardwaarde en niet ongewijzigd gelaten. Je kunt een gebruikersaccount op een Compute Node alleen bijwerken als deze in de idle of running state is. |
| replace |
Dit vervangt volledig alle up-dateerbare eigenschappen van de Pool. Als bijvoorbeeld de Pool een StartTask heeft gekoppeld en StartTask niet is gespecificeerd met dit verzoek, dan verwijdert de Batch-service de bestaande StartTask. |
| replace |
Werkt de eigenschappen van de opgegeven taak bij. |
| resize |
U kunt het formaat van een pool alleen wijzigen wanneer de toewijzingsstatus stabiel is. Als de grootte van de pool al is gewijzigd, mislukt de aanvraag met statuscode 409. Wanneer u het formaat van een pool wijzigt, verandert de toewijzingsstatus van de pool van gestage tot het wijzigen van de grootte. U kunt de grootte van pools die zijn geconfigureerd voor automatisch schalen niet wijzigen. Als u dit probeert te doen, retourneert de Batch-service een fout 409. Als u het formaat van een pool omlaag wijzigt, kiest de Batch-service welke rekenknooppunten u wilt verwijderen. Als u specifieke rekenknooppunten wilt verwijderen, verwijdert u in plaats daarvan de API voor rekenknooppunten met de pool. |
| start |
Je kunt een Compute Node alleen starten als deze is gedeald. |
| stop |
Dit herstelt de Pool niet naar de vorige staat vóór de wijziging: het stopt alleen verdere wijzigingen en de Pool behoudt zijn huidige toestand. Na het stoppen stabiliseert de Pool het aantal rekenknooppunten waarop het zich bevond toen de stopoperatie werd uitgevoerd. Tijdens de stopwerking verandert de poolallocatietoestand eerst in stoppen en daarna in stabiel. Een hergroottebewerking hoeft niet per se een expliciet verzoek om de grootte van de Pool te zijn; deze API kan ook worden gebruikt om de initiële grootte van de Pool te stoppen wanneer deze wordt aangemaakt. |
| terminate |
Wanneer een verzoek om Beëindigen van een baan wordt ontvangen, zet de batchservice de taak in de beëindigende toestand. De Batch-service beëindigt vervolgens alle lopende taken die aan de taak zijn gekoppeld en voert alle benodigde taakvrijgavetaken uit. Daarna gaat de Job naar de voltooide staat. Als er taken in de actieve staat in de baan zijn, blijven die in de actieve staat. Zodra een taak is beëindigd, kunnen er geen nieuwe taken worden toegevoegd en worden eventuele resterende actieve taken niet meer ingepland. |
| terminate |
Hiermee wordt een taakplanning beëindigd. |
| terminate |
Wanneer de taak is beëindigd, wordt deze verplaatst naar de voltooide status. Voor taken met meerdere exemplaren wordt de beëindigingstaak synchroon toegepast op de primaire taak; subtaken worden vervolgens asynchroon op de achtergrond beëindigd. |
| update |
Dit vervangt alleen de Job-eigenschappen die in het verzoek zijn gespecificeerd. Als de Job bijvoorbeeld beperkingen heeft en een verzoek het constraints-element niet specificeert, dan behoudt de Job de bestaande beperkingen. |
| update |
Dit vervangt alleen de taken van het takenschema die in het verzoek zijn gespecificeerd. Als bijvoorbeeld de schedule-eigenschap niet is gespecificeerd bij dit verzoek, dan behoudt de Batch-service de bestaande schedule. Wijzigingen in een taakschema hebben alleen invloed op taken die door het schema zijn aangemaakt nadat de update heeft plaatsgevonden; momenteel lopende banen zijn onaangetast. |
| update |
Dit vervangt alleen de Pool-eigenschappen die in het verzoek zijn gespecificeerd. Als bijvoorbeeld de Pool een StartTask heeft en een verzoek geen StartTask-element specificeert, dan behoudt de Pool de bestaande StartTask. |
| upload |
Dit is bedoeld om Azure Batch-servicelogbestanden op geautomatiseerde wijze te verzamelen vanuit Compute Nodes als je een fout ervaart en wilt escaleren naar Azure-ondersteuning. De logboekbestanden van de Azure Batch-service moeten worden gedeeld met ondersteuning voor Azure om problemen met de Batch-service op te sporen. |
Constructordetails
BatchClient(string, TokenCredential | AzureNamedKeyCredential, BatchClientOptionalParams)
new BatchClient(endpointParam: string, credential: TokenCredential | AzureNamedKeyCredential, options?: BatchClientOptionalParams)
Parameters
- endpointParam
-
string
- credential
- options
- BatchClientOptionalParams
Methodedetails
createJob(BatchJobCreateOptions, CreateJobOptionalParams)
De Batch-service ondersteunt twee manieren om het werk dat als onderdeel van een Job wordt uitgevoerd te controleren. In de eerste benadering specificeert de gebruiker een Taakbeheertaak. De Batch-service start deze taak wanneer hij klaar is om de taak te starten. De Taakbeheer-taak beheert alle andere taken die onder deze taak draaien, door gebruik te maken van de Taak-API's. In de tweede benadering bestuurt de gebruiker direct de uitvoering van taken onder een actieve taak, door gebruik te maken van de Taak-API's. Let ook op: bij het benoemen van banen moet je gevoelige informatie vermijden zoals gebruikersnamen of geheime projectnamen. Deze informatie kan voorkomen in telemetrielogboeken die toegankelijk zijn voor Microsoft Ondersteuning-ingenieurs.
function createJob(job: BatchJobCreateOptions, options?: CreateJobOptionalParams): Promise<void>
Parameters
- options
- CreateJobOptionalParams
Retouren
Promise<void>
createJobSchedule(BatchJobScheduleCreateOptions, CreateJobScheduleOptionalParams)
Maakt een taakschema aan voor het opgegeven account.
function createJobSchedule(jobSchedule: BatchJobScheduleCreateOptions, options?: CreateJobScheduleOptionalParams): Promise<void>
Parameters
- jobSchedule
- BatchJobScheduleCreateOptions
- options
- CreateJobScheduleOptionalParams
Retouren
Promise<void>
createNodeUser(string, string, BatchNodeUserCreateOptions, CreateNodeUserOptionalParams)
Je kunt een gebruikersaccount alleen toevoegen aan een Compute Node als deze in de idle of running state is. Voordat je op afstand kunt inloggen op een Compute Node, moet je toegangspoorten configureren voor SSH en RDP. Zie https://dotnet.territoriali.olinfo.it/azure/batch/pool-endpoint-configuration voor meer informatie
function createNodeUser(poolId: string, nodeId: string, user: BatchNodeUserCreateOptions, options?: CreateNodeUserOptionalParams): Promise<void>
Parameters
- poolId
-
string
- nodeId
-
string
- options
- CreateNodeUserOptionalParams
Retouren
Promise<void>
createPool(BatchPoolCreateOptions, CreatePoolOptionalParams)
Vermijd bij het benoemen van groepen gevoelige informatie, zoals gebruikersnamen of geheime projectnamen. Deze informatie kan voorkomen in telemetrielogboeken die toegankelijk zijn voor Microsoft Ondersteuning-ingenieurs.
function createPool(pool: BatchPoolCreateOptions, options?: CreatePoolOptionalParams): Promise<void>
Parameters
- options
- CreatePoolOptionalParams
Retouren
Promise<void>
createTask(string, BatchTaskCreateOptions, CreateTaskOptionalParams)
De maximale levensduur van een taak van optelling tot voltooiing is 180 dagen. Als een taak niet binnen 180 dagen na toevoeging is voltooid, wordt deze door de batchservice beëindigd en blijft hij in de staat waarin hij zich op dat moment bevond.
function createTask(jobId: string, task: BatchTaskCreateOptions, options?: CreateTaskOptionalParams): Promise<void>
Parameters
- jobId
-
string
- options
- CreateTaskOptionalParams
Retouren
Promise<void>
createTaskCollection(string, BatchTaskGroup, CreateTaskCollectionOptionalParams)
Let op dat elke taak een unieke ID moet hebben. De batchservice kan de resultaten voor elke taak niet in dezelfde volgorde teruggeven als wanneer de taken in dit verzoek zijn ingediend. Als de server uitvalt of de verbinding wordt gesloten tijdens het verzoek, kan het verzoek gedeeltelijk of volledig zijn verwerkt, of helemaal niet. In zulke gevallen dient de gebruiker het verzoek opnieuw te sturen. Let op: het is aan de gebruiker om fouten correct te behandelen bij het opnieuw uitsturen van een verzoek. Je moet bijvoorbeeld dezelfde Taak-ID's gebruiken tijdens een herpoging, zodat als de vorige operatie slaagde, de herpoging niet onverwacht extra taken aanmaakt. Als het antwoord taken bevat die niet zijn toegevoegd, kan een client het verzoek opnieuw proberen. Bij een herhaling is het het meest efficiënt om alleen taken opnieuw in te dienen die niet zijn toegevoegd, en taken die bij de eerste poging succesvol zijn toegevoegd, weg te laten. De maximale levensduur van een taak van optelling tot voltooiing is 180 dagen. Als een taak niet binnen 180 dagen na toevoeging is voltooid, wordt deze door de batchservice beëindigd en blijft hij in de staat waarin hij zich op dat moment bevond.
function createTaskCollection(jobId: string, taskCollection: BatchTaskGroup, options?: CreateTaskCollectionOptionalParams): Promise<BatchCreateTaskCollectionResult>
Parameters
- jobId
-
string
- taskCollection
- BatchTaskGroup
Retouren
Promise<BatchCreateTaskCollectionResult>
deallocateNode(string, string, DeallocateNodeOptionalParams)
U kunt de toewijzing van een rekenknooppunt alleen ongedaan maken als het een niet-actieve of actieve status heeft.
function deallocateNode(poolId: string, nodeId: string, options?: DeallocateNodeOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- poolId
-
string
- nodeId
-
string
- options
- DeallocateNodeOptionalParams
Retouren
PollerLike<OperationState<void>, void>
deleteJob(string, DeleteJobOptionalParams)
Het verwijderen van een taak verwijdert ook alle taken die deel uitmaken van die taak, evenals alle taakstatistieken. Dit overschrijft ook de retentieperiode voor taakgegevens; dat wil zeggen, als de Job taken bevat die nog steeds op Compute Nodes worden bewaard, verwijdert de Batch-services de werkmappen van die Tasks en al hun inhoud. Wanneer een Verwijder-taakverzoek wordt ontvangen, zet de Batch-service de Taak op de verwijderingsstatus. Alle updatebewerkingen op een taak die in verwijderingstoestand is, falen met statuscode 409 (Conflict), met aanvullende informatie die aangeeft dat de taak wordt verwijderd.
function deleteJob(jobId: string, options?: DeleteJobOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- jobId
-
string
- options
- DeleteJobOptionalParams
Retouren
PollerLike<OperationState<void>, void>
deleteJobSchedule(string, DeleteJobScheduleOptionalParams)
Wanneer u een taakplanning verwijdert, worden ook alle taken en taken onder die planning verwijderd. Wanneer taken worden verwijderd, worden alle bestanden in hun werkmappen op de rekenknooppunten ook verwijderd (de bewaarperiode wordt genegeerd). De taakplanningsstatistieken zijn niet meer toegankelijk zodra de taakplanning is verwijderd, hoewel ze nog steeds worden meegeteld bij de levensduur van het account.
function deleteJobSchedule(jobScheduleId: string, options?: DeleteJobScheduleOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- jobScheduleId
-
string
- options
- DeleteJobScheduleOptionalParams
Retouren
PollerLike<OperationState<void>, void>
deleteNodeFile(string, string, string, DeleteNodeFileOptionalParams)
Hiermee verwijdert u het opgegeven bestand uit het rekenknooppunt.
function deleteNodeFile(poolId: string, nodeId: string, filePath: string, options?: DeleteNodeFileOptionalParams): Promise<void>
Parameters
- poolId
-
string
- nodeId
-
string
- filePath
-
string
- options
- DeleteNodeFileOptionalParams
Retouren
Promise<void>
deleteNodeUser(string, string, string, DeleteNodeUserOptionalParams)
U kunt een gebruikersaccount alleen verwijderen naar een rekenknooppunt wanneer het inactief of actief is. Voordat je op afstand kunt inloggen op een Compute Node, moet je toegangspoorten configureren voor SSH en RDP. Zie https://dotnet.territoriali.olinfo.it/azure/batch/pool-endpoint-configuration voor meer informatie
function deleteNodeUser(poolId: string, nodeId: string, userName: string, options?: DeleteNodeUserOptionalParams): Promise<void>
Parameters
- poolId
-
string
- nodeId
-
string
- userName
-
string
- options
- DeleteNodeUserOptionalParams
Retouren
Promise<void>
deletePool(string, DeletePoolOptionalParams)
Wanneer u aanvraagt dat een pool wordt verwijderd, vinden de volgende acties plaats: de poolstatus is ingesteld op verwijderen; eventuele lopende groottebewerkingen in de pool worden gestopt; de Batch-service begint de grootte van de pool te wijzigen in nul rekenknooppunten; alle taken die op bestaande rekenknooppunten worden uitgevoerd, worden beëindigd en opnieuw in de wachtrij gezet (alsof een bewerking voor het wijzigen van de grootte van de pool is aangevraagd met de standaardoptie voor opnieuw weergeven); ten slotte wordt de pool uit het systeem verwijderd. Omdat taken opnieuw worden uitgevoerd, kan de gebruiker deze taken opnieuw uitvoeren door de taak bij te werken om een andere pool te bereiken. De taken kunnen vervolgens worden uitgevoerd op de nieuwe pool. Als u het requeuegedrag wilt overschrijven, moet u het formaat van de pool expliciet aanroepen om de pool te verkleinen tot nul voordat u de pool verwijdert. Als u een Update-, Patch- of Delete-API aanroept in een pool met de status Verwijderen, mislukt deze met HTTP-statuscode 409 met foutcode PoolBeingDeleted.
function deletePool(poolId: string, options?: DeletePoolOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- poolId
-
string
- options
- DeletePoolOptionalParams
Retouren
PollerLike<OperationState<void>, void>
deleteTask(string, string, DeleteTaskOptionalParams)
Wanneer een taak wordt verwijderd, worden alle bestanden in de map op het rekenknooppunt waarop deze is uitgevoerd ook verwijderd (ongeacht de bewaartijd). Voor taken met meerdere exemplaren wordt de verwijdertaak synchroon toegepast op de primaire taak; subtaken en hun bestanden worden vervolgens asynchroon op de achtergrond verwijderd.
function deleteTask(jobId: string, taskId: string, options?: DeleteTaskOptionalParams): Promise<void>
Parameters
- jobId
-
string
- taskId
-
string
- options
- DeleteTaskOptionalParams
Retouren
Promise<void>
deleteTaskFile(string, string, string, DeleteTaskFileOptionalParams)
Hiermee verwijdert u het opgegeven taakbestand uit het rekenknooppunt waar de taak is uitgevoerd.
function deleteTaskFile(jobId: string, taskId: string, filePath: string, options?: DeleteTaskFileOptionalParams): Promise<void>
Parameters
- jobId
-
string
- taskId
-
string
- filePath
-
string
- options
- DeleteTaskFileOptionalParams
Retouren
Promise<void>
disableJob(string, BatchJobDisableOptions, DisableJobOptionalParams)
De Batch Service verplaatst de Job onmiddellijk naar de uitschakelende staat. Batch gebruikt vervolgens de disableTasks-parameter om te bepalen wat er moet gebeuren met de momenteel draaiende taken van de taak. De Job blijft in de deactiveringstoestand totdat de uitschakelingsoperatie is voltooid en alle taken zijn afgehandeld volgens de disableTasks-optie; de baan verplaatst zich vervolgens naar de toestand van een ongeschiktheid. Er worden geen nieuwe taken gestart onder de Job totdat deze weer actief wordt. Als je probeert een taak uit te schakelen die in een andere staat is dan actief, uitgeschakeld of uitgeschakeld, mislukt het verzoek met statuscode 409.
function disableJob(jobId: string, disableOptions: BatchJobDisableOptions, options?: DisableJobOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- jobId
-
string
- disableOptions
- BatchJobDisableOptions
- options
- DisableJobOptionalParams
Retouren
PollerLike<OperationState<void>, void>
disableJobSchedule(string, DisableJobScheduleOptionalParams)
Er worden geen nieuwe taken gemaakt totdat de taakplanning opnieuw is ingeschakeld.
function disableJobSchedule(jobScheduleId: string, options?: DisableJobScheduleOptionalParams): Promise<void>
Parameters
- jobScheduleId
-
string
- options
- DisableJobScheduleOptionalParams
Retouren
Promise<void>
disableNodeScheduling(string, string, DisableNodeSchedulingOptionalParams)
Je kunt taakplanning op een rekenknoop alleen uitschakelen als de huidige planningsstatus is ingeschakeld.
function disableNodeScheduling(poolId: string, nodeId: string, options?: DisableNodeSchedulingOptionalParams): Promise<void>
Parameters
- poolId
-
string
- nodeId
-
string
Retouren
Promise<void>
disablePoolAutoScale(string, DisablePoolAutoScaleOptionalParams)
Hiermee schakelt u automatisch schalen voor een pool uit.
function disablePoolAutoScale(poolId: string, options?: DisablePoolAutoScaleOptionalParams): Promise<void>
Parameters
- poolId
-
string
Retouren
Promise<void>
enableJob(string, EnableJobOptionalParams)
Wanneer je deze API aanroept, zet de Batch-service een uitgeschakelde taak in de ingeschakelde status. Nadat deze operatie is voltooid, gaat de Taak over naar de actieve staat en wordt het plannen van nieuwe taken onder de Taak hervat. De Batch-service staat niet toe dat een Taak langer dan 180 dagen actief blijft. Dus als je een taak inschakelt met actieve taken die meer dan 180 dagen geleden zijn toegevoegd, zullen die taken niet draaien.
function enableJob(jobId: string, options?: EnableJobOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- jobId
-
string
- options
- EnableJobOptionalParams
Retouren
PollerLike<OperationState<void>, void>
enableJobSchedule(string, EnableJobScheduleOptionalParams)
Hiermee schakelt u een taakplanning in.
function enableJobSchedule(jobScheduleId: string, options?: EnableJobScheduleOptionalParams): Promise<void>
Parameters
- jobScheduleId
-
string
- options
- EnableJobScheduleOptionalParams
Retouren
Promise<void>
enableNodeScheduling(string, string, EnableNodeSchedulingOptionalParams)
Je kunt taakplanning op een Compute Node alleen inschakelen als de huidige planningsstatus is uitgeschakeld
function enableNodeScheduling(poolId: string, nodeId: string, options?: EnableNodeSchedulingOptionalParams): Promise<void>
Parameters
- poolId
-
string
- nodeId
-
string
Retouren
Promise<void>
enablePoolAutoScale(string, BatchPoolEnableAutoScaleOptions, EnablePoolAutoScaleOptionalParams)
U kunt automatisch schalen voor een pool niet inschakelen als er een bewerking voor het wijzigen van de grootte van de pool wordt uitgevoerd. Als automatisch schalen van de pool momenteel is uitgeschakeld, moet u een geldige formule voor automatische schaalaanpassing opgeven als onderdeel van de aanvraag. Als automatisch schalen van de pool al is ingeschakeld, kunt u een nieuwe formule voor automatische schaalaanpassing en/of een nieuw evaluatie-interval opgeven. U kunt deze API niet meer dan één keer per 30 seconden aanroepen voor dezelfde pool.
function enablePoolAutoScale(poolId: string, enableAutoScaleOptions: BatchPoolEnableAutoScaleOptions, options?: EnablePoolAutoScaleOptionalParams): Promise<void>
Parameters
- poolId
-
string
- enableAutoScaleOptions
- BatchPoolEnableAutoScaleOptions
Retouren
Promise<void>
evaluatePoolAutoScale(string, BatchPoolEvaluateAutoScaleOptions, EvaluatePoolAutoScaleOptionalParams)
Deze API is voornamelijk bedoeld voor het valideren van een formule voor automatisch schalen, omdat het resultaat eenvoudigweg wordt geretourneerd zonder de formule toe te passen op de pool. De pool moet automatisch schalen hebben ingeschakeld om een formule te kunnen evalueren.
function evaluatePoolAutoScale(poolId: string, evaluateAutoScaleOptions: BatchPoolEvaluateAutoScaleOptions, options?: EvaluatePoolAutoScaleOptionalParams): Promise<AutoScaleRun>
Parameters
- poolId
-
string
- evaluateAutoScaleOptions
- BatchPoolEvaluateAutoScaleOptions
Retouren
Promise<AutoScaleRun>
getApplication(string, GetApplicationOptionalParams)
Deze bewerking levert alleen applicaties en versies terug die beschikbaar zijn voor gebruik op rekenknooppunten; dat wil zeggen, die gebruikt kan worden in een Package-referentie. Voor beheerdersinformatie over applicaties en versies die nog niet beschikbaar zijn voor Compute Nodes, gebruik het Azure-portaal of de Azure Resource Manager API.
function getApplication(applicationId: string, options?: GetApplicationOptionalParams): Promise<BatchApplication>
Parameters
- applicationId
-
string
- options
- GetApplicationOptionalParams
Retouren
Promise<BatchApplication>
getJob(string, GetJobOptionalParams)
Krijgt informatie over de opgegeven functie.
function getJob(jobId: string, options?: GetJobOptionalParams): Promise<BatchJob>
Parameters
- jobId
-
string
- options
- GetJobOptionalParams
Retouren
Promise<BatchJob>
getJobSchedule(string, GetJobScheduleOptionalParams)
Krijgt informatie over het opgegeven werkrooster.
function getJobSchedule(jobScheduleId: string, options?: GetJobScheduleOptionalParams): Promise<BatchJobSchedule>
Parameters
- jobScheduleId
-
string
- options
- GetJobScheduleOptionalParams
Retouren
Promise<BatchJobSchedule>
getJobTaskCounts(string, GetJobTaskCountsOptionalParams)
Taakaantallen bieden een telling van de taken per actieve, actieve of voltooide taakstatus en een aantal taken dat is geslaagd of mislukt. Taken in de voorbereidingsstatus worden meegeteld als actief. Houd er rekening mee dat de geretourneerde getallen mogelijk niet altijd up-to-date zijn. Als u exact aantal taken nodig hebt, gebruikt u een lijstquery.
function getJobTaskCounts(jobId: string, options?: GetJobTaskCountsOptionalParams): Promise<BatchTaskCountsResult>
Parameters
- jobId
-
string
- options
- GetJobTaskCountsOptionalParams
Retouren
Promise<BatchTaskCountsResult>
getNode(string, string, GetNodeOptionalParams)
Hiermee wordt informatie opgehaald over het opgegeven rekenknooppunt.
function getNode(poolId: string, nodeId: string, options?: GetNodeOptionalParams): Promise<BatchNode>
Parameters
- poolId
-
string
- nodeId
-
string
- options
- GetNodeOptionalParams
Retouren
Promise<BatchNode>
getNodeExtension(string, string, string, GetNodeExtensionOptionalParams)
Krijgt informatie over de gespecificeerde Compute Node Extension.
function getNodeExtension(poolId: string, nodeId: string, extensionName: string, options?: GetNodeExtensionOptionalParams): Promise<BatchNodeVMExtension>
Parameters
- poolId
-
string
- nodeId
-
string
- extensionName
-
string
- options
- GetNodeExtensionOptionalParams
Retouren
Promise<BatchNodeVMExtension>
getNodeFile(string, string, string, GetNodeFileOptionalParams)
Geeft de inhoud van het opgegeven Compute Node-bestand terug.
function getNodeFile(poolId: string, nodeId: string, filePath: string, options?: GetNodeFileOptionalParams): Promise<Uint8Array>
Parameters
- poolId
-
string
- nodeId
-
string
- filePath
-
string
- options
- GetNodeFileOptionalParams
Retouren
Promise<Uint8Array>
getNodeFileProperties(string, string, string, GetNodeFilePropertiesOptionalParams)
Hiermee haalt u de eigenschappen van het opgegeven rekenknooppuntbestand op.
function getNodeFileProperties(poolId: string, nodeId: string, filePath: string, options?: GetNodeFilePropertiesOptionalParams): Promise<BatchNodeFile>
Parameters
- poolId
-
string
- nodeId
-
string
- filePath
-
string
Retouren
Promise<BatchNodeFile>
getNodeRemoteLoginSettings(string, string, GetNodeRemoteLoginSettingsOptionalParams)
Voordat je op afstand kunt inloggen op een Compute Node met de remote login-instellingen, moet je een gebruikersaccount aanmaken op de Compute Node en toegangspoorten configureren voor SSH en RDP. Zie https://dotnet.territoriali.olinfo.it/azure/batch/pool-endpoint-configuration voor meer informatie
function getNodeRemoteLoginSettings(poolId: string, nodeId: string, options?: GetNodeRemoteLoginSettingsOptionalParams): Promise<BatchNodeRemoteLoginSettings>
Parameters
- poolId
-
string
- nodeId
-
string
Retouren
Promise<BatchNodeRemoteLoginSettings>
getPool(string, GetPoolOptionalParams)
Hiermee wordt informatie opgehaald over de opgegeven pool.
function getPool(poolId: string, options?: GetPoolOptionalParams): Promise<BatchPool>
Parameters
- poolId
-
string
- options
- GetPoolOptionalParams
Retouren
Promise<BatchPool>
getTask(string, string, GetTaskOptionalParams)
Voor multi-instance taken verwijzen informatie zoals affinityId, executionInfo en nodeInfo naar de primaire taak. Gebruik de list subtasks API om informatie over subtaken op te halen.
function getTask(jobId: string, taskId: string, options?: GetTaskOptionalParams): Promise<BatchTask>
Parameters
- jobId
-
string
- taskId
-
string
- options
- GetTaskOptionalParams
Retouren
Promise<BatchTask>
getTaskFile(string, string, string, GetTaskFileOptionalParams)
Geeft de inhoud van het opgegeven Taakbestand terug.
function getTaskFile(jobId: string, taskId: string, filePath: string, options?: GetTaskFileOptionalParams): Promise<Uint8Array>
Parameters
- jobId
-
string
- taskId
-
string
- filePath
-
string
- options
- GetTaskFileOptionalParams
Retouren
Promise<Uint8Array>
getTaskFileProperties(string, string, string, GetTaskFilePropertiesOptionalParams)
Hiermee haalt u de eigenschappen van het opgegeven taakbestand op.
function getTaskFileProperties(jobId: string, taskId: string, filePath: string, options?: GetTaskFilePropertiesOptionalParams): Promise<BatchNodeFile>
Parameters
- jobId
-
string
- taskId
-
string
- filePath
-
string
Retouren
Promise<BatchNodeFile>
jobScheduleExists(string, JobScheduleExistsOptionalParams)
Controleert of het opgegeven werkrooster bestaat.
function jobScheduleExists(jobScheduleId: string, options?: JobScheduleExistsOptionalParams): Promise<boolean>
Parameters
- jobScheduleId
-
string
- options
- JobScheduleExistsOptionalParams
Retouren
Promise<boolean>
listApplications(ListApplicationsOptionalParams)
Deze bewerking levert alleen applicaties en versies terug die beschikbaar zijn voor gebruik op rekenknooppunten; dat wil zeggen, die gebruikt kan worden in een Package-referentie. Voor beheerdersinformatie over applicaties en versies die nog niet beschikbaar zijn voor Compute Nodes, gebruik het Azure-portaal of de Azure Resource Manager API.
function listApplications(options?: ListApplicationsOptionalParams): PagedAsyncIterableIterator<BatchApplication, BatchApplication[], PageSettings>
Parameters
- options
- ListApplicationsOptionalParams
Retouren
listJobPreparationAndReleaseTaskStatus(string, ListJobPreparationAndReleaseTaskStatusOptionalParams)
Deze API retourneert de taakstatus jobvoorbereiding en jobreleasetaak op alle rekenknooppunten waarop de taakvoorbereiding of jobreleasetaak is uitgevoerd. Dit omvat rekenknooppunten die sindsdien uit de pool zijn verwijderd. Als deze API wordt aangeroepen op een taak die geen jobvoorbereidingstaak of jobreleasetaak heeft, retourneert de Batch-service HTTP-statuscode 409 (Conflict) met een foutcode van JobPreparationTaskNotSpecified.
function listJobPreparationAndReleaseTaskStatus(jobId: string, options?: ListJobPreparationAndReleaseTaskStatusOptionalParams): PagedAsyncIterableIterator<BatchJobPreparationAndReleaseTaskStatus, BatchJobPreparationAndReleaseTaskStatus[], PageSettings>
Parameters
- jobId
-
string
Retouren
listJobs(ListJobsOptionalParams)
Geeft alle banen in het opgegeven account weer op.
function listJobs(options?: ListJobsOptionalParams): PagedAsyncIterableIterator<BatchJob, BatchJob[], PageSettings>
Parameters
- options
- ListJobsOptionalParams
Retouren
listJobSchedules(ListJobSchedulesOptionalParams)
Geeft alle taakschema's in het opgegeven account weer op.
function listJobSchedules(options?: ListJobSchedulesOptionalParams): PagedAsyncIterableIterator<BatchJobSchedule, BatchJobSchedule[], PageSettings>
Parameters
- options
- ListJobSchedulesOptionalParams
Retouren
listJobsFromSchedule(string, ListJobsFromScheduleOptionalParams)
Geeft een lijst van de Jobs die zijn aangemaakt onder het gespecificeerde Job Schedule.
function listJobsFromSchedule(jobScheduleId: string, options?: ListJobsFromScheduleOptionalParams): PagedAsyncIterableIterator<BatchJob, BatchJob[], PageSettings>
Parameters
- jobScheduleId
-
string
Retouren
listNodeExtensions(string, string, ListNodeExtensionsOptionalParams)
Geeft een lijst van de extensies van de Compute Nodes in de opgegeven pool.
function listNodeExtensions(poolId: string, nodeId: string, options?: ListNodeExtensionsOptionalParams): PagedAsyncIterableIterator<BatchNodeVMExtension, BatchNodeVMExtension[], PageSettings>
Parameters
- poolId
-
string
- nodeId
-
string
- options
- ListNodeExtensionsOptionalParams
Retouren
listNodeFiles(string, string, ListNodeFilesOptionalParams)
Bevat alle bestanden in taakmappen op het opgegeven rekenknooppunt.
function listNodeFiles(poolId: string, nodeId: string, options?: ListNodeFilesOptionalParams): PagedAsyncIterableIterator<BatchNodeFile, BatchNodeFile[], PageSettings>
Parameters
- poolId
-
string
- nodeId
-
string
- options
- ListNodeFilesOptionalParams
Retouren
listNodes(string, ListNodesOptionalParams)
Geeft een lijst weer van de rekenknooppunten in de opgegeven pool.
function listNodes(poolId: string, options?: ListNodesOptionalParams): PagedAsyncIterableIterator<BatchNode, BatchNode[], PageSettings>
Parameters
- poolId
-
string
- options
- ListNodesOptionalParams
Retouren
listPoolNodeCounts(ListPoolNodeCountsOptionalParams)
Hiermee haalt u het aantal rekenknooppunten in elke status op, gegroepeerd op pool. Houd er rekening mee dat de geretourneerde getallen mogelijk niet altijd up-to-date zijn. Als u exact aantal knooppunten nodig hebt, gebruikt u een lijstquery.
function listPoolNodeCounts(options?: ListPoolNodeCountsOptionalParams): PagedAsyncIterableIterator<BatchPoolNodeCounts, BatchPoolNodeCounts[], PageSettings>
Parameters
- options
- ListPoolNodeCountsOptionalParams
Retouren
listPools(ListPoolsOptionalParams)
Een lijst met alle pools in het opgegeven account.
function listPools(options?: ListPoolsOptionalParams): PagedAsyncIterableIterator<BatchPool, BatchPool[], PageSettings>
Parameters
- options
- ListPoolsOptionalParams
Retouren
listPoolUsageMetrics(ListPoolUsageMetricsOptionalParams)
Als u geen $filter component met inbegrip van een poolId opgeeft, bevat het antwoord alle pools die in het account aanwezig zijn in het tijdsbereik van de geretourneerde aggregatie-intervallen. Als u geen $filter component opgeeft, inclusief een startTime of endTime, worden deze filters standaard ingesteld op de begin- en eindtijden van het laatste aggregatie-interval dat momenteel beschikbaar is; Dat wil gezegd, alleen het laatste aggregatie-interval wordt geretourneerd.
function listPoolUsageMetrics(options?: ListPoolUsageMetricsOptionalParams): PagedAsyncIterableIterator<BatchPoolUsageMetrics, BatchPoolUsageMetrics[], PageSettings>
Parameters
Retouren
listSubTasks(string, string, ListSubTasksOptionalParams)
Als de taak geen taak met meerdere exemplaren is, retourneert dit een lege verzameling.
function listSubTasks(jobId: string, taskId: string, options?: ListSubTasksOptionalParams): PagedAsyncIterableIterator<BatchSubtask, BatchSubtask[], PageSettings>
Parameters
- jobId
-
string
- taskId
-
string
- options
- ListSubTasksOptionalParams
Retouren
listSupportedImages(ListSupportedImagesOptionalParams)
Een lijst met alle installatiekopieën van virtuele machines die worden ondersteund door de Azure Batch-service.
function listSupportedImages(options?: ListSupportedImagesOptionalParams): PagedAsyncIterableIterator<BatchSupportedImage, BatchSupportedImage[], PageSettings>
Parameters
Retouren
listTaskFiles(string, string, ListTaskFilesOptionalParams)
Geeft een lijst weer van de bestanden in de map van een taak op het rekenknooppunt.
function listTaskFiles(jobId: string, taskId: string, options?: ListTaskFilesOptionalParams): PagedAsyncIterableIterator<BatchNodeFile, BatchNodeFile[], PageSettings>
Parameters
- jobId
-
string
- taskId
-
string
- options
- ListTaskFilesOptionalParams
Retouren
listTasks(string, ListTasksOptionalParams)
Voor multi-instance taken verwijzen informatie zoals affinityId, executionInfo en nodeInfo naar de primaire taak. Gebruik de list subtasks API om informatie over subtaken op te halen.
function listTasks(jobId: string, options?: ListTasksOptionalParams): PagedAsyncIterableIterator<BatchTask, BatchTask[], PageSettings>
Parameters
- jobId
-
string
- options
- ListTasksOptionalParams
Retouren
poolExists(string, PoolExistsOptionalParams)
Krijgt de basiseigenschappen van een Pool.
function poolExists(poolId: string, options?: PoolExistsOptionalParams): Promise<boolean>
Parameters
- poolId
-
string
- options
- PoolExistsOptionalParams
Retouren
Promise<boolean>
reactivateTask(string, string, ReactivateTaskOptionalParams)
Door opnieuw te activeren kan een taak opnieuw worden geprobeerd tot het maximumaantal nieuwe pogingen. De status van de taak wordt gewijzigd in actief. Omdat de taak niet langer de status Voltooid heeft, zijn eventuele eerdere afsluitcode of foutinformatie niet meer beschikbaar na opnieuw activeren. Telkens wanneer een taak opnieuw wordt geactiveerd, wordt het aantal nieuwe pogingen opnieuw ingesteld op 0. Opnieuw activeren mislukt voor taken die niet zijn voltooid of die eerder zijn voltooid (met een afsluitcode van 0). Bovendien mislukt het als de taak is voltooid (of wordt beëindigd of verwijderd).
function reactivateTask(jobId: string, taskId: string, options?: ReactivateTaskOptionalParams): Promise<void>
Parameters
- jobId
-
string
- taskId
-
string
- options
- ReactivateTaskOptionalParams
Retouren
Promise<void>
rebootNode(string, string, RebootNodeOptionalParams)
U kunt een rekenknooppunt alleen opnieuw opstarten als het een niet-actieve of actieve status heeft.
function rebootNode(poolId: string, nodeId: string, options?: RebootNodeOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- poolId
-
string
- nodeId
-
string
- options
- RebootNodeOptionalParams
Retouren
PollerLike<OperationState<void>, void>
reimageNode(string, string, ReimageNodeOptionalParams)
U kunt het besturingssysteem alleen opnieuw installeren op een rekenknooppunt als het een niet-actieve of actieve status heeft. Deze API kan alleen worden aangeroepen op pools die zijn aangemaakt met de cloud service configuratie-eigenschap.
function reimageNode(poolId: string, nodeId: string, options?: ReimageNodeOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- poolId
-
string
- nodeId
-
string
- options
- ReimageNodeOptionalParams
Retouren
PollerLike<OperationState<void>, void>
removeNodes(string, BatchNodeRemoveOptions, RemoveNodesOptionalParams)
Deze bewerking kan alleen worden uitgevoerd wanneer de toewijzingsstatus van de pool stabiel is. Wanneer deze bewerking wordt uitgevoerd, verandert de toewijzingsstatus van constant in het wijzigen van de grootte. Elke aanvraag kan maximaal 100 knooppunten verwijderen.
function removeNodes(poolId: string, removeOptions: BatchNodeRemoveOptions, options?: RemoveNodesOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- poolId
-
string
- removeOptions
- BatchNodeRemoveOptions
- options
- RemoveNodesOptionalParams
Retouren
PollerLike<OperationState<void>, void>
replaceJob(string, BatchJob, ReplaceJobOptionalParams)
Dit vervangt volledig alle up-dateerbare eigenschappen van de Job. Als bijvoorbeeld de Job beperkingen heeft en als constraints niet met dit verzoek zijn gespecificeerd, zal de batchservice de bestaande constraints verwijderen.
function replaceJob(jobId: string, job: BatchJob, options?: ReplaceJobOptionalParams): Promise<void>
Parameters
- jobId
-
string
- job
- BatchJob
- options
- ReplaceJobOptionalParams
Retouren
Promise<void>
replaceJobSchedule(string, BatchJobSchedule, ReplaceJobScheduleOptionalParams)
Dit vervangt volledig alle up-dateerbare eigenschappen van het Job Schedule. Als bijvoorbeeld de schedule-eigenschap niet bij dit verzoek is gespecificeerd, verwijdert de Batch-service de bestaande schedule. Wijzigingen in een taakschema hebben alleen invloed op taken die door het schema zijn aangemaakt nadat de update heeft plaatsgevonden; momenteel lopende banen zijn onaangetast.
function replaceJobSchedule(jobScheduleId: string, jobSchedule: BatchJobSchedule, options?: ReplaceJobScheduleOptionalParams): Promise<void>
Parameters
- jobScheduleId
-
string
- jobSchedule
- BatchJobSchedule
- options
- ReplaceJobScheduleOptionalParams
Retouren
Promise<void>
replaceNodeUser(string, string, string, BatchNodeUserUpdateOptions, ReplaceNodeUserOptionalParams)
Deze bewerking vervangt alle updateerbare eigenschappen van het Account. Als bijvoorbeeld het expiryTime-element niet wordt gespecificeerd, wordt de huidige waarde vervangen door de standaardwaarde en niet ongewijzigd gelaten. Je kunt een gebruikersaccount op een Compute Node alleen bijwerken als deze in de idle of running state is.
function replaceNodeUser(poolId: string, nodeId: string, userName: string, updateOptions: BatchNodeUserUpdateOptions, options?: ReplaceNodeUserOptionalParams): Promise<void>
Parameters
- poolId
-
string
- nodeId
-
string
- userName
-
string
- updateOptions
- BatchNodeUserUpdateOptions
- options
- ReplaceNodeUserOptionalParams
Retouren
Promise<void>
replacePoolProperties(string, BatchPoolReplaceOptions, ReplacePoolPropertiesOptionalParams)
Dit vervangt volledig alle up-dateerbare eigenschappen van de Pool. Als bijvoorbeeld de Pool een StartTask heeft gekoppeld en StartTask niet is gespecificeerd met dit verzoek, dan verwijdert de Batch-service de bestaande StartTask.
function replacePoolProperties(poolId: string, pool: BatchPoolReplaceOptions, options?: ReplacePoolPropertiesOptionalParams): Promise<void>
Parameters
- poolId
-
string
Retouren
Promise<void>
replaceTask(string, string, BatchTask, ReplaceTaskOptionalParams)
Werkt de eigenschappen van de opgegeven taak bij.
function replaceTask(jobId: string, taskId: string, task: BatchTask, options?: ReplaceTaskOptionalParams): Promise<void>
Parameters
- jobId
-
string
- taskId
-
string
- task
- BatchTask
- options
- ReplaceTaskOptionalParams
Retouren
Promise<void>
resizePool(string, BatchPoolResizeOptions, ResizePoolOptionalParams)
U kunt het formaat van een pool alleen wijzigen wanneer de toewijzingsstatus stabiel is. Als de grootte van de pool al is gewijzigd, mislukt de aanvraag met statuscode 409. Wanneer u het formaat van een pool wijzigt, verandert de toewijzingsstatus van de pool van gestage tot het wijzigen van de grootte. U kunt de grootte van pools die zijn geconfigureerd voor automatisch schalen niet wijzigen. Als u dit probeert te doen, retourneert de Batch-service een fout 409. Als u het formaat van een pool omlaag wijzigt, kiest de Batch-service welke rekenknooppunten u wilt verwijderen. Als u specifieke rekenknooppunten wilt verwijderen, verwijdert u in plaats daarvan de API voor rekenknooppunten met de pool.
function resizePool(poolId: string, resizeOptions: BatchPoolResizeOptions, options?: ResizePoolOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- poolId
-
string
- resizeOptions
- BatchPoolResizeOptions
- options
- ResizePoolOptionalParams
Retouren
PollerLike<OperationState<void>, void>
startNode(string, string, StartNodeOptionalParams)
Je kunt een Compute Node alleen starten als deze is gedeald.
function startNode(poolId: string, nodeId: string, options?: StartNodeOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- poolId
-
string
- nodeId
-
string
- options
- StartNodeOptionalParams
Retouren
PollerLike<OperationState<void>, void>
stopPoolResize(string, StopPoolResizeOptionalParams)
Dit herstelt de Pool niet naar de vorige staat vóór de wijziging: het stopt alleen verdere wijzigingen en de Pool behoudt zijn huidige toestand. Na het stoppen stabiliseert de Pool het aantal rekenknooppunten waarop het zich bevond toen de stopoperatie werd uitgevoerd. Tijdens de stopwerking verandert de poolallocatietoestand eerst in stoppen en daarna in stabiel. Een hergroottebewerking hoeft niet per se een expliciet verzoek om de grootte van de Pool te zijn; deze API kan ook worden gebruikt om de initiële grootte van de Pool te stoppen wanneer deze wordt aangemaakt.
function stopPoolResize(poolId: string, options?: StopPoolResizeOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- poolId
-
string
- options
- StopPoolResizeOptionalParams
Retouren
PollerLike<OperationState<void>, void>
terminateJob(string, TerminateJobOptionalParams)
Wanneer een verzoek om Beëindigen van een baan wordt ontvangen, zet de batchservice de taak in de beëindigende toestand. De Batch-service beëindigt vervolgens alle lopende taken die aan de taak zijn gekoppeld en voert alle benodigde taakvrijgavetaken uit. Daarna gaat de Job naar de voltooide staat. Als er taken in de actieve staat in de baan zijn, blijven die in de actieve staat. Zodra een taak is beëindigd, kunnen er geen nieuwe taken worden toegevoegd en worden eventuele resterende actieve taken niet meer ingepland.
function terminateJob(jobId: string, options?: TerminateJobOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- jobId
-
string
- options
- TerminateJobOptionalParams
Retouren
PollerLike<OperationState<void>, void>
terminateJobSchedule(string, TerminateJobScheduleOptionalParams)
Hiermee wordt een taakplanning beëindigd.
function terminateJobSchedule(jobScheduleId: string, options?: TerminateJobScheduleOptionalParams): PollerLike<OperationState<void>, void>
Parameters
- jobScheduleId
-
string
Retouren
PollerLike<OperationState<void>, void>
terminateTask(string, string, TerminateTaskOptionalParams)
Wanneer de taak is beëindigd, wordt deze verplaatst naar de voltooide status. Voor taken met meerdere exemplaren wordt de beëindigingstaak synchroon toegepast op de primaire taak; subtaken worden vervolgens asynchroon op de achtergrond beëindigd.
function terminateTask(jobId: string, taskId: string, options?: TerminateTaskOptionalParams): Promise<void>
Parameters
- jobId
-
string
- taskId
-
string
- options
- TerminateTaskOptionalParams
Retouren
Promise<void>
updateJob(string, BatchJobUpdateOptions, UpdateJobOptionalParams)
Dit vervangt alleen de Job-eigenschappen die in het verzoek zijn gespecificeerd. Als de Job bijvoorbeeld beperkingen heeft en een verzoek het constraints-element niet specificeert, dan behoudt de Job de bestaande beperkingen.
function updateJob(jobId: string, job: BatchJobUpdateOptions, options?: UpdateJobOptionalParams): Promise<void>
Parameters
- jobId
-
string
- options
- UpdateJobOptionalParams
Retouren
Promise<void>
updateJobSchedule(string, BatchJobScheduleUpdateOptions, UpdateJobScheduleOptionalParams)
Dit vervangt alleen de taken van het takenschema die in het verzoek zijn gespecificeerd. Als bijvoorbeeld de schedule-eigenschap niet is gespecificeerd bij dit verzoek, dan behoudt de Batch-service de bestaande schedule. Wijzigingen in een taakschema hebben alleen invloed op taken die door het schema zijn aangemaakt nadat de update heeft plaatsgevonden; momenteel lopende banen zijn onaangetast.
function updateJobSchedule(jobScheduleId: string, jobSchedule: BatchJobScheduleUpdateOptions, options?: UpdateJobScheduleOptionalParams): Promise<void>
Parameters
- jobScheduleId
-
string
- jobSchedule
- BatchJobScheduleUpdateOptions
- options
- UpdateJobScheduleOptionalParams
Retouren
Promise<void>
updatePool(string, BatchPoolUpdateOptions, UpdatePoolOptionalParams)
Dit vervangt alleen de Pool-eigenschappen die in het verzoek zijn gespecificeerd. Als bijvoorbeeld de Pool een StartTask heeft en een verzoek geen StartTask-element specificeert, dan behoudt de Pool de bestaande StartTask.
function updatePool(poolId: string, pool: BatchPoolUpdateOptions, options?: UpdatePoolOptionalParams): Promise<void>
Parameters
- poolId
-
string
- options
- UpdatePoolOptionalParams
Retouren
Promise<void>
uploadNodeLogs(string, string, UploadBatchServiceLogsOptions, UploadNodeLogsOptionalParams)
Dit is bedoeld om Azure Batch-servicelogbestanden op geautomatiseerde wijze te verzamelen vanuit Compute Nodes als je een fout ervaart en wilt escaleren naar Azure-ondersteuning. De logboekbestanden van de Azure Batch-service moeten worden gedeeld met ondersteuning voor Azure om problemen met de Batch-service op te sporen.
function uploadNodeLogs(poolId: string, nodeId: string, uploadOptions: UploadBatchServiceLogsOptions, options?: UploadNodeLogsOptionalParams): Promise<UploadBatchServiceLogsResult>
Parameters
- poolId
-
string
- nodeId
-
string
- uploadOptions
- UploadBatchServiceLogsOptions
- options
- UploadNodeLogsOptionalParams
Retouren
Promise<UploadBatchServiceLogsResult>