Pool Classe

display_name

str

Le nom d’affichage n’a pas besoin d’être unique et peut contenir des caractères Unicode d’une longueur maximale de 1 024.

vm_size

str

Pour plus d’informations sur les tailles disponibles des machines virtuelles pour les pools Services cloud (pools créés avec cloudServiceConfiguration), consultez Tailles des Services cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch prend en charge toutes les tailles de machine virtuelle Services cloud à l’exception d’ExtraSmall. Pour plus d’informations sur les tailles de machine virtuelle disponibles pour les pools utilisant des images de la Place de marché Machines Virtuelles (pools créés avec virtualMachineConfiguration), consultez Tailles pour Machines Virtuelles (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou Tailles pour Machines Virtuelles (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch prend en charge toutes les tailles de machines virtuelles Azure, à l’exception des STANDARD_A0 et des machines virtuelles avec stockage Premium (STANDARD_GS, STANDARD_DS et série STANDARD_DSV2).

deployment_configuration

DeploymentConfiguration

L’utilisation de CloudServiceConfiguration spécifie que les nœuds doivent être créés à l’aide d’Azure Services cloud (PaaS), tandis que VirtualMachineConfiguration utilise Azure Machines Virtuelles (IaaS).

scale_settings

ScaleSettings

Définit la taille souhaitée du pool. Il peut s’agir de « fixedScale » où le targetDedicatedNodes demandé est spécifié, ou de « autoScale » qui définit une formule régulièrement réévaluée. Si cette propriété n’est pas spécifiée, le pool aura une échelle fixe avec 0 targetDedicatedNodes.

inter_node_communication

str ou InterNodeCommunicationState

Cela impose des restrictions sur les nœuds qui peuvent être affectés au pool. L’activation de cette valeur peut réduire le risque que le nombre demandé de nœuds soit alloué dans le pool. Si elle n’est pas spécifiée, cette valeur est définie par défaut sur « Disabled ». Les valeurs connues sont « Enabled » et « Disabled ».

network_configuration

NetworkConfiguration

Configuration réseau d’un pool.

task_slots_per_node

int

La valeur par défaut est 1. La valeur maximale est la plus petite de 4 fois le nombre de cœurs du vmSize du pool ou 256.

task_scheduling_policy

TaskSchedulingPolicy

Si elle n’est pas spécifiée, la valeur par défaut est répartie.

user_accounts

list[UserAccount]

Liste des comptes d’utilisateur à créer sur chaque nœud du pool.

metadata

list[MetadataItem]

Le service Batch n’attribue aucune signification aux métadonnées ; il s’agit uniquement de l’utilisation du code utilisateur.

start_task

StartTask

Dans une opération PATCH (mise à jour), cette propriété peut être définie sur un objet vide pour supprimer la tâche de démarrage du pool.

certificates

list[CertificateReference]

Pour les nœuds de calcul Windows, le service Batch installe les certificats dans le magasin de certificats et l’emplacement spécifiés. Pour les nœuds de calcul Linux, les certificats sont stockés dans un répertoire à l’intérieur du répertoire de travail de la tâche et une variable d’environnement AZ_BATCH_CERTIFICATES_DIR est fournie à la tâche pour interroger cet emplacement. Pour les certificats avec une visibilité de « remoteUser », un répertoire « certs » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{nom-utilisateur}/certs) et les certificats sont placés dans ce répertoire.

Avertissement : cette propriété est déconseillée et sera supprimée après février 2024. Utilisez plutôt l’extension Azure KeyVault .

application_packages

list[ApplicationPackageReference]

Les modifications apportées aux références de package d’application affectent tous les nouveaux nœuds de calcul qui rejoignent le pool, mais n’affectent pas les nœuds de calcul qui se trouvent déjà dans le pool tant qu’ils ne sont pas redémarrés ou réinitialisé. Il existe un maximum de 10 références de package d’application sur un pool donné.

application_licenses

list[str]

La liste des licences d’application doit être un sous-ensemble des licences d’application de service Batch disponibles. Si une licence non prise en charge est demandée, la création du pool échoue.

mount_configuration

list[MountConfiguration]

Cela prend en charge Azure Files, NFS, CIFS/SMB et Blobfuse.

target_node_communication_mode

str ou NodeCommunicationMode

Si elle est omise, la valeur par défaut est Default. Les valeurs connues sont les suivantes : « Default », « Classic » et « Simplified ».

resource_tags

dict[str, str]

Balises définies par l’utilisateur à associer au pool de Azure Batch. Quand elles sont spécifiées, ces balises sont propagées aux ressources Azure de stockage associées au pool. Cette propriété ne peut être spécifiée que lorsque le compte Batch a été créé avec la propriété poolAllocationMode définie sur « UserSubscription ».

name

str

Nom de la ressource.

type

str

Type de la ressource.

etag

str

ETag de la ressource, utilisé pour les instructions d’accès concurrentiel.

identity

BatchPoolIdentity

Type d’identité utilisé pour le pool Batch.

display_name

str

Le nom d’affichage n’a pas besoin d’être unique et peut contenir des caractères Unicode d’une longueur maximale de 1 024.

last_modified

datetime

C’est la dernière fois que les données au niveau du pool, telles que targetDedicatedNodes ou autoScaleSettings, ont changé. Il ne prend pas en compte les changements au niveau du nœud, comme le changement d’état d’un nœud de calcul.

creation_time

datetime

Heure de création du pool.

provisioning_state

str ou PoolProvisioningState

État actuel du pool. Les valeurs connues sont « Succeeded » et « Deleting ».

provisioning_state_transition_time

datetime

Heure à laquelle le pool est passé à l'état actuel.

allocation_state

str ou AllocationState

Indique si le pool est en cours de redimensionnement. Les valeurs connues sont « Steady », « Resizing » et « Stopping ».

allocation_state_transition_time

datetime

Heure à laquelle le pool est passé à l'état d'allocation actuel.

vm_size

str

Pour plus d’informations sur les tailles disponibles des machines virtuelles pour les pools Services cloud (pools créés avec cloudServiceConfiguration), consultez Tailles des Services cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch prend en charge toutes les tailles de machine virtuelle Services cloud à l’exception d’ExtraSmall. Pour plus d’informations sur les tailles de machine virtuelle disponibles pour les pools utilisant des images de la Place de marché Machines Virtuelles (pools créés avec virtualMachineConfiguration), consultez Tailles pour Machines Virtuelles (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou Tailles pour Machines Virtuelles (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch prend en charge toutes les tailles de machines virtuelles Azure, à l’exception des STANDARD_A0 et des machines virtuelles avec stockage Premium (STANDARD_GS, STANDARD_DS et série STANDARD_DSV2).

deployment_configuration

DeploymentConfiguration

L’utilisation de CloudServiceConfiguration spécifie que les nœuds doivent être créés à l’aide d’Azure Services cloud (PaaS), tandis que VirtualMachineConfiguration utilise Azure Machines Virtuelles (IaaS).

current_dedicated_nodes

int

Nombre de nœuds de calcul dédiés actuellement dans le pool.

current_low_priority_nodes

int

Nombre de nœuds de calcul spot/basse priorité actuellement dans le pool.

scale_settings

ScaleSettings

Définit la taille souhaitée du pool. Il peut s’agir de « fixedScale » où le targetDedicatedNodes demandé est spécifié, ou de « autoScale » qui définit une formule régulièrement réévaluée. Si cette propriété n’est pas spécifiée, le pool aura une échelle fixe avec 0 targetDedicatedNodes.

auto_scale_run

AutoScaleRun

Cette propriété est définie uniquement si le pool est automatiquement mis à l’échelle, c’est-à-dire si des paramètres de mise à l’échelle automatique sont utilisés.

inter_node_communication

str ou InterNodeCommunicationState

Cela impose des restrictions sur les nœuds qui peuvent être affectés au pool. L’activation de cette valeur peut réduire le risque que le nombre demandé de nœuds soit alloué dans le pool. Si elle n’est pas spécifiée, cette valeur est définie par défaut sur « Disabled ». Les valeurs connues sont « Enabled » et « Disabled ».

network_configuration

NetworkConfiguration

Configuration réseau d’un pool.

task_slots_per_node

int

La valeur par défaut est 1. La valeur maximale est la plus petite de 4 fois le nombre de cœurs du vmSize du pool ou 256.

task_scheduling_policy

TaskSchedulingPolicy

Si elle n’est pas spécifiée, la valeur par défaut est répartie.

user_accounts

list[UserAccount]

Liste des comptes d’utilisateur à créer sur chaque nœud du pool.

metadata

list[MetadataItem]

Le service Batch n’attribue aucune signification aux métadonnées ; il s’agit uniquement de l’utilisation du code utilisateur.

start_task

StartTask

Dans une opération PATCH (mise à jour), cette propriété peut être définie sur un objet vide pour supprimer la tâche de démarrage du pool.

certificates

list[CertificateReference]

Pour les nœuds de calcul Windows, le service Batch installe les certificats dans le magasin de certificats et l’emplacement spécifiés. Pour les nœuds de calcul Linux, les certificats sont stockés dans un répertoire à l’intérieur du répertoire de travail de la tâche et une variable d’environnement AZ_BATCH_CERTIFICATES_DIR est fournie à la tâche pour interroger cet emplacement. Pour les certificats avec une visibilité de « remoteUser », un répertoire « certs » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{nom-utilisateur}/certs) et les certificats sont placés dans ce répertoire.

Avertissement : cette propriété est déconseillée et sera supprimée après février 2024. Utilisez plutôt l’extension Azure KeyVault .

application_packages

list[ApplicationPackageReference]

Les modifications apportées aux références de package d’application affectent tous les nouveaux nœuds de calcul qui rejoignent le pool, mais n’affectent pas les nœuds de calcul qui se trouvent déjà dans le pool tant qu’ils ne sont pas redémarrés ou réinitialisé. Il existe un maximum de 10 références de package d’application sur un pool donné.

application_licenses

list[str]

La liste des licences d’application doit être un sous-ensemble des licences d’application de service Batch disponibles. Si une licence non prise en charge est demandée, la création du pool échoue.

resize_operation_status

ResizeOperationStatus

Décrit l’opération en cours (si le pool AllocationState est redimensionnement) ou l’opération précédemment terminée (si l’État d’allocation est stable).

mount_configuration

list[MountConfiguration]

Cela prend en charge Azure Files, NFS, CIFS/SMB et Blobfuse.

target_node_communication_mode

str ou NodeCommunicationMode

Si elle est omise, la valeur par défaut est Default. Les valeurs connues sont les suivantes : « Default », « Classic » et « Simplified ».

current_node_communication_mode

str ou NodeCommunicationMode

Détermine comment un pool communique avec le service Batch. Les valeurs connues sont les suivantes : « Default », « Classic » et « Simplified ».

resource_tags

dict[str, str]

Balises définies par l’utilisateur à associer au pool de Azure Batch. Quand elles sont spécifiées, ces balises sont propagées aux ressources Azure de stockage associées au pool. Cette propriété ne peut être spécifiée que lorsque le compte Batch a été créé avec la propriété poolAllocationMode définie sur « UserSubscription ».