Dela via


BatchPoolSpecificationOutput interface

Specifikation för att skapa en ny pool.

Egenskaper

applicationPackageReferences

Listan över paket som ska installeras på varje beräkningsnod i poolen. När du skapar en pool måste paketets program-ID vara fullständigt kvalificerat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Ändringar i paketreferenser påverkar alla nya noder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Det finns högst 10 paketreferenser för en viss pool.

autoScaleEvaluationInterval

Tidsintervallet då poolstorleken ska justeras automatiskt enligt autoskalningsformeln. Standardvärdet är 15 minuter. Det lägsta och högsta värdet är 5 minuter respektive 168 timmar. Om du anger ett värde som är mindre än 5 minuter eller större än 168 timmar avvisar Batch-tjänsten begäran med ett ogiltigt egenskapsvärdefel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran).

autoScaleFormula

Formeln för önskat antal beräkningsnoder i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på false. Det krävs om enableAutoScale är inställt på true. Formeln kontrolleras för giltighet innan poolen skapas. Om formeln inte är giltig avvisar Batch-tjänsten begäran med detaljerad felinformation.

displayName

Visningsnamnet för poolen. Visningsnamnet behöver inte vara unikt och kan innehålla unicode-tecken upp till en maximal längd på 1024.

enableAutoScale

Om poolstorleken ska justeras automatiskt över tid. Om det är falskt måste minst en av targetDedicatedNodes och targetLowPriorityNodes anges. Om sant krävs autoScaleFormula-elementet. Poolen ändrar automatiskt storlek enligt formeln. Standardvärdet är falskt.

enableInterNodeCommunication

Om poolen tillåter direkt kommunikation mellan beräkningsnoder. Om kommunikation mellan noder aktiveras begränsas poolens maximala storlek på grund av distributionsbegränsningar för poolens beräkningsnoder. Detta kan leda till att poolen inte når önskad storlek. Standardvärdet är falskt.

metadata

En lista över namn/värde-par som är associerade med poolen som metadata. Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod.

mountConfiguration

En lista över filsystem som ska monteras på varje nod i poolen. Detta stöder Azure Files, NFS, CIFS/SMB och Blobfuse.

networkConfiguration

Nätverkskonfigurationen för poolen.

resizeTimeout

Tidsgränsen för allokering av beräkningsnoder till poolen. Den här tidsgränsen gäller endast för manuell skalning. det har ingen effekt när enableAutoScale är inställt på sant. Standardvärdet är 15 minuter. Minimivärdet är 5 minuter. Om du anger ett värde som är mindre än 5 minuter avvisar Batch-tjänsten begäran med ett fel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran).

startTask

En uppgift som ska köras på varje beräkningsnod när den ansluter till poolen. Aktiviteten körs när beräkningsnoden läggs till i poolen eller när beräkningsnoden startas om.

targetDedicatedNodes

Önskat antal dedikerade beräkningsnoder i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på true. Om enableAutoScale är inställt på false måste du ange antingen targetDedicatedNodes, targetLowPriorityNodes eller båda.

targetLowPriorityNodes

Önskat antal beräkningsnoder med oanvänd kapacitet/låg prioritet i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på true. Om enableAutoScale är inställt på false måste du ange antingen targetDedicatedNodes, targetLowPriorityNodes eller båda.

taskSchedulingPolicy

Så här distribueras uppgifter mellan beräkningsnoder i en pool. Om det inte anges är standardvärdet utspritt.

taskSlotsPerNode

Antalet aktivitetsfack som kan användas för att köra samtidiga uppgifter på en enda beräkningsnod i poolen. Standardvärdet är 1. Det maximala värdet är mindre än 4 gånger antalet kärnor i vmSize för poolen eller 256.

upgradePolicy

Uppgraderingsprincipen för poolen. Beskriver en uppgraderingsprincip – automatisk, manuell eller rullande.

userAccounts

Listan över användarkonton som ska skapas på varje beräkningsnod i poolen.

virtualMachineConfiguration

Konfigurationen av den virtuella datorn för poolen. Den här egenskapen måste anges.

vmSize

Storleken på de virtuella datorerna i poolen. Alla virtuella datorer i en pool har samma storlek. Information om tillgängliga storlekar på virtuella datorer i pooler finns i Välja en VM-storlek för beräkningsnoder i en Azure Batch-pool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

Egenskapsinformation

applicationPackageReferences

Listan över paket som ska installeras på varje beräkningsnod i poolen. När du skapar en pool måste paketets program-ID vara fullständigt kvalificerat (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Ändringar i paketreferenser påverkar alla nya noder som ansluter till poolen, men påverkar inte beräkningsnoder som redan finns i poolen förrän de startas om eller omskapas. Det finns högst 10 paketreferenser för en viss pool.

applicationPackageReferences?: BatchApplicationPackageReferenceOutput[]

Egenskapsvärde

autoScaleEvaluationInterval

Tidsintervallet då poolstorleken ska justeras automatiskt enligt autoskalningsformeln. Standardvärdet är 15 minuter. Det lägsta och högsta värdet är 5 minuter respektive 168 timmar. Om du anger ett värde som är mindre än 5 minuter eller större än 168 timmar avvisar Batch-tjänsten begäran med ett ogiltigt egenskapsvärdefel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran).

