Microsoft.Batch BatchAccounts/pools 2017-09-01

Article
12/21/2024

Définition de ressource Bicep

Le type de ressource batchAccounts/pools peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Batch/batchAccounts/pools, ajoutez le bicep suivant à votre modèle.

resource symbolicname 'Microsoft.Batch/batchAccounts/pools@2017-09-01' = {
  parent: resourceSymbolicName
  name: 'string'
  properties: {
    applicationLicenses: [
      'string'
    ]
    applicationPackages: [
      {
        id: 'string'
        version: 'string'
      }
    ]
    certificates: [
      {
        id: 'string'
        storeLocation: 'string'
        storeName: 'string'
        visibility: [
          'string'
        ]
      }
    ]
    deploymentConfiguration: {
      cloudServiceConfiguration: {
        currentOSVersion: 'string'
        osFamily: 'string'
        targetOSVersion: 'string'
      }
      virtualMachineConfiguration: {
        dataDisks: [
          {
            caching: 'string'
            diskSizeGB: int
            lun: int
            storageAccountType: 'string'
          }
        ]
        imageReference: {
          id: 'string'
          offer: 'string'
          publisher: 'string'
          sku: 'string'
          version: 'string'
        }
        licenseType: 'string'
        nodeAgentSkuId: 'string'
        osDisk: {
          caching: 'string'
        }
        windowsConfiguration: {
          enableAutomaticUpdates: bool
        }
      }
    }
    displayName: 'string'
    interNodeCommunication: 'string'
    maxTasksPerNode: int
    metadata: [
      {
        name: 'string'
        value: 'string'
      }
    ]
    networkConfiguration: {
      endpointConfiguration: {
        inboundNatPools: [
          {
            backendPort: int
            frontendPortRangeEnd: int
            frontendPortRangeStart: int
            name: 'string'
            networkSecurityGroupRules: [
              {
                access: 'string'
                priority: int
                sourceAddressPrefix: 'string'
              }
            ]
            protocol: 'string'
          }
        ]
      }
      subnetId: 'string'
    }
    scaleSettings: {
      autoScale: {
        evaluationInterval: 'string'
        formula: 'string'
      }
      fixedScale: {
        nodeDeallocationOption: 'string'
        resizeTimeout: 'string'
        targetDedicatedNodes: int
        targetLowPriorityNodes: int
      }
    }
    startTask: {
      commandLine: 'string'
      environmentSettings: [
        {
          name: 'string'
          value: 'string'
        }
      ]
      maxTaskRetryCount: int
      resourceFiles: [
        {
          blobSource: 'string'
          fileMode: 'string'
          filePath: 'string'
        }
      ]
      userIdentity: {
        autoUser: {
          elevationLevel: 'string'
          scope: 'string'
        }
        userName: 'string'
      }
      waitForSuccess: bool
    }
    taskSchedulingPolicy: {
      nodeFillType: 'string'
    }
    userAccounts: [
      {
        elevationLevel: 'string'
        linuxUserConfiguration: {
          gid: int
          sshPrivateKey: 'string'
          uid: int
        }
        name: 'string'
        password: 'string'
      }
    ]
    vmSize: 'string'
  }
}

Valeurs de propriété

ApplicationPackageReference

Nom	Description	Valeur
id	ID du package d’application à installer. Cela doit se trouver dans le même compte batch que le pool. Il peut s’agir d’une référence à une version spécifique ou à la version par défaut s’il en existe une.	chaîne (obligatoire)
Version	Si cela est omis et qu’aucune version par défaut n’est spécifiée pour cette application, la requête échoue avec le code d’erreur InvalidApplicationPackageReferences. Si vous appelez directement l’API REST, le code d’état HTTP est 409.	corde

AutoScaleSettings

Nom	Description	Valeur
evaluationInterval	Si elle est omise, la valeur par défaut est de 15 minutes (PT15M).	corde
formule	Formule pour le nombre souhaité de nœuds de calcul dans le pool.	chaîne (obligatoire)

AutoUserSpecification

Nom	Description	Valeur
elevationLevel	nonAdmin : l’utilisateur automatique est un utilisateur standard sans accès élevé. administrateur : l’utilisateur automatique est un utilisateur disposant d’un accès élevé et fonctionne avec des autorisations d’administrateur complètes. La valeur par défaut n’est pasAdmin.	'Admin' 'NonAdmin'
portée	pool : spécifie que la tâche s’exécute en tant que compte d’utilisateur automatique commun créé sur chaque nœud d’un pool. tâche : spécifie que le service doit créer un utilisateur pour la tâche. La valeur par défaut est la tâche.	'Pool' 'Task'

CertificateReference

Nom	Description	Valeur
id	ID complet du certificat à installer sur le pool. Cela doit se trouver dans le même compte batch que le pool.	chaîne (obligatoire)
storeLocation	La valeur par défaut est currentUser. Cette propriété s’applique uniquement aux pools configurés avec des nœuds Windows (c’est-à-dire créés avec cloudServiceConfiguration ou virtualMachineConfiguration à l’aide d’une référence d’image Windows). 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 visibilité de « remoteUser », un répertoire « certificats » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{user-name}/certs) et les certificats sont placés dans ce répertoire.	'CurrentUser' 'LocalMachine'
storeName	Cette propriété s’applique uniquement aux pools configurés avec des nœuds Windows (c’est-à-dire créés avec cloudServiceConfiguration ou virtualMachineConfiguration à l’aide d’une référence d’image Windows). Les noms de magasin courants sont : My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, mais tout nom de magasin personnalisé peut également être utilisé. La valeur par défaut est My.	corde
visibilité	Les valeurs sont les suivantes : starttask : compte d’utilisateur sous lequel la tâche de démarrage est exécutée. tâche : comptes sous lesquels les tâches de travail sont exécutées. remoteuser : comptes sous lesquels les utilisateurs accèdent à distance au nœud. Vous pouvez spécifier plusieurs visibilités dans cette collection. La valeur par défaut est tous les comptes.	Tableau de chaînes contenant l’un des éléments suivants : 'RemoteUser' 'StartTask' 'Task'

CloudServiceConfiguration

Nom	Description	Valeur
currentOSVersion	Cela peut différer de targetOSVersion si l’état du pool est mis à niveau. Dans ce cas, certaines machines virtuelles peuvent se trouver sur targetOSVersion et certaines peuvent se trouver sur currentOSVersion pendant le processus de mise à niveau. Une fois toutes les machines virtuelles mises à niveau, currentOSVersion est mis à jour pour être identique à targetOSVersion.	corde
osFamily	Les valeurs possibles sont : 2 - Famille de système d’exploitation 2, équivalente à Windows Server 2008 R2 SP1. 3 - Famille de systèmes d’exploitation 3, équivalent à Windows Server 2012. 4 - Famille de système d’exploitation 4, équivalente à Windows Server 2012 R2. 5 - Famille de systèmes d’exploitation 5, équivalent à Windows Server 2016. Pour plus d’informations, consultez Versions du système d’exploitation invité Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).	chaîne (obligatoire)
targetOSVersion	La valeur par défaut est * qui spécifie la dernière version du système d’exploitation pour la famille de systèmes d’exploitation spécifiée.	corde

DataDisk

Nom	Description	Valeur
Cache	Les valeurs sont les suivantes : none : le mode de mise en cache du disque n’est pas activé. readOnly : le mode de mise en cache du disque est en lecture seule. readWrite : le mode de mise en cache du disque est en lecture et en écriture. La valeur par défaut de la mise en cache n’est pas. Pour plus d’informations sur les options de mise en cache, consultez : https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	'None' 'ReadOnly' 'ReadWrite'
diskSizeGB	Taille initiale du disque en Go lors de la création d’un disque de données.	int (obligatoire)
lun	Le lun est utilisé pour identifier de manière unique chaque disque de données. Si vous attachez plusieurs disques, chacun doit avoir un lun distinct.	int (obligatoire)
storageAccountType	S’il est omis, la valeur par défaut est « Standard_LRS ». Les valeurs sont les suivantes : Standard_LRS : le disque de données doit utiliser un stockage standard localement redondant. Premium_LRS : le disque de données doit utiliser un stockage premium localement redondant.	'Premium_LRS' 'Standard_LRS'

DeploymentConfiguration

Nom	Description	Valeur
cloudServiceConfiguration	Cette propriété et virtualMachineConfiguration s’excluent mutuellement et l’une des propriétés doit être spécifiée. Cette propriété ne peut pas être spécifiée si le compte Batch a été créé avec sa propriété poolAllocationMode définie sur « UserSubscription ».	cloudServiceConfiguration
virtualMachineConfiguration	Cette propriété et cloudServiceConfiguration s’excluent mutuellement et l’une des propriétés doit être spécifiée.	VirtualMachineConfiguration

EnvironmentSetting

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	chaîne (obligatoire)
valeur	Valeur de la variable d’environnement.	corde

FixedScaleSettings

Nom	Description	Valeur
nodeDeallocationOption	Si elle est omise, la valeur par défaut est Requeue.	'Requeue' 'RetainedData' 'TaskCompletion' 'Terminate'
resizeTimeout	La valeur par défaut est de 15 minutes. Les valeurs de délai d’expiration utilisent le format ISO 8601. Par exemple, utilisez PT10M pendant 10 minutes. La valeur minimale est de 5 minutes. Si vous spécifiez une valeur inférieure à 5 minutes, le service Batch rejette la demande avec une erreur ; si vous appelez directement l’API REST, le code d’état HTTP est 400 (requête incorrecte).	corde
targetDedicatedNodes	Au moins un des nœuds targetDedicatedNodes, les nœuds targetLowPriority doivent être définis.	Int
targetLowPriorityNodes	Au moins un des nœuds targetDedicatedNodes, les nœuds targetLowPriority doivent être définis.	Int

ImageReference

Nom	Description	Valeur
id	Cette propriété s’exclue mutuellement avec d’autres propriétés. L’image de machine virtuelle doit se trouver dans la même région et dans le même abonnement que le compte Azure Batch. Pour plus d’informations sur les paramètres de pare-feu pour que l’agent de nœud Batch communique avec le service Batch, consultez /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration .	corde
offrir	Par exemple, UbuntuServer ou WindowsServer.	corde
éditeur	Par exemple, Canonical ou MicrosoftWindowsServer.	corde
Sku	Par exemple, 14.04.0-LTS ou 2012-R2-Datacenter.	corde
Version	Vous pouvez spécifier la valeur « latest » pour sélectionner la dernière version d’une image. S’il est omis, la valeur par défaut est « latest ».	corde

InboundNatPool

