Nodes - List Nodes

Service:: Batch Service

Version d'API:: 2025-06-01

Liste les nœuds de calcul dans le pool spécifié.

GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01

Avec des paramètres facultatifs:

GET {endpoint}/pools/{poolId}/nodes?api-version=2025-06-01&timeOut={timeOut}&maxresults={maxresults}&$filter={$filter}&$select={$select}

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
endpoint	path	True	string (uri)	Point de terminaison de compte Batch (par exemple : https://batchaccount.eastus2.batch.azure.com).
poolId	path	True	string	L’ID du pool à partir duquel vous souhaitez lister les nœuds de calcul.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.
$filter	query		string	Clause OData $filter. Pour plus d’informations sur la construction de ce filtre, voir https://learn.microsoft.com/rest/api/batchservice/odata-filters-in-batch#list-nodes-in-a-pool.
$select	query		string[]	Clause OData $select.
maxresults	query		integer (int32) minimum: 1 maximum: 1000	Nombre maximal d’éléments à retourner dans la réponse. Un maximum de 1000 candidatures peuvent être retournées.
timeOut	query		integer (int32)	Durée maximale pendant laquelle le serveur peut passer le traitement de la requête, en secondes. La valeur par défaut est de 30 secondes. Si la valeur est supérieure à 30, le par défaut sera utilisé à la place. »

En-tête de la demande

Nom	Type	Description
client-request-id	string	L’identité de requête générée par l’appelant, sous la forme d’un GUID sans décoration telle que les accolades, par exemple 9C4D50EE-2D56-4CD3-8152-34347DC9F2B0.
return-client-request-id	boolean	Indique si le serveur doit retourner l’ID client-request-id dans la réponse.
ocp-date	string (date-time-rfc7231)	Heure à laquelle la demande a été émise. Les bibliothèques clientes définissent généralement cette valeur sur l’heure de l’horloge système actuelle ; définissez-le explicitement si vous appelez directement l’API REST.

Réponses

Nom	Type	Description
200 OK	BatchNodeListResult	La demande a réussi. En-têtes ETag: string Last-Modified: string client-request-id: string request-id: string
Other Status Codes	BatchError	Réponse d’erreur inattendue.

Nom

Type

Description

200 OK

BatchNodeListResult

La demande a réussi.

En-têtes

ETag: string
Last-Modified: string
client-request-id: string
request-id: string

Other Status Codes

BatchError

Réponse d’erreur inattendue.

Sécurité

OAuth2Auth

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/v2.0/authorize

Étendues

Nom	Description
https://batch.core.windows.net//.default

Exemples

Node list

Exemple de requête

HTTP

GET {endpoint}/pools/poolId/nodes?api-version=2025-06-01

Exemple de réponse

Code d’état:: 200

{
  "value": [
    {
      "id": "tvm-1695681911_1-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_1-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T22:22:27.2236818Z",
      "lastBootTime": "2025-11-22T22:22:24.4634125Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_1-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T22:22:27.2236818Z",
        "endTime": "2025-11-22T22:22:27.567189Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_2-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:37:31.4285526Z",
      "lastBootTime": "2025-11-22T19:37:28.623369Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:37:31.4285526Z",
        "endTime": "2025-11-22T19:37:31.838028Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    },
    {
      "id": "tvm-1695681911_3-20161122t193202z",
      "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_3-20161122t193202z",
      "state": "idle",
      "schedulingState": "enabled",
      "stateTransitionTime": "2025-11-22T19:36:51.0013378Z",
      "lastBootTime": "2025-11-22T19:36:48.21721Z",
      "allocationTime": "2025-11-22T19:32:02.8155319Z",
      "ipAddress": "1.1.1.1",
      "ipv6Address": "1.1.1.1",
      "affinityId": "TVM:tvm-1695681911_3-20161122t193202z",
      "vmSize": "Standard_D2_v5",
      "totalTasksRun": 0,
      "totalTasksSucceeded": 0,
      "runningTasksCount": 0,
      "runningTaskSlotsCount": 0,
      "isDedicated": true,
      "startTask": {
        "commandLine": "cmd /c echo hello",
        "userIdentity": {
          "autoUser": {
            "scope": "task",
            "elevationLevel": "nonadmin"
          }
        },
        "maxTaskRetryCount": 0,
        "waitForSuccess": false
      },
      "virtualMachineInfo": {
        "imageReference": {
          "publisher": "Canonical",
          "offer": "ubuntu-24_04-lts",
          "sku": "server",
          "version": "latest",
          "exactVersion": "latest"
        }
      },
      "startTaskInfo": {
        "state": "completed",
        "startTime": "2025-11-22T19:36:51.0013378Z",
        "endTime": "2025-11-22T19:36:51.2363447Z",
        "exitCode": 0,
        "retryCount": 0
      },
      "nodeAgentInfo": {
        "version": "1.2.0.0",
        "lastUpdateTime": "2025-11-22T22:22:24.4634125Z"
      }
    }
  ]
}

Définitions

Nom	Description
AutoUserScope	Enums AutoUserScope
AutoUserSpecification	Spécifie les options de l’utilisateur automatique qui exécute une tâche Azure Batch.
BatchError	Réponse d’erreur reçue du service Azure Batch.
BatchErrorDetail	Élément d’informations supplémentaires inclus dans une réponse d’erreur Azure Batch.
BatchErrorMessage	Message d’erreur reçu dans une réponse d’erreur Azure Batch.
BatchErrorSourceCategory	BatchErrorSourceCategory enums
BatchNode	Nœud de calcul dans le service Batch.
BatchNodeAgentInfo	L’agent Batch Compute Node est un programme qui s’exécute sur chaque nœud de calcul du pool et fournit une fonctionnalité Batch sur le nœud de calcul.
BatchNodeEndpointConfiguration	Configuration du point de terminaison pour le nœud de calcul.
BatchNodeError	Erreur rencontrée par un nœud de calcul.
BatchNodeIdentityReference	Référence à une identité affectée par l’utilisateur associée au pool Batch qu’un nœud de calcul utilisera.
BatchNodeListResult	Résultat de la liste des nœuds de calcul dans un pool.
BatchNodeState	Enums BatchNodeState
BatchStartTask	Batch réessaye les tâches lorsqu’une opération de récupération est déclenchée sur un nœud. Les exemples d’opérations de récupération incluent (mais ne sont pas limités) lorsqu’un nœud non sain est redémarré ou qu’un nœud de calcul a disparu en raison d’une défaillance de l’hôte. Les nouvelles tentatives en raison d’opérations de récupération sont indépendantes et ne sont pas comptabilisées par rapport au maxTaskRetryCount. Même si maxTaskRetryCount est 0, une nouvelle tentative interne en raison d’une opération de récupération peut se produire. En raison de cela, toutes les tâches doivent être idempotentes. Cela signifie que les tâches doivent tolérer l’interruption et le redémarrage sans provoquer d’altération ou de doublon des données. La meilleure pratique pour les tâches longues consiste à utiliser une forme de point de contrôle. Dans certains cas, startTask peut être réexécuter même si le nœud de calcul n’a pas été redémarré. Vous devez veiller à éviter les tâches StartTask qui créent un processus d’arrêt ou installent/lancent des services à partir du répertoire de travail StartTask, car cela empêche Batch de pouvoir réexécuter l’objet StartTask.
BatchStartTaskInfo	Informations sur un startTask en cours d’exécution sur un nœud de calcul.
BatchStartTaskState	Enums BatchStartTaskState
BatchTaskContainerExecutionInfo	Contient des informations sur le conteneur exécuté par une tâche.
BatchTaskContainerSettings	Paramètres de conteneur d’une tâche.
BatchTaskExecutionInfo	Informations sur l’exécution d’une tâche.
BatchTaskExecutionResult	Enums BatchTaskExecutionResult
BatchTaskFailureInfo	Informations sur un échec de tâche.
BatchTaskInfo	Informations sur une tâche en cours d’exécution sur un nœud de calcul.
BatchTaskState	Enums BatchTaskState
BatchVmImageReference	Référence à une image de la Place de marché de machines virtuelles Azure ou à une image de galerie de calcul Azure. Pour obtenir la liste de toutes les références d’images de la Place de marché Azure vérifiées par Azure Batch, consultez l’opération « Liste des images prises en charge ».
ContainerHostBatchBindMountEntry	Entrée du chemin d’accès et du mode montage que vous souhaitez monter dans le conteneur de tâches.
ContainerHostDataPath	Chemins d’accès qui seront montés sur le conteneur de la tâche de conteneur.
ContainerRegistryReference	Registre de conteneurs privé.
ContainerWorkingDirectory	ContainerWorkingDirectory enums
ElevationLevel	Enums de niveau d’élévation
EnvironmentSetting	Variable d’environnement à définir sur un processus de tâche.
InboundEndpoint	Point de terminaison entrant sur un nœud de calcul.
InboundEndpointProtocol	InboundEndpointProtocol enums
NameValuePair	Représente une paire nom-valeur.
ResourceFile	Un seul fichier ou plusieurs fichiers à télécharger sur un nœud de calcul.
SchedulingState	Calendrier Enums d’État
UserIdentity	Définition de l’identité de l’utilisateur sous laquelle la tâche est exécutée. Spécifiez la propriété userName ou autoUser, mais pas les deux.
VirtualMachineInfo	Informations sur l’état actuel de la machine virtuelle.

AutoUserScope

Énumération

Enums AutoUserScope

Valeur	Description
task	Précise que le service doit créer un nouvel utilisateur pour la tâche.
pool	Spécifie que la tâche s’exécute comme le compte utilisateur automatique commun, créé sur chaque nœud de calcul d’un pool.

AutoUserSpecification

Objet

Spécifie les options de l’utilisateur automatique qui exécute une tâche Azure Batch.

Nom	Type	Description
elevationLevel	ElevationLevel	Niveau d’élévation de l’utilisateur automatique. La valeur par défaut n’est pasAdmin.
scope	AutoUserScope	Étendue de l’utilisateur automatique. La valeur par défaut est pool. Si le pool exécute Windows, une valeur de tâche doit être spécifiée si une isolation plus stricte entre les tâches est requise. Par exemple, si la tâche modifie le registre d’une manière qui pourrait avoir un impact sur d’autres tâches.

BatchError

Objet

Réponse d’erreur reçue du service Azure Batch.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
message	BatchErrorMessage	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
values	BatchErrorDetail[]	Collection de paires clé-valeur contenant des détails supplémentaires sur l’erreur.

BatchErrorDetail

Objet

Élément d’informations supplémentaires inclus dans une réponse d’erreur Azure Batch.

Nom	Type	Description
key	string	Identificateur spécifiant la signification de la propriété Value.
value	string	Informations supplémentaires incluses dans la réponse d’erreur.

BatchErrorMessage

Objet

Message d’erreur reçu dans une réponse d’erreur Azure Batch.

Nom	Type	Description
lang	string	Le code de langue du message d’erreur.
value	string	Le texte du message.

BatchErrorSourceCategory

Énumération

BatchErrorSourceCategory enums

Valeur	Description
usererror	L’erreur est due à un problème utilisateur, comme une mauvaise configuration.
servererror	L’erreur est due à un problème interne du serveur.

BatchNode

Objet

Nœud de calcul dans le service Batch.

Nom	Type	Description
affinityId	string	Identificateur qui peut être passé lors de l’ajout d’une tâche pour demander que la tâche soit planifiée sur ce nœud de calcul. Notez qu’il s’agit simplement d’une affinité douce. Si le nœud de calcul cible est occupé ou indisponible au moment où la tâche est planifiée, la tâche est planifiée ailleurs.
allocationTime	string (date-time)	Heure à laquelle ce nœud de calcul a été alloué au pool. Il s’agit de l’heure à laquelle le nœud de calcul a été initialement alloué et ne change pas une fois défini. Elle n’est pas mise à jour lorsque le nœud de calcul est guéri ou préempté.
endpointConfiguration	BatchNodeEndpointConfiguration	Configuration du point de terminaison pour le nœud de calcul.
errors	BatchNodeError[]	Liste des erreurs actuellement rencontrées par le nœud de calcul.
id	string	ID du nœud de calcul. Chaque nœud de calcul ajouté à un pool reçoit un ID unique. Chaque fois qu’un nœud de calcul est supprimé d’un pool, tous ses fichiers locaux sont supprimés et l’ID est récupéré et peut être réutilisé pour les nouveaux nœuds de calcul.
ipAddress	string	Adresse IP que d’autres nœuds peuvent utiliser pour communiquer avec ce nœud de calcul. Chaque nœud de calcul ajouté à un pool reçoit une adresse IP unique. Chaque fois qu’un nœud de calcul est supprimé d’un pool, tous ses fichiers locaux sont supprimés et l’adresse IP est récupérée et peut être réutilisée pour les nouveaux nœuds de calcul.
ipv6Address	string	Adresse IPv6 que d’autres nœuds peuvent utiliser pour communiquer avec ce nœud de calcul. Chaque nœud de calcul ajouté à un pool reçoit une adresse IP unique. Chaque fois qu’un nœud de calcul est supprimé d’un pool, tous ses fichiers locaux sont supprimés et l’adresse IP est récupérée et peut être réutilisée pour les nouveaux nœuds de calcul. Cette propriété n’est pas présente si le pool n’est pas configuré pour IPv6.
isDedicated	boolean	Indique si ce nœud de calcul est un nœud de calcul dédié. Si la valeur est false, le nœud de calcul est un nœud de calcul spot/basse priorité.
lastBootTime	string (date-time)	Dernière fois que le nœud de calcul a été démarré. Cette propriété peut ne pas être présente si l’état du nœud de calcul est inutilisable.
nodeAgentInfo	BatchNodeAgentInfo	Informations sur la version de l’agent Compute Node et l’heure à laquelle le nœud de calcul a été mis à niveau vers une nouvelle version.
recentTasks	BatchTaskInfo[]	Liste des tâches dont l’état a récemment changé. Cette propriété n’est présente que si au moins une tâche s’exécute sur ce nœud de calcul, car elle a été affectée au pool.
runningTaskSlotsCount	integer (int32)	Nombre total d’emplacements de planification utilisés par l’exécution des tâches de travail sur le nœud de calcul. Cela inclut les tâches du Gestionnaire de travaux et les tâches normales, mais pas la préparation du travail, la mise en production du travail ou les tâches de démarrage.
runningTasksCount	integer (int32)	Nombre total de tâches en cours d’exécution sur le nœud de calcul. Cela inclut les tâches du Gestionnaire de travaux et les tâches normales, mais pas la préparation du travail, la mise en production du travail ou les tâches de démarrage.
schedulingState	SchedulingState	Indique si le nœud de calcul est disponible pour la planification des tâches.
startTask	BatchStartTask	Tâche spécifiée pour s’exécuter sur le nœud de calcul au fur et à mesure qu’elle joint le pool.
startTaskInfo	BatchStartTaskInfo	Informations d’exécution sur l’exécution de StartTask sur le nœud de calcul.
state	BatchNodeState	État actuel du nœud de calcul.
stateTransitionTime	string (date-time)	Heure à laquelle le nœud de calcul a entré son état actuel.
totalTasksRun	integer (int32)	Nombre total de tâches terminées sur le nœud de calcul. Cela inclut les tâches du Gestionnaire de travaux et les tâches normales, mais pas la préparation du travail, la mise en production du travail ou les tâches de démarrage.
totalTasksSucceeded	integer (int32)	Nombre total de tâches effectuées avec succès (avec exitCode 0) sur le nœud de calcul. Cela inclut les tâches du Gestionnaire de travaux et les tâches normales, mais pas la préparation du travail, la mise en production du travail ou les tâches de démarrage.
url	string (uri)	URL du nœud de calcul.
virtualMachineInfo	VirtualMachineInfo	Informations sur l’état actuel de la machine virtuelle.
vmSize	string	Taille de la machine virtuelle hébergeant le nœud de calcul. Pour plus d’informations sur les tailles disponibles de machines virtuelles dans les pools, consultez Choisir une taille de machine virtuelle pour les nœuds de calcul dans un pool Azure Batch (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).

BatchNodeAgentInfo

Objet

L’agent Batch Compute Node est un programme qui s’exécute sur chaque nœud de calcul du pool et fournit une fonctionnalité Batch sur le nœud de calcul.

Nom	Type	Description
lastUpdateTime	string (date-time)	Le moment où l’agent du nœud de calcul a été mis à jour sur le nœud de calcul. C’est la dernière fois que l’agent Compute Node a été mis à jour vers une nouvelle version.
version	string	La version de l’agent du nœud de calcul batch qui tourne sur le nœud de calcul. Ce numéro de version peut être vérifié par rapport aux notes de publication de l’agent Compute Node situées à l’adresse https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md.

BatchNodeEndpointConfiguration

Objet

Configuration du point de terminaison pour le nœud de calcul.

Nom	Type	Description
inboundEndpoints	InboundEndpoint[]	La liste des points d’accès entrants accessibles sur le nœud de calcul.

BatchNodeError

Objet

Erreur rencontrée par un nœud de calcul.

Nom	Type	Description
code	string	Un identifiant pour l’erreur de nœud de calcul. Les codes sont invariants et sont destinés à être consommés par programme.
errorDetails	NameValuePair[]	La liste des détails supplémentaires sur l’erreur d’erreur de nœud de calcul.
message	string	Un message décrivant l’erreur de nœud de calcul, destiné à être affiché dans une interface utilisateur.

BatchNodeIdentityReference

Objet

Référence à une identité affectée par l’utilisateur associée au pool Batch qu’un nœud de calcul utilisera.

Nom	Type	Description
resourceId	string (arm-id)	ID de ressource ARM de l’identité affectée par l’utilisateur.

BatchNodeListResult

Objet

Résultat de la liste des nœuds de calcul dans un pool.

Nom	Type	Description
odata.nextLink	string (uri)	L’URL permettant d’obtenir la prochaine série de résultats.
value	BatchNode[]	La liste des nœuds de calcul.

BatchNodeState

Énumération

Enums BatchNodeState

Valeur	Description
idle	Le nœud de calcul n’exécute actuellement pas de tâche.
rebooting	Le nœud de calcul est en train de redémarrer.
reimaging	Le nœud de calcul est en train de réimager.
running	Le nœud de calcul exécute une ou plusieurs tâches (autres qu’une tâche de démarrage).
unusable	Le nœud de calcul ne peut pas être utilisé pour l’exécution de la tâche en raison d’erreurs.
creating	Le service Batch a obtenu la machine virtuelle sous-jacente d’Azure Compute, mais elle n’a pas encore commencé à rejoindre le Pool.
starting	Le service Batch démarre sur la machine virtuelle sous-jacente.
waitingforstarttask	Le StartTask a commencé à s’exécuter sur le nœud de calcul, mais waitForSuccess est défini et le StartTask n’est pas encore terminé.
starttaskfailed	Le StartTask a échoué sur le nœud de calcul (et a épuisé toutes les tentatives), et waitForSuccess est défini. Le nœud de calcul n’est pas utilisable pour exécuter des tâches.
unknown	Le service Batch a perdu le contact avec le nœud de calcul et ne connaît pas son état réel.
leavingpool	Le nœud de calcul quitte le pool, soit parce que l’utilisateur l’a explicitement supprimé, soit parce que le pool se redimensionne ou se réduit automatiquement.
offline	Le nœud de calcul n’exécute pas actuellement de tâche, et la planification des nouvelles tâches vers le nœud de calcul est désactivée.
preempted	Le nœud de calcul Spot/Basse priorité a été préempté. Les tâches qui s’exécutaient sur le nœud de calcul lorsqu’elles ont été préemptées seront replanifiées quand un autre nœud de calcul devient disponible.
upgradingos	Le nœud de calcul est en cours d’une opération de mise à niveau du système d’exploitation.
deallocated	Le nœud de calcul est dédistribué.
deallocating	Le nœud de calcul est en opération de désallocation.

BatchStartTask

Objet

Batch réessaye les tâches lorsqu’une opération de récupération est déclenchée sur un nœud. Les exemples d’opérations de récupération incluent (mais ne sont pas limités) lorsqu’un nœud non sain est redémarré ou qu’un nœud de calcul a disparu en raison d’une défaillance de l’hôte. Les nouvelles tentatives en raison d’opérations de récupération sont indépendantes et ne sont pas comptabilisées par rapport au maxTaskRetryCount. Même si maxTaskRetryCount est 0, une nouvelle tentative interne en raison d’une opération de récupération peut se produire. En raison de cela, toutes les tâches doivent être idempotentes. Cela signifie que les tâches doivent tolérer l’interruption et le redémarrage sans provoquer d’altération ou de doublon des données. La meilleure pratique pour les tâches longues consiste à utiliser une forme de point de contrôle. Dans certains cas, startTask peut être réexécuter même si le nœud de calcul n’a pas été redémarré. Vous devez veiller à éviter les tâches StartTask qui créent un processus d’arrêt ou installent/lancent des services à partir du répertoire de travail StartTask, car cela empêche Batch de pouvoir réexécuter l’objet StartTask.

Nom	Type	Description
commandLine	string	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://learn.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	BatchTaskContainerSettings	Les paramètres du conteneur sous lequel s’exécute la tâche Démarrer. Lorsque cela est spécifié, tous les répertoires sous le AZ_BATCH_NODE_ROOT_DIR (la racine des répertoires Azure Batch sur le nœud) sont mappés dans le conteneur, toutes les variables de l’environnement Tâche sont mappées dans le conteneur, et la ligne de commande Tâche est exécutée dans le conteneur. Les fichiers produits dans le conteneur en dehors de AZ_BATCH_NODE_ROOT_DIR peuvent ne pas être reflétés sur le disque hôte, ce qui signifie que les API de fichiers Batch ne pourront pas accéder à ces fichiers.
environmentSettings	EnvironmentSetting[]	Liste des paramètres de variable d’environnement pour StartTask.
maxTaskRetryCount	integer (int32)	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).
resourceFiles	ResourceFile[]	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.
userIdentity	UserIdentity	L’identité utilisateur sous laquelle s’exécute la StartTask. Si elle est omise, la tâche s’exécute en tant qu’utilisateur non administratif unique à la tâche.
waitForSuccess	boolean	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.

BatchStartTaskInfo

Objet

Informations sur un startTask en cours d’exécution sur un nœud de calcul.

Nom	Type	Description
containerInfo	BatchTaskContainerExecutionInfo	Informations sur le conteneur sous lequel la Tâche est exécutée. Cette propriété n’est définie que si la tâche s’exécute dans un contexte conteneur.
endTime	string (date-time)	Le moment où la StartTask s’est arrêtée. C’est l’heure de fin de la dernière exécution de la StartTask, si cette exécution est terminée (même si elle a échoué et qu’une nouvelle tentative est en attente). Cet élément n’est pas présent si la StartTask est en cours d’exécution.
exitCode	integer (int32)	Le code de sortie du programme spécifié sur la ligne de commande StartTask. Cette propriété n’est définie que si la StartTask est dans l’état terminé. En général, le code de sortie d’un processus reflète la convention spécifique implémentée par le développeur de l’application pour ce processus. Si vous utilisez la valeur du code de sortie pour prendre des décisions dans votre code, assurez-vous de connaître la convention de code de sortie utilisée par le processus de candidature. Cependant, si le service Batch met fin à la StartTask (en raison d’un délai d’attente ou de la terminaison utilisateur via l’API), vous pouvez voir un code de sortie défini par le système d’exploitation.
failureInfo	BatchTaskFailureInfo	Informations décrivant l’échec de la tâche, le cas échéant. Cette propriété n’est définie que si la tâche est dans l’état terminé et a rencontré un échec.
lastRetryTime	string (date-time)	La dernière fois où une nouvelle tentative de la Tâche a commencé à s’exécuter. Cet élément n’est présent que si la Tâche a été retentée (c’est-à-dire que le nombre de retentatives est non nul). Si elle est présente, c’est généralement le même que le temps de départ, mais cela peut être différent si la tâche a été redémarrée pour d’autres raisons que la réévaluation ; par exemple, si le nœud de calcul a été redémarré lors d’une rétentative, alors le startTime est mis à jour mais le lastRetryTime ne l’est pas.
result	BatchTaskExecutionResult	Le résultat de l’exécution de la Tâche. Si la valeur est « failed », alors les détails de la défaillance se trouvent dans la propriété failureInfo.
retryCount	integer (int32)	Le nombre de fois où la tâche a été retentée par le service Batch. Les échecs des applications de tâche (code de sortie non nul) sont réessayés, les erreurs de prétraitement (la tâche n’a pas pu être exécutées) et les erreurs de téléversement de fichiers ne sont pas réessayées. Le service Batch réessaiera la tâche jusqu’à la limite spécifiée par les contraintes.
startTime	string (date-time)	Le moment où la StartTask a commencé à s’exécuter. Cette valeur est réinitialisée à chaque redémarrage ou réessai de la tâche (c’est-à-dire que c’est la dernière fois que la tâche démarre la dernière fois).
state	BatchStartTaskState	L’état du StartTask sur le nœud de calcul.

BatchStartTaskState

Énumération

Enums BatchStartTaskState

Valeur	Description
running	Le StartTask est actuellement en cours d’exécution.
completed	Le StartTask s’est terminé avec le code de sortie 0, ou le StartTask a échoué et la limite de réessay a été atteinte, ou le processus StartTask n’a pas été exécuté en raison d’erreurs de préparation de la tâche (comme des échecs de téléchargement de fichiers ressources).

BatchTaskContainerExecutionInfo

Objet

Contient des informations sur le conteneur exécuté par une tâche.

Nom	Type	Description
containerId	string	ID du conteneur.
error	string	Informations détaillées sur l’erreur concernant le conteneur. Voici la chaîne d’erreur détaillée du service Docker, si disponible. Il est équivalent au champ d’erreur rendu par « docker inspect ».
state	string	L’état du contenant. Voici l’état du conteneur selon le service Docker. C’est équivalent au champ d’état rendu par « docker inspect ».

BatchTaskContainerSettings

Objet

Paramètres de conteneur d’une tâche.

Nom	Type	Description
containerHostBatchBindMounts	ContainerHostBatchBindMountEntry[]	Chemins que vous souhaitez monter sur la tâche conteneur. Si ce tableau est null ou n’est pas présent, la tâche de conteneur monte l’intégralité du lecteur de disque temporaire dans windows (ou AZ_BATCH_NODE_ROOT_DIR sous Linux). Il ne monte aucun chemin de données dans un conteneur si ce tableau est défini comme vide.
containerRunOptions	string	Options supplémentaires pour la commande de création de conteneur. Ces options supplémentaires sont fournies en tant qu’arguments de la commande « docker create », en plus de celles contrôlées par le service Batch.
imageName	string	L’image à utiliser pour créer le conteneur dans lequel la tâche s’exécutera. Voici la référence complète de l’image, comme cela serait spécifié pour « docker pull ». Si aucune étiquette n’est fournie dans le nom de l’image, la balise « :lont » est utilisée par défaut.
registry	ContainerRegistryReference	Le registre privé qui contient l’image du conteneur. Ce paramètre peut être omis si cela a déjà été proposé lors de la création du pool.
workingDirectory	ContainerWorkingDirectory	L’emplacement du répertoire de travail Tâches du conteneur. La valeur par défaut est « taskWorkingDirectory ».

BatchTaskExecutionInfo

Objet

Informations sur l’exécution d’une tâche.

Nom	Type	Description
containerInfo	BatchTaskContainerExecutionInfo	Informations sur le conteneur sous lequel la Tâche est exécutée. Cette propriété n’est définie que si la tâche s’exécute dans un contexte conteneur.
endTime	string (date-time)	Le moment auquel la Tâche a été accomplie. Cette propriété n’est définie que si la Tâche est dans l’état Terminé.
exitCode	integer (int32)	Le code de sortie du programme spécifié sur la ligne de commande Task. Cette propriété n’est définie que si la Tâche est dans l’état terminé. En général, le code de sortie d’un processus reflète la convention spécifique implémentée par le développeur de l’application pour ce processus. Si vous utilisez la valeur du code de sortie pour prendre des décisions dans votre code, assurez-vous de connaître la convention de code de sortie utilisée par le processus de candidature. Cependant, si le service Batch termine la tâche (en raison d’un délai d’attente ou de la terminaison utilisateur via l’API), vous pouvez voir un code de sortie défini par le système d’exploitation.
failureInfo	BatchTaskFailureInfo	Informations décrivant l’échec de la tâche, le cas échéant. Cette propriété n’est définie que si la tâche est dans l’état terminé et a rencontré un échec.
lastRequeueTime	string (date-time)	La dernière fois où la tâche a été remise en file d’attente par le service Batch à la suite d’une demande d’utilisateur. Cette propriété n’est définie que si le nombre de requeueCount est non nul.
lastRetryTime	string (date-time)	La dernière fois où une nouvelle tentative de la Tâche a commencé à s’exécuter. Cet élément n’est présent que si la Tâche a été retentée (c’est-à-dire que le nombre de retentatives est non nul). Si elle est présente, c’est généralement le même que le temps de départ, mais cela peut être différent si la tâche a été redémarrée pour d’autres raisons que la réévaluation ; par exemple, si le nœud de calcul a été redémarré lors d’une rétentative, alors le startTime est mis à jour mais le lastRetryTime ne l’est pas.
requeueCount	integer (int32)	Le nombre de fois où la tâche a été remise en file d’attente par le service Batch à la suite d’une demande d’utilisateur. Lorsque l’utilisateur retire les nœuds de calcul d’un pool (en redimensionnant ou en réduisant le pool) ou lorsque le travail est désactivé, il peut spécifier que les tâches exécutées sur les nœuds de calcul doivent être remises en file d’attente pour exécution. Ce compte indique combien de fois la tâche a été remise en file d’attente pour ces raisons.
result	BatchTaskExecutionResult	Le résultat de l’exécution de la Tâche. Si la valeur est « failed », alors les détails de la défaillance se trouvent dans la propriété failureInfo.
retryCount	integer (int32)	Le nombre de fois où la tâche a été retentée par le service Batch. Les échecs des applications de tâche (code de sortie non nul) sont réessayés, les erreurs de prétraitement (la tâche n’a pas pu être exécutées) et les erreurs de téléversement de fichiers ne sont pas réessayées. Le service Batch réessaiera la tâche jusqu’à la limite spécifiée par les contraintes.
startTime	string (date-time)	L’heure à laquelle la Tâche a commencé à se dérouler. « Exécution » correspond à l’état d’exécution, donc si la tâche spécifie des fichiers ressources ou des paquets, alors l’heure de début reflète le moment où la tâche a commencé à télécharger ou déployer ces données. Si la tâche a été relancée ou réessayée, c’est la dernière fois où la tâche a commencé à s’exécuter. Cette propriété n’existe que pour les tâches en cours ou terminées.

BatchTaskExecutionResult

Énumération

Enums BatchTaskExecutionResult

Valeur	Description
success	La Tâche a fonctionné avec succès.
failure	Il y a eu une erreur lors du traitement de la Tâche. L’échec peut s’être produit avant le lancement du processus Tâche, pendant que celui-ci était en cours d’exécution, ou après la fin du processus Tâche.

BatchTaskFailureInfo

Objet

Informations sur un échec de tâche.

Nom	Type	Description
category	BatchErrorSourceCategory	La catégorie de l’erreur de tâche.
code	string	Un identifiant pour l’erreur Task. Les codes sont invariants et sont destinés à être consommés par programme.
details	NameValuePair[]	Une liste de détails supplémentaires liés à l’erreur.
message	string	Un message décrivant l’erreur de la tâche, destiné à être affiché dans une interface utilisateur.

BatchTaskInfo

Objet

Informations sur une tâche en cours d’exécution sur un nœud de calcul.

Nom	Type	Description
executionInfo	BatchTaskExecutionInfo	Informations sur l’exécution de la Tâche.
jobId	string	L’ID du Job auquel la Tâche appartient.
subtaskId	integer (int32)	L’identifiant de la sous-tâche si la tâche est une tâche multi-instances.
taskId	string	L’ID de la tâche.
taskState	BatchTaskState	L’état actuel de la Tâche.
taskUrl	string (uri)	L’URL de la tâche.

BatchTaskState

Énumération

Enums BatchTaskState

Valeur	Description
active	La tâche est en file d’attente et peut s’exécuter, mais n’est pas actuellement assignée à un nœud de calcul. Une tâche entre dans cet état lorsqu’elle est créée, lorsqu’elle est activée après avoir été désactivée, ou lorsqu’elle attend une nouvelle tentative après un échec d’exécution.
preparing	La tâche a été assignée à un nœud de calcul, mais attend qu’une tâche de préparation de tâche requise soit achevée sur le nœud de calcul. Si la tâche de préparation réussit, la tâche passera à la course. Si la tâche de préparation de l’emploi échoue, la tâche redevient active et peut être affectée à un autre nœud de calcul.
running	La tâche s’exécute sur un nœud de calcul. Cela inclut la préparation au niveau de la tâche, comme le téléchargement de fichiers ressources ou le déploiement de paquets spécifiés sur la tâche – cela ne signifie pas nécessairement que la ligne de commande de la tâche a commencé à s’exécuter.
completed	La Tâche n’est plus éligible à la tentative, généralement parce qu’elle a réussi à être terminée, ou parce qu’elle a échoué et a épuisé sa limite de réessayage. Une tâche est également marquée comme terminée si une erreur s’est produite lors du lancement de la tâche, ou lorsque la tâche a été terminée.

BatchVmImageReference

Objet

Référence à une image de la Place de marché de machines virtuelles Azure ou à une image de galerie de calcul Azure. Pour obtenir la liste de toutes les références d’images de la Place de marché Azure vérifiées par Azure Batch, consultez l’opération « Liste des images prises en charge ».

Nom	Type	Description
communityGalleryImageId	string	L’image de la galerie communautaire identifie uniquement. Cette propriété s’exclue mutuellement avec d’autres propriétés et peut être extraite de l’appel GET de la galerie de la galerie de communautés.
exactVersion	string	La version spécifique de l’image de plateforme ou de l’image marketplace utilisée pour créer le nœud. Ce champ en lecture seule diffère de « version » uniquement si la valeur spécifiée pour « version » lors de la création du pool était « plus récente ».
offer	string	Le type d’offre de l’image Azure Virtual Machines Marketplace. Par exemple, UbuntuServer ou WindowsServer.
publisher	string	L’éditeur de l’image Azure Virtual Machines Marketplace. Par exemple, Canonical ou MicrosoftWindowsServer.
sharedGalleryImageId	string	L’identifiant unique de l’image de galerie partagée. Cette propriété s’exclue mutuellement avec d’autres propriétés et peut être extraite de l’appel GET de l’image de galerie partagée.
sku	string	Le SKU de l’image Azure Virtual Machines Marketplace. Par exemple, 18.04-LTS ou 2019-Datacenter.
version	string	La version de l’image Azure Virtual Machines Marketplace. Une valeur de « plus tard » peut être spécifiée pour sélectionner la dernière version d’une image. S’il est omis, la valeur par défaut est « latest ».
virtualMachineImageId	string (arm-id)	Identificateur de ressource ARM de l’image de la galerie de calcul Azure. Les nœuds de calcul du pool seront créés à l’aide de cet identifiant d’image. Ceci prend la forme /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName}/versions/{VersionId} ou /subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageDefinitionName} pour toujours utiliser par défaut la dernière version de l’image. Cette propriété est mutuellement exclusive avec les autres propriétés ImageReference. L’image de la galerie Azure Compute doit avoir des répliques dans la même région et être dans le même abonnement que le compte Azure Batch. Si la version de l’image n’est pas spécifiée dans l’imageId, la version la plus récente sera utilisée. Pour des informations sur les paramètres de pare-feu de l’agent du nœud de calcul batch afin de communiquer avec le service Batch, voir https://learn.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