autoScaleEvaluationInterval?: string

Egenskapsvärde

string

autoScaleFormula

Formeln för önskat antal beräkningsnoder i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på false. Det krävs om enableAutoScale är inställt på true. Formeln kontrolleras för giltighet innan poolen skapas. Om formeln inte är giltig avvisar Batch-tjänsten begäran med detaljerad felinformation.

autoScaleFormula?: string

Egenskapsvärde

string

displayName

Visningsnamnet för poolen. Visningsnamnet behöver inte vara unikt och kan innehålla unicode-tecken upp till en maximal längd på 1024.

displayName?: string

Egenskapsvärde

string

enableAutoScale

Om poolstorleken ska justeras automatiskt över tid. Om det är falskt måste minst en av targetDedicatedNodes och targetLowPriorityNodes anges. Om sant krävs autoScaleFormula-elementet. Poolen ändrar automatiskt storlek enligt formeln. Standardvärdet är falskt.

enableAutoScale?: boolean

Egenskapsvärde

boolean

enableInterNodeCommunication

Om poolen tillåter direkt kommunikation mellan beräkningsnoder. Om kommunikation mellan noder aktiveras begränsas poolens maximala storlek på grund av distributionsbegränsningar för poolens beräkningsnoder. Detta kan leda till att poolen inte når önskad storlek. Standardvärdet är falskt.

enableInterNodeCommunication?: boolean

Egenskapsvärde

boolean

metadata

En lista över namn/värde-par som är associerade med poolen som metadata. Batch-tjänsten tilldelar ingen betydelse för metadata. det är endast för användning av användarkod.

metadata?: BatchMetadataItemOutput[]

Egenskapsvärde

mountConfiguration

En lista över filsystem som ska monteras på varje nod i poolen. Detta stöder Azure Files, NFS, CIFS/SMB och Blobfuse.

mountConfiguration?: MountConfigurationOutput[]

Egenskapsvärde

networkConfiguration

Nätverkskonfigurationen för poolen.

networkConfiguration?: NetworkConfigurationOutput

Egenskapsvärde

resizeTimeout

Tidsgränsen för allokering av beräkningsnoder till poolen. Den här tidsgränsen gäller endast för manuell skalning. det har ingen effekt när enableAutoScale är inställt på sant. Standardvärdet är 15 minuter. Minimivärdet är 5 minuter. Om du anger ett värde som är mindre än 5 minuter avvisar Batch-tjänsten begäran med ett fel. Om du anropar REST-API:et direkt är HTTP-statuskoden 400 (felaktig begäran).

resizeTimeout?: string

Egenskapsvärde

string

startTask

En uppgift som ska köras på varje beräkningsnod när den ansluter till poolen. Aktiviteten körs när beräkningsnoden läggs till i poolen eller när beräkningsnoden startas om.

startTask?: BatchStartTaskOutput

Egenskapsvärde

targetDedicatedNodes

Önskat antal dedikerade beräkningsnoder i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på true. Om enableAutoScale är inställt på false måste du ange antingen targetDedicatedNodes, targetLowPriorityNodes eller båda.

targetDedicatedNodes?: number

Egenskapsvärde

number

targetLowPriorityNodes

Önskat antal beräkningsnoder med oanvänd kapacitet/låg prioritet i poolen. Den här egenskapen får inte anges om enableAutoScale är inställt på true. Om enableAutoScale är inställt på false måste du ange antingen targetDedicatedNodes, targetLowPriorityNodes eller båda.

targetLowPriorityNodes?: number

Egenskapsvärde

number

taskSchedulingPolicy

Så här distribueras uppgifter mellan beräkningsnoder i en pool. Om det inte anges är standardvärdet utspritt.

taskSchedulingPolicy?: BatchTaskSchedulingPolicyOutput

Egenskapsvärde

taskSlotsPerNode

Antalet aktivitetsfack som kan användas för att köra samtidiga uppgifter på en enda beräkningsnod i poolen. Standardvärdet är 1. Det maximala värdet är mindre än 4 gånger antalet kärnor i vmSize för poolen eller 256.

taskSlotsPerNode?: number

Egenskapsvärde

number

upgradePolicy

Uppgraderingsprincipen för poolen. Beskriver en uppgraderingsprincip – automatisk, manuell eller rullande.

upgradePolicy?: UpgradePolicyOutput

Egenskapsvärde

userAccounts

Listan över användarkonton som ska skapas på varje beräkningsnod i poolen.

userAccounts?: UserAccountOutput[]

Egenskapsvärde

virtualMachineConfiguration

Konfigurationen av den virtuella datorn för poolen. Den här egenskapen måste anges.

virtualMachineConfiguration?: VirtualMachineConfigurationOutput

Egenskapsvärde

vmSize

Storleken på de virtuella datorerna i poolen. Alla virtuella datorer i en pool har samma storlek. Information om tillgängliga storlekar på virtuella datorer i pooler finns i Välja en VM-storlek för beräkningsnoder i en Azure Batch-pool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

vmSize: string

Egenskapsvärde

string