Nom	Description	Valeur
backendPort	Cela doit être unique dans un pool Batch. Les valeurs acceptables sont comprises entre 1 et 65535, à l’exception de 22, 3389, 29876 et 29877, car elles sont réservées. Si des valeurs réservées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
frontendPortRangeEnd	Les valeurs acceptables sont comprises entre 1 et 65534, à l’exception des ports compris entre 5 000 et 55 000, qui sont réservés par le service Batch. Toutes les plages d’un pool doivent être distinctes et ne peuvent pas se chevaucher. Si des valeurs réservées ou superposées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
frontendPortRangeStart	Les valeurs acceptables sont comprises entre 1 et 65534, à l’exception des ports compris entre 50000 et 55000, qui sont réservés. Toutes les plages d’un pool doivent être distinctes et ne peuvent pas se chevaucher. Si des valeurs réservées ou superposées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
nom	Le nom doit être unique dans un pool Batch, peut contenir des lettres, des chiffres, des traits de soulignement, des points et des traits d’union. Les noms doivent commencer par une lettre ou un nombre, doivent se terminer par une lettre, un nombre ou un trait de soulignement, et ne peuvent pas dépasser 77 caractères. Si des valeurs non valides sont fournies, la requête échoue avec le code d’état HTTP 400.	chaîne (obligatoire)
networkSecurityGroupRules	Le nombre maximal de règles qui peuvent être spécifiées sur tous les points de terminaison d’un pool Batch est de 25. Si aucune règle de groupe de sécurité réseau n’est spécifiée, une règle par défaut est créée pour autoriser l’accès entrant au backendPort spécifié. Si le nombre maximal de règles de groupe de sécurité réseau est dépassé, la requête échoue avec le code d’état HTTP 400.	NetworkSecurityGroupRule[]
protocole	Protocole du point de terminaison.	'TCP' 'UDP' (obligatoire)

LinuxUserConfiguration

Nom	Description	Valeur
Gid	Les propriétés uid et gid doivent être spécifiées ensemble ou pas du tout. Si le système d’exploitation sous-jacent n’est pas spécifié, le gid est sélectionné.	Int
sshPrivateKey	La clé privée ne doit pas être protégée par mot de passe. La clé privée est utilisée pour configurer automatiquement l’authentification basée sur une clé asymétrique pour SSH entre les nœuds d’un pool Linux lorsque la propriété enableInterNodeCommunication du pool est true (elle est ignorée si enableInterNodeCommunication est false). Pour ce faire, placez la paire de clés dans le répertoire .ssh de l’utilisateur. S’il n’est pas spécifié, ssh sans mot de passe n’est pas configuré entre les nœuds (aucune modification du répertoire .ssh de l’utilisateur est effectuée).	corde
Uid	Les propriétés uid et gid doivent être spécifiées ensemble ou pas du tout. S’il n’est pas spécifié, le système d’exploitation sous-jacent sélectionne l’interface utilisateur.	Int

MetadataItem

Nom	Description	Valeur
nom	Nom de l’élément de métadonnées.	chaîne (obligatoire)
valeur	Valeur de l’élément de métadonnées.	chaîne (obligatoire)

Microsoft.Batch/batchAccounts/pools

Nom	Description	Valeur
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 1 Longueur maximale = 1 Modèle = `^[a-zA-Z0-9_-]+$` (obligatoire)
parent	Dans Bicep, vous pouvez spécifier la ressource parente d’une ressource enfant. Vous devez uniquement ajouter cette propriété lorsque la ressource enfant est déclarée en dehors de la ressource parente. Pour plus d’informations, consultez ressource enfant en dehors de la ressource parente.	Nom symbolique de la ressource de type : batchAccounts
Propriétés	Propriétés associées au pool.	PoolProperties

NetworkConfiguration

Nom	Description	Valeur
endpointConfiguration	La configuration du point de terminaison de pool est prise en charge uniquement sur les pools avec la propriété virtualMachineConfiguration.	PoolEndpointConfiguration
subnetId	Le réseau virtuel doit se trouver dans la même région et dans le même abonnement que le compte Azure Batch. Le sous-réseau spécifié doit avoir suffisamment d’adresses IP libres pour prendre en charge le nombre de nœuds dans le pool. Si le sous-réseau n’a pas suffisamment d’adresses IP libres, le pool alloue partiellement des nœuds de calcul et une erreur de redimensionnement se produit. Le principal de service « MicrosoftAzureBatch » doit avoir le rôle « Contributeur de machine virtuelle classique » Role-Based Contrôle d’accès (RBAC) pour le réseau virtuel spécifié. Le sous-réseau spécifié doit autoriser la communication du service Azure Batch à planifier des tâches sur les nœuds de calcul. Cela peut être vérifié en vérifiant si le réseau virtuel spécifié a des groupes de sécurité réseau (NSG) associés. Si la communication aux nœuds de calcul dans le sous-réseau spécifié est refusée par un groupe de sécurité réseau, le service Batch définit l’état des nœuds de calcul sur inutilisable. Pour les pools créés via virtualMachineConfiguration, le compte Batch doit avoir poolAllocationMode userSubscription pour utiliser un réseau virtuel. Si le réseau virtuel spécifié a des groupes de sécurité réseau (NSG) associés, quelques ports système réservés doivent être activés pour la communication entrante. Pour les pools créés avec une configuration de machine virtuelle, activez les ports 29876 et 29877, ainsi que le port 22 pour Linux et le port 3389 pour Windows. Pour les pools créés avec une configuration de service cloud, activez les ports 10100, 20100 et 30100. Activez également les connexions sortantes au stockage Azure sur le port 443. Pour plus d’informations, consultez : /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration	corde

NetworkSecurityGroupRule

Nom	Description	Valeur
accès	Action qui doit être effectuée pour une adresse IP, une plage de sous-réseaux ou une balise spécifiée.	'Autoriser' 'Deny' (obligatoire)
priorité	Les priorités au sein d’un pool doivent être uniques et sont évaluées par ordre de priorité. Plus le nombre est faible, plus la priorité est élevée. Par exemple, les règles peuvent être spécifiées avec des numéros de commande de 150, 250 et 350. La règle avec le numéro d’ordre de 150 est prioritaire sur la règle dont l’ordre est de 250. Les priorités autorisées sont de 150 à 3500. Si des valeurs réservées ou dupliquées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
sourceAddressPrefix	Les valeurs valides sont une seule adresse IP (c’est-à-dire 10.10.10.10), un sous-réseau IP (par exemple, 192.168.1.0/24), une balise par défaut ou * (pour toutes les adresses). Si d’autres valeurs sont fournies, la requête échoue avec le code d’état HTTP 400.	chaîne (obligatoire)

OSDisk

Nom	Description	Valeur
Cache	La valeur par défaut n’est aucune.	'None' 'ReadOnly' 'ReadWrite'

PoolEndpointConfiguration

Nom	Description	Valeur
inboundNatPools	Le nombre maximal de pools NAT entrants par pool Batch est de 5. Si le nombre maximal de pools NAT entrants est dépassé, la requête échoue avec le code d’état HTTP 400.	inboundNatPool[] (obligatoire)

PoolProperties

