BatchPoolSpecification interface

Pacchetto:

@azure-rest/batch

Specifica per la creazione di un nuovo pool.

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 rifiuta la richiesta con un errore di valore della proprietà non valido; 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.
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, è necessario l'elemento autoScaleFormula. 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.
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	Elenco di file system da montare in ogni nodo del pool. Supporta File di Azure, NFS, CIFS/SMB e Blobfuse.
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 rifiuta la richiesta con un errore; se si chiama direttamente l'API REST, il codice di stato HTTP è 400 (richiesta non valida).
startTask	Un'attività da eseguire in ogni nodo di calcolo quando viene aggiunto 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. Questa proprietà deve essere specificata.
vmSize	Dimensioni delle macchine virtuali nel pool. Tutte le macchine virtuali in un pool hanno le stesse dimensioni. Per informazioni sulle dimensioni disponibili delle macchine virtuali nei pool, vedere Scegliere una dimensione di macchina virtuale per i nodi di calcolo in un pool di Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

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 rifiuta la richiesta con un errore di valore della proprietà non valido; 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.

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, è necessario l'elemento autoScaleFormula. 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

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

Elenco di file system da montare in ogni nodo del pool. Supporta File di Azure, NFS, CIFS/SMB e Blobfuse.

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 rifiuta la richiesta con 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à da eseguire in ogni nodo di calcolo quando viene aggiunto 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. Questa proprietà deve essere specificata.

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 disponibili delle macchine virtuali nei pool, vedere Scegliere una dimensione di macchina virtuale per i nodi di calcolo in un pool di Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

vmSize: string

Valore della proprietà

string