ContainerHostBatchBindMountEntry

Objet

Entrée du chemin d’accès et du mode montage que vous souhaitez monter dans le conteneur de tâches.

Nom	Type	Description
isReadOnly	boolean	Montez ce chemin source en mode lecture seule ou non. La valeur par défaut est false (mode lecture/écriture). Pour Linux, si vous montez ce chemin en mode lecture/écriture, cela ne signifie pas que tous les utilisateurs du conteneur disposent de l’accès en lecture/écriture pour le chemin d’accès, cela dépend de l’accès dans la machine virtuelle hôte. Si ce chemin d’accès est monté en lecture seule, tous les utilisateurs du conteneur ne pourront pas modifier le chemin d’accès.
source	ContainerHostDataPath	Le chemin d’accès à monter sur le client conteneur peut être sélectionné.

ContainerHostDataPath

Énumération

Chemins d’accès qui seront montés sur le conteneur de la tâche de conteneur.

Valeur	Description
Shared	Chemin d’accès de la tâche multi-instances pour partager leurs fichiers.
Startup	Chemin d’accès de la tâche de démarrage.
VfsMounts	Le chemin d’accès contient tous les systèmes de fichiers virtuels sont montés sur ce nœud.
Task	Chemin d’accès de la tâche.
JobPrep	Chemin de la tâche de préparation du travail.
Applications	Chemin d’accès des applications.