Nom	Description	Valeur
applicationLicenses	La liste des licences d’application doit être un sous-ensemble de licences d’application de service Batch disponibles. Si une licence n’est pas prise en charge, la création du pool échoue.	string[]
applicationPackages	Les modifications apportées aux packages 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 reimages.	applicationPackageReference[]
Certificats	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 visibilité de « remoteUser », un répertoire « certificats » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{user-name}/certs) et les certificats sont placés dans ce répertoire.	CertificateReference[]
deploymentConfiguration	L’utilisation de CloudServiceConfiguration spécifie que les nœuds doivent être créés à l’aide d’Azure Cloud Services (PaaS), tandis que VirtualMachineConfiguration utilise des machines virtuelles Azure (IaaS).	DeploymentConfiguration
displayName	Le nom complet n’a pas besoin d’être unique et peut contenir des caractères Unicode pouvant atteindre une longueur maximale de 1024.	corde
interNodeCommunication	Cela impose des restrictions sur les nœuds qui peuvent être affectés au pool. L’activation de cette valeur peut réduire le nombre de nœuds demandé à allouer dans le pool. Si elle n’est pas spécifiée, cette valeur est définie par défaut sur « Disabled ».	'Désactivé' 'Activé'
maxTasksPerNode	Nombre maximal de tâches qui peuvent s’exécuter simultanément sur un nœud de calcul unique dans le pool.	Int
métadonnées	Le service Batch n’affecte aucune signification aux métadonnées ; il s’agit uniquement de l’utilisation du code utilisateur.	MetadataItem[]
networkConfiguration	Configuration réseau d’un pool.	networkConfiguration
scaleSettings	Définit la taille souhaitée du pool. Il peut s’agir de « fixedScale » où les targetDedicatedNodes demandés sont spécifiés, ou « autoScale » qui définit une formule qui est 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.	scaleSettings
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.	startTask
taskSchedulingPolicy	Spécifie la façon dont les tâches doivent être distribuées entre les nœuds de calcul.	TaskSchedulingPolicy
userAccounts	Liste des comptes d’utilisateur à créer sur chaque nœud du pool.	UserAccount[]
vmSize	Pour plus d’informations sur les tailles disponibles de machines virtuelles pour les pools de services cloud (pools créés avec cloudServiceConfiguration), consultez Tailles pour les services cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch prend en charge toutes les tailles de machine virtuelle cloud Services, à l’exception d’ExtraSmall. Pour plus d’informations sur les tailles de machines virtuelles disponibles pour les pools utilisant des images de la Place de marché des machines virtuelles (pools créés avec virtualMachineConfiguration) consultez Tailles pour les machines virtuelles (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou tailles pour les machines virtuelles (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch prend en charge toutes les tailles de machine virtuelle Azure, à l’exception des STANDARD_A0 et celles avec stockage Premium (STANDARD_GS, STANDARD_DS et série STANDARD_DSV2).	corde

ResourceFile

Nom	Description	Valeur
blobSource	Cette URL doit être lisible à l’aide de l’accès anonyme ; autrement dit, le service Batch ne présente aucune information d’identification lors du téléchargement de l’objet blob. Il existe deux façons d’obtenir cette URL pour un objet blob dans le stockage Azure : incluez une signature d’accès partagé (SAP) accordant des autorisations de lecture sur l’objet blob, ou définissez la liste de contrôle d’accès pour l’objet blob ou son conteneur afin d’autoriser l’accès public.	chaîne (obligatoire)
fileMode	Cette propriété s’applique uniquement aux fichiers téléchargés sur des nœuds de calcul Linux. Il sera ignoré s’il est spécifié pour un resourceFile qui sera téléchargé sur un nœud Windows. Si cette propriété n’est pas spécifiée pour un nœud Linux, la valeur par défaut 0770 est appliquée au fichier.	corde
filePath	Emplacement sur le nœud de calcul auquel télécharger le fichier, par rapport au répertoire de travail de la tâche.	chaîne (obligatoire)

ScaleSettings

Nom	Description	Valeur
mise à l’échelle automatique	Cette propriété et fixedScale s’excluent mutuellement et l’une des propriétés doit être spécifiée.	AutoScaleSettings
fixedScale	Cette propriété et cette mise à l’échelle automatique sont mutuellement exclusives et l’une des propriétés doit être spécifiée.	fixedScaleSettings

StartTask

Nom	Description	Valeur
commandLine	La ligne de commande ne s’exécute pas sous un interpréteur de commandes et ne peut donc pas tirer parti des fonctionnalités de l’interpréteur de commandes telles que l’extension de variable d’environnement. Si vous souhaitez tirer parti de ces fonctionnalités, vous devez appeler l’interpréteur de commandes dans la ligne de commande, par exemple en utilisant « cmd /c MyCommand » dans Windows ou « /bin/sh -c MyCommand » dans Linux. Obligatoire si d’autres propriétés de startTask sont spécifiées.	corde
environmentSettings	Liste des paramètres de variable d’environnement pour la tâche de démarrage.	EnvironmentSetting[]
maxTaskRetryCount	Le service Batch retente une tâche si son code de sortie n’est pas différent de zéro. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch essaie la tâche une fois, puis peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est égal à 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est égal à 0, le service Batch ne réessaye pas la tâche. Si le nombre maximal de nouvelles tentatives est -1, le service Batch retente la tâche sans limite.	Int
resourceFiles	Liste des fichiers que le service Batch télécharge sur le nœud de calcul avant d’exécuter la ligne de commande.	ResourceFile[]
userIdentity	Si elle est omise, la tâche s’exécute en tant qu’utilisateur non administratif unique à la tâche.	userIdentity
waitForSuccess	Si la valeur est true et que la tâche de démarrage échoue sur un nœud de calcul, le service Batch retente la tâche de démarrage jusqu’à son nombre maximal de nouvelles tentatives (maxTaskRetryCount). Si la tâche n’est toujours pas terminée après toutes les nouvelles tentatives, le service Batch marque le nœud de calcul inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via l’état du nœud et la planification des détails d’erreur. Si la valeur est false, le service Batch n’attend pas la fin de la tâche de démarrage. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant que la tâche de démarrage est toujours en cours d’exécution ; et même si la tâche de démarrage échoue, les nouvelles tâches continueront d’être planifiées sur le nœud. La valeur par défaut est false.	Bool

TaskSchedulingPolicy

Nom	Description	Valeur
nodeFillType	Comment les tâches doivent être distribuées entre les nœuds de calcul.	'Pack' 'Spread' (obligatoire)

UserAccount

Nom	Description	Valeur
elevationLevel	nonAdmin : l’utilisateur automatique est un utilisateur standard sans accès élevé. administrateur : l’utilisateur automatique est un utilisateur disposant d’un accès élevé et fonctionne avec des autorisations d’administrateur complètes. La valeur par défaut n’est pasAdmin.	'Admin' 'NonAdmin'
linuxUserConfiguration	Cette propriété est ignorée si elle est spécifiée sur un pool Windows. S’il n’est pas spécifié, l’utilisateur est créé avec les options par défaut.	LinuxUserConfiguration
nom	Nom du compte d’utilisateur.	chaîne (obligatoire)
mot de passe	Mot de passe du compte d’utilisateur.	chaîne (obligatoire)

UserIdentity

Nom	Description	Valeur
autoUser	Les propriétés userName et autoUser s’excluent mutuellement ; vous devez en spécifier un, mais pas les deux.	AutoUserSpecification
nom d’utilisateur	Les propriétés userName et autoUser s’excluent mutuellement ; vous devez en spécifier un, mais pas les deux.	corde

VirtualMachineConfiguration

Nom	Description	Valeur
dataDisks	Cette propriété doit être spécifiée si les nœuds de calcul du pool doivent avoir des disques de données vides attachés.	DataDisk[]
imageReference	Référence à une image de la Place de marché des machines virtuelles Azure ou à la ressource Image Azure d’une machine virtuelle personnalisée. Pour obtenir la liste de toutes les images Vérifiées par Azure Batch, consultez l’opération « Répertorier les références SKU de l’agent de nœud prises en charge ».	ImageReference (obligatoire)
licenseType	Cela s’applique uniquement aux images qui contiennent le système d’exploitation Windows et ne doivent être utilisées que lorsque vous conservez des licences locales valides pour les nœuds qui seront déployés. En cas d’omission, aucune remise de licence locale n’est appliquée. Les valeurs sont les suivantes : Windows_Server : la licence locale est destinée à Windows Server. Windows_Client : la licence locale est destinée au client Windows.	corde
nodeAgentSkuId	L’agent de nœud Batch est un programme qui s’exécute sur chaque nœud du pool et fournit l’interface de commande et de contrôle entre le nœud et le service Batch. Il existe différentes implémentations de l’agent de nœud, appelées références SKU, pour différents systèmes d’exploitation. Vous devez spécifier une référence SKU de l’agent de nœud qui correspond à la référence d’image sélectionnée. Pour obtenir la liste des références SKU de l’agent de nœud prises en charge, ainsi que leur liste de références d’images vérifiées, consultez l’opération « Répertorier les références SKU de l’agent de nœud prises en charge ».	chaîne (obligatoire)
osDisk	Paramètres du disque du système d’exploitation de la machine virtuelle.	osDisk
windowsConfiguration	Cette propriété ne doit pas être spécifiée si l’imageReference spécifie une image de système d’exploitation Linux.	windowsConfiguration

WindowsConfiguration

Nom	Description	Valeur
enableAutomaticUpdates	Si elle est omise, la valeur par défaut est true.	Bool

Exemples de démarrage rapide

Les exemples de démarrage rapide suivants déploient ce type de ressource.

Fichier Bicep	Description
pool Azure Batch sans adresses IP publiques	Ce modèle crée un pool de communications de nœud simplifié Azure Batch sans adresses IP publiques.

Définition de ressource de modèle ARM

Le type de ressource batchAccounts/pools peut être déployé avec des opérations qui ciblent :

groupes de ressources - Consultez commandes de déploiement de groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Batch/batchAccounts/pools, ajoutez le code JSON suivant à votre modèle.

{
  "type": "Microsoft.Batch/batchAccounts/pools",
  "apiVersion": "2017-09-01",
  "name": "string",
  "properties": {
    "applicationLicenses": [ "string" ],
    "applicationPackages": [
      {
        "id": "string",
        "version": "string"
      }
    ],
    "certificates": [
      {
        "id": "string",
        "storeLocation": "string",
        "storeName": "string",
        "visibility": [ "string" ]
      }
    ],
    "deploymentConfiguration": {
      "cloudServiceConfiguration": {
        "currentOSVersion": "string",
        "osFamily": "string",
        "targetOSVersion": "string"
      },
      "virtualMachineConfiguration": {
        "dataDisks": [
          {
            "caching": "string",
            "diskSizeGB": "int",
            "lun": "int",
            "storageAccountType": "string"
          }
        ],
        "imageReference": {
          "id": "string",
          "offer": "string",
          "publisher": "string",
          "sku": "string",
          "version": "string"
        },
        "licenseType": "string",
        "nodeAgentSkuId": "string",
        "osDisk": {
          "caching": "string"
        },
        "windowsConfiguration": {
          "enableAutomaticUpdates": "bool"
        }
      }
    },
    "displayName": "string",
    "interNodeCommunication": "string",
    "maxTasksPerNode": "int",
    "metadata": [
      {
        "name": "string",
        "value": "string"
      }
    ],
    "networkConfiguration": {
      "endpointConfiguration": {
        "inboundNatPools": [
          {
            "backendPort": "int",
            "frontendPortRangeEnd": "int",
            "frontendPortRangeStart": "int",
            "name": "string",
            "networkSecurityGroupRules": [
              {
                "access": "string",
                "priority": "int",
                "sourceAddressPrefix": "string"
              }
            ],
            "protocol": "string"
          }
        ]
      },
      "subnetId": "string"
    },
    "scaleSettings": {
      "autoScale": {
        "evaluationInterval": "string",
        "formula": "string"
      },
      "fixedScale": {
        "nodeDeallocationOption": "string",
        "resizeTimeout": "string",
        "targetDedicatedNodes": "int",
        "targetLowPriorityNodes": "int"
      }
    },
    "startTask": {
      "commandLine": "string",
      "environmentSettings": [
        {
          "name": "string",
          "value": "string"
        }
      ],
      "maxTaskRetryCount": "int",
      "resourceFiles": [
        {
          "blobSource": "string",
          "fileMode": "string",
          "filePath": "string"
        }
      ],
      "userIdentity": {
        "autoUser": {
          "elevationLevel": "string",
          "scope": "string"
        },
        "userName": "string"
      },
      "waitForSuccess": "bool"
    },
    "taskSchedulingPolicy": {
      "nodeFillType": "string"
    },
    "userAccounts": [
      {
        "elevationLevel": "string",
        "linuxUserConfiguration": {
          "gid": "int",
          "sshPrivateKey": "string",
          "uid": "int"
        },
        "name": "string",
        "password": "string"
      }
    ],
    "vmSize": "string"
  }
}

Valeurs de propriété

ApplicationPackageReference

Nom	Description	Valeur
id	ID du package d’application à installer. Cela doit se trouver dans le même compte batch que le pool. Il peut s’agir d’une référence à une version spécifique ou à la version par défaut s’il en existe une.	chaîne (obligatoire)
Version	Si cela est omis et qu’aucune version par défaut n’est spécifiée pour cette application, la requête échoue avec le code d’erreur InvalidApplicationPackageReferences. Si vous appelez directement l’API REST, le code d’état HTTP est 409.	corde

AutoScaleSettings

Nom	Description	Valeur
evaluationInterval	Si elle est omise, la valeur par défaut est de 15 minutes (PT15M).	corde
formule	Formule pour le nombre souhaité de nœuds de calcul dans le pool.	chaîne (obligatoire)

AutoUserSpecification

Nom	Description	Valeur
elevationLevel	nonAdmin : l’utilisateur automatique est un utilisateur standard sans accès élevé. administrateur : l’utilisateur automatique est un utilisateur disposant d’un accès élevé et fonctionne avec des autorisations d’administrateur complètes. La valeur par défaut n’est pasAdmin.	'Admin' 'NonAdmin'
portée	pool : spécifie que la tâche s’exécute en tant que compte d’utilisateur automatique commun créé sur chaque nœud d’un pool. tâche : spécifie que le service doit créer un utilisateur pour la tâche. La valeur par défaut est la tâche.	'Pool' 'Task'

CertificateReference

Nom	Description	Valeur
id	ID complet du certificat à installer sur le pool. Cela doit se trouver dans le même compte batch que le pool.	chaîne (obligatoire)
storeLocation	La valeur par défaut est currentUser. Cette propriété s’applique uniquement aux pools configurés avec des nœuds Windows (c’est-à-dire créés avec cloudServiceConfiguration ou virtualMachineConfiguration à l’aide d’une référence d’image Windows). 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 visibilité de « remoteUser », un répertoire « certificats » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{user-name}/certs) et les certificats sont placés dans ce répertoire.	'CurrentUser' 'LocalMachine'
storeName	Cette propriété s’applique uniquement aux pools configurés avec des nœuds Windows (c’est-à-dire créés avec cloudServiceConfiguration ou virtualMachineConfiguration à l’aide d’une référence d’image Windows). Les noms de magasin courants sont : My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, mais tout nom de magasin personnalisé peut également être utilisé. La valeur par défaut est My.	corde
visibilité	Les valeurs sont les suivantes : starttask : compte d’utilisateur sous lequel la tâche de démarrage est exécutée. tâche : comptes sous lesquels les tâches de travail sont exécutées. remoteuser : comptes sous lesquels les utilisateurs accèdent à distance au nœud. Vous pouvez spécifier plusieurs visibilités dans cette collection. La valeur par défaut est tous les comptes.	Tableau de chaînes contenant l’un des éléments suivants : 'RemoteUser' 'StartTask' 'Task'

CloudServiceConfiguration

Nom	Description	Valeur
currentOSVersion	Cela peut différer de targetOSVersion si l’état du pool est mis à niveau. Dans ce cas, certaines machines virtuelles peuvent se trouver sur targetOSVersion et certaines peuvent se trouver sur currentOSVersion pendant le processus de mise à niveau. Une fois toutes les machines virtuelles mises à niveau, currentOSVersion est mis à jour pour être identique à targetOSVersion.	corde
osFamily	Les valeurs possibles sont : 2 - Famille de système d’exploitation 2, équivalente à Windows Server 2008 R2 SP1. 3 - Famille de systèmes d’exploitation 3, équivalent à Windows Server 2012. 4 - Famille de système d’exploitation 4, équivalente à Windows Server 2012 R2. 5 - Famille de systèmes d’exploitation 5, équivalent à Windows Server 2016. Pour plus d’informations, consultez Versions du système d’exploitation invité Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).	chaîne (obligatoire)
targetOSVersion	La valeur par défaut est * qui spécifie la dernière version du système d’exploitation pour la famille de systèmes d’exploitation spécifiée.	corde

