az batch pool
Gérer les pools Batch.
Commandes
| Nom | Description | Type | État |
|---|---|---|---|
| az batch pool autoscale |
Gérer la mise à l’échelle automatique des pools Batch. |
Noyau | GA |
| az batch pool autoscale disable |
Désactive la mise à l’échelle automatique d’un pool. |
Noyau | GA |
| az batch pool autoscale enable |
Active la mise à l’échelle automatique pour un pool. |
Noyau | GA |
| az batch pool autoscale evaluate |
Obtient le résultat de l’évaluation d’une formule de mise à l’échelle automatique sur le pool. |
Noyau | GA |
| az batch pool create |
Créez un pool Batch dans un compte. Lors de la création d’un pool, choisissez des arguments dans La configuration des services cloud ou la configuration de machine virtuelle. |
Noyau | GA |
| az batch pool delete |
Supprime un pool du compte spécifié. |
Noyau | GA |
| az batch pool list |
Répertorie tous les pools dans le compte spécifié. |
Noyau | GA |
| az batch pool node-counts |
Obtenez les nombres de nœuds pour les pools Batch. |
Noyau | GA |
| az batch pool node-counts list |
Obtient le nombre de nœuds de calcul dans chaque état, regroupés par pool. |
Noyau | GA |
| az batch pool reset |
Mettez à jour les propriétés d’un pool Batch. Les propriétés non spécifiées qui peuvent être mises à jour sont réinitialisées à leurs valeurs par défaut. |
Noyau | GA |
| az batch pool resize |
Redimensionnez ou arrêtez le redimensionnement d’un pool Batch. |
Noyau | GA |
| az batch pool set |
Mettez à jour les propriétés d’un pool Batch. La mise à jour d’une propriété dans un sous-groupe réinitialise les propriétés non spécifiées de ce groupe. |
Noyau | GA |
| az batch pool show |
Obtient des informations sur le pool spécifié. |
Noyau | GA |
| az batch pool supported-images |
Interroger des informations sur les images de machine virtuelle prises en charge par le service Azure Batch. |
Noyau | GA |
| az batch pool supported-images list |
Répertorie toutes les images de machine virtuelle prises en charge par le service Azure Batch. |
Noyau | GA |
| az batch pool usage-metrics |
Affichez les métriques d’utilisation des pools Batch. |
Noyau | GA |
| az batch pool usage-metrics list |
Répertorie les métriques d’utilisation, agrégées par pool à intervalles de temps individuels, pour le compte spécifié. |
Noyau | GA |
az batch pool create
Créez un pool Batch dans un compte. Lors de la création d’un pool, choisissez des arguments dans La configuration des services cloud ou la configuration de machine virtuelle.
az batch pool create [--accelerated-networking {false, true}]
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--auto-scale-formula]
[--defer-os-rolling-upgrade {false, true}]
[--disable-auto-rollback {false, true}]
[--disk-encryption-targets]
[--enable-auto-os-upgrade {false, true}]
[--enable-cross-zone-upgrade {false, true}]
[--enable-inter-node-communication]
[--enable-secure-boot {false, true}]
[--enable-vtpm {false, true}]
[--enable-write-accel {false, true}]
[--encryption-at-host {false, true}]
[--id]
[--image]
[--json-file]
[--max-batch-instance-percent]
[--max-unhealthy-instance-percent]
[--max-unhealthy-upgraded-instance-percent]
[--metadata]
[--node-agent-sku-id]
[--os-disk-caching {none, readonly, readwrite}]
[--os-disk-size]
[--pause-time-between-batches]
[--placement]
[--policy]
[--prioritize-unhealthy-instances {false, true}]
[--resize-timeout]
[--resource-tags]
[--rollback-failed-instances-on-policy-breach {false, true}]
[--security-type]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--storage-account-type {premium_lrs, standard_lrs, standardssd_lrs}]
[--target-communication {classic, default, simplified}]
[--target-dedicated-nodes]
[--target-low-priority-nodes]
[--targets]
[--task-slots-per-node]
[--upgrade-policy-mode]
[--use-rolling-upgrade-policy {false, true}]
[--vm-size]Paramètres facultatifs
Indique si ce pool doit activer la mise en réseau accélérée. La mise en réseau accélérée permet une virtualisation d’E/S racine unique (SR-IOV) vers une machine virtuelle, ce qui peut entraîner une amélioration des performances réseau. Pour plus d’informations, consultez : https://learn.microsoft.com/azure/virtual-network/accelerated-networking-overview. Définissez true pour activer.
Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.
Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.
Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.
Liste des packages à installer sur chaque nœud de calcul du pool. Lors de la création d’un pool, l’ID d’application du package doit être complet (/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Batch/batchAccounts/{accountName}/applications/{applicationName}). # pylint : disable=line-too-long Changes to Package references affecte tous les nouveaux nœuds 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. Il existe un maximum de 10 références de package sur un pool donné. ID d’application séparés par espace avec version facultative au format « id[#version] ».
Formule pour le nombre souhaité de nœuds de calcul dans le pool. Cette propriété ne doit pas être spécifiée si enableAutoScale a la valeur false. Elle est requise si enableAutoScale a la valeur true. La formule est vérifiée pour la validité avant la création du pool. Si la formule n’est pas valide, le service Batch rejette la demande avec des informations d’erreur détaillées. Pour plus d’informations sur la spécification de cette formule, consultez « Mettre automatiquement à l’échelle des nœuds de calcul dans un pool Azure Batch » (https://azure.microsoft.com/documentation/articles/batch-automatic-scaling/).
Différer les mises à niveau du système d’exploitation sur les machines virtuelles si elles exécutent des tâches. True si l’indicateur est présent.
Indique si la fonctionnalité de restauration d’image du système d’exploitation doit être désactivée. True si l’indicateur est présent.
Liste séparée par un espace de DiskEncryptionTargets. les valeurs possibles actuelles incluent OsDisk et TemporaryDisk.
Indique si les mises à niveau du système d’exploitation doivent être appliquées automatiquement aux instances de groupe identique de manière propagée lorsqu’une version plus récente de l’image du système d’exploitation devient disponible. :code :<br />:code :<br /> Si cette valeur est définie sur true pour les pools Windows, WindowsConfiguration.enableAutomaticUpdates <https://learn.microsoft.com/en-us/rest/api/batchservice/pool/add?tabs=HTTP#windowsconfiguration>_ ne peut pas être définie sur true. True si l’indicateur est présent.
Autorisez VMSS à ignorer les limites AZ lors de la construction de lots de mise à niveau. Prenez en compte le domaine de mise à jour et maxBatchInstancePercent pour déterminer la taille du lot. Ce champ peut être défini sur true ou false uniquement lors de l’utilisation de NodePlacementConfiguration comme Zonal. True si l’indicateur est présent.
Indique si le pool autorise la communication directe entre les nœuds de calcul. L’activation de la communication entre nœuds limite la taille maximale du pool en raison de restrictions de déploiement sur les nœuds de calcul du pool. Cela peut entraîner le fait que le pool n’atteigne pas sa taille souhaitée. La valeur par défaut est false. True si l’indicateur est présent.
Activez le démarrage sécurisé.
Activez vTPM.
Spécifiez si writeAccelerator doit être activé ou désactivé sur le disque.
Cette propriété peut être utilisée par l’utilisateur dans la demande pour activer ou désactiver le chiffrement de l’hôte pour la machine virtuelle ou le groupe de machines virtuelles identiques. Cela active le chiffrement pour tous les disques, y compris le disque Resource/Temp sur l’hôte lui-même. Le comportement par défaut est : Le chiffrement sur l’hôte est désactivé, sauf si cette propriété a la valeur true pour la ressource.
Chaîne qui identifie de façon unique le pool dans le compte. L’ID peut contenir n’importe quelle combinaison de caractères alphanumériques, y compris des traits d’union et des traits de soulignement, et ne peut pas contenir plus de 64 caractères. L’ID est respectant la casse et ne respecte pas la casse (autrement dit, vous n’avez peut-être pas deux ID de pool au sein d’un compte qui diffèrent uniquement par cas). Obligatoire.
Référence d’image du système d’exploitation. Il peut s’agir du format « publisher :offer :sku[ :version] » ou d’un ID d’image ARM complet du formulaire « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/images/{imageName} ». Si le format « publisher :offer :sku[ :version] » est facultatif et s’il est omis le plus récent sera utilisé. Les valeurs valides peuvent être récupérées via « az batch pool supported-images list ». Par exemple : « MicrosoftWindowsServer :WindowsServer :2012-R2-Datacenter :latest ».
Le fichier contenant le pool crée une spécification de paramètre de propriétés dans JSON(mis en forme pour correspondre au corps de la demande de l’API REST). Si ce paramètre est spécifié, tous les arguments de paramètre de création de propriétés du pool sont ignorés. Voir https://learn.microsoft.com/rest/api/batchservice/pool/add?tabs=HTTP#request-body.
Pourcentage maximal d’instances de machines virtuelles totales qui seront mises à niveau simultanément par la mise à niveau propagée dans un lot. Comme il s’agit d’un nombre maximal d’instances non saines dans les lots précédents ou futurs, le pourcentage d’instances d’un lot peut diminuer pour garantir une fiabilité plus élevée. La valeur de ce champ doit être comprise entre 5 et 100, inclus. Si maxBatchInstancePercent et maxUnhealthyInstancePercent sont attribués avec la valeur, la valeur de maxBatchInstancePercent ne doit pas être supérieure à maxUnhealthyInstancePercent.
Pourcentage maximal des instances de machine virtuelle totales dans le groupe identique qui peuvent être simultanément non saines, soit en raison d’une mise à niveau, soit en étant trouvées dans un état non sain par les vérifications d’intégrité de la machine virtuelle avant l’abandon de la mise à niveau propagée. Cette contrainte sera vérifiée avant de démarrer un lot. La valeur de ce champ doit être comprise entre 5 et 100, inclus. Si maxBatchInstancePercent et maxUnhealthyInstancePercent sont attribués avec la valeur, la valeur de maxBatchInstancePercent ne doit pas être supérieure à maxUnhealthyInstancePercent.
Pourcentage maximal d’instances de machine virtuelle mises à niveau qui peuvent être trouvées dans un état non sain. Cette vérification se produit après la mise à niveau de chaque lot. Si ce pourcentage est jamais dépassé, la mise à jour propagée abandonne. La valeur de ce champ doit être comprise entre 0 et 100, inclus.
Liste des paires nom-valeur associées au pool en tant que métadonnées. Le service Batch n’affecte aucune signification aux métadonnées ; il s’agit uniquement de l’utilisation du code utilisateur. Valeurs séparées par l’espace au format « key=value ».
Référence (SKU) de l’agent Batch Compute Node à provisionner sur les nœuds de calcul du pool. L’agent Batch Compute Node est un programme qui s’exécute sur chaque nœud de calcul du pool et fournit l’interface de commande et de contrôle entre le nœud de calcul et le service Batch. Il existe différentes implémentations de l’agent de nœud de calcul, 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 Compute Node 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 de calcul 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 de calcul prises en charge ». Obligatoire.
Spécifiez les exigences de mise en cache. Les valeurs possibles sont : None, ReadOnly, ReadWrite. Les valeurs par défaut sont : Aucune pour le stockage Standard. ReadOnly pour le stockage Premium.
Taille initiale du disque en Go lors de la création d’un disque de système d’exploitation.
Délai d’attente entre la fin de la mise à jour pour toutes les machines virtuelles d’un lot et le démarrage du lot suivant. La durée doit être spécifiée au format ISO 8601. Le format attendu est une durée ISO-8601.
Spécifie le placement éphémère du disque du système d’exploitation pour toutes les machines virtuelles du pool. Cette propriété peut être utilisée par l’utilisateur dans la demande pour choisir l’emplacement, par exemple, mettre en cache l’espace disque pour l’approvisionnement de disque de système d’exploitation éphémère. Pour plus d’informations sur les exigences de taille de disque de système d’exploitation éphémère, reportez-vous à la configuration requise pour la taille de disque du système d’exploitation éphémère pour les machines virtuelles Windows à https://docs.microsoft.com/en-us/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements et les machines virtuelles Linux à https://docs.microsoft.com/en-us/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. « cachedisk ».
Type de stratégie de placement de nœud sur les pools Batch. Stratégie d’allocation utilisée par le service Batch pour approvisionner les nœuds. S’il n’est pas spécifié, Batch utilise la stratégie régionale. Les valeurs connues sont les suivantes : « régional » et « zonal ».
Mettez à niveau toutes les instances non saines dans un groupe identique avant toutes les instances saines. True si l’indicateur est présent.
Délai d’expiration pour l’allocation de nœuds de calcul au pool. Ce délai d’expiration s’applique uniquement à la mise à l’échelle manuelle ; elle n’a aucun effet quand enableAutoScale a la valeur true. La valeur par défaut est de 15 minutes. La valeur minimale est de 5 minutes. Si vous spécifiez une valeur inférieure à 5 minutes, le service Batch retourne une erreur ; si vous appelez directement l’API REST, le code d’état HTTP est 400 (requête incorrecte). Le format attendu est une durée ISO-8601.
L’utilisateur peut spécifier des balises de ressource pour le pool. Toutes les ressources créées pour le pool seront également marquées par les mêmes balises de ressource.
Échec de restauration des instances dans le modèle précédent si la stratégie de mise à niveau propagée est enfreinte. True si l’indicateur est présent.
Spécifiez le SecurityType de la machine virtuelle. Il doit être défini sur n’importe quelle valeur spécifiée pour activer UefiSettings. Le comportement par défaut est : UefiSettings n’est pas activé, sauf si cette propriété est définie.
Ligne de commande de StartTask. 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. Si la ligne de commande fait référence à des chemins de fichier, elle doit utiliser un chemin relatif (par rapport au répertoire de travail de tâche) ou utiliser la variable d’environnement fournie par Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Obligatoire.
Liste des paramètres de variable d’environnement pour StartTask. Valeurs séparées par l’espace au format « key=value ».
Nombre maximal de nouvelles tentatives de la tâche. 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 essaiera la tâche une seule fois et peut ensuite 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, mais cela n’est pas recommandé pour une tâche de démarrage ou une tâche. La valeur par défaut est 0 (aucune nouvelle tentative).
Liste des fichiers que le service Batch télécharge sur le nœud de calcul avant d’exécuter la ligne de commande. Il existe une taille maximale pour la liste des fichiers de ressources. Lorsque la taille maximale est dépassée, la requête échoue et le code d’erreur de réponse est RequestEntityTooLarge. Si cela se produit, la collection de ResourceFiles doit être réduite en taille. Pour ce faire, vous pouvez utiliser des fichiers .zip, des packages d’application ou des conteneurs Docker. Les fichiers répertoriés sous cet élément se trouvent dans le répertoire de travail de la tâche. Références de ressources séparées par l’espace au format filename=httpurl.
Indique si le service Batch doit attendre que StartTask se termine correctement (autrement dit, pour quitter avec le code de sortie 0) avant de planifier des tâches sur le nœud de calcul. Si la valeur est true et que StartTask échoue sur un nœud, le service Batch retente la tâche StartTask 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 inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via les détails de l’état du nœud de calcul et des informations d’échec. Si la valeur est false, le service Batch n’attend pas la fin de l’opération StartTask. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant l’exécution de StartTask ; et même si StartTask échoue, les nouvelles tâches continuent d’être planifiées sur le nœud de calcul. La valeur par défaut est true. True si l’indicateur est présent.
Type de compte de stockage pour disque managé.
Mode de communication de nœud souhaité pour le pool. Si cet élément est présent, il remplace le targetNodeCommunicationMode existant configuré sur le pool. S’il est omis, toutes les métadonnées existantes restent inchangées.
Nombre souhaité de nœuds de calcul dédiés dans le pool. Cette propriété ne doit pas être spécifiée si enableAutoScale a la valeur true. Si enableAutoScale a la valeur false, vous devez définir targetDedicatedNodes, targetLowPriorityNodes ou les deux.
Nombre souhaité de nœuds de calcul Spot/Basse priorité dans le pool. Cette propriété ne doit pas être spécifiée si enableAutoScale a la valeur true. Si enableAutoScale a la valeur false, vous devez définir targetDedicatedNodes, targetLowPriorityNodes ou les deux.
La liste des cibles de disque batch Service chiffre sur le nœud de calcul. En cas d’omission, aucun disque sur les nœuds de calcul du pool ne sera chiffré. Sur le pool Linux, seul « TemporaryDisk » est pris en charge ; sur le pool Windows, « OsDisk » et « TemporaryDisk » doivent être spécifiés. Espace des disques cibles séparés à chiffrer. Les valeurs peuvent être OsDisk ou TemporaryDisk.
Nombre d’emplacements de tâche qui peuvent être utilisés pour exécuter des tâches simultanées sur un nœud de calcul unique dans le pool. La valeur par défaut est 1. La valeur maximale est la plus petite de 4 fois le nombre de cœurs de la vmSize du pool ou 256.
Mode de mise à niveau du système d’exploitation du pool.
Indique si la stratégie de mise à niveau propagée doit être utilisée pendant la mise à niveau automatique du système d’exploitation. La mise à niveau automatique du système d’exploitation revient à la stratégie par défaut si aucune stratégie n’est définie sur vmSS. True si l’indicateur est présent.
Taille des machines virtuelles dans le pool. Toutes les machines virtuelles d’un pool sont de la même taille. Pour plus d’informations sur les tailles de machines virtuelles disponibles pour les pools utilisant des images à partir de la Place de marché des machines virtuelles (pools créés avec virtualMachineConfiguration), consultez Tailles des 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). Obligatoire.
Paramètres globaux
Augmentez la détail de journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez-le.
Affiche uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.
az batch pool delete
Supprime un pool du compte spécifié.
Lorsque vous demandez qu’un pool soit supprimé, les actions suivantes se produisent : l’état du pool est défini sur la suppression ; toute opération de redimensionnement en cours sur le pool est arrêtée ; le service Batch démarre le redimensionnement du pool sur zéro nœuds de calcul ; toutes les tâches exécutées sur des nœuds de calcul existants sont arrêtées et requeuées (comme si une opération de redimensionnement de pool avait été demandée avec l’option de mise en file d’attente par défaut) ; enfin, le pool est supprimé du système. Étant donné que les tâches en cours d’exécution sont requeuées, l’utilisateur peut réexécuter ces tâches en mettant à jour leur travail pour cibler un autre pool. Les tâches peuvent ensuite s’exécuter sur le nouveau pool. Si vous souhaitez remplacer le comportement de mise en file d’attente, vous devez appeler le pool de redimensionnement explicitement pour réduire la taille zéro du pool avant de supprimer le pool. Si vous appelez une API Update, Patch ou Delete sur un pool dans l’état de suppression, elle échoue avec le code d’état HTTP 409 avec le code d’erreur PoolBeingDeleted.
az batch pool delete --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--yes]Paramètres obligatoires
ID du pool à obtenir. Obligatoire.
Paramètres facultatifs
Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.
Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.
Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.
Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service correspond exactement à la valeur spécifiée par le client.
Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.
Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service ne correspond pas à la valeur spécifiée par le client.
Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.
N’invitez pas à confirmer.
Paramètres globaux
Augmentez la détail de journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez-le.
Affiche uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.
az batch pool list
Répertorie tous les pools dans le compte spécifié.
az batch pool list [--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--filter]
[--select]Paramètres facultatifs
Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.
Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.
Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.
Clause $expand OData.
Clause OData $filter. Pour plus d’informations sur la construction de ce filtre, consultez https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch.
Clause OData $select.
Paramètres globaux
Augmentez la détail de journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez-le.
Affiche uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.
az batch pool reset
Mettez à jour les propriétés d’un pool Batch. Les propriétés non spécifiées qui peuvent être mises à jour sont réinitialisées à leurs valeurs par défaut.
az batch pool reset --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-communication {classic, default, simplified}]Paramètres obligatoires
ID du pool à mettre à jour.
Paramètres facultatifs
Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.
Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.
Nom du compte Batch. Uniquement nécessaire, défini par variable d’environnement : AZURE_BATCH_ACCOUNT.
Obligatoire. La liste remplace toutes les références de package d’application existantes sur le pool. Les modifications apportées aux références de package d’application affectent tous les nouveaux nœuds de calcul qui rejoignent le pool, mais n’affectent pas les nœuds de calcul qui se trouvent déjà dans le pool tant qu’ils ne sont pas redémarrés ou réimages. Il existe au maximum 10 références de package d’application sur un pool donné. En cas d’omission ou si vous spécifiez une collection vide, toutes les références de packages d’application existantes sont supprimées du pool. Un maximum de 10 références peut être spécifié sur un pool donné.
Fichier contenant la spécification des paramètres de propriétés de mise à jour du pool dans JSON(mis en forme pour correspondre au corps de la demande de l’API REST). Si ce paramètre est spécifié, tous les arguments de paramètre de paramètre de mise à jour du pool sont ignorés.
Obligatoire. Cette liste remplace toutes les métadonnées existantes configurées sur le pool. S’il est omis ou si vous spécifiez une collection d’anempty, toutes les métadonnées existantes sont supprimées dupool.
Ligne de commande de la tâche de démarrage. 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.
Liste des paramètres de variable d’environnement pour la tâche de démarrage. Valeurs séparées par l’espace au format « key=value ».
Nombre maximal de fois où la tâche peut être retentée.
Liste des fichiers que le service Batch télécharge sur le nœud de calcul avant d’exécuter la ligne de commande. Les fichiers répertoriés sous cet élément se trouvent dans le répertoire de travail de la tâche. Références de ressources séparées par l’espace au format filename=httpurl.
Indique si le service Batch doit attendre que la tâche de démarrage se termine correctement (autrement dit, pour quitter avec le code de sortie 0) avant de planifier des tâches sur le nœud de calcul. True si l’indicateur est présent, sinon a la valeur False.
Mode de communication de nœud souhaité pour le pool. Si cet élément est présent, il remplace le targetNodeCommunicationMode existant configuré sur le pool. S’il est omis, toutes les métadonnées existantes restent inchangées.
Paramètres globaux
Augmentez la détail de journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez-le.
Affiche uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.
az batch pool resize
Redimensionnez ou arrêtez le redimensionnement d’un pool Batch.
az batch pool resize --pool-id
[--abort]
[--account-endpoint]
[--account-key]
[--account-name]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--node-deallocation-option {requeue, retaineddata, taskcompletion, terminate}]
[--resize-timeout]
[--target-dedicated-nodes]
[--target-low-priority-nodes]Paramètres obligatoires
ID du pool.
Paramètres facultatifs
Arrêtez l’opération de redimensionnement du pool.
Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.
Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.
Nom du compte Batch. Uniquement nécessaire, défini par variable d’environnement : AZURE_BATCH_ACCOUNT.
L’opération est effectuée uniquement si l’ETag actuel de la ressource correspond exactement à la valeur spécifiée.
L’opération est effectuée uniquement si la ressource a été modifiée depuis l’horodatage spécifié.
L’opération ne sera pas effectuée uniquement si l’ETag actuel de la ressource correspond exactement à la valeur spécifiée.
L’opération ne sera pas effectuée uniquement si la ressource a été modifiée depuis l’horodatage spécifié.
Lorsque les nœuds peuvent être supprimés du pool, si la taille du pool diminue.
La valeur par défaut est de 15 minutes. La valeur minimale est de 5 minutes. Si vous spécifiez une valeur inférieure à 5 minutes, le service Batch retourne une erreur ; si vous appelez directement l’API REST, le code d’état HTTP est 400 (requête incorrecte). Format de durée ISO-8601.
Nombre souhaité de nœuds de calcul dédiés dans le pool.
Nombre souhaité de nœuds de calcul Spot/Basse priorité dans le pool.
Paramètres globaux
Augmentez la détail de journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez-le.
Affiche uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.
az batch pool set
Mettez à jour les propriétés d’un pool Batch. La mise à jour d’une propriété dans un sous-groupe réinitialise les propriétés non spécifiées de ce groupe.
az batch pool set --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--application-package-references]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--json-file]
[--metadata]
[--start-task-command-line]
[--start-task-environment-settings]
[--start-task-max-task-retry-count]
[--start-task-resource-files]
[--start-task-wait-for-success]
[--target-communication {classic, default, simplified}]Paramètres obligatoires
ID du pool à obtenir. Obligatoire.
Paramètres facultatifs
Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.
Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.
Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.
Liste des packages à installer sur chaque nœud de calcul du pool. Les modifications apportées aux références de package affectent tous les nouveaux nœuds qui rejoignent le pool, mais n’affectent pas les nœuds de calcul qui se trouvent déjà dans le pool tant qu’ils ne sont pas redémarrés ou réinitialisé. Si cet élément est présent, il remplace toutes les références de package existantes. Si vous spécifiez une collection vide, toutes les références de package sont supprimées du pool. En cas d’omission, toutes les références de package existantes restent inchangées. ID d’application séparés par espace avec version facultative au format « id[#version] ».
Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service correspond exactement à la valeur spécifiée par le client.
Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.
Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service ne correspond pas à la valeur spécifiée par le client.
Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.
Fichier contenant la spécification du pool au format JSON (mis en forme pour correspondre au corps de l’API REST respective). Si ce paramètre est spécifié, tous les « arguments de pool » sont ignorés.
Liste des paires nom-valeur associées au pool en tant que métadonnées. Si cet élément est présent, il remplace toutes les métadonnées existantes configurées sur le pool. Si vous spécifiez une collection vide, toutes les métadonnées sont supprimées du pool. S’il est omis, toutes les métadonnées existantes restent inchangées. Valeurs séparées par l’espace au format « key=value ».
Ligne de commande de StartTask. 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. Si la ligne de commande fait référence à des chemins de fichier, elle doit utiliser un chemin relatif (par rapport au répertoire de travail de tâche) ou utiliser la variable d’environnement fournie par Batch (https://docs.microsoft.com/en-us/azure/batch/batch-compute-node-environment-variables). Obligatoire.
Liste des paramètres de variable d’environnement pour StartTask. Valeurs séparées par l’espace au format « key=value ».
Nombre maximal de nouvelles tentatives de la tâche. 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 essaiera la tâche une seule fois et peut ensuite 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, mais cela n’est pas recommandé pour une tâche de démarrage ou une tâche. La valeur par défaut est 0 (aucune nouvelle tentative).
Liste des fichiers que le service Batch télécharge sur le nœud de calcul avant d’exécuter la ligne de commande. Il existe une taille maximale pour la liste des fichiers de ressources. Lorsque la taille maximale est dépassée, la requête échoue et le code d’erreur de réponse est RequestEntityTooLarge. Si cela se produit, la collection de ResourceFiles doit être réduite en taille. Pour ce faire, vous pouvez utiliser des fichiers .zip, des packages d’application ou des conteneurs Docker. Les fichiers répertoriés sous cet élément se trouvent dans le répertoire de travail de la tâche. Références de ressources séparées par l’espace au format filename=httpurl.
Indique si le service Batch doit attendre que StartTask se termine correctement (autrement dit, pour quitter avec le code de sortie 0) avant de planifier des tâches sur le nœud de calcul. Si la valeur est true et que StartTask échoue sur un nœud, le service Batch retente la tâche StartTask 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 inutilisable et ne planifie pas les tâches. Cette condition peut être détectée via les détails de l’état du nœud de calcul et des informations d’échec. Si la valeur est false, le service Batch n’attend pas la fin de l’opération StartTask. Dans ce cas, d’autres tâches peuvent commencer à s’exécuter sur le nœud de calcul pendant l’exécution de StartTask ; et même si StartTask échoue, les nouvelles tâches continuent d’être planifiées sur le nœud de calcul. La valeur par défaut est true. True si l’indicateur est présent.
Mode de communication de nœud souhaité pour le pool. Si cet élément est présent, il remplace le targetNodeCommunicationMode existant configuré sur le pool. S’il est omis, toutes les métadonnées existantes restent inchangées.
Paramètres globaux
Augmentez la détail de journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez-le.
Affiche uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.
az batch pool show
Obtient des informations sur le pool spécifié.
az batch pool show --pool-id
[--account-endpoint]
[--account-key]
[--account-name]
[--expand]
[--if-match]
[--if-modified-since]
[--if-none-match]
[--if-unmodified-since]
[--select]Paramètres obligatoires
ID du pool à obtenir. Obligatoire.
Paramètres facultatifs
Point de terminaison de service Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ENDPOINT.
Clé de compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCESS_KEY.
Nom du compte Batch. Vous pouvez également définir par variable d’environnement : AZURE_BATCH_ACCOUNT.
Clause $expand OData.
Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service correspond exactement à la valeur spécifiée par le client.
Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.
Valeur ETag associée à la version de la ressource connue du client. L’opération n’est effectuée que si l’ETag actuel de la ressource sur le service ne correspond pas à la valeur spécifiée par le client.
Horodatage indiquant l’heure de dernière modification de la ressource connue du client. L’opération n’est effectuée que si la ressource sur le service a été modifiée depuis l’heure spécifiée.
Clause OData $select.
Paramètres globaux
Augmentez la détail de journalisation pour afficher tous les journaux de débogage.
Affichez ce message d’aide et quittez-le.
Affiche uniquement les erreurs, en supprimant les avertissements.
Format de sortie.
Chaîne de requête JMESPath. Pour plus d’informations et d’exemples, consultez http://jmespath.org/.
Nom ou ID de l’abonnement. Vous pouvez configurer l’abonnement par défaut à l’aide de az account set -s NAME_OR_ID.
Augmentez la détail de journalisation. Utilisez --debug pour les journaux de débogage complets.
