PoolSpecification interface

Pakket:

@azure/batch

Een interface die PoolSpecification vertegenwoordigt.

Eigenschappen

applicationLicenses	De lijst met toepassingslicenties die de Batch-service beschikbaar maakt op elk rekenknooppunt in de pool. De lijst met toepassingslicenties moet een subset van beschikbare Licenties voor Batch-servicetoepassingen zijn. Als er een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van een pool. De toegestane licenties die beschikbaar zijn op de pool zijn 'maya', 'vray', '3dsmax', 'arnold'. Er worden extra kosten in rekening gebracht voor elke toepassingslicentie die is toegevoegd aan de groep.
applicationPackageReferences	De lijst met pakketten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. 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.
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).
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.
certificateReferences	Een lijst met certificaten die op elk rekenknooppunt in de pool moeten worden geïnstalleerd. Voor Windows-knooppunten installeert de Batch-service de certificaten op het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap Taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak verstrekt om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en certificaten worden in die map geplaatst.
cloudServiceConfiguration	De cloudserviceconfiguratie voor de pool. Deze eigenschap moet worden opgegeven als de pool moet worden gemaakt met Azure PaaS-VM's. Deze eigenschap en virtualMachineConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. Als geen van beide is opgegeven, retourneert de Batch-service een fout. als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). Deze eigenschap kan niet worden opgegeven als het Batch-account is gemaakt met de eigenschap poolAllocationMode ingesteld op UserSubscription.
displayName	De weergavenaam voor de pool. De weergavenaam hoeft niet uniek te zijn en mag unicode-tekens bevatten tot een maximale lengte van 1024.
enableAutoScale	Of de grootte van de pool na verloop van tijd automatisch moet worden aangepast. Als dit onwaar is, moeten ten minste één van targetDedicateNodes 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.
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.
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.
mountConfiguration	Een lijst met bestandssystemen die op elk knooppunt in de pool moeten worden gekoppeld. Dit ondersteunt Azure Files, NFS, CIFS/SMB en Blobfuse.
networkConfiguration	De netwerkconfiguratie voor de pool.
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).
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.
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.
targetLowPriorityNodes	Het gewenste aantal rekenknooppunten met lage prioriteit 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.
taskSchedulingPolicy	Hoe taken worden verdeeld over rekenknooppunten in een pool. Als dit niet is opgegeven, wordt de standaardwaarde verspreid.
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.
userAccounts	De lijst met gebruikersaccounts die moeten worden gemaakt op elk rekenknooppunt in de pool.
virtualMachineConfiguration	De configuratie van de virtuele machine voor de pool. Deze eigenschap moet worden opgegeven als de pool moet worden gemaakt met Azure IaaS-VM's. Deze eigenschap en cloudServiceConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. Als geen van beide is opgegeven, retourneert de Batch-service een fout. als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag).
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://docs.microsoft.com/azure/batch/batch-pool-vm-sizes) voor informatie over de beschikbare grootten van virtuele machines in pools.

Eigenschapdetails

applicationLicenses

De lijst met toepassingslicenties die de Batch-service beschikbaar maakt op elk rekenknooppunt in de pool. De lijst met toepassingslicenties moet een subset van beschikbare Licenties voor Batch-servicetoepassingen zijn. Als er een licentie wordt aangevraagd die niet wordt ondersteund, mislukt het maken van een pool. De toegestane licenties die beschikbaar zijn op de pool zijn 'maya', 'vray', '3dsmax', 'arnold'. Er worden extra kosten in rekening gebracht voor elke toepassingslicentie die is toegevoegd aan de groep.

applicationLicenses?: string[]

Waarde van eigenschap

string[]

applicationPackageReferences

De lijst met pakketten die moeten worden geïnstalleerd op elk rekenknooppunt in de pool. 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?: ApplicationPackageReference[]

Waarde van eigenschap

ApplicationPackageReference[]

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

certificateReferences

Een lijst met certificaten die op elk rekenknooppunt in de pool moeten worden geïnstalleerd. Voor Windows-knooppunten installeert de Batch-service de certificaten op het opgegeven certificaatarchief en de opgegeven locatie. Voor Linux-rekenknooppunten worden de certificaten opgeslagen in een map in de werkmap Taak en wordt een omgevingsvariabele AZ_BATCH_CERTIFICATES_DIR aan de taak verstrekt om een query uit te voeren op deze locatie. Voor certificaten met zichtbaarheid van remoteUser wordt een map met certificaten gemaakt in de basismap van de gebruiker (bijvoorbeeld /home/{user-name}/certs) en certificaten worden in die map geplaatst.

certificateReferences?: CertificateReference[]

Waarde van eigenschap

CertificateReference[]

cloudServiceConfiguration

De cloudserviceconfiguratie voor de pool. Deze eigenschap moet worden opgegeven als de pool moet worden gemaakt met Azure PaaS-VM's. Deze eigenschap en virtualMachineConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. Als geen van beide is opgegeven, retourneert de Batch-service een fout. als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag). Deze eigenschap kan niet worden opgegeven als het Batch-account is gemaakt met de eigenschap poolAllocationMode ingesteld op UserSubscription.

cloudServiceConfiguration?: CloudServiceConfiguration

Waarde van eigenschap

CloudServiceConfiguration

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 targetDedicateNodes 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?: MetadataItem[]

Waarde van eigenschap

MetadataItem[]

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?: MountConfiguration[]

Waarde van eigenschap

MountConfiguration[]

networkConfiguration

De netwerkconfiguratie voor de pool.

networkConfiguration?: NetworkConfiguration

Waarde van eigenschap

NetworkConfiguration

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?: StartTask

Waarde van eigenschap

StartTask

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 rekenknooppunten met lage prioriteit 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?: TaskSchedulingPolicy

Waarde van eigenschap

TaskSchedulingPolicy

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

userAccounts

De lijst met gebruikersaccounts die moeten worden gemaakt op elk rekenknooppunt in de pool.

userAccounts?: UserAccount[]

Waarde van eigenschap

UserAccount[]

virtualMachineConfiguration

De configuratie van de virtuele machine voor de pool. Deze eigenschap moet worden opgegeven als de pool moet worden gemaakt met Azure IaaS-VM's. Deze eigenschap en cloudServiceConfiguration sluiten elkaar wederzijds uit en een van de eigenschappen moet worden opgegeven. Als geen van beide is opgegeven, retourneert de Batch-service een fout. als u de REST API rechtstreeks aanroept, is de HTTP-statuscode 400 (Ongeldige aanvraag).

virtualMachineConfiguration?: VirtualMachineConfiguration

Waarde van eigenschap

VirtualMachineConfiguration

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://docs.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