DataDisk

Nom	Description	Valeur
Cache	Les valeurs sont les suivantes : none : le mode de mise en cache du disque n’est pas activé. readOnly : le mode de mise en cache du disque est en lecture seule. readWrite : le mode de mise en cache du disque est en lecture et en écriture. La valeur par défaut de la mise en cache n’est pas. Pour plus d’informations sur les options de mise en cache, consultez : https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	'None' 'ReadOnly' 'ReadWrite'
diskSizeGB	Taille initiale du disque en Go lors de la création d’un disque de données.	int (obligatoire)
lun	Le lun est utilisé pour identifier de manière unique chaque disque de données. Si vous attachez plusieurs disques, chacun doit avoir un lun distinct.	int (obligatoire)
storageAccountType	S’il est omis, la valeur par défaut est « Standard_LRS ». Les valeurs sont les suivantes : Standard_LRS : le disque de données doit utiliser un stockage standard localement redondant. Premium_LRS : le disque de données doit utiliser un stockage premium localement redondant.	'Premium_LRS' 'Standard_LRS'

DeploymentConfiguration

Nom	Description	Valeur
cloudServiceConfiguration	Cette propriété et virtualMachineConfiguration s’excluent mutuellement et l’une des propriétés doit être spécifiée. Cette propriété ne peut pas être spécifiée si le compte Batch a été créé avec sa propriété poolAllocationMode définie sur « UserSubscription ».	cloudServiceConfiguration
virtualMachineConfiguration	Cette propriété et cloudServiceConfiguration s’excluent mutuellement et l’une des propriétés doit être spécifiée.	VirtualMachineConfiguration

EnvironmentSetting

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	chaîne (obligatoire)
valeur	Valeur de la variable d’environnement.	corde

FixedScaleSettings

Nom	Description	Valeur
nodeDeallocationOption	Si elle est omise, la valeur par défaut est Requeue.	'Requeue' 'RetainedData' 'TaskCompletion' 'Terminate'
resizeTimeout	La valeur par défaut est de 15 minutes. Les valeurs de délai d’expiration utilisent le format ISO 8601. Par exemple, utilisez PT10M pendant 10 minutes. La valeur minimale est de 5 minutes. Si vous spécifiez une valeur inférieure à 5 minutes, le service Batch rejette la demande avec une erreur ; si vous appelez directement l’API REST, le code d’état HTTP est 400 (requête incorrecte).	corde
targetDedicatedNodes	Au moins un des nœuds targetDedicatedNodes, les nœuds targetLowPriority doivent être définis.	Int
targetLowPriorityNodes	Au moins un des nœuds targetDedicatedNodes, les nœuds targetLowPriority doivent être définis.	Int

ImageReference

Nom	Description	Valeur
id	Cette propriété s’exclue mutuellement avec d’autres propriétés. L’image de machine virtuelle doit se trouver dans la même région et dans le même abonnement que le compte Azure Batch. Pour plus d’informations sur les paramètres de pare-feu pour que l’agent de nœud Batch communique avec le service Batch, consultez /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration .	corde
offrir	Par exemple, UbuntuServer ou WindowsServer.	corde
éditeur	Par exemple, Canonical ou MicrosoftWindowsServer.	corde
Sku	Par exemple, 14.04.0-LTS ou 2012-R2-Datacenter.	corde
Version	Vous pouvez spécifier la valeur « latest » pour sélectionner la dernière version d’une image. S’il est omis, la valeur par défaut est « latest ».	corde

InboundNatPool

Nom	Description	Valeur
backendPort	Cela doit être unique dans un pool Batch. Les valeurs acceptables sont comprises entre 1 et 65535, à l’exception de 22, 3389, 29876 et 29877, car elles sont réservées. Si des valeurs réservées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
frontendPortRangeEnd	Les valeurs acceptables sont comprises entre 1 et 65534, à l’exception des ports compris entre 5 000 et 55 000, qui sont réservés par le service Batch. Toutes les plages d’un pool doivent être distinctes et ne peuvent pas se chevaucher. Si des valeurs réservées ou superposées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
frontendPortRangeStart	Les valeurs acceptables sont comprises entre 1 et 65534, à l’exception des ports compris entre 50000 et 55000, qui sont réservés. Toutes les plages d’un pool doivent être distinctes et ne peuvent pas se chevaucher. Si des valeurs réservées ou superposées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
nom	Le nom doit être unique dans un pool Batch, peut contenir des lettres, des chiffres, des traits de soulignement, des points et des traits d’union. Les noms doivent commencer par une lettre ou un nombre, doivent se terminer par une lettre, un nombre ou un trait de soulignement, et ne peuvent pas dépasser 77 caractères. Si des valeurs non valides sont fournies, la requête échoue avec le code d’état HTTP 400.	chaîne (obligatoire)
networkSecurityGroupRules	Le nombre maximal de règles qui peuvent être spécifiées sur tous les points de terminaison d’un pool Batch est de 25. Si aucune règle de groupe de sécurité réseau n’est spécifiée, une règle par défaut est créée pour autoriser l’accès entrant au backendPort spécifié. Si le nombre maximal de règles de groupe de sécurité réseau est dépassé, la requête échoue avec le code d’état HTTP 400.	NetworkSecurityGroupRule[]
protocole	Protocole du point de terminaison.	'TCP' 'UDP' (obligatoire)

LinuxUserConfiguration

Nom	Description	Valeur
Gid	Les propriétés uid et gid doivent être spécifiées ensemble ou pas du tout. Si le système d’exploitation sous-jacent n’est pas spécifié, le gid est sélectionné.	Int
sshPrivateKey	La clé privée ne doit pas être protégée par mot de passe. La clé privée est utilisée pour configurer automatiquement l’authentification basée sur une clé asymétrique pour SSH entre les nœuds d’un pool Linux lorsque la propriété enableInterNodeCommunication du pool est true (elle est ignorée si enableInterNodeCommunication est false). Pour ce faire, placez la paire de clés dans le répertoire .ssh de l’utilisateur. S’il n’est pas spécifié, ssh sans mot de passe n’est pas configuré entre les nœuds (aucune modification du répertoire .ssh de l’utilisateur est effectuée).	corde
Uid	Les propriétés uid et gid doivent être spécifiées ensemble ou pas du tout. S’il n’est pas spécifié, le système d’exploitation sous-jacent sélectionne l’interface utilisateur.	Int

MetadataItem

Nom	Description	Valeur
nom	Nom de l’élément de métadonnées.	chaîne (obligatoire)
valeur	Valeur de l’élément de métadonnées.	chaîne (obligatoire)

Microsoft.Batch/batchAccounts/pools

Nom	Description	Valeur
apiVersion	Version de l’API	'2017-09-01'
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 1 Longueur maximale = 1 Modèle = `^[a-zA-Z0-9_-]+$` (obligatoire)
Propriétés	Propriétés associées au pool.	PoolProperties
type	Type de ressource	'Microsoft.Batch/batchAccounts/pools'

NetworkConfiguration