ContainerRegistryReference

Objet

Registre de conteneurs privé.

Nom	Type	Description
identityReference	BatchNodeIdentityReference	Référence à l’identité affectée par l’utilisateur à utiliser pour accéder à azure Container Registry au lieu du nom d’utilisateur et du mot de passe.
password	string (password)	Mot de passe pour vous connecter au serveur de Registre.
registryServer	string (uri)	L’URL du registre. S’il est omis, la valeur par défaut est « docker.io ».
username	string	Nom d’utilisateur à connecter au serveur de Registre.

ContainerWorkingDirectory

Énumération

ContainerWorkingDirectory enums

Valeur	Description
taskWorkingDirectory	Utilisez le répertoire de travail standard du service Batch Task, qui contiendra les fichiers de ressources de la tâche remplis par Batch.
containerImageDefault	Utilisez le répertoire de travail défini dans l’image du conteneur. Attention : ce répertoire ne contiendra pas les fichiers de ressources téléchargés par Batch.

ElevationLevel

Énumération

Enums de niveau d’élévation

Valeur	Description
nonadmin	L’utilisateur est un utilisateur standard sans accès élevé.
admin	L’utilisateur est un utilisateur disposant d’un accès élevé et fonctionne avec des autorisations d’administrateur complètes.

EnvironmentSetting

