Condividi tramite

BatchPoolCreateOptions interface

Pacchetto:
@azure-rest/batch

Parametri per la creazione di un pool di Azure Batch.

Proprietà

applicationPackageReferences

Elenco di pacchetti da installare in ogni nodo di calcolo nel pool. Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto in un determinato pool.
autoScaleEvaluationInterval

Intervallo di tempo in cui modificare automaticamente le dimensioni del pool in base alla formula di scalabilità automatica. Il valore predefinito è 15 minuti. Il valore minimo e massimo sono rispettivamente 5 minuti e 168 ore. Se si specifica un valore minore di 5 minuti o superiore a 168 ore, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
autoScaleFormula

Formula per il numero desiderato di nodi di calcolo nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su false. È necessario se enableAutoScale è impostato su true. La formula viene verificata la validità prima della creazione del pool. Se la formula non è valida, il servizio Batch rifiuta la richiesta con informazioni dettagliate sull'errore. Per altre informazioni sulla specifica di questa formula, vedere "Ridimensionare automaticamente i nodi di calcolo in un pool di Azure Batch" (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).
displayName

Nome visualizzato del pool. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.
enableAutoScale

Indica se le dimensioni del pool devono essere regolate automaticamente nel tempo. Se false, è necessario specificare almeno uno di targetDedicatedNodes e targetLowPriorityNodes. Se true, la proprietà autoScaleFormula è obbligatoria e il pool viene ridimensionato automaticamente in base alla formula. Il valore predefinito è false.
enableInterNodeCommunication

Indica se il pool consente la comunicazione diretta tra nodi di calcolo. L'abilitazione della comunicazione tra nodi limita le dimensioni massime del pool a causa delle restrizioni di distribuzione nei nodi di calcolo del pool. Ciò può comportare che il pool non raggiunga le dimensioni desiderate. Il valore predefinito è false.
id

Stringa che identifica in modo univoco il pool all'interno dell'account. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID pool all'interno di un account che differisce solo per caso.
metadata

Elenco di coppie nome-valore associate al pool come metadati. Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.
mountConfiguration

Montare l'archiviazione usando il file system specificato per l'intera durata del pool. Montare l'archiviazione usando fileshare di Azure, NFS, CIFS o Blobfuse basato su file system.
networkConfiguration

Configurazione di rete per il pool.
resizeTimeout

Timeout per l'allocazione dei nodi di calcolo al pool. Questo timeout si applica solo alla scalabilità manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
startTask

Un'attività specificata per l'esecuzione in ogni nodo di calcolo durante l'aggiunta al pool. L'attività viene eseguita quando il nodo di calcolo viene aggiunto al pool o quando il nodo di calcolo viene riavviato.
targetDedicatedNodes

Numero desiderato di nodi di calcolo dedicati nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.
targetLowPriorityNodes

Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.
taskSchedulingPolicy

Modalità di distribuzione delle attività tra nodi di calcolo in un pool. Se non specificato, il valore predefinito è spread.
taskSlotsPerNode

Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool. Il valore predefinito è 1. Il valore massimo è minore di 4 volte il numero di core di vmSize del pool o 256.
upgradePolicy

Criteri di aggiornamento per il pool. Descrive un criterio di aggiornamento: automatico, manuale o in sequenza.
userAccounts

Elenco di account utente da creare in ogni nodo di calcolo nel pool.
virtualMachineConfiguration

Configurazione della macchina virtuale per il pool. È necessario specificare questa proprietà.
vmSize

Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace di macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per le macchine virtuali in Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). Batch supporta tutte le dimensioni delle macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).

Dettagli proprietà

applicationPackageReferences

Elenco di pacchetti da installare in ogni nodo di calcolo nel pool. Quando si crea un pool, l'ID applicazione del pacchetto deve essere completo (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). Le modifiche apportate ai riferimenti ai pacchetti influiscono su tutti i nuovi nodi che si aggiungono al pool, ma non influiscono sui nodi di calcolo già presenti nel pool fino a quando non vengono riavviati o ricreati l'immagine. È previsto un massimo di 10 riferimenti al pacchetto in un determinato pool.

applicationPackageReferences?: BatchApplicationPackageReference[]

Valore della proprietà

BatchApplicationPackageReference[]

autoScaleEvaluationInterval

Intervallo di tempo in cui modificare automaticamente le dimensioni del pool in base alla formula di scalabilità automatica. Il valore predefinito è 15 minuti. Il valore minimo e massimo sono rispettivamente 5 minuti e 168 ore. Se si specifica un valore minore di 5 minuti o superiore a 168 ore, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

autoScaleEvaluationInterval?: string

Valore della proprietà

string

autoScaleFormula

Formula per il numero desiderato di nodi di calcolo nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su false. È necessario se enableAutoScale è impostato su true. La formula viene verificata la validità prima della creazione del pool. Se la formula non è valida, il servizio Batch rifiuta la richiesta con informazioni dettagliate sull'errore. Per altre informazioni sulla specifica di questa formula, vedere "Ridimensionare automaticamente i nodi di calcolo in un pool di Azure Batch" (https://learn.microsoft.com/azure/batch/batch-automatic-scaling).

autoScaleFormula?: string