Nom	Description	Valeur
endpointConfiguration	La configuration du point de terminaison de pool est prise en charge uniquement sur les pools avec la propriété virtualMachineConfiguration.	PoolEndpointConfiguration
subnetId	Le réseau virtuel doit se trouver dans la même région et dans le même abonnement que le compte Azure Batch. Le sous-réseau spécifié doit avoir suffisamment d’adresses IP libres pour prendre en charge le nombre de nœuds dans le pool. Si le sous-réseau n’a pas suffisamment d’adresses IP libres, le pool alloue partiellement des nœuds de calcul et une erreur de redimensionnement se produit. Le principal de service « MicrosoftAzureBatch » doit avoir le rôle « Contributeur de machine virtuelle classique » Role-Based Contrôle d’accès (RBAC) pour le réseau virtuel spécifié. Le sous-réseau spécifié doit autoriser la communication du service Azure Batch à planifier des tâches sur les nœuds de calcul. Cela peut être vérifié en vérifiant si le réseau virtuel spécifié a des groupes de sécurité réseau (NSG) associés. Si la communication aux nœuds de calcul dans le sous-réseau spécifié est refusée par un groupe de sécurité réseau, le service Batch définit l’état des nœuds de calcul sur inutilisable. Pour les pools créés via virtualMachineConfiguration, le compte Batch doit avoir poolAllocationMode userSubscription pour utiliser un réseau virtuel. Si le réseau virtuel spécifié a des groupes de sécurité réseau (NSG) associés, quelques ports système réservés doivent être activés pour la communication entrante. Pour les pools créés avec une configuration de machine virtuelle, activez les ports 29876 et 29877, ainsi que le port 22 pour Linux et le port 3389 pour Windows. Pour les pools créés avec une configuration de service cloud, activez les ports 10100, 20100 et 30100. Activez également les connexions sortantes au stockage Azure sur le port 443. Pour plus d’informations, consultez : /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration	corde

NetworkSecurityGroupRule

Nom	Description	Valeur
accès	Action qui doit être effectuée pour une adresse IP, une plage de sous-réseaux ou une balise spécifiée.	'Autoriser' 'Deny' (obligatoire)
priorité	Les priorités au sein d’un pool doivent être uniques et sont évaluées par ordre de priorité. Plus le nombre est faible, plus la priorité est élevée. Par exemple, les règles peuvent être spécifiées avec des numéros de commande de 150, 250 et 350. La règle avec le numéro d’ordre de 150 est prioritaire sur la règle dont l’ordre est de 250. Les priorités autorisées sont de 150 à 3500. Si des valeurs réservées ou dupliquées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
sourceAddressPrefix	Les valeurs valides sont une seule adresse IP (c’est-à-dire 10.10.10.10), un sous-réseau IP (par exemple, 192.168.1.0/24), une balise par défaut ou * (pour toutes les adresses). Si d’autres valeurs sont fournies, la requête échoue avec le code d’état HTTP 400.	chaîne (obligatoire)

OSDisk

Nom	Description	Valeur
Cache	La valeur par défaut n’est aucune.	'None' 'ReadOnly' 'ReadWrite'

PoolEndpointConfiguration

Nom	Description	Valeur
inboundNatPools	Le nombre maximal de pools NAT entrants par pool Batch est de 5. Si le nombre maximal de pools NAT entrants est dépassé, la requête échoue avec le code d’état HTTP 400.	inboundNatPool[] (obligatoire)

PoolProperties

Nom	Description	Valeur
applicationLicenses	La liste des licences d’application doit être un sous-ensemble de licences d’application de service Batch disponibles. Si une licence n’est pas prise en charge, la création du pool échoue.	string[]
applicationPackages	Les modifications apportées aux packages 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 reimages.	applicationPackageReference[]
Certificats	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 visibilité de « remoteUser », un répertoire « certificats » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{user-name}/certs) et les certificats sont placés dans ce répertoire.	CertificateReference[]
deploymentConfiguration	L’utilisation de CloudServiceConfiguration spécifie que les nœuds doivent être créés à l’aide d’Azure Cloud Services (PaaS), tandis que VirtualMachineConfiguration utilise des machines virtuelles Azure (IaaS).	DeploymentConfiguration
displayName	Le nom complet n’a pas besoin d’être unique et peut contenir des caractères Unicode pouvant atteindre une longueur maximale de 1024.	corde
interNodeCommunication	Cela impose des restrictions sur les nœuds qui peuvent être affectés au pool. L’activation de cette valeur peut réduire le nombre de nœuds demandé à allouer dans le pool. Si elle n’est pas spécifiée, cette valeur est définie par défaut sur « Disabled ».	'Désactivé' 'Activé'
maxTasksPerNode	Nombre maximal de tâches qui peuvent s’exécuter simultanément sur un nœud de calcul unique dans le pool.	Int
métadonnées	Le service Batch n’affecte aucune signification aux métadonnées ; il s’agit uniquement de l’utilisation du code utilisateur.	MetadataItem[]
networkConfiguration	Configuration réseau d’un pool.	networkConfiguration
scaleSettings	Définit la taille souhaitée du pool. Il peut s’agir de « fixedScale » où les targetDedicatedNodes demandés sont spécifiés, ou « autoScale » qui définit une formule qui est 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.	scaleSettings
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.	startTask
taskSchedulingPolicy	Spécifie la façon dont les tâches doivent être distribuées entre les nœuds de calcul.	TaskSchedulingPolicy
userAccounts	Liste des comptes d’utilisateur à créer sur chaque nœud du pool.	UserAccount[]
vmSize	Pour plus d’informations sur les tailles disponibles de machines virtuelles pour les pools de services cloud (pools créés avec cloudServiceConfiguration), consultez Tailles pour les services cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch prend en charge toutes les tailles de machine virtuelle cloud Services, à l’exception d’ExtraSmall. Pour plus d’informations sur les tailles de machines virtuelles disponibles pour les pools utilisant des images de la Place de marché des machines virtuelles (pools créés avec virtualMachineConfiguration) consultez Tailles pour les machines virtuelles (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou tailles pour les machines virtuelles (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch prend en charge toutes les tailles de machine virtuelle Azure, à l’exception des STANDARD_A0 et celles avec stockage Premium (STANDARD_GS, STANDARD_DS et série STANDARD_DSV2).	corde

ResourceFile

Nom	Description	Valeur
blobSource	Cette URL doit être lisible à l’aide de l’accès anonyme ; autrement dit, le service Batch ne présente aucune information d’identification lors du téléchargement de l’objet blob. Il existe deux façons d’obtenir cette URL pour un objet blob dans le stockage Azure : incluez une signature d’accès partagé (SAP) accordant des autorisations de lecture sur l’objet blob, ou définissez la liste de contrôle d’accès pour l’objet blob ou son conteneur afin d’autoriser l’accès public.	chaîne (obligatoire)
fileMode	Cette propriété s’applique uniquement aux fichiers téléchargés sur des nœuds de calcul Linux. Il sera ignoré s’il est spécifié pour un resourceFile qui sera téléchargé sur un nœud Windows. Si cette propriété n’est pas spécifiée pour un nœud Linux, la valeur par défaut 0770 est appliquée au fichier.	corde
filePath	Emplacement sur le nœud de calcul auquel télécharger le fichier, par rapport au répertoire de travail de la tâche.	chaîne (obligatoire)

ScaleSettings

Nom	Description	Valeur
mise à l’échelle automatique	Cette propriété et fixedScale s’excluent mutuellement et l’une des propriétés doit être spécifiée.	AutoScaleSettings
fixedScale	Cette propriété et cette mise à l’échelle automatique sont mutuellement exclusives et l’une des propriétés doit être spécifiée.	fixedScaleSettings

StartTask

Nom	Description	Valeur
commandLine	La ligne de commande ne s’exécute pas sous un interpréteur de commandes et ne peut donc pas tirer parti des fonctionnalités de l’interpréteur de commandes telles que l’extension de variable d’environnement. Si vous souhaitez tirer parti de ces fonctionnalités, vous devez appeler l’interpréteur de commandes dans la ligne de commande, par exemple en utilisant « cmd /c MyCommand » dans Windows ou « /bin/sh -c MyCommand » dans Linux. Obligatoire si d’autres propriétés de startTask sont spécifiées.	corde
environmentSettings	Liste des paramètres de variable d’environnement pour la tâche de démarrage.	EnvironmentSetting[]
maxTaskRetryCount	Le service Batch retente une tâche si son code de sortie n’est pas différent de zéro. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch essaie la tâche une fois, puis peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est égal à 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est égal à 0, le service Batch ne réessaye pas la tâche. Si le nombre maximal de nouvelles tentatives est -1, le service Batch retente la tâche sans limite.	Int
resourceFiles	Liste des fichiers que le service Batch télécharge sur le nœud de calcul avant d’exécuter la ligne de commande.	ResourceFile[]
userIdentity	Si elle est omise, la tâche s’exécute en tant qu’utilisateur non administratif unique à la tâche.	userIdentity
waitForSuccess	Si la valeur est true et que la tâche de démarrage échoue sur un nœud de calcul, le service Batch retente la tâche de démarrage jusqu’à son nombre maximal de nouvelles tentatives (maxTaskRetryCount). Si la tâche n’est toujours pas terminée après toutes les nouvelles tentatives, le service Batch marque le nœud de calcul inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via l’état du nœud et la planification des détails d’erreur. Si la valeur est false, le service Batch n’attend pas la fin de la tâche de démarrage. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant que la tâche de démarrage est toujours en cours d’exécution ; et même si la tâche de démarrage échoue, les nouvelles tâches continueront d’être planifiées sur le nœud. La valeur par défaut est false.	Bool

TaskSchedulingPolicy

Nom	Description	Valeur
nodeFillType	Comment les tâches doivent être distribuées entre les nœuds de calcul.	'Pack' 'Spread' (obligatoire)

UserAccount

Nom	Description	Valeur
elevationLevel	nonAdmin : l’utilisateur automatique est un utilisateur standard sans accès élevé. administrateur : l’utilisateur automatique est un utilisateur disposant d’un accès élevé et fonctionne avec des autorisations d’administrateur complètes. La valeur par défaut n’est pasAdmin.	'Admin' 'NonAdmin'
linuxUserConfiguration	Cette propriété est ignorée si elle est spécifiée sur un pool Windows. S’il n’est pas spécifié, l’utilisateur est créé avec les options par défaut.	LinuxUserConfiguration
nom	Nom du compte d’utilisateur.	chaîne (obligatoire)
mot de passe	Mot de passe du compte d’utilisateur.	chaîne (obligatoire)

UserIdentity

Nom	Description	Valeur
autoUser	Les propriétés userName et autoUser s’excluent mutuellement ; vous devez en spécifier un, mais pas les deux.	AutoUserSpecification
nom d’utilisateur	Les propriétés userName et autoUser s’excluent mutuellement ; vous devez en spécifier un, mais pas les deux.	corde

VirtualMachineConfiguration

Nom	Description	Valeur
dataDisks	Cette propriété doit être spécifiée si les nœuds de calcul du pool doivent avoir des disques de données vides attachés.	DataDisk[]
imageReference	Référence à une image de la Place de marché des machines virtuelles Azure ou à la ressource Image Azure d’une machine virtuelle personnalisée. Pour obtenir la liste de toutes les images Vérifiées par Azure Batch, consultez l’opération « Répertorier les références SKU de l’agent de nœud prises en charge ».	ImageReference (obligatoire)
licenseType	Cela s’applique uniquement aux images qui contiennent le système d’exploitation Windows et ne doivent être utilisées que lorsque vous conservez des licences locales valides pour les nœuds qui seront déployés. En cas d’omission, aucune remise de licence locale n’est appliquée. Les valeurs sont les suivantes : Windows_Server : la licence locale est destinée à Windows Server. Windows_Client : la licence locale est destinée au client Windows.	corde
nodeAgentSkuId	L’agent de nœud Batch est un programme qui s’exécute sur chaque nœud du pool et fournit l’interface de commande et de contrôle entre le nœud et le service Batch. Il existe différentes implémentations de l’agent de nœud, appelées références SKU, pour différents systèmes d’exploitation. Vous devez spécifier une référence SKU de l’agent de nœud qui correspond à la référence d’image sélectionnée. Pour obtenir la liste des références SKU de l’agent de nœud prises en charge, ainsi que leur liste de références d’images vérifiées, consultez l’opération « Répertorier les références SKU de l’agent de nœud prises en charge ».	chaîne (obligatoire)
osDisk	Paramètres du disque du système d’exploitation de la machine virtuelle.	osDisk
windowsConfiguration	Cette propriété ne doit pas être spécifiée si l’imageReference spécifie une image de système d’exploitation Linux.	windowsConfiguration

WindowsConfiguration

Nom	Description	Valeur
enableAutomaticUpdates	Si elle est omise, la valeur par défaut est true.	Bool

Modèles de démarrage rapide

Les modèles de démarrage rapide suivants déploient ce type de ressource.

Modèle	Description
pool Azure Batch sans adresses IP publiques	Ce modèle crée un pool de communications de nœud simplifié Azure Batch sans adresses IP publiques.

Définition de ressource Terraform (fournisseur AzAPI)

Le type de ressource batchAccounts/pools peut être déployé avec des opérations qui ciblent :

groupes de ressources

Pour obtenir la liste des propriétés modifiées dans chaque version de l’API, consultez journal des modifications.

Format de ressource

Pour créer une ressource Microsoft.Batch/batchAccounts/pools, ajoutez le terraform suivant à votre modèle.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.Batch/batchAccounts/pools@2017-09-01"
  name = "string"
  body = jsonencode({
    properties = {
      applicationLicenses = [
        "string"
      ]
      applicationPackages = [
        {
          id = "string"
          version = "string"
        }
      ]
      certificates = [
        {
          id = "string"
          storeLocation = "string"
          storeName = "string"
          visibility = [
            "string"
          ]
        }
      ]
      deploymentConfiguration = {
        cloudServiceConfiguration = {
          currentOSVersion = "string"
          osFamily = "string"
          targetOSVersion = "string"
        }
        virtualMachineConfiguration = {
          dataDisks = [
            {
              caching = "string"
              diskSizeGB = int
              lun = int
              storageAccountType = "string"
            }
          ]
          imageReference = {
            id = "string"
            offer = "string"
            publisher = "string"
            sku = "string"
            version = "string"
          }
          licenseType = "string"
          nodeAgentSkuId = "string"
          osDisk = {
            caching = "string"
          }
          windowsConfiguration = {
            enableAutomaticUpdates = bool
          }
        }
      }
      displayName = "string"
      interNodeCommunication = "string"
      maxTasksPerNode = int
      metadata = [
        {
          name = "string"
          value = "string"
        }
      ]
      networkConfiguration = {
        endpointConfiguration = {
          inboundNatPools = [
            {
              backendPort = int
              frontendPortRangeEnd = int
              frontendPortRangeStart = int
              name = "string"
              networkSecurityGroupRules = [
                {
                  access = "string"
                  priority = int
                  sourceAddressPrefix = "string"
                }
              ]
              protocol = "string"
            }
          ]
        }
        subnetId = "string"
      }
      scaleSettings = {
        autoScale = {
          evaluationInterval = "string"
          formula = "string"
        }
        fixedScale = {
          nodeDeallocationOption = "string"
          resizeTimeout = "string"
          targetDedicatedNodes = int
          targetLowPriorityNodes = int
        }
      }
      startTask = {
        commandLine = "string"
        environmentSettings = [
          {
            name = "string"
            value = "string"
          }
        ]
        maxTaskRetryCount = int
        resourceFiles = [
          {
            blobSource = "string"
            fileMode = "string"
            filePath = "string"
          }
        ]
        userIdentity = {
          autoUser = {
            elevationLevel = "string"
            scope = "string"
          }
          userName = "string"
        }
        waitForSuccess = bool
      }
      taskSchedulingPolicy = {
        nodeFillType = "string"
      }
      userAccounts = [
        {
          elevationLevel = "string"
          linuxUserConfiguration = {
            gid = int
            sshPrivateKey = "string"
            uid = int
          }
          name = "string"
          password = "string"
        }
      ]
      vmSize = "string"
    }
  })
}

Valeurs de propriété

ApplicationPackageReference

Nom	Description	Valeur
id	ID du package d’application à installer. Cela doit se trouver dans le même compte batch que le pool. Il peut s’agir d’une référence à une version spécifique ou à la version par défaut s’il en existe une.	chaîne (obligatoire)
Version	Si cela est omis et qu’aucune version par défaut n’est spécifiée pour cette application, la requête échoue avec le code d’erreur InvalidApplicationPackageReferences. Si vous appelez directement l’API REST, le code d’état HTTP est 409.	corde

AutoScaleSettings

Nom	Description	Valeur
evaluationInterval	Si elle est omise, la valeur par défaut est de 15 minutes (PT15M).	corde
formule	Formule pour le nombre souhaité de nœuds de calcul dans le pool.	chaîne (obligatoire)

AutoUserSpecification

Nom	Description	Valeur
elevationLevel	nonAdmin : l’utilisateur automatique est un utilisateur standard sans accès élevé. administrateur : l’utilisateur automatique est un utilisateur disposant d’un accès élevé et fonctionne avec des autorisations d’administrateur complètes. La valeur par défaut n’est pasAdmin.	'Admin' 'NonAdmin'
portée	pool : spécifie que la tâche s’exécute en tant que compte d’utilisateur automatique commun créé sur chaque nœud d’un pool. tâche : spécifie que le service doit créer un utilisateur pour la tâche. La valeur par défaut est la tâche.	'Pool' 'Task'

CertificateReference

Nom	Description	Valeur
id	ID complet du certificat à installer sur le pool. Cela doit se trouver dans le même compte batch que le pool.	chaîne (obligatoire)
storeLocation	La valeur par défaut est currentUser. Cette propriété s’applique uniquement aux pools configurés avec des nœuds Windows (c’est-à-dire créés avec cloudServiceConfiguration ou virtualMachineConfiguration à l’aide d’une référence d’image Windows). 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 visibilité de « remoteUser », un répertoire « certificats » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{user-name}/certs) et les certificats sont placés dans ce répertoire.	'CurrentUser' 'LocalMachine'
storeName	Cette propriété s’applique uniquement aux pools configurés avec des nœuds Windows (c’est-à-dire créés avec cloudServiceConfiguration ou virtualMachineConfiguration à l’aide d’une référence d’image Windows). Les noms de magasin courants sont : My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, mais tout nom de magasin personnalisé peut également être utilisé. La valeur par défaut est My.	corde
visibilité	Les valeurs sont les suivantes : starttask : compte d’utilisateur sous lequel la tâche de démarrage est exécutée. tâche : comptes sous lesquels les tâches de travail sont exécutées. remoteuser : comptes sous lesquels les utilisateurs accèdent à distance au nœud. Vous pouvez spécifier plusieurs visibilités dans cette collection. La valeur par défaut est tous les comptes.	Tableau de chaînes contenant l’un des éléments suivants : 'RemoteUser' 'StartTask' 'Task'

