BatchPoolSpecificationOutput interface
Specificatie voor het maken van een nieuwe pool.
Eigenschappen
| application |
De lijst met pakketten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. Bij het maken van een pool moet de toepassings-id van het pakket volledig zijn gekwalificeerd (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Wijzigingen in pakketverwijzingen zijn van invloed op alle nieuwe knooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw worden hersteld. Er zijn maximaal 10 pakketverwijzingen voor een bepaalde groep. |
| auto |
Het tijdsinterval waarmee de poolgrootte automatisch moet worden aangepast volgens de formule voor automatische schaalaanpassing. De standaardwaarde is 15 minuten. De minimum- en maximumwaarde zijn respectievelijk 5 minuten en 168 uur. Als u een waarde opgeeft die minder dan 5 minuten of langer is dan 168 uur, weigert de Batch-service de aanvraag met een ongeldige eigenschapswaardefout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). |
| auto |
De formule voor het gewenste aantal rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op false. Dit is vereist als enableAutoScale is ingesteld op true. De formule wordt gecontroleerd op geldigheid voordat de pool wordt gemaakt. Als de formule niet geldig is, weigert de Batch-service de aanvraag met gedetailleerde foutinformatie. |
| display |
De weergavenaam voor de pool. De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024. |
| enable |
Of de grootte van de pool na verloop van tijd automatisch moet worden aangepast. Als dit onwaar is, moeten ten minste één van targetDedicatedNodes en targetLowPriorityNodes worden opgegeven. Indien waar, is het element autoScaleFormula vereist. De grootte van de pool wordt automatisch aangepast aan de formule. De standaardwaarde is onwaar. |
| enable |
Of de pool directe communicatie tussen rekenknooppunten toestaat. Als u communicatie tussen knooppunten inschakelt, wordt de maximale grootte van de pool beperkt vanwege implementatiebeperkingen op de rekenknooppunten van de pool. Dit kan ertoe leiden dat de pool de gewenste grootte niet bereikt. De standaardwaarde is onwaar. |
| metadata | Een lijst met naam-waardeparen die zijn gekoppeld aan de pool als metagegevens. De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode. |
| mount |
Een lijst met bestandssystemen die op elk knooppunt in de pool moeten worden gekoppeld. Dit ondersteunt Azure Files, NFS, CIFS/SMB en Blobfuse. |
| network |
De netwerkconfiguratie voor de pool. |
| resize |
De time-out voor de toewijzing van rekenknooppunten aan de pool. Deze time-out is alleen van toepassing op handmatig schalen; dit heeft geen effect wanneer enableAutoScale is ingesteld op true. De standaardwaarde is 15 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten duurt, weigert de Batch-service de aanvraag met een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). |
| start |
Een taak die moet worden uitgevoerd op elk rekenknooppunt terwijl deze lid wordt van de pool. De taak wordt uitgevoerd wanneer het rekenknooppunt wordt toegevoegd aan de pool of wanneer het rekenknooppunt opnieuw wordt opgestart. |
| target |
Het gewenste aantal toegewezen rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen. |
| target |
Het gewenste aantal spot-/lage prioriteit rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen. |
| task |
Hoe taken worden verdeeld over rekenknooppunten in een pool. Als dit niet is opgegeven, wordt de standaardwaarde verspreid. |
| task |
Het aantal taaksites dat kan worden gebruikt om gelijktijdige taken uit te voeren op één rekenknooppunt in de pool. De standaardwaarde is 1. De maximumwaarde is de kleinste van 4 keer het aantal kernen van de vmSize van de pool of 256. |
| upgrade |
Het upgradebeleid voor de pool. Beschrijft een upgradebeleid: automatisch, handmatig of rolling. |
| user |
De lijst met gebruikersaccounts die moeten worden gemaakt op elk rekenknooppunt in de pool. |
| virtual |
De configuratie van de virtuele machine voor de pool. Deze eigenschap moet worden opgegeven. |
| vm |
De grootte van de virtuele machines in de pool. Alle virtuele machines in een pool hebben dezelfde grootte. Zie Een VM-grootte kiezen voor rekenknooppunten in een Azure Batch-pool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes) voor informatie over de beschikbare grootten van virtuele machines in pools. |
Eigenschapdetails
applicationPackageReferences
De lijst met pakketten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. Bij het maken van een pool moet de toepassings-id van het pakket volledig zijn gekwalificeerd (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Wijzigingen in pakketverwijzingen zijn van invloed op alle nieuwe knooppunten die lid zijn van de pool, maar hebben geen invloed op rekenknooppunten die zich al in de pool bevinden totdat ze opnieuw worden opgestart of opnieuw worden hersteld. Er zijn maximaal 10 pakketverwijzingen voor een bepaalde groep.
applicationPackageReferences?: BatchApplicationPackageReferenceOutput[]
Waarde van eigenschap
autoScaleEvaluationInterval
Het tijdsinterval waarmee de poolgrootte automatisch moet worden aangepast volgens de formule voor automatische schaalaanpassing. De standaardwaarde is 15 minuten. De minimum- en maximumwaarde zijn respectievelijk 5 minuten en 168 uur. Als u een waarde opgeeft die minder dan 5 minuten of langer is dan 168 uur, weigert de Batch-service de aanvraag met een ongeldige eigenschapswaardefout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag).
autoScaleEvaluationInterval?: string
Waarde van eigenschap
string
autoScaleFormula
De formule voor het gewenste aantal rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op false. Dit is vereist als enableAutoScale is ingesteld op true. De formule wordt gecontroleerd op geldigheid voordat de pool wordt gemaakt. Als de formule niet geldig is, weigert de Batch-service de aanvraag met gedetailleerde foutinformatie.
autoScaleFormula?: string
Waarde van eigenschap
string
displayName
De weergavenaam voor de pool. De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024.
displayName?: string
Waarde van eigenschap
string
enableAutoScale
Of de grootte van de pool na verloop van tijd automatisch moet worden aangepast. Als dit onwaar is, moeten ten minste één van targetDedicatedNodes en targetLowPriorityNodes worden opgegeven. Indien waar, is het element autoScaleFormula vereist. De grootte van de pool wordt automatisch aangepast aan de formule. De standaardwaarde is onwaar.
enableAutoScale?: boolean
Waarde van eigenschap
boolean
enableInterNodeCommunication
Of de pool directe communicatie tussen rekenknooppunten toestaat. Als u communicatie tussen knooppunten inschakelt, wordt de maximale grootte van de pool beperkt vanwege implementatiebeperkingen op de rekenknooppunten van de pool. Dit kan ertoe leiden dat de pool de gewenste grootte niet bereikt. De standaardwaarde is onwaar.
enableInterNodeCommunication?: boolean
Waarde van eigenschap
boolean
metadata
Een lijst met naam-waardeparen die zijn gekoppeld aan de pool als metagegevens. De Batch-service wijst geen betekenis toe aan metagegevens; deze is uitsluitend bedoeld voor het gebruik van gebruikerscode.
metadata?: BatchMetadataItemOutput[]
Waarde van eigenschap
mountConfiguration
Een lijst met bestandssystemen die op elk knooppunt in de pool moeten worden gekoppeld. Dit ondersteunt Azure Files, NFS, CIFS/SMB en Blobfuse.
mountConfiguration?: MountConfigurationOutput[]
Waarde van eigenschap
networkConfiguration
De netwerkconfiguratie voor de pool.
networkConfiguration?: NetworkConfigurationOutput
Waarde van eigenschap
resizeTimeout
De time-out voor de toewijzing van rekenknooppunten aan de pool. Deze time-out is alleen van toepassing op handmatig schalen; dit heeft geen effect wanneer enableAutoScale is ingesteld op true. De standaardwaarde is 15 minuten. De minimumwaarde is 5 minuten. Als u een waarde opgeeft die minder dan 5 minuten duurt, weigert de Batch-service de aanvraag met een fout; als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag).
resizeTimeout?: string
Waarde van eigenschap
string
startTask
Een taak die moet worden uitgevoerd op elk rekenknooppunt terwijl deze lid wordt van de pool. De taak wordt uitgevoerd wanneer het rekenknooppunt wordt toegevoegd aan de pool of wanneer het rekenknooppunt opnieuw wordt opgestart.
startTask?: BatchStartTaskOutput
Waarde van eigenschap
targetDedicatedNodes
Het gewenste aantal toegewezen rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen.
targetDedicatedNodes?: number
Waarde van eigenschap
number
targetLowPriorityNodes
Het gewenste aantal spot-/lage prioriteit rekenknooppunten in de pool. Deze eigenschap mag niet worden opgegeven als enableAutoScale is ingesteld op true. Als enableAutoScale is ingesteld op false, moet u targetDedicatedNodes, targetLowPriorityNodes of beide instellen.
targetLowPriorityNodes?: number
Waarde van eigenschap
number
taskSchedulingPolicy
Hoe taken worden verdeeld over rekenknooppunten in een pool. Als dit niet is opgegeven, wordt de standaardwaarde verspreid.
taskSchedulingPolicy?: BatchTaskSchedulingPolicyOutput
Waarde van eigenschap
taskSlotsPerNode
Het aantal taaksites dat kan worden gebruikt om gelijktijdige taken uit te voeren op één rekenknooppunt in de pool. De standaardwaarde is 1. De maximumwaarde is de kleinste van 4 keer het aantal kernen van de vmSize van de pool of 256.
taskSlotsPerNode?: number
Waarde van eigenschap
number
upgradePolicy
Het upgradebeleid voor de pool. Beschrijft een upgradebeleid: automatisch, handmatig of rolling.
upgradePolicy?: UpgradePolicyOutput
Waarde van eigenschap
userAccounts
De lijst met gebruikersaccounts die moeten worden gemaakt op elk rekenknooppunt in de pool.
userAccounts?: UserAccountOutput[]
Waarde van eigenschap
virtualMachineConfiguration
De configuratie van de virtuele machine voor de pool. Deze eigenschap moet worden opgegeven.
virtualMachineConfiguration?: VirtualMachineConfigurationOutput
Waarde van eigenschap
vmSize
De grootte van de virtuele machines in de pool. Alle virtuele machines in een pool hebben dezelfde grootte. Zie Een VM-grootte kiezen voor rekenknooppunten in een Azure Batch-pool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes) voor informatie over de beschikbare grootten van virtuele machines in pools.
vmSize: string
Waarde van eigenschap
string