Valore della proprietà

string

displayName

Nome visualizzato del pool. Il nome visualizzato non deve essere univoco e può contenere caratteri Unicode fino a una lunghezza massima di 1024.

displayName?: string

Valore della proprietà

string

enableAutoScale

Indica se le dimensioni del pool devono essere regolate automaticamente nel tempo. Se false, è necessario specificare almeno uno di targetDedicatedNodes e targetLowPriorityNodes. Se true, la proprietà autoScaleFormula è obbligatoria e il pool viene ridimensionato automaticamente in base alla formula. Il valore predefinito è false.

enableAutoScale?: boolean

Valore della proprietà

boolean

enableInterNodeCommunication

Indica se il pool consente la comunicazione diretta tra nodi di calcolo. L'abilitazione della comunicazione tra nodi limita le dimensioni massime del pool a causa delle restrizioni di distribuzione nei nodi di calcolo del pool. Ciò può comportare che il pool non raggiunga le dimensioni desiderate. Il valore predefinito è false.

enableInterNodeCommunication?: boolean

Valore della proprietà

boolean

id

Stringa che identifica in modo univoco il pool all'interno dell'account. L'ID può contenere qualsiasi combinazione di caratteri alfanumerici, inclusi trattini e caratteri di sottolineatura, e non può contenere più di 64 caratteri. L'ID mantiene la distinzione tra maiuscole e minuscole e non fa distinzione tra maiuscole e minuscole, ovvero potrebbe non avere due ID pool all'interno di un account che differisce solo per caso.

id: string

Valore della proprietà

string

metadata

Elenco di coppie nome-valore associate al pool come metadati. Il servizio Batch non assegna alcun significato ai metadati; è esclusivamente per l'uso del codice utente.

metadata?: BatchMetadataItem[]

Valore della proprietà

BatchMetadataItem[]

mountConfiguration

Montare l'archiviazione usando il file system specificato per l'intera durata del pool. Montare l'archiviazione usando fileshare di Azure, NFS, CIFS o Blobfuse basato su file system.

mountConfiguration?: MountConfiguration[]

Valore della proprietà

MountConfiguration[]

networkConfiguration

Configurazione di rete per il pool.

networkConfiguration?: NetworkConfiguration

Valore della proprietà

NetworkConfiguration

resizeTimeout

Timeout per l'allocazione dei nodi di calcolo al pool. Questo timeout si applica solo alla scalabilità manuale; non ha alcun effetto quando enableAutoScale è impostato su true. Il valore predefinito è 15 minuti. Il valore minimo è 5 minuti. Se si specifica un valore inferiore a 5 minuti, il servizio Batch restituisce un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).

resizeTimeout?: string

Valore della proprietà

string

startTask

Un'attività specificata per l'esecuzione in ogni nodo di calcolo durante l'aggiunta al pool. L'attività viene eseguita quando il nodo di calcolo viene aggiunto al pool o quando il nodo di calcolo viene riavviato.

startTask?: BatchStartTask

Valore della proprietà

BatchStartTask

targetDedicatedNodes

Numero desiderato di nodi di calcolo dedicati nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

targetDedicatedNodes?: number

Valore della proprietà

number

targetLowPriorityNodes

Numero desiderato di nodi di calcolo spot/con priorità bassa nel pool. Questa proprietà non deve essere specificata se enableAutoScale è impostato su true. Se enableAutoScale è impostato su false, è necessario impostare targetDedicatedNodes, targetLowPriorityNodes o entrambi.

targetLowPriorityNodes?: number

Valore della proprietà

number

taskSchedulingPolicy

Modalità di distribuzione delle attività tra nodi di calcolo in un pool. Se non specificato, il valore predefinito è spread.

taskSchedulingPolicy?: BatchTaskSchedulingPolicy

Valore della proprietà

BatchTaskSchedulingPolicy

taskSlotsPerNode

Numero di slot di attività che possono essere usati per eseguire attività simultanee in un singolo nodo di calcolo nel pool. Il valore predefinito è 1. Il valore massimo è minore di 4 volte il numero di core di vmSize del pool o 256.

taskSlotsPerNode?: number

Valore della proprietà

number

upgradePolicy

Criteri di aggiornamento per il pool. Descrive un criterio di aggiornamento: automatico, manuale o in sequenza.

upgradePolicy?: UpgradePolicy

Valore della proprietà

UpgradePolicy

userAccounts

Elenco di account utente da creare in ogni nodo di calcolo nel pool.

userAccounts?: UserAccount[]

Valore della proprietà

UserAccount[]

virtualMachineConfiguration

Configurazione della macchina virtuale per il pool. È necessario specificare questa proprietà.

virtualMachineConfiguration?: VirtualMachineConfiguration

Valore della proprietà

VirtualMachineConfiguration

vmSize

Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace di macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per le macchine virtuali in Azure (https://learn.microsoft.com/azure/virtual-machines/sizes/overview). Batch supporta tutte le dimensioni delle macchine virtuali di Azure tranne STANDARD_A0 e quelle con archiviazione Premium (STANDARD_GS, STANDARD_DS e serie di STANDARD_DSV2).

vmSize: string

Valore della proprietà

string