Condividi tramite


PoolAddParameter interface

Interfaccia che rappresenta PoolAddParameter.

Proprietà

applicationLicenses

L'elenco delle licenze dell'applicazione che il servizio Batch renderà disponibile in ogni nodo di calcolo nel pool. L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza non supportata, la creazione del pool avrà esito negativo.

applicationPackageReferences

Elenco di pacchetti da installare in ogni nodo di calcolo nel pool. 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://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

certificateReferences

Elenco di certificati da installare in ogni nodo di calcolo nel pool. Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory.

cloudServiceConfiguration

Configurazione del servizio cloud per il pool. Questa proprietà e virtualMachineConfiguration si escludono a vicenda e deve essere specificata una delle proprietà. Questa proprietà non può essere specificata se l'account Batch è stato creato con la relativa proprietà poolAllocationMode impostata su 'UserSubscription'.

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 dei valori targetDedicateNodes 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 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.

userAccounts

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

virtualMachineConfiguration

Configurazione della macchina virtuale per il pool. Questa proprietà e cloudServiceConfiguration si escludono a vicenda e una delle 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 per i pool di servizi cloud (pool creati con cloudServiceConfiguration), vedere Dimensioni per i servizi cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supporta tutte le dimensioni delle macchine virtuali di Servizi cloud ad eccezione di ExtraSmall, A1V2 e A2V2. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace delle macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per le macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o dimensioni per le macchine virtuali (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). 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à

applicationLicenses

L'elenco delle licenze dell'applicazione che il servizio Batch renderà disponibile in ogni nodo di calcolo nel pool. L'elenco delle licenze dell'applicazione deve essere un subset di licenze dell'applicazione di servizio Batch disponibili. Se viene richiesta una licenza non supportata, la creazione del pool avrà esito negativo.

applicationLicenses?: string[]

Valore della proprietà

string[]

applicationPackageReferences

Elenco di pacchetti da installare in ogni nodo di calcolo nel pool. 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?: ApplicationPackageReference[]

Valore della proprietà

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://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).

autoScaleFormula?: string

Valore della proprietà

string

certificateReferences

Elenco di certificati da installare in ogni nodo di calcolo nel pool. Per i nodi Di Windows, il servizio Batch installa i certificati nell'archivio certificati e nel percorso specificati. Per i nodi di calcolo Linux, i certificati vengono archiviati in una directory all'interno della directory di lavoro attività e viene fornita una variabile di ambiente AZ_BATCH_CERTIFICATES_DIR all'attività per eseguire una query per questo percorso. Per i certificati con visibilità di 'remoteUser', viene creata una directory 'certs' nella home directory dell'utente (ad esempio, /home/{user-name}/certs) e i certificati vengono inseriti in tale directory.

certificateReferences?: CertificateReference[]

Valore della proprietà

cloudServiceConfiguration

Configurazione del servizio cloud per il pool. Questa proprietà e virtualMachineConfiguration si escludono a vicenda e deve essere specificata una delle proprietà. Questa proprietà non può essere specificata se l'account Batch è stato creato con la relativa proprietà poolAllocationMode impostata su 'UserSubscription'.

cloudServiceConfiguration?: CloudServiceConfiguration

Valore della proprietà

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

Valore della proprietà

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à

networkConfiguration

Configurazione di rete per il pool.

networkConfiguration?: NetworkConfiguration

Valore della proprietà

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

Valore della proprietà

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

Valore della proprietà

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

userAccounts

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

userAccounts?: UserAccount[]

Valore della proprietà

virtualMachineConfiguration

Configurazione della macchina virtuale per il pool. Questa proprietà e cloudServiceConfiguration si escludono a vicenda e una delle proprietà deve essere specificata.

virtualMachineConfiguration?: VirtualMachineConfiguration

Valore della proprietà

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 per i pool di servizi cloud (pool creati con cloudServiceConfiguration), vedere Dimensioni per i servizi cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch supporta tutte le dimensioni delle macchine virtuali di Servizi cloud ad eccezione di ExtraSmall, A1V2 e A2V2. Per informazioni sulle dimensioni delle macchine virtuali disponibili per i pool che usano immagini dal Marketplace delle macchine virtuali (pool creati con virtualMachineConfiguration), vedere Dimensioni per le macchine virtuali (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) o dimensioni per le macchine virtuali (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). 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