Objet

Variable d’environnement à définir sur un processus de tâche.

Nom	Type	Description
name	string	Nom de la variable d’environnement.
value	string	Valeur de la variable d’environnement.

InboundEndpoint

Objet

Point de terminaison entrant sur un nœud de calcul.

Nom	Type	Description
backendPort	integer (int32)	Le numéro de port backend du point de terminaison.
frontendPort	integer (int32)	Le numéro de port public du point de terminaison.
name	string	Nom du point de terminaison.
protocol	InboundEndpointProtocol	Protocole du point de terminaison.
publicFQDN	string	Le nom de domaine public pleinement qualifié pour le nœud de calcul.
publicIPAddress	string	L’adresse IP publique du nœud de calcul.

InboundEndpointProtocol

Énumération

InboundEndpointProtocol enums

Valeur	Description
tcp	Utilisez TCP pour le point de terminaison.
udp	Utilisez UDP pour le point de terminaison.

NameValuePair

Objet

Représente une paire nom-valeur.

Nom	Type	Description
name	string	Le nom dans la paire nom-valeur.
value	string	La valeur dans la paire nom-valeur.

ResourceFile

Objet

Un seul fichier ou plusieurs fichiers à télécharger sur un nœud de calcul.

Nom	Type	Description
autoStorageContainerName	string	Le nom du conteneur de stockage est dans le compte de stockage automatique. Les propriétés autoStorageContainerName, storageContainerUrl et httpUrl s’excluent mutuellement et l’une d’elles doit être spécifiée.
blobPrefix	string	Préfixe d’objet blob à utiliser lors du téléchargement d’objets blob à partir d’un conteneur stockage Azure. Seuls les objets blob dont les noms commencent par le préfixe spécifié sont téléchargés. La propriété est valide uniquement lorsque autoStorageContainerName ou storageContainerUrl est utilisé. Ce préfixe peut être un nom de fichier partiel ou un sous-répertoire. Si aucun préfixe n’est spécifié, tous les fichiers du conteneur sont téléchargés.
fileMode	string	Attribut du mode d’autorisation de fichier au format octal. Cette propriété ne s’applique qu’aux fichiers téléchargés vers 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 de calcul Windows. Si cette propriété n’est pas spécifiée pour un nœud Linux Compute, alors une valeur par défaut de 0770 est appliquée au fichier.
filePath	string	L’emplacement sur le nœud de calcul vers lequel télécharger le(s) fichier(s), par rapport au répertoire de travail de la tâche. Si la propriété httpUrl est spécifiée, filePath est requis et décrit le chemin vers lequel le fichier sera téléchargé, y compris le nom de fichier. Sinon, si la propriété autoStorageContainerName ou storageContainerUrl est spécifiée, filePath est facultatif et est le répertoire dans lequel télécharger les fichiers. Dans le cas où filePath est utilisé comme répertoire, toute structure de répertoires déjà associée aux données d’entrée sera conservée dans son intégralité et ajoutée au répertoire filePath spécifié. Le chemin relatif spécifié ne peut pas sortir du répertoire de travail de la tâche (par exemple en utilisant '..').
httpUrl	string (uri)	URL du fichier à télécharger. Les propriétés autoStorageContainerName, storageContainerUrl et httpUrl s’excluent mutuellement et l’une d’elles doit être spécifiée. Si l’URL pointe vers stockage Blob Azure, elle doit être lisible à partir de nœuds de calcul. Il existe trois 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, utilisez une identité managée avec une autorisation de lecture 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.
identityReference	BatchNodeIdentityReference	La référence à l’identité attribuée par l’utilisateur pour accéder à Azure Blob Storage spécifiée par storageContainerUrl ou httpUrl.
storageContainerUrl	string (uri)	URL du conteneur d’objets blob dans Stockage Blob Azure. Les propriétés autoStorageContainerName, storageContainerUrl et httpUrl s’excluent mutuellement et l’une d’elles doit être spécifiée. Cette URL doit être lisible et listable à partir de nœuds de calcul. Il existe trois façons d’obtenir une telle URL pour un conteneur dans le stockage Azure : inclure une signature d’accès partagé (SAP) accordant des autorisations de lecture et de liste sur le conteneur, utiliser une identité managée avec des autorisations de lecture et de liste, ou définir la liste de contrôle d’accès pour le conteneur afin d’autoriser l’accès public.