CloudServiceConfiguration

Nom	Description	Valeur
currentOSVersion	Cela peut différer de targetOSVersion si l’état du pool est mis à niveau. Dans ce cas, certaines machines virtuelles peuvent se trouver sur targetOSVersion et certaines peuvent se trouver sur currentOSVersion pendant le processus de mise à niveau. Une fois toutes les machines virtuelles mises à niveau, currentOSVersion est mis à jour pour être identique à targetOSVersion.	corde
osFamily	Les valeurs possibles sont : 2 - Famille de système d’exploitation 2, équivalente à Windows Server 2008 R2 SP1. 3 - Famille de systèmes d’exploitation 3, équivalent à Windows Server 2012. 4 - Famille de système d’exploitation 4, équivalente à Windows Server 2012 R2. 5 - Famille de systèmes d’exploitation 5, équivalent à Windows Server 2016. Pour plus d’informations, consultez Versions du système d’exploitation invité Azure (https://azure.microsoft.com/documentation/articles/cloud-services-guestos-update-matrix/#releases).	chaîne (obligatoire)
targetOSVersion	La valeur par défaut est * qui spécifie la dernière version du système d’exploitation pour la famille de systèmes d’exploitation spécifiée.	corde

DataDisk

Nom	Description	Valeur
Cache	Les valeurs sont les suivantes : none : le mode de mise en cache du disque n’est pas activé. readOnly : le mode de mise en cache du disque est en lecture seule. readWrite : le mode de mise en cache du disque est en lecture et en écriture. La valeur par défaut de la mise en cache n’est pas. Pour plus d’informations sur les options de mise en cache, consultez : https://blogs.msdn.microsoft.com/windowsazurestorage/2012/06/27/exploring-windows-azure-drives-disks-and-images/.	'None' 'ReadOnly' 'ReadWrite'
diskSizeGB	Taille initiale du disque en Go lors de la création d’un disque de données.	int (obligatoire)
lun	Le lun est utilisé pour identifier de manière unique chaque disque de données. Si vous attachez plusieurs disques, chacun doit avoir un lun distinct.	int (obligatoire)
storageAccountType	S’il est omis, la valeur par défaut est « Standard_LRS ». Les valeurs sont les suivantes : Standard_LRS : le disque de données doit utiliser un stockage standard localement redondant. Premium_LRS : le disque de données doit utiliser un stockage premium localement redondant.	'Premium_LRS' 'Standard_LRS'

DeploymentConfiguration

Nom	Description	Valeur
cloudServiceConfiguration	Cette propriété et virtualMachineConfiguration s’excluent mutuellement et l’une des propriétés doit être spécifiée. Cette propriété ne peut pas être spécifiée si le compte Batch a été créé avec sa propriété poolAllocationMode définie sur « UserSubscription ».	cloudServiceConfiguration
virtualMachineConfiguration	Cette propriété et cloudServiceConfiguration s’excluent mutuellement et l’une des propriétés doit être spécifiée.	VirtualMachineConfiguration

EnvironmentSetting

Nom	Description	Valeur
nom	Nom de la variable d’environnement.	chaîne (obligatoire)
valeur	Valeur de la variable d’environnement.	corde

FixedScaleSettings

Nom	Description	Valeur
nodeDeallocationOption	Si elle est omise, la valeur par défaut est Requeue.	'Requeue' 'RetainedData' 'TaskCompletion' 'Terminate'
resizeTimeout	La valeur par défaut est de 15 minutes. Les valeurs de délai d’expiration utilisent le format ISO 8601. Par exemple, utilisez PT10M pendant 10 minutes. La valeur minimale est de 5 minutes. Si vous spécifiez une valeur inférieure à 5 minutes, le service Batch rejette la demande avec une erreur ; si vous appelez directement l’API REST, le code d’état HTTP est 400 (requête incorrecte).	corde
targetDedicatedNodes	Au moins un des nœuds targetDedicatedNodes, les nœuds targetLowPriority doivent être définis.	Int
targetLowPriorityNodes	Au moins un des nœuds targetDedicatedNodes, les nœuds targetLowPriority doivent être définis.	Int

ImageReference

Nom	Description	Valeur
id	Cette propriété s’exclue mutuellement avec d’autres propriétés. L’image de machine virtuelle doit se trouver dans la même région et dans le même abonnement que le compte Azure Batch. Pour plus d’informations sur les paramètres de pare-feu pour que l’agent de nœud Batch communique avec le service Batch, consultez /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration .	corde
offrir	Par exemple, UbuntuServer ou WindowsServer.	corde
éditeur	Par exemple, Canonical ou MicrosoftWindowsServer.	corde
Sku	Par exemple, 14.04.0-LTS ou 2012-R2-Datacenter.	corde
Version	Vous pouvez spécifier la valeur « latest » pour sélectionner la dernière version d’une image. S’il est omis, la valeur par défaut est « latest ».	corde

InboundNatPool

Nom	Description	Valeur
backendPort	Cela doit être unique dans un pool Batch. Les valeurs acceptables sont comprises entre 1 et 65535, à l’exception de 22, 3389, 29876 et 29877, car elles sont réservées. Si des valeurs réservées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
frontendPortRangeEnd	Les valeurs acceptables sont comprises entre 1 et 65534, à l’exception des ports compris entre 5 000 et 55 000, qui sont réservés par le service Batch. Toutes les plages d’un pool doivent être distinctes et ne peuvent pas se chevaucher. Si des valeurs réservées ou superposées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
frontendPortRangeStart	Les valeurs acceptables sont comprises entre 1 et 65534, à l’exception des ports compris entre 50000 et 55000, qui sont réservés. Toutes les plages d’un pool doivent être distinctes et ne peuvent pas se chevaucher. Si des valeurs réservées ou superposées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
nom	Le nom doit être unique dans un pool Batch, peut contenir des lettres, des chiffres, des traits de soulignement, des points et des traits d’union. Les noms doivent commencer par une lettre ou un nombre, doivent se terminer par une lettre, un nombre ou un trait de soulignement, et ne peuvent pas dépasser 77 caractères. Si des valeurs non valides sont fournies, la requête échoue avec le code d’état HTTP 400.	chaîne (obligatoire)
networkSecurityGroupRules	Le nombre maximal de règles qui peuvent être spécifiées sur tous les points de terminaison d’un pool Batch est de 25. Si aucune règle de groupe de sécurité réseau n’est spécifiée, une règle par défaut est créée pour autoriser l’accès entrant au backendPort spécifié. Si le nombre maximal de règles de groupe de sécurité réseau est dépassé, la requête échoue avec le code d’état HTTP 400.	NetworkSecurityGroupRule[]
protocole	Protocole du point de terminaison.	'TCP' 'UDP' (obligatoire)

LinuxUserConfiguration

Nom	Description	Valeur
Gid	Les propriétés uid et gid doivent être spécifiées ensemble ou pas du tout. Si le système d’exploitation sous-jacent n’est pas spécifié, le gid est sélectionné.	Int
sshPrivateKey	La clé privée ne doit pas être protégée par mot de passe. La clé privée est utilisée pour configurer automatiquement l’authentification basée sur une clé asymétrique pour SSH entre les nœuds d’un pool Linux lorsque la propriété enableInterNodeCommunication du pool est true (elle est ignorée si enableInterNodeCommunication est false). Pour ce faire, placez la paire de clés dans le répertoire .ssh de l’utilisateur. S’il n’est pas spécifié, ssh sans mot de passe n’est pas configuré entre les nœuds (aucune modification du répertoire .ssh de l’utilisateur est effectuée).	corde
Uid	Les propriétés uid et gid doivent être spécifiées ensemble ou pas du tout. S’il n’est pas spécifié, le système d’exploitation sous-jacent sélectionne l’interface utilisateur.	Int

MetadataItem

Nom	Description	Valeur
nom	Nom de l’élément de métadonnées.	chaîne (obligatoire)
valeur	Valeur de l’élément de métadonnées.	chaîne (obligatoire)

Microsoft.Batch/batchAccounts/pools

Nom	Description	Valeur
nom	Nom de la ressource	corde Contraintes: Longueur minimale = 1 Longueur maximale = 1 Modèle = `^[a-zA-Z0-9_-]+$` (obligatoire)
parent_id	ID de la ressource qui est le parent de cette ressource.	ID de ressource de type : batchAccounts
Propriétés	Propriétés associées au pool.	PoolProperties
type	Type de ressource	« Microsoft.Batch/batchAccounts/pools@2017-09-01 »

NetworkConfiguration

Nom	Description	Valeur
endpointConfiguration	La configuration du point de terminaison de pool est prise en charge uniquement sur les pools avec la propriété virtualMachineConfiguration.	PoolEndpointConfiguration
subnetId	Le réseau virtuel doit se trouver dans la même région et dans le même abonnement que le compte Azure Batch. Le sous-réseau spécifié doit avoir suffisamment d’adresses IP libres pour prendre en charge le nombre de nœuds dans le pool. Si le sous-réseau n’a pas suffisamment d’adresses IP libres, le pool alloue partiellement des nœuds de calcul et une erreur de redimensionnement se produit. Le principal de service « MicrosoftAzureBatch » doit avoir le rôle « Contributeur de machine virtuelle classique » Role-Based Contrôle d’accès (RBAC) pour le réseau virtuel spécifié. Le sous-réseau spécifié doit autoriser la communication du service Azure Batch à planifier des tâches sur les nœuds de calcul. Cela peut être vérifié en vérifiant si le réseau virtuel spécifié a des groupes de sécurité réseau (NSG) associés. Si la communication aux nœuds de calcul dans le sous-réseau spécifié est refusée par un groupe de sécurité réseau, le service Batch définit l’état des nœuds de calcul sur inutilisable. Pour les pools créés via virtualMachineConfiguration, le compte Batch doit avoir poolAllocationMode userSubscription pour utiliser un réseau virtuel. Si le réseau virtuel spécifié a des groupes de sécurité réseau (NSG) associés, quelques ports système réservés doivent être activés pour la communication entrante. Pour les pools créés avec une configuration de machine virtuelle, activez les ports 29876 et 29877, ainsi que le port 22 pour Linux et le port 3389 pour Windows. Pour les pools créés avec une configuration de service cloud, activez les ports 10100, 20100 et 30100. Activez également les connexions sortantes au stockage Azure sur le port 443. Pour plus d’informations, consultez : /azure/batch/batch-api-basics#virtual-network-vnet-and-firewall-configuration	corde

NetworkSecurityGroupRule

Nom	Description	Valeur
accès	Action qui doit être effectuée pour une adresse IP, une plage de sous-réseaux ou une balise spécifiée.	'Autoriser' 'Deny' (obligatoire)
priorité	Les priorités au sein d’un pool doivent être uniques et sont évaluées par ordre de priorité. Plus le nombre est faible, plus la priorité est élevée. Par exemple, les règles peuvent être spécifiées avec des numéros de commande de 150, 250 et 350. La règle avec le numéro d’ordre de 150 est prioritaire sur la règle dont l’ordre est de 250. Les priorités autorisées sont de 150 à 3500. Si des valeurs réservées ou dupliquées sont fournies, la requête échoue avec le code d’état HTTP 400.	int (obligatoire)
sourceAddressPrefix	Les valeurs valides sont une seule adresse IP (c’est-à-dire 10.10.10.10), un sous-réseau IP (par exemple, 192.168.1.0/24), une balise par défaut ou * (pour toutes les adresses). Si d’autres valeurs sont fournies, la requête échoue avec le code d’état HTTP 400.	chaîne (obligatoire)

OSDisk

Nom	Description	Valeur
Cache	La valeur par défaut n’est aucune.	'None' 'ReadOnly' 'ReadWrite'

PoolEndpointConfiguration

Nom	Description	Valeur
inboundNatPools	Le nombre maximal de pools NAT entrants par pool Batch est de 5. Si le nombre maximal de pools NAT entrants est dépassé, la requête échoue avec le code d’état HTTP 400.	inboundNatPool[] (obligatoire)

PoolProperties

Nom	Description	Valeur
applicationLicenses	La liste des licences d’application doit être un sous-ensemble de licences d’application de service Batch disponibles. Si une licence n’est pas prise en charge, la création du pool échoue.	string[]
applicationPackages	Les modifications apportées aux packages 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 reimages.	applicationPackageReference[]
Certificats	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 visibilité de « remoteUser », un répertoire « certificats » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{user-name}/certs) et les certificats sont placés dans ce répertoire.	CertificateReference[]
deploymentConfiguration	L’utilisation de CloudServiceConfiguration spécifie que les nœuds doivent être créés à l’aide d’Azure Cloud Services (PaaS), tandis que VirtualMachineConfiguration utilise des machines virtuelles Azure (IaaS).	DeploymentConfiguration
displayName	Le nom complet n’a pas besoin d’être unique et peut contenir des caractères Unicode pouvant atteindre une longueur maximale de 1024.	corde
interNodeCommunication	Cela impose des restrictions sur les nœuds qui peuvent être affectés au pool. L’activation de cette valeur peut réduire le nombre de nœuds demandé à allouer dans le pool. Si elle n’est pas spécifiée, cette valeur est définie par défaut sur « Disabled ».	'Désactivé' 'Activé'
maxTasksPerNode	Nombre maximal de tâches qui peuvent s’exécuter simultanément sur un nœud de calcul unique dans le pool.	Int
métadonnées	Le service Batch n’affecte aucune signification aux métadonnées ; il s’agit uniquement de l’utilisation du code utilisateur.	MetadataItem[]
networkConfiguration	Configuration réseau d’un pool.	networkConfiguration
scaleSettings	Définit la taille souhaitée du pool. Il peut s’agir de « fixedScale » où les targetDedicatedNodes demandés sont spécifiés, ou « autoScale » qui définit une formule qui est 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.	scaleSettings
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.	startTask
taskSchedulingPolicy	Spécifie la façon dont les tâches doivent être distribuées entre les nœuds de calcul.	TaskSchedulingPolicy
userAccounts	Liste des comptes d’utilisateur à créer sur chaque nœud du pool.	UserAccount[]
vmSize	Pour plus d’informations sur les tailles disponibles de machines virtuelles pour les pools de services cloud (pools créés avec cloudServiceConfiguration), consultez Tailles pour les services cloud (https://azure.microsoft.com/documentation/articles/cloud-services-sizes-specs/). Batch prend en charge toutes les tailles de machine virtuelle cloud Services, à l’exception d’ExtraSmall. Pour plus d’informations sur les tailles de machines virtuelles disponibles pour les pools utilisant des images de la Place de marché des machines virtuelles (pools créés avec virtualMachineConfiguration) consultez Tailles pour les machines virtuelles (Linux) (https://azure.microsoft.com/documentation/articles/virtual-machines-linux-sizes/) ou tailles pour les machines virtuelles (Windows) (https://azure.microsoft.com/documentation/articles/virtual-machines-windows-sizes/). Batch prend en charge toutes les tailles de machine virtuelle Azure, à l’exception des STANDARD_A0 et celles avec stockage Premium (STANDARD_GS, STANDARD_DS et série STANDARD_DSV2).	corde

ResourceFile

Nom	Description	Valeur
blobSource	Cette URL doit être lisible à l’aide de l’accès anonyme ; autrement dit, le service Batch ne présente aucune information d’identification lors du téléchargement de l’objet blob. Il existe deux façons d’obtenir cette URL pour un objet blob dans le stockage Azure : incluez une signature d’accès partagé (SAP) accordant des autorisations de lecture sur l’objet blob, ou définissez la liste de contrôle d’accès pour l’objet blob ou son conteneur afin d’autoriser l’accès public.	chaîne (obligatoire)
fileMode	Cette propriété s’applique uniquement aux fichiers téléchargés sur des nœuds de calcul Linux. Il sera ignoré s’il est spécifié pour un resourceFile qui sera téléchargé sur un nœud Windows. Si cette propriété n’est pas spécifiée pour un nœud Linux, la valeur par défaut 0770 est appliquée au fichier.	corde
filePath	Emplacement sur le nœud de calcul auquel télécharger le fichier, par rapport au répertoire de travail de la tâche.	chaîne (obligatoire)

ScaleSettings

Nom	Description	Valeur
mise à l’échelle automatique	Cette propriété et fixedScale s’excluent mutuellement et l’une des propriétés doit être spécifiée.	AutoScaleSettings
fixedScale	Cette propriété et cette mise à l’échelle automatique sont mutuellement exclusives et l’une des propriétés doit être spécifiée.	fixedScaleSettings

StartTask

Nom	Description	Valeur
commandLine	La ligne de commande ne s’exécute pas sous un interpréteur de commandes et ne peut donc pas tirer parti des fonctionnalités de l’interpréteur de commandes telles que l’extension de variable d’environnement. Si vous souhaitez tirer parti de ces fonctionnalités, vous devez appeler l’interpréteur de commandes dans la ligne de commande, par exemple en utilisant « cmd /c MyCommand » dans Windows ou « /bin/sh -c MyCommand » dans Linux. Obligatoire si d’autres propriétés de startTask sont spécifiées.	corde
environmentSettings	Liste des paramètres de variable d’environnement pour la tâche de démarrage.	EnvironmentSetting[]
maxTaskRetryCount	Le service Batch retente une tâche si son code de sortie n’est pas différent de zéro. Notez que cette valeur contrôle spécifiquement le nombre de nouvelles tentatives. Le service Batch essaie la tâche une fois, puis peut réessayer jusqu’à cette limite. Par exemple, si le nombre maximal de nouvelles tentatives est égal à 3, Batch tente la tâche jusqu’à 4 fois (une tentative initiale et 3 nouvelles tentatives). Si le nombre maximal de nouvelles tentatives est égal à 0, le service Batch ne réessaye pas la tâche. Si le nombre maximal de nouvelles tentatives est -1, le service Batch retente la tâche sans limite.	Int
resourceFiles	Liste des fichiers que le service Batch télécharge sur le nœud de calcul avant d’exécuter la ligne de commande.	ResourceFile[]
userIdentity	Si elle est omise, la tâche s’exécute en tant qu’utilisateur non administratif unique à la tâche.	userIdentity
waitForSuccess	Si la valeur est true et que la tâche de démarrage échoue sur un nœud de calcul, le service Batch retente la tâche de démarrage jusqu’à son nombre maximal de nouvelles tentatives (maxTaskRetryCount). Si la tâche n’est toujours pas terminée après toutes les nouvelles tentatives, le service Batch marque le nœud de calcul inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via l’état du nœud et la planification des détails d’erreur. Si la valeur est false, le service Batch n’attend pas la fin de la tâche de démarrage. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant que la tâche de démarrage est toujours en cours d’exécution ; et même si la tâche de démarrage échoue, les nouvelles tâches continueront d’être planifiées sur le nœud. La valeur par défaut est false.	Bool

TaskSchedulingPolicy

Nom	Description	Valeur
nodeFillType	Comment les tâches doivent être distribuées entre les nœuds de calcul.	'Pack' 'Spread' (obligatoire)

UserAccount

Nom	Description	Valeur
elevationLevel	nonAdmin : l’utilisateur automatique est un utilisateur standard sans accès élevé. administrateur : l’utilisateur automatique est un utilisateur disposant d’un accès élevé et fonctionne avec des autorisations d’administrateur complètes. La valeur par défaut n’est pasAdmin.	'Admin' 'NonAdmin'
linuxUserConfiguration	Cette propriété est ignorée si elle est spécifiée sur un pool Windows. S’il n’est pas spécifié, l’utilisateur est créé avec les options par défaut.	LinuxUserConfiguration
nom	Nom du compte d’utilisateur.	chaîne (obligatoire)
mot de passe	Mot de passe du compte d’utilisateur.	chaîne (obligatoire)

UserIdentity

Nom	Description	Valeur
autoUser	Les propriétés userName et autoUser s’excluent mutuellement ; vous devez en spécifier un, mais pas les deux.	AutoUserSpecification
nom d’utilisateur	Les propriétés userName et autoUser s’excluent mutuellement ; vous devez en spécifier un, mais pas les deux.	corde

VirtualMachineConfiguration

Nom	Description	Valeur
dataDisks	Cette propriété doit être spécifiée si les nœuds de calcul du pool doivent avoir des disques de données vides attachés.	DataDisk[]
imageReference	Référence à une image de la Place de marché des machines virtuelles Azure ou à la ressource Image Azure d’une machine virtuelle personnalisée. Pour obtenir la liste de toutes les images Vérifiées par Azure Batch, consultez l’opération « Répertorier les références SKU de l’agent de nœud prises en charge ».	ImageReference (obligatoire)
licenseType	Cela s’applique uniquement aux images qui contiennent le système d’exploitation Windows et ne doivent être utilisées que lorsque vous conservez des licences locales valides pour les nœuds qui seront déployés. En cas d’omission, aucune remise de licence locale n’est appliquée. Les valeurs sont les suivantes : Windows_Server : la licence locale est destinée à Windows Server. Windows_Client : la licence locale est destinée au client Windows.	corde
nodeAgentSkuId	L’agent de nœud Batch est un programme qui s’exécute sur chaque nœud du pool et fournit l’interface de commande et de contrôle entre le nœud et le service Batch. Il existe différentes implémentations de l’agent de nœud, appelées références SKU, pour différents systèmes d’exploitation. Vous devez spécifier une référence SKU de l’agent de nœud qui correspond à la référence d’image sélectionnée. Pour obtenir la liste des références SKU de l’agent de nœud prises en charge, ainsi que leur liste de références d’images vérifiées, consultez l’opération « Répertorier les références SKU de l’agent de nœud prises en charge ».	chaîne (obligatoire)
osDisk	Paramètres du disque du système d’exploitation de la machine virtuelle.	osDisk
windowsConfiguration	Cette propriété ne doit pas être spécifiée si l’imageReference spécifie une image de système d’exploitation Linux.	windowsConfiguration

WindowsConfiguration

Nom	Description	Valeur
enableAutomaticUpdates	Si elle est omise, la valeur par défaut est true.	Bool

Partager via

Microsoft.Batch BatchAccounts/pools 2017-09-01

Définition de ressource Bicep

Format de ressource

Valeurs de propriété

ApplicationPackageReference

AutoScaleSettings

AutoUserSpecification

CertificateReference

CloudServiceConfiguration

DataDisk

DeploymentConfiguration

EnvironmentSetting

FixedScaleSettings

ImageReference

InboundNatPool

LinuxUserConfiguration

MetadataItem

Microsoft.Batch/batchAccounts/pools

NetworkConfiguration

NetworkSecurityGroupRule

OSDisk

PoolEndpointConfiguration

PoolProperties

ResourceFile

ScaleSettings

StartTask

TaskSchedulingPolicy

UserAccount

UserIdentity

VirtualMachineConfiguration

WindowsConfiguration

Exemples de démarrage rapide

Définition de ressource de modèle ARM

Format de ressource

Valeurs de propriété

ApplicationPackageReference

AutoScaleSettings

AutoUserSpecification

CertificateReference

CloudServiceConfiguration

DataDisk

DeploymentConfiguration

EnvironmentSetting

FixedScaleSettings

ImageReference

InboundNatPool

LinuxUserConfiguration

MetadataItem

Microsoft.Batch/batchAccounts/pools

NetworkConfiguration

NetworkSecurityGroupRule

OSDisk

PoolEndpointConfiguration

PoolProperties

ResourceFile

ScaleSettings

StartTask

TaskSchedulingPolicy

UserAccount

UserIdentity

VirtualMachineConfiguration

WindowsConfiguration

Modèles de démarrage rapide

Définition de ressource Terraform (fournisseur AzAPI)

Format de ressource

Valeurs de propriété

ApplicationPackageReference

AutoScaleSettings

AutoUserSpecification

CertificateReference

CloudServiceConfiguration

DataDisk

DeploymentConfiguration

EnvironmentSetting

FixedScaleSettings

ImageReference

InboundNatPool

LinuxUserConfiguration

MetadataItem