Versions d'API REST du service de traitement par lots
Les opérations de l'API REST du service de traitement par lots peuvent avoir plusieurs versions, afin d'assurer la compatibilité descendante à mesure que l'API évolue. Vous devez spécifier la version d'une opération à utiliser lorsque vous l'appelez, en indiquant la version dans votre appel REST. Si votre application appelle une version antérieure d'une opération, vous pouvez choisir de continuer d'appeler la version antérieure, ou modifier votre code pour appeler une version plus récente. Si la version n’est pas spécifiée ou si une version incorrecte est spécifiée, une erreur est retournée.
Pour spécifier la version d’une opération à utiliser, définissez le paramètre de requête api-version . La version est au format Groupe.Majeure.Mineure où Groupe est au format « AAAA-MM-JJ », et où Majeure et Mineure sont des nombres entiers.
Dernière version : 2023-05-01.17.0
- [Cassant] API Statistiques de la durée de vie des travaux/pools supprimés :
lifetimejobstats
etlifetimepoolstats
. - Ajout de la propriété
enableAcceleratedNetworking
booléenne àNetworkConfiguration
.- Cette propriété détermine si ce pool doit activer la mise en réseau accélérée, avec la valeur par défaut False.
- La possibilité d’activer cette fonctionnalité est également liée à la prise en charge d’un instance de système d’exploitation/machine virtuelle, qui doit s’aligner sur la stratégie de mise en réseau accélérée.
- Ajout de la propriété
enableAutomaticUpgrade
booléenne àVMExtension
.- Cette propriété détermine si l’extension doit être automatiquement mise à niveau par la plateforme si une version plus récente de l’extension est disponible.
-
type
Propriété deContainerConfiguration
, qui prend désormais en charge deux valeurs :DockerCompatible
etCriCompatible
.
Versions antérieures
Les versions précédentes sont les suivantes :
- 2022-10-01.16.0
- 2022-01-01.15.0
- 2021-06-01.14.0
- 2020-09-01.12.0
- 2020-03-01.11.0
- 2019-08-01.10.0
- 2019-06-01.9.0
- 2018-12-01.8.0
- 2018-08-01.7.0
- 2018-03-01.6.1
- 2017-09-01.6.0
- 2017-06-01.5.1
- 2017-05-01.5.0
- 2017-01-01.4.0
- 2016-07-01.3.1
- 2016-02-01.3.0
- 2015-12-01.2.2
- 2015-11-01.2.1
- 2015-06-01.2.0
- 2015-03-01.1.1
- 2014-10-01.1.0
Version : 2022-10-01.16.0
- Ajout d’une nouvelle
NodeCommunicationMode
propriété qui détermine la façon dont un pool communique avec le service Batch - Ajout d’une nouvelle
currentNodeCommunicationMode
propriété duNodeCommunicationMode
type auCloudPool
modèle pour faire référence à l’état actuel du mode de communication du pool. - Ajout d’une nouvelle
targetNodeCommunicationMode
propriété duNodeCommunicationMode
type aux modèles suivants pour faire référence au mode de communication de nœud souhaité pour le pool :
Version : 2022-01-01.15.0
- Ajout d’une nouvelle
uploadHeaders
propriété auOutputFileBlobContainerDestination
modèle pour permettre aux utilisateurs de définir des en-têtes HTTP personnalisés sur les chargements de fichiers de ressources. - Ajout d’une nouvelle
allowTaskPreemption
propriété aux modèles suivants pour prendre en charge la préemption des tâches de priorité plus élevée (nécessite Comms-Enabled ou un pool de locataires uniques) :
Version : 2021-06-01.14.0
- Ajoutez la possibilité d’affecter des identités managées affectées par l’utilisateur à
CloudPool
. Ces identités seront mises à disposition sur chaque nœud du pool et peuvent être utilisées pour accéder à différentes ressources. - Ajout de la propriété aux modèles suivants pour prendre en charge l’accès aux ressources via une identité managée
identityReference
: - Ajout d’une nouvelle
extensions
propriété à VirtualMachineConfiguration surCloudPool
pour spécifier des extensions de machine virtuelle pour les nœuds - Ajout de la possibilité de spécifier des zones de disponibilité à l’aide d’une nouvelle propriété
nodePlacementConfiguration
sur VirtualMachineConfiguration - Ajout d’une nouvelle
osDisk
propriété à VirtualMachineConfiguration, qui contient les paramètres du disque du système d’exploitation de la machine virtuelle.- La
placement
propriété surDiffDiskSettings
spécifie l’emplacement des disques éphémères pour les disques de système d’exploitation pour toutes les machines virtuelles du pool. La définition de la valeur « CacheDisk » permet de stocker le disque de système d’exploitation éphémère sur le cache de la machine virtuelle.
- La
- Ajout
maxParallelTasks
de la propriété surCloudJob
pour contrôler le nombre maximal de tâches pouvant s’exécuter en même temps par travail (la valeur par défaut est -1, ce qui signifie illimité). Cette propriété est actuellement en préversion privée. - Ajout
virtualMachineInfo
de la propriété surComputeNode
laquelle contient des informations sur l’état actuel de la machine virtuelle, y compris la version exacte de l’image de la Place de marché utilisée par la machine virtuelle. - Ajout
recurrenceInterval
de la propriété àSchedule
pour contrôler l’intervalle entre les heures de début de deux travaux successifs dans une planification de travail.
Version : 2020-09-01.12.0
- [Cassant]
maxTasksPerNode
taskSlotsPerNode
Propriété remplacée par sur le pool. L’utilisation de cette propriété dans un travail peut consommer un nombre dynamique d’emplacements permettant un contrôle plus précis de la consommation des ressources. - [Cassant] Modification du type de réponse de
GetTaskCounts
pour retournerTaskCountsResult
, qui est un objet complexe contenant l’objet précédentTaskCounts
et un nouvelTaskSlotCounts
objet fournissant des informations similaires dans le contexte des emplacements utilisés. - Ajout de la propriété
requiredSlots
à la tâche permettant à l’utilisateur de spécifier le nombre d’emplacements sur un nœud qu’il doit prendre.
Version : 2020-03-01.11.0
- Ajout de la possibilité de chiffrer les lecteurs de disque ComputeNode à l’aide de la nouvelle
DiskEncryptionConfiguration
propriété deVirtualMachineConfiguration
. - [Cassant] La
virtualMachineImageId
propriété deImageReference
peut désormais uniquement faire référence à une image Shared Image Gallery. - [Cassant] La
password
propriété du corps de l’opération deAdd Certificate
la demande est facultative pour les certificats au format PFX. - [Cassant] Les pools peuvent désormais être provisionnés sans adresse IP publique à l’aide de la nouvelle
PublicIPAddressConfiguration
propriété deNetworkConfiguration
. - [Cassant] La
publicIPs
propriété deNetworkConfiguration
a également été renommée en etipAddressIds
a été déplacée versPublicIPAddressConfiguration
. Cette propriété ne peut être spécifiée que siprovision
la propriété a la valeurusermanaged
.
Version : 2019-08-01.10.0
- Ajout de la possibilité de spécifier une collection d’adresses IP publiques sur via
NetworkConfiguration
la nouvellepublicIPs
propriété sur le pool. Cela garantit que les nœuds du pool auront une adresse IP de la liste fournie par l’utilisateur. - Ajout de la possibilité de monter des systèmes de fichiers distants sur chaque nœud d’un pool via la
MountConfiguration
propriété . - Shared Image Gallery images peuvent désormais être spécifiées sur la
virtualMachineImageId
propriété deImageReference
en référençant l’image via son ID de Resource Manager Azure. - [Cassant] Lorsqu’il n’est pas spécifié, la valeur par défaut de
waitForSuccess
surStartTask
esttrue
(auparavant, il s’agissaitfalse
de ). - [Cassant] Quand elle n’est pas spécifiée, la valeur par défaut de
scope
onAutoUserSpecification
est désormais toujoursPool
(auparavant, elle étaitTask
sur les nœuds Windows etPool
sur les nœuds Linux). - Amélioration de divers documents confus ou incomplets.
Version : 2019-06-01.9.0
[Cassant]
ListSupportedImages
Remplacé parListNodeAgentSKUs
.ListSupportedImages
contient toutes les mêmes informations disponibles à l’origine dansListNodeAgentSKUs
, mais dans un format plus clair. De nouvelles images non vérifiées sont également retournées. Des informations supplémentaires surCapabilities
et sontBatchSupportEndOfLife
accessibles viaImageInformation
.À présent, prenez en charge les règles de sécurité réseau bloquant l’accès réseau à un
CloudPool
en fonction du port source du trafic. Cette opération s’effectue via la propriétéSourcePortRanges
surNetworkSecurityGroupRule
.Lors de l’exécution d’un conteneur, Batch prend désormais en charge l’exécution de la tâche dans le répertoire de travail du conteneur ou dans le répertoire de travail de la tâche Batch. Cela est contrôlé par la propriété
WorkingDirectory
surTaskContainerSettings
.Amélioration de divers documents confus ou incomplets.
Version : 2018-12-01.8.0
[Cassant] Suppression de la prise en charge de
upgradeos
sur lescloudServiceConfiguration
pools.[Cassant] Supprimé et
dataEgressGiB
dataIngressGiB
depoolusagemetrics
. Ces propriétés ne sont plus prises en charge.[Cassant]
ResourceFile
Améliorations- Ajout de la possibilité de spécifier un conteneur de stockage Azure entier dans ResourceFile. Il existe désormais trois modes pris en charge pour ResourceFile :
-
httpUrl
crée unResourceFile
pointant vers une URL HTTP unique. -
storageContainerUrl
crée unResourceFile
pointant vers un conteneur Stockage Blob Azure. -
autoStorageContainerName
crée unResourceFile
pointant vers un conteneur Stockage Blob Azure dans le compte de stockage automatique inscrit par Batch.
-
- Les URL fournies à
ResourceFile
via lahttpUrl
méthode peuvent désormais être n’importe quelle URL HTTP. Auparavant, il s’agit d’une URL Stockage Blob Azure. -
blobPrefix
peut être utilisé pour filtrer les téléchargements à partir d’un conteneur de stockage uniquement ceux correspondant au préfixe.
- Ajout de la possibilité de spécifier un conteneur de stockage Azure entier dans ResourceFile. Il existe désormais trois modes pris en charge pour ResourceFile :
[Rupture] Propriété supprimée
osDisk
deVirtualMachineConfiguration
. Cette propriété n'est plus prise en charge.Les pools qui définissent le
dynamicVNetAssignmentScope
surNetworkConfiguration
sur peuventjob
désormais affecter dynamiquement une Réseau virtuel à chaque nœud sur lequel les tâches du travail s’exécutent. Le Réseau virtuel spécifique à joindre les nœuds à est spécifié dans la nouvelleJobNetworkConfiguration
propriété surCloudJob
etJobSpecification
.Notes
Cette fonctionnalité est en version préliminaire publique. Il est désactivé pour tous les comptes Batch, à l’exception de ceux qui nous ont contactés et demandé à être dans le pilote.
La durée de vie maximale d’une tâche est désormais de 180 jours (auparavant, elle était de 7).
Ajout de la prise en charge sur les pools Windows pour la création d’utilisateurs avec un mode de connexion spécifique (ou
batch
interactive
) viaLoginMode
.Le temps de rétention des tâches par défaut pour toutes les tâches est désormais de 7 jours, auparavant il était infini.
Version 2018-08-01.7.0
Les nouvelles fonctionnalités de la version 2018-08-01.7.0 sont les suivantes :
- Affichez la version de l’agent node Azure Batch via la nouvelle propriété NodeAgentInfo sur ComputeNode.
- Ajout de la possibilité de spécifier un
Filter
sur leResult
d’une tâche. Consultez ce document pour plus d’informations.- Cela permet au scénario souvent demandé d’effectuer une requête côté serveur pour rechercher toutes les tâches ayant échoué.
-
[Rupture] Suppression de la
ValidationStatus
propriété de TaskCounts. -
[Rupture] Le type de mise en cache par défaut pour DataDisk et OSDisk est maintenant
ReadWrite
au lieu deNone
. -
[Rupture] Renommage de la seule valeur de ContainerType à .
docker
dockerCompatible
Version 2018-03-01.6.1
Les nouvelles fonctionnalités de la version 2018-03-01.6.1 sont les suivantes :
- Nombres de nœuds de pool par état : cette version ajoute la possibilité d’interroger les nombres de nœuds de pool par état, via la nouvelle opération ListPoolNodeCounts . Cette opération vous permet d’interroger tous les pools d’un compte Batch pour les états de nœud, y compris la création, l’inactivité, le mode hors connexion, le préempted, le redémarrage, la réimagerie, le démarrage et d’autres.
- Journaux de l’agent de nœud : cette version permet de charger Azure Batch journaux d’activité de l’agent de nœud à partir d’un nœud particulier, via l’opération UploadBatchServiceLogs. Il est destiné à être utilisé dans le débogage par Support Microsoft si des problèmes se produisent sur un nœud.
Version 2017-09-01.6.0
Azure Hybrid Use Benefit : vous pouvez maintenant créer des pools de machines virtuelles Windows Batch en spécifiant que la licence Azure Hybrid Use Benefit doit être utilisée. Lorsque cette licence est utilisée, une remise est appliquée au prix de la machine virtuelle. Utilisez la nouvelle propriété LicenseType sur VirtualMachineConfiguration.
Disques de données de machines virtuelles de pool : vous pouvez attacher un ou plusieurs disques de données vides aux pools de machines virtuelles à l’aide de la nouvelle configuration de disque de données qui fait partie de la configuration de la machine virtuelle. Utilisez la propriété DataDisks sur VirtualMachineConfiguration.
(Changement cassant) Les images personnalisées sont désormais créées et déployées à l’aide de ressources d’images Azure Resource Manager au lieu de fichiers de disque dur virtuel blob. Batch utilise désormais des disques managés pour créer les machines virtuelles du pool et utilise donc une ressource Image . Il n’existe désormais aucune limite au nombre de machines virtuelles dans un pool créé à l’aide d’une image personnalisée ; en outre, plusieurs copies de l’objet blob VHD pour les grands pools ne sont plus nécessaires. Les pools d’images personnalisés sont donc beaucoup plus faciles à créer et à mettre à l’échelle. Pour plus d’informations, consultez Utiliser une image personnalisée pour créer un pool de machines virtuelles.
La nouvelle propriété VirtualMachineImageId sur ImageReference contient la référence à l’image, et OSDisk.ImageUris n’existe plus.
En raison de cette modification, ImageReference est désormais une propriété obligatoire de VirtualMachineConfiguration.
(Changement cassant) Les tâches multi-instance (créées à l’aide de MultiInstanceSettings) doivent maintenant spécifier CoordinationCommandLine, et NumberOfInstances est désormais facultatif et la valeur par défaut est 1.
Ajout de la prise en charge des tâches exécutées à l’aide de conteneurs Docker. Pour exécuter une tâche à l’aide d’un conteneur Docker, vous devez spécifier un ContainerConfiguration sur VirtualMachineConfiguration pour un pool, puis ajouter TaskContainerSettings sur la tâche.
Version 2017-06-01.5.1
La version de l’API Batch décrite ici est 2017-06-01.5.1. L’utilisation de la dernière version est recommandée lorsque cela est possible.
Les nouvelles fonctionnalités de la version 2017-06-01.5.1 sont les suivantes :
- Prise en charge du nombre de tâches efficace via la nouvelle opération Obtenir le nombre de tâches . En appelant l’opération Obtenir le nombre de tâches, vous pouvez obtenir un nombre de tâches actives, en cours d’exécution et terminées, ainsi que de tâches qui ont réussi ou échoué. Pour plus d’informations, consultez Compter les tâches d’un travail par état (préversion).
- Prise en charge de la spécification de points de terminaison entrants sur des nœuds de calcul de pool, via la nouvelle propriété poolEndpointConfiguration . En définissant cette propriété, vous pouvez adresser des ports spécifiques sur le nœud en externe.
Version 2017-05-01.5.0
Les sections suivantes décrivent les fonctionnalités nouvelles et modifiées dans la version 2017-05-01.5.0.
Important
La version 2017-05-01.5.0 inclut plusieurs modifications cassants. Examinez les modifications cassants notées ci-dessous et mettez à jour votre code afin d’appeler la version 2017-05-01.5.0.
Nœuds de calcul de faible priorité
Azure Batch offre désormais des nœuds de calcul de faible priorité pour réduire le coût des charges de travail Batch. Les machines virtuelles de faible priorité rendent possibles de nouveaux types de charges de travail Batch en fournissant une grande quantité de puissance de calcul qui est également rentable.
Plusieurs modifications sont apportées à l’API REST pour les nœuds de faible priorité :
- (Changement cassant) Les propriétés targetDedicated et currentDedicated d’une spécification de pool ou de pool ont été renommées targetDedicatedNodes et currentComputeNodes.
- (Changement cassant) La propriété resizeError d’un pool est désormais une collection appelée resizeErrors.
- Les nœuds de calcul ont une nouvelle propriété isDedicated . Cette propriété a la valeur true pour les nœuds dédiés et false pour les nœuds de faible priorité.
- Une tâche Job Manager a une nouvelle propriété allowLowPriorityNode . Si cette propriété a la valeur true, la tâche Gestionnaire de travaux peut s’exécuter sur un nœud de faible priorité. Si elle est false, la tâche Gestionnaire de travaux s’exécute sur un nœud de calcul dédié.
Utilisateurs nommés sur Linux
Azure Batch offre désormais une prise en charge supplémentaire pour la création d’utilisateurs nommés sur des nœuds Linux.
- La nouvelle propriété linuxUserConfiguration prend en charge la spécification d’un uid (ID utilisateur) et d’un gid (ID de groupe) lors de la création d’un utilisateur Linux.
- (Changement cassant) La propriété sshPrivateKey a été déplacée de la propriété userAccount vers la nouvelle propriété linuxUserConfiguration . La propriété linuxUserConfiguration est elle-même une propriété de la propriété userAccount .
Pour plus d’informations sur les comptes d’utilisateur nommés, consultez Exécuter des tâches sous des comptes d’utilisateur dans Batch.
Fichiers de sortie pour les données de tâche
Vous pouvez maintenant spécifier des fichiers de sortie pour charger les données de tâche une fois qu’une tâche est terminée.
- La nouvelle propriété outputFiles prend en charge la spécification des fichiers de tâches à charger dans stockage Azure.
- La nouvelle propriété fileUploadError de la propriété exitConditions prend en charge la spécification des actions à effectuer en fonction du status de chargement d’un fichier de sortie.
Rapport d’erreurs de tâche
Plusieurs modifications ont été apportées pour améliorer la création de rapports pour les erreurs de tâche.
- La nouvelle propriété result de la propriété executionInfo indique si une tâche a réussi ou échoué.
- (Changement cassant) La propriété schedulingError de la propriété executionInfo a été renommée failureInfo. La propriété failureInfo est retournée chaque fois qu’une tâche échoue. Cela inclut tous les cas d’erreur de planification précédents, tous les cas où un code de sortie de tâche différent de zéro est retourné et tous les échecs de chargement de fichiers.
- (Changement cassant) La propriété schedulingError de la propriété exitConditions a été renommée preProcessingError pour déterminer quand l’erreur s’est produite dans le cycle de vie de la tâche.
- (Changement cassant) La propriété schedulingErrorCateogry a été renommée errorCategory.
Licences d’application
Vous pouvez maintenant demander que les licences d’application soient approvisionnées dans votre pool, via la nouvelle propriété applicationLicenses sur une spécification de pool ou de pool.
Version 2017-01-01.4.0
Cette version étend toute la prise en charge de la version précédente, 2016-07-01.3.1. En outre, il prend en charge les fonctionnalités suivantes :
Exécutez une tâche sous une identité d’utilisateur spécifiée.
Vous pouvez maintenant exécuter une tâche ou une collection de tâches sous l’une des identités d’utilisateur suivantes, spécifiées via la nouvelle propriété userIdentity sur la ressource de tâche :
Un compte d’utilisateur avec un nom que vous définissez.
Un compte d’utilisateur créé automatiquement (un utilisateur automatique). Un utilisateur automatique peut s’exécuter en tant qu’utilisateur administratif ou en tant qu’utilisateur non administratif. Par défaut, un utilisateur automatique s’exécute en tant qu’utilisateur non administratif.
Important
La propriété userIdentity , par sa propriété elevationLevel , remplace la propriété runElevated dans les requêtes qui ajoutent une tâche ou une collection de tâches, et dans les réponses qui obtiennent des informations sur une tâche ou cette liste de tâches.
Si vous effectuez une demande qui inclut la propriété runElevated à la version 2017-01-01.4.0 du service Batch, la demande échoue.
Pour exécuter en tant qu’utilisateur administratif, mettez à jour votre application pour utiliser la propriété userIdentity , en définissant la propriété elevationLevel sur admin.
Pour exécuter en tant qu’utilisateur non administratif, mettez à jour votre application pour utiliser la propriété userIdentity , en définissant la propriété elevationLevel sur nonAdmin. Étant donné qu’il s’agit de la valeur par défaut, vous pouvez également omettre le paramètre.
Définissez des comptes d’utilisateur sur tous les nœuds d’un pool.
Vous pouvez maintenant exécuter une tâche ou une collection de tâches sous un compte d’utilisateur que vous définissez sur la ressource de pool. Définissez un compte d’utilisateur via la nouvelle propriété userAccounts dans les demandes d’ajout de pool. Lorsque vous définissez le compte, vous pouvez spécifier le nom du compte, le mot de passe, le niveau d’élévation (administrateur ou non administrateur) et la clé privée SSH (pour les pools Linux).
Une fois que vous avez défini le compte d’utilisateur, vous pouvez spécifier ce compte d’utilisateur pour la propriété userIdentity dans les demandes qui ajoutent une tâche ou une collection de tâches.
Fournissez à une tâche un jeton pour s’authentifier auprès du service Batch lorsque la tâche s’exécute.
Le service Batch peut désormais fournir un jeton d’authentification à une tâche lors de son exécution. Le jeton d’authentification permet à une tâche d’émettre des demandes liées au travail au service Batch, sans les clés de compte Batch. Le jeton est fourni via la variable d’environnement AZ_BATCH_AUTHENTICATION_TOKEN.
Actuellement, les jetons d’authentification sont pris en charge pour les opérations d’appel sur la ressource de travail uniquement. Le jeton d’authentification accorde l’accès à toutes les opérations sur le travail qui contient la tâche.
Pour que le service Batch fournisse le jeton d’authentification, spécifiez la nouvelle propriété authenticationTokenSettings , ainsi que sa propriété d’accès , dans les demandes d’ajout de tâche ou d’ajout d’une collection de tâches.
Spécifiez une action à entreprendre sur les dépendances d’une tâche en cas d’échec de la tâche.
Vous pouvez maintenant spécifier que les tâches dépendantes se poursuivent même si la tâche dont elles dépendent échoue. Définissez la nouvelle propriété dependencyAction d’une ressource de tâche à satisfaire pour exécuter des tâches dépendantes, même si la tâche parente échoue. Vous pouvez également définir dependencyAction sur bloquer pour empêcher l’exécution de tâches dépendantes en cas d’échec de la tâche parente.
Spécifiez la propriété dependencyAction dans les demandes d’ajout de tâche ou d’ajout d’une collection de tâches.
Pour plus d’informations sur l’utilisation des actions de dépendance, consultez Actions de dépendance.
Utilisez des images de disque de système d’exploitation personnalisées lors de la création d’un pool.
Vous pouvez maintenant utiliser des images de disque de système d’exploitation personnalisées pour créer un pool.
Pour ce faire, vous devez spécifier lors de la création de votre compte Batch que les pools doivent être provisionnés dans l’abonnement utilisateur, plutôt que dans un abonnement géré par le service Batch. Dans un appel à Créer un compte, définissez la propriété poolAllocationMode sur UserSubscription. Utilisez ensuite la propriété osDisk pour spécifier une référence à une image disque dans une demande d’ajout de pool.
Important
Lorsque vous créez votre compte Batch, si vous spécifiez que les pools doivent être provisionnés dans l’abonnement utilisateur, vous devez utiliser l’authentification basée sur Azure Active Directory pour toutes les demandes effectuées via ce compte.
Utilisez l’authentification basée sur Azure Active Directory pour les demandes adressées au service Batch.
Azure Active Directory (Azure AD) est désormais pris en charge pour l’authentification des appels au service Batch.
Si votre compte Batch est configuré pour provisionner des pools dans l’abonnement utilisateur, l’utilisation de l’authentification Azure AD est requise.
Version 2016-07-01.3.1
Cette version étend toute la prise en charge de la version précédente, 2016-02-01.3.0. En outre, il prend en charge les fonctionnalités suivantes :
Possibilité de créer un pool et un pool automatique avec la configuration réseau
- Une nouvelle propriété networkConfiguration a été ajoutée aux ressources du pool et du pool automatique. Cette propriété peut être utilisée pour spécifier la configuration réseau du pool, telle que le sous-réseau dans lequel les nœuds de calcul du pool sont créés.
Arrêt automatique d’un travail lorsque toutes les tâches sont terminées.
- Une nouvelle propriété onAllTasksComplete a été ajoutée à la ressource de travail. Vous pouvez le spécifier lorsque vous créez ou mettez à jour un travail.
Arrêter ou désactiver automatiquement un travail en cas d’échec d’une tâche.
- Une nouvelle propriété onTaskFailure a été ajoutée à la ressource de travail, et une nouvelle propriété exitConditions a été ajoutée à la ressource de tâche. Le paramètre de travail onTaskFailure indique si l’échec de tâche peut avoir un impact au niveau du travail, et la propriété exitConditions de tâche permet aux tâches d’adapter l’impact au niveau du travail à la nature de l’échec.
Associez des packages d’application à des tâches ainsi qu’à des pools.
- Une nouvelle propriété applicationPackageReferences a été ajoutée à la ressource de tâche et aux paramètres du travail jobManagerTask. Cela permet de déployer des packages d’application à la demande, car les tâches les nécessitent plutôt que de les spécifier au moment de la création du pool. Cela est particulièrement utile pour les pools à longue durée de vie qui peuvent être appelés à exécuter différents types de travaux ou différentes versions d’application au cours de leur durée de vie, ou si vous disposez d’un package d’application volumineux qui n’est pas requis par toutes les tâches.
Possibilité de réactiver une tâche ayant échoué.
- Une nouvelle opération Réactiver une tâche a été ajoutée pour réinitialiser l’état actif d’une tâche ayant échoué. Cela permet de réessayer les échecs, par exemple si l’échec était temporaire ou si vous avez pu corriger la cause de l’échec, sans recréer la tâche.
Version 2016-02-01.3.0
Cette version étend toute la prise en charge de la version précédente, 2015-12-01.2.2. En outre, il prend en charge les fonctionnalités suivantes :
Possibilité de créer un pool et un pool automatique avec la configuration de machine virtuelle IaaS
Les propriétés existantes « osFamily », « targetOSVersion » et « currentOSVersion » sont déplacées à partir des propriétés de niveau supérieur des ressources Pool et Autopool et sont déplacées à l’intérieur d’une nouvelle propriété appelée « cloudServiceConfiguration ».
Une nouvelle propriété « virtualMachineConfiguration » est ajoutée aux ressources Pool et Autopool. Cette propriété peut être spécifiée pour configurer un pool/pool automatique avec des machines virtuelles IaaS.
Une nouvelle API est ajoutée pour obtenir des informations sur toutes les références SKU d’agent de nœud prises en charge par le service Batch. Consultez Répertorier les références SKU d’agent de nœud prises en charge.
Une nouvelle API est ajoutée pour obtenir des paramètres de connexion à distance qui peuvent être utilisés pour se connecter à distance à un nœud de calcul créé avec la configuration de machine virtuelle IaaS. Consultez Obtenir les paramètres de connexion à distance pour un nœud.
Une nouvelle API est ajoutée pour ajouter une collection de tâches à un travail. Consultez Ajouter une collection de tâches à un travail.
Une nouvelle propriété facultative « sshPublicKey » est ajoutée à la ressource Utilisateur qui peut être utilisée pour ajouter/mettre à jour des utilisateurs sur un nœud de calcul Linux.
Deux nouvelles propriétés « totalTasksSucceed » et « runningTasksCount » sont ajoutées à la ressource Node. Ces propriétés peuvent être obtenues via Obtenir des informations sur un nœud ou répertorier les nœuds de calcul d’un pool.
Une nouvelle propriété « fileMode » est ajoutée au type complexe « ResourceFile ». Cette propriété est appliquée uniquement sur les nœuds de calcul Linux et ignorée pour les nœuds de calcul Windows.
Une nouvelle propriété « fileMode » est ajoutée au type complexe « FileProperties ». Cette propriété est retournée par le service Batch pour les nœuds de calcul Linux dans le cadre des API GetFileProperties ou ListFileProperties. En outre, la propriété existante « creationTime » sous le type complexe « FileProperties » est remplacée par une propriété facultative, car cette propriété ne sera pas retournée pour les nœuds de calcul Linux.
Le type de données de la propriété existante « visibility » à l’intérieur du type complexe « CertificateReference » est modifié d’une chaîne avec des valeurs séparées par des virgules en une collection de chaînes. De plus, l’une des valeurs existantes pour la visibilité est renommée de « rdp » en « remoteuser ».
Les URL des API suivantes sont modifiées pour remplacer « ? » pour le nom de l’action par « / » :
Mettre à niveau le système d’exploitation des nœuds de calcul dans un pool
Version 2015-12-01.2.2
Cette version étend toute la prise en charge de la version précédente, 2015-11-01.2.1. En outre, il prend en charge les fonctionnalités suivantes :
Les applications peuvent désormais être déployées sur des nœuds de calcul à l’aide de packages d’application au lieu de fichiers de ressources.
De nouvelles API sont fournies aux clients pour parcourir la liste des applications et versions disponibles, par exemple pour afficher un sélecteur dans une interface utilisateur.
Les API liées au pool sont modifiées pour permettre à un pool de spécifier les packages d’application à télécharger sur tous les nœuds de ce pool.
Les tâches peuvent désormais être rendues dépendantes d’autres tâches. Une tâche dépendante ne démarre pas tant que toutes les tâches dont elle dépend ne sont pas terminées.
Cette version inclut les autres modifications suivantes :
- Le délai de redimensionnement du pool par défaut est passé à 15 minutes.
Version 2015-11-01.2.1
Cette version étend toute la prise en charge de la version précédente 2015-06-01.2.0. En outre, il prend en charge les fonctionnalités suivantes :
Possibilité d’ajouter et d’exécuter une tâche multi-instance (par exemple, MPI)
Une nouvelle propriété facultative « multiInstanceSettings » est ajoutée à la ressource Task qui peut éventuellement être incluse dans les API Ajouter une tâche, Obtenir une tâche, lister des tâches.
Une nouvelle liste d’API répertorie les tâches secondaires d’une tâche est ajoutée pour obtenir des informations sur les tâches secondaires.
Une nouvelle propriété facultative « subtaskId » est ajoutée à « recentTasks » pour un nœud de calcul. Cette propriété est retournée dans le cadre de Get Compute Node et List Compute Nodes
Possibilité de désactiver ou d’activer la planification des tâches sur un nœud de calcul
Deux nouvelles API Désactiver la planification des tâches sur un nœud et Activer la planification des tâches sur un nœud sont ajoutées sur la ressource de nœud de calcul.
Un nouvel état de nœud de calcul « hors connexion » est ajouté. Pour les versions antérieures de l’API, cet état est mappé à « inutilisable ».
Une nouvelle propriété « schedulingState » est ajoutée à la ressource de nœud de calcul. Valeurs possibles pour 'enabled' et 'disabled'.
Possibilité de spécifier l’intervalle d’évaluation de mise à l’échelle automatique sur un pool/un pool automatique
Une nouvelle propriété « autoScaleEvaluationInterval » est ajoutée à la ressource de pool. Cette propriété peut être incluse dans les API Ajouter un pool, Obtenir un pool, Activer la mise à l’échelle automatique et Répertorier les pools.
De même, pour les pools automatiques, une nouvelle propriété « autoScaleEvaluationInterval » est ajoutée à la propriété « autoPoolSpecification ». Cette propriété peut être incluse dans Ajouter un travail, Obtenir un travail, Lister des travaux, Ajouter une planification de travail, Obtenir une planification de travail, Mettre à jour la planification du travail, Répertorier les planifications de travail et Répertorier les travaux dans les API Planification de travaux.
Amélioration des API de tâche pour renvoyer le répertoire racine de la tâche sur le nœud de calcul.
Deux nouvelles propriétés « taskRootDirectory » et « taskRootDirectoryUrl » sont ajoutées à la ressource Task qui peut être obtenue dans le cadre de Obtenir des informations sur une tâche, Répertorier les API tâches
Une nouvelle propriété « taskRootDirectory » est ajoutée à « jobPreparationTaskExecutionInfo » et « jobReleaseTaskExecutionInfo », qui peut être obtenue via Lister les status des tâches de préparation et de publication de travaux pour une API de travail.