SchedulingState

Énumération

Calendrier Enums d’État

Valeur	Description
enabled	Les tâches peuvent être planifiées sur le nœud de calcul.
disabled	Aucune nouvelle tâche ne sera programmée sur le nœud de calcul. Les tâches déjà en cours sur le nœud de calcul peuvent encore s’exécuter jusqu’à leur fin. Tous les nœuds de calcul commencent avec la planification activée.

UserIdentity

Objet

Définition de l’identité de l’utilisateur sous laquelle la tâche est exécutée. Spécifiez la propriété userName ou autoUser, mais pas les deux.

Nom	Type	Description
autoUser	AutoUserSpecification	L’utilisateur automatique sous lequel la tâche est exécutée. Les propriétés userName et autoUser s’excluent mutuellement ; vous devez en spécifier un, mais pas les deux.
username	string	Le nom de l’identité utilisateur sous laquelle la tâche est exécutée. Les propriétés userName et autoUser s’excluent mutuellement ; vous devez en spécifier un, mais pas les deux.

VirtualMachineInfo

Objet

Informations sur l’état actuel de la machine virtuelle.

Nom	Type	Description
imageReference	BatchVmImageReference	La référence à l’image Marketplace de la machine virtuelle Azure.
scaleSetVmResourceId	string	L’identifiant de ressource de la VM actuelle du jeu d’échelle de la machine virtuelle du nœud de calcul. Défini uniquement si le compte Batch a été créé avec sa propriété poolAllocationMode définie sur « UserSubscription ».

Partager via

Nodes - List Nodes

Paramètres URI

En-tête de la demande

Réponses

Sécurité

OAuth2Auth

Étendues

Exemples

Node list

Exemple de requête

Exemple de réponse

Définitions

AutoUserScope

AutoUserSpecification

BatchError

BatchErrorDetail

BatchErrorMessage

BatchErrorSourceCategory

BatchNode

BatchNodeAgentInfo

BatchNodeEndpointConfiguration

BatchNodeError

BatchNodeIdentityReference

BatchNodeListResult

BatchNodeState

BatchStartTask

BatchStartTaskInfo

BatchStartTaskState

BatchTaskContainerExecutionInfo

BatchTaskContainerSettings

BatchTaskExecutionInfo

BatchTaskExecutionResult

BatchTaskFailureInfo

BatchTaskInfo

BatchTaskState

BatchVmImageReference

ContainerHostBatchBindMountEntry

ContainerHostDataPath

ContainerRegistryReference

ContainerWorkingDirectory

ElevationLevel

EnvironmentSetting

InboundEndpoint

InboundEndpointProtocol

NameValuePair

ResourceFile

SchedulingState

UserIdentity

VirtualMachineInfo