Compute Node - Get

Service:

Batch Service

Version d'API:

2024-07-01.20.0

Obtient des informations sur le nœud de calcul spécifié.

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?api-version=2024-07-01.20.0

Avec des paramètres facultatifs:

GET {batchUrl}/pools/{poolId}/nodes/{nodeId}?$select={$select}&timeout={timeout}&api-version=2024-07-01.20.0

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
batchUrl	path	True	string	URL de base pour toutes les demandes de service Azure Batch.
nodeId	path	True	string	ID du nœud de calcul sur lequel vous souhaitez obtenir des informations.
poolId	path	True	string	ID du pool qui contient le nœud de calcul.
api-version	query	True	string	Version de l’API cliente.
$select	query		string	Clause OData $select.
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, la valeur par défaut est utilisée à la place.

En-tête de la demande

Media Types: "application/json; odata=minimalmetadata"

Nom	Obligatoire	Type	Description
client-request-id		string uuid	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-rfc1123	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	ComputeNode	Réponse contenant le nœud de calcul. En-têtes client-request-id: string request-id: string ETag: string Last-Modified: string
Other Status Codes	BatchError	Erreur du service Batch.

Sécurité

azure_auth

Flux de code d’authentification Microsoft Entra OAuth 2.0

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

Étendues

Nom	Description
user_impersonation	Emprunter l’identité de votre compte d’utilisateur

Authorization

Type: apiKey
Dans: header

Exemples

Node get

Exemple de requête

HTTP

GET account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z?api-version=2024-07-01.20.0

Exemple de réponse

Code d’état:

200

{
  "id": "tvm-1695681911_2-20161122t193202z",
  "url": "https://account.region.batch.azure.com/pools/poolId/nodes/tvm-1695681911_2-20161122t193202z",
  "state": "idle",
  "schedulingState": "enabled",
  "stateTransitionTime": "2016-11-22T19:37:31.4285526Z",
  "lastBootTime": "2016-11-22T19:37:28.623369Z",
  "allocationTime": "2016-11-22T19:32:02.8155319Z",
  "ipAddress": "1.1.1.1",
  "affinityId": "TVM:tvm-1695681911_2-20161122t193202z",
  "vmSize": "small",
  "totalTasksRun": 0,
  "totalTasksSucceeded": 0,
  "runningTasksCount": 0,
  "isDedicated": true,
  "startTask": {
    "commandLine": "cmd /c echo hello",
    "userIdentity": {
      "autoUser": {
        "scope": "task",
        "elevationLevel": "nonadmin"
      }
    },
    "maxTaskRetryCount": 0,
    "waitForSuccess": false
  },
  "startTaskInfo": {
    "state": "completed",
    "startTime": "2016-11-22T19:37:31.4285526Z",
    "endTime": "2016-11-22T19:37:31.838028Z",
    "exitCode": 0,
    "retryCount": 0
  },
  "nodeAgentInfo": {
    "version": "1.2.0.0",
    "lastUpdateTime": "2016-11-22T19:37:28.623369Z"
  }
}

Définitions

Nom	Description
AutoUserScope	Étendue de l’utilisateur automatique
AutoUserSpecification	Spécifie les paramètres de l’utilisateur automatique qui exécute une tâche sur le service 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.
CertificateReference	Référence à un certificat à installer sur des nœuds de calcul dans un pool.
CertificateStoreLocation	Emplacement du magasin de certificats sur le nœud de calcul dans lequel installer le certificat.
CertificateVisibility	Quels comptes d’utilisateur sur le nœud de calcul doivent avoir accès aux données privées du certificat.
ComputeNode	Nœud de calcul dans le service Batch.
ComputeNodeEndpointConfiguration	Configuration du point de terminaison pour le nœud de calcul.
ComputeNodeError	Erreur rencontrée par un nœud de calcul.
ComputeNodeIdentityReference	Référence à une identité affectée par l’utilisateur associée au pool Batch qu’un nœud de calcul utilisera.
ComputeNodeState	État actuel du nœud de calcul.
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.
ContainerRegistry	Registre de conteneurs privé.
ContainerWorkingDirectory	Emplacement du répertoire de travail de tâche de conteneur.
ElevationLevel	Niveau d’élévation de l’utilisateur.
EnvironmentSetting	Variable d’environnement à définir sur un processus de tâche.
ErrorCategory	Catégorie de l’erreur.
ErrorMessage	Message d’erreur reçu dans une réponse d’erreur Azure Batch.
ImageReference	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 « Répertorier les images prises en charge ».
InboundEndpoint	Point de terminaison entrant sur un nœud de calcul.
InboundEndpointProtocol	Protocole du point de terminaison.
NameValuePair	Représente une paire nom-valeur.
NodeAgentInformation	Informations sur l’agent De nœud de calcul.
ResourceFile	Un seul fichier ou plusieurs fichiers à télécharger sur un nœud de calcul.
SchedulingState	Indique si le nœud de calcul est disponible pour la planification des tâches.
StartTask	Tâche exécutée lorsqu’un nœud joint un pool dans le service Azure Batch, ou lorsque le nœud de calcul est redémarré ou réinitialisé.
StartTaskInformation	Informations sur un startTask en cours d’exécution sur un nœud de calcul.
StartTaskState	État de StartTask sur le nœud de calcul.
TaskContainerExecutionInformation	Contient des informations sur le conteneur exécuté par une tâche.
TaskContainerSettings	Paramètres de conteneur d’une tâche.
TaskExecutionInformation	Informations sur l’exécution d’une tâche.
TaskExecutionResult	Résultat de l’exécution de la tâche.
TaskFailureInformation	Informations sur un échec de tâche.
TaskInformation	Informations sur une tâche en cours d’exécution sur un nœud de calcul.
TaskState	État de la tâche.
UserIdentity	Définition de l’identité de l’utilisateur sous laquelle la tâche est exécutée.
VirtualMachineInfo	Informations sur l’état actuel de la machine virtuelle.

AutoUserScope

Étendue de l’utilisateur automatique

Nom	Type	Description
pool	string	Spécifie que la tâche s’exécute en tant que compte d’utilisateur automatique commun créé sur chaque nœud de calcul d’un pool.
task	string	Spécifie que le service doit créer un utilisateur pour la tâche.

AutoUserSpecification

Spécifie les paramètres de l’utilisateur automatique qui exécute une tâche sur le service 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 mute le Registre d’une manière qui peut avoir un impact sur d’autres tâches, ou si des certificats ont été spécifiés sur le pool qui ne doit pas être accessible par les tâches normales, mais qu’il doit être accessible par StartTasks.

BatchError

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	ErrorMessage	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

É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.

CertificateReference

Référence à un certificat à installer sur des nœuds de calcul dans un pool.

Nom	Type	Description
storeLocation	CertificateStoreLocation	Emplacement du magasin de certificats sur le nœud de calcul dans lequel installer le certificat. La valeur par défaut est currentuser. Cette propriété s’applique uniquement aux pools configurés avec des nœuds de calcul Windows. Pour les nœuds de calcul Linux, les certificats sont stockés dans un répertoire à l’intérieur du répertoire de travail de tâche et une variable d’environnement AZ_BATCH_CERTIFICATES_DIR est fournie à la tâche pour interroger cet emplacement. Pour les certificats avec une visibilité de « remoteUser », un répertoire « certificats » est créé dans le répertoire d’accueil de l’utilisateur (par exemple, /home/{user-name}/certs) et les certificats sont placés dans ce répertoire.
storeName	string	Nom du magasin de certificats sur le nœud de calcul dans lequel installer le certificat. Cette propriété s’applique uniquement aux pools configurés avec des nœuds de calcul Windows. Les noms de magasin courants sont : My, Root, CA, Trust, Disallowed, TrustedPeople, TrustedPublisher, AuthRoot, AddressBook, mais tout nom de magasin personnalisé peut également être utilisé. La valeur par défaut est My.
thumbprint	string	Empreinte numérique du certificat.
thumbprintAlgorithm	string	Algorithme avec lequel l’empreinte numérique est associée. Cela doit être sha1.
visibility	CertificateVisibility[]	Quels comptes d’utilisateur sur le nœud de calcul doivent avoir accès aux données privées du certificat. Vous pouvez spécifier plusieurs visibilités dans cette collection. La valeur par défaut est tous les comptes.

CertificateStoreLocation

Emplacement du magasin de certificats sur le nœud de calcul dans lequel installer le certificat.

Nom	Type	Description
currentuser	string	Les certificats doivent être installés dans le magasin de certificats CurrentUser.
localmachine	string	Les certificats doivent être installés dans le magasin de certificats LocalMachine.

CertificateVisibility

Quels comptes d’utilisateur sur le nœud de calcul doivent avoir accès aux données privées du certificat.

Nom	Type	Description
remoteuser	string	Le certificat doit être visible pour les comptes d’utilisateur sous lesquels les utilisateurs accèdent à distance au nœud de calcul.
starttask	string	Le certificat doit être visible pour le compte d’utilisateur sous lequel StartTask est exécuté. Notez que si l’étendue de l’utilisateur automatique est pool pour startTask et une tâche, ce certificat sera également visible pour la tâche.
task	string	Le certificat doit être visible pour les comptes d’utilisateur sous lesquels les tâches de travail sont exécutées.

ComputeNode

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	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é.
certificateReferences	CertificateReference[]	Liste des certificats installés sur le nœud de calcul. Pour les nœuds Windows, le service Batch installe les certificats dans le magasin de certificats et l’emplacement spécifiés. Pour les nœuds de calcul Linux, les certificats sont stockés dans un répertoire à l’intérieur du répertoire de travail de tâche et une variable d’environnement AZ_BATCH_CERTIFICATES_DIR est fournie à la tâche pour interroger cet emplacement. Pour les certificats avec une visibilité de « remoteUser », un répertoire « certificats » est créé dans le répertoire d’accueil de l’utilisateur (par exemple, /home/{user-name}/certs) et les certificats sont placés dans ce répertoire. Avertissement : cette propriété est déconseillée et sera supprimée après février 2024. Utilisez plutôt l''extension Azure KeyVault.
endpointConfiguration	ComputeNodeEndpointConfiguration	Configuration du point de terminaison pour le nœud de calcul.
errors	ComputeNodeError[]	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.
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	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	NodeAgentInformation	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. 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.
recentTasks	TaskInformation[]	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	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	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	StartTask	Tâche spécifiée pour s’exécuter sur le nœud de calcul au fur et à mesure qu’elle joint le pool. 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.
startTaskInfo	StartTaskInformation	Informations d’exécution sur l’exécution de StartTask sur le nœud de calcul.
state	ComputeNodeState	État actuel du nœud de calcul. 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.
stateTransitionTime	string	Heure à laquelle le nœud de calcul a entré son état actuel.
totalTasksRun	integer	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	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	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://docs.microsoft.com/azure/batch/batch-pool-vm-sizes).

ComputeNodeEndpointConfiguration

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

Nom	Type	Description
inboundEndpoints	InboundEndpoint[]	Liste des points de terminaison entrants accessibles sur le nœud de calcul.

ComputeNodeError

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

Nom	Type	Description
code	string	Identificateur de l’erreur nœud de calcul. Les codes sont invariants et sont destinés à être consommés par programme.
errorDetails	NameValuePair[]	Liste des détails d’erreur supplémentaires liés à l’erreur nœud de calcul.
message	string	Message décrivant l’erreur de nœud de calcul, destiné à être adapté à l’affichage dans une interface utilisateur.

ComputeNodeIdentityReference

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	ID de ressource ARM de l’identité affectée par l’utilisateur.

ComputeNodeState

État actuel du nœud de calcul.

Nom	Type	Description
creating	string	Le service Batch a obtenu la machine virtuelle sous-jacente à partir d’Azure Compute, mais il n’a pas encore commencé à rejoindre le pool.
deallocated	string	Le nœud de calcul est désalloué.
deallocating	string	Le nœud de calcul est déallouer.
idle	string	Le nœud de calcul n’exécute actuellement pas de tâche.
leavingpool	string	Le nœud de calcul quitte le pool, soit parce que l’utilisateur l’a supprimé explicitement, soit parce que le pool redimensionne ou la mise à l’échelle automatique.
offline	string	Le nœud de calcul n’exécute pas actuellement de tâche et la planification de nouvelles tâches sur le nœud de calcul est désactivée.
preempted	string	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.
rebooting	string	Le nœud de calcul redémarre.
reimaging	string	Le nœud de calcul est réimagée.
running	string	Le nœud de calcul exécute une ou plusieurs tâches (autres qu’une tâche StartTask).
starting	string	Le service Batch démarre sur la machine virtuelle sous-jacente.
starttaskfailed	string	StartTask a échoué sur le nœud de calcul (et épuisé toutes les nouvelles tentatives) et waitForSuccess est défini. Le nœud de calcul n’est pas utilisable pour l’exécution des tâches.
unknown	string	Le service Batch a perdu le contact avec le nœud de calcul et ne connaît pas son état réel.
unusable	string	Le nœud de calcul ne peut pas être utilisé pour l’exécution de la tâche en raison d’erreurs.
upgradingos	string	Le nœud de calcul subit une opération de mise à niveau du système d’exploitation.
waitingforstarttask	string	StartTask a commencé à s’exécuter sur le nœud de calcul, mais waitForSuccess est défini et StartTask n’a pas encore terminé.

ContainerHostBatchBindMountEntry

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

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

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

ContainerRegistry

Registre de conteneurs privé.

Nom	Type	Description
identityReference	ComputeNodeIdentityReference	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. Référence à une identité affectée par l’utilisateur associée au pool Batch qu’un nœud de calcul utilisera.
password	string	Mot de passe pour vous connecter au serveur de Registre.
registryServer	string	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

Emplacement du répertoire de travail de tâche de conteneur.

Nom	Type	Description
containerImageDefault	string	Utilisez le répertoire de travail défini dans l’image conteneur. Veillez à ce que ce répertoire ne contienne pas les fichiers de ressources téléchargés par Batch.
taskWorkingDirectory	string	Utilisez le répertoire de travail de tâche du service Batch standard, qui contiendra les fichiers de ressources de tâche renseignés par Batch.

ElevationLevel

Niveau d’élévation de l’utilisateur.

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

EnvironmentSetting

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.

ErrorCategory

Catégorie de l’erreur.

Nom	Type	Description
servererror	string	L’erreur est due à un problème de serveur interne.
usererror	string	L’erreur est due à un problème d’utilisateur, tel que la configuration incorrecte.

ErrorMessage

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

Nom	Type	Description
lang	string	Code de langue du message d’erreur
value	string	Texte du message.

ImageReference

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 « Répertorier les images prises en charge ».

Nom	Type	Description
communityGalleryImageId	string	Identificateur unique de l’image de la galerie de communautés 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	Version spécifique de l’image de plateforme ou de la place de marché 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 » lorsque le pool a été créé était « latest ».
offer	string	Type d’offre de l’image de la Place de marché des machines virtuelles Azure. Par exemple, UbuntuServer ou WindowsServer.
publisher	string	Éditeur de l’image de la Place de marché des machines virtuelles Azure. Par exemple, Canonical ou MicrosoftWindowsServer.
sharedGalleryImageId	string	Identificateur unique de l’image de la 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	Référence SKU de l’image de la Place de marché des machines virtuelles Azure. Par exemple, 18.04-LTS ou 2019-Datacenter.
version	string	Version de l’image de la Place de marché des machines virtuelles Azure. Vous pouvez spécifier la valeur « latest » pour sélectionner la dernière version d’une image. S’il est omis, la valeur par défaut est « latest ».
virtualMachineImageId	string	Identificateur de ressource ARM de l’image de la galerie de calcul Azure. Les nœuds de calcul du pool sont créés à l’aide de cet ID d’image. Il s’agit de 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 la dernière version d’image. Cette propriété s’exclue mutuellement avec d’autres propriétés ImageReference. L’image de la galerie de calcul Azure doit avoir des réplicas dans la même région et doit se trouver dans le même abonnement que le compte Azure Batch. Si la version de l’image n’est pas spécifiée dans l’id d’image, la dernière version sera utilisée. Pour plus d’informations sur les paramètres de pare-feu de l’agent de nœud de calcul Batch pour communiquer avec le service Batch, consultez https://docs.microsoft.com/azure/batch/nodes-and-pools#virtual-network-vnet-and-firewall-configuration.

InboundEndpoint

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

Nom	Type	Description
backendPort	integer	Numéro de port principal du point de terminaison.
frontendPort	integer	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	Nom de domaine complet public pour le nœud de calcul.
publicIPAddress	string	Adresse IP publique du nœud de calcul.

InboundEndpointProtocol

Protocole du point de terminaison.

Nom	Type	Description
tcp	string	Utilisez TCP pour le point de terminaison.
udp	string	Utilisez UDP pour le point de terminaison.

NameValuePair

Représente une paire nom-valeur.

Nom	Type	Description
name	string	Nom de la paire nom-valeur.
value	string	Valeur de la paire nom-valeur.

NodeAgentInformation

Informations sur l’agent De nœud de calcul.

Nom	Type	Description
lastUpdateTime	string	Heure à laquelle l’agent de nœud de calcul a été mis à jour sur le nœud de calcul. Il s’agit de la dernière fois que l’agent Compute Node a été mis à jour vers une nouvelle version.
version	string	Version de l’agent Batch Compute Node s’exécutant 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 à https://github.com/Azure/Batch/blob/master/changelogs/nodeagent/CHANGELOG.md.

ResourceFile

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

Nom	Type	Description
autoStorageContainerName	string	Nom du conteneur de stockage 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é s’applique uniquement aux fichiers téléchargés sur des nœuds de calcul Linux. Elle sera ignorée si elle est spécifiée 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 de calcul Linux, la valeur par défaut 0770 est appliquée au fichier.
filePath	string	Emplacement sur le nœud de calcul vers lequel télécharger le ou les fichiers, 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 d’accès relatif spécifié ne peut pas sortir du répertoire de travail de la tâche (par exemple à l’aide de '..').
httpUrl	string	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	ComputeNodeIdentityReference	Référence à l’identité affectée par l’utilisateur à utiliser pour accéder au stockage Blob Azure spécifié par storageContainerUrl ou httpUrl Référence à une identité affectée par l’utilisateur associée au pool Batch qu’un nœud de calcul utilisera.
storageContainerUrl	string	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

Indique si le nœud de calcul est disponible pour la planification des tâches.

Nom	Type	Description
disabled	string	Aucune nouvelle tâche n’est planifiée sur le nœud de calcul. Les tâches déjà en cours d’exécution sur le nœud de calcul peuvent toujours s’exécuter jusqu’à la fin. Tous les nœuds de calcul commencent par la planification activée.
enabled	string	Les tâches peuvent être planifiées sur le nœud de calcul.

StartTask

Tâche exécutée lorsqu’un nœud joint un pool dans le service Azure Batch, ou lorsque le nœud de calcul est redémarré ou réinitialisé.

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://docs.microsoft.com/azure/batch/batch-compute-node-environment-variables).
containerSettings	TaskContainerSettings	Paramètres du conteneur sous lequel StartTask s’exécute. Lorsque cela est spécifié, tous les répertoires sont récursifs 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 d’environnement de tâche sont mappées au conteneur et la ligne de commande Task 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 répercutés sur le disque hôte, ce qui signifie que les API de fichier Batch ne pourront pas accéder à ces fichiers.
environmentSettings	EnvironmentSetting[]	Liste des paramètres de variable d’environnement pour StartTask.
maxTaskRetryCount	integer	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	Identité de l’utilisateur sous laquelle StartTask s’exécute. 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.

StartTaskInformation

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

Nom	Type	Description
containerInfo	TaskContainerExecutionInformation	Informations sur le conteneur sous lequel la tâche s’exécute. Cette propriété est définie uniquement si la tâche s’exécute dans un contexte de conteneur.
endTime	string	Heure à laquelle StartTask a cessé de s’exécuter. Il s’agit de l’heure de fin de l’exécution la plus récente de StartTask, si cette exécution est terminée (même si cette exécution a échoué et qu’une nouvelle tentative est en attente). Cet élément n’est pas présent si StartTask est en cours d’exécution.
exitCode	integer	Code de sortie du programme spécifié sur la ligne de commande StartTask. Cette propriété est définie uniquement si 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 d’applications pour ce processus. Si vous utilisez la valeur du code de sortie pour prendre des décisions dans votre code, veillez à connaître la convention de code de sortie utilisée par le processus d’application. Toutefois, si le service Batch met fin à StartTask (en raison du délai d’expiration ou de l’arrêt de l’utilisateur via l’API), vous pouvez voir un code de sortie défini par le système d’exploitation.
failureInfo	TaskFailureInformation	Informations décrivant l’échec de la tâche, le cas échéant. Cette propriété est définie uniquement si la tâche est dans l’état terminé et a rencontré un échec.
lastRetryTime	string	Heure la plus récente à laquelle 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 retryCount n’est pas différente de zéro). Si elle est présente, elle est généralement identique à startTime, mais peut être différente si la tâche a été redémarrée pour des raisons autres que la nouvelle tentative ; par exemple, si le nœud de calcul a été redémarré lors d’une nouvelle tentative, le startTime est mis à jour, mais le dernierRetryTime n’est pas.
result	TaskExecutionResult	Résultat de l’exécution de la tâche. Si la valeur est « échec », les détails de l’échec sont trouvés dans la propriété failureInfo.
retryCount	integer	Nombre de fois où la tâche a été retentée par le service Batch. Les échecs d’application de tâche (code de sortie différent de zéro) sont retentés, les erreurs de prétraitement (la tâche n’a pas pu être exécutée) et les erreurs de chargement de fichier ne sont pas retentées. Le service Batch réessaye la tâche jusqu’à la limite spécifiée par les contraintes.
startTime	string	Heure à laquelle StartTask a commencé à s’exécuter. Cette valeur est réinitialisée chaque fois que la tâche est redémarrée ou retentée (autrement dit, il s’agit de l’heure la plus récente à laquelle l’opération StartTask a démarré).
state	StartTaskState	État de StartTask sur le nœud de calcul.

StartTaskState

État de StartTask sur le nœud de calcul.

Nom	Type	Description
completed	string	StartTask a quitté le code de sortie 0, ou StartTask a échoué et la limite de nouvelle tentative a atteint, ou le processus StartTask n’a pas été exécuté en raison d’erreurs de préparation des tâches (telles que les échecs de téléchargement de fichiers de ressources).
running	string	StartTask est en cours d’exécution.

TaskContainerExecutionInformation

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

Nom	Type	Description
containerId	string	ID du conteneur.
error	string	Informations d’erreur détaillées sur le conteneur. Il s’agit de la chaîne d’erreur détaillée du service Docker, le cas échéant. Il équivaut au champ d’erreur retourné par « docker inspect ».
state	string	État du conteneur. Il s’agit de l’état du conteneur en fonction du service Docker. Il équivaut au champ d’état retourné par « docker inspect ».

TaskContainerSettings

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	Image à utiliser pour créer le conteneur dans lequel la tâche s’exécutera. Il s’agit de la référence d’image complète, comme indiqué dans « docker pull ». Si aucune balise n’est fournie dans le cadre du nom de l’image, la balise « :latest » est utilisée comme valeur par défaut.
registry	ContainerRegistry	Registre privé qui contient l’image conteneur. Ce paramètre peut être omis s’il a déjà été fourni lors de la création du pool.
workingDirectory	ContainerWorkingDirectory	Emplacement du répertoire de travail de tâche de conteneur. La valeur par défaut est « taskWorkingDirectory ».

TaskExecutionInformation

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

Nom	Type	Description
containerInfo	TaskContainerExecutionInformation	Informations sur le conteneur sous lequel la tâche s’exécute. Cette propriété est définie uniquement si la tâche s’exécute dans un contexte de conteneur.
endTime	string	Heure à laquelle la tâche s’est terminée. Cette propriété est définie uniquement si la tâche est dans l’état Terminé.
exitCode	integer	Code de sortie du programme spécifié sur la ligne de commande Tâche. Cette propriété est définie uniquement 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 d’applications pour ce processus. Si vous utilisez la valeur du code de sortie pour prendre des décisions dans votre code, veillez à connaître la convention de code de sortie utilisée par le processus d’application. Toutefois, si le service Batch met fin à la tâche (en raison du délai d’expiration ou de l’arrêt de l’utilisateur via l’API), vous pouvez voir un code de sortie défini par le système d’exploitation.
failureInfo	TaskFailureInformation	Informations décrivant l’échec de la tâche, le cas échéant. Cette propriété est définie uniquement si la tâche est dans l’état terminé et a rencontré un échec.
lastRequeueTime	string	Heure la plus récente à laquelle la tâche a été mise 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 requeueCount est différent de zéro.
lastRetryTime	string	Heure la plus récente à laquelle 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 retryCount n’est pas différente de zéro). Si elle est présente, elle est généralement identique à startTime, mais peut être différente si la tâche a été redémarrée pour des raisons autres que la nouvelle tentative ; par exemple, si le nœud de calcul a été redémarré lors d’une nouvelle tentative, le startTime est mis à jour, mais le dernierRetryTime n’est pas.
requeueCount	integer	Nombre de fois où la tâche a été mise en file d’attente par le service Batch à la suite d’une demande d’utilisateur. Lorsque l’utilisateur supprime des nœuds de calcul d’un pool (en redimensionnant/réduisant le pool) ou lorsque le travail est désactivé, l’utilisateur peut spécifier que les tâches en cours d’exécution sur les nœuds de calcul sont requeuées pour l’exécution. Ce nombre suit le nombre de fois où la tâche a été mise en file d’attente pour ces raisons.
result	TaskExecutionResult	Résultat de l’exécution de la tâche. Si la valeur est « échec », les détails de l’échec sont trouvés dans la propriété failureInfo.
retryCount	integer	Nombre de fois où la tâche a été retentée par le service Batch. Les échecs d’application de tâche (code de sortie différent de zéro) sont retentés, les erreurs de prétraitement (la tâche n’a pas pu être exécutée) et les erreurs de chargement de fichier ne sont pas retentées. Le service Batch réessaye la tâche jusqu’à la limite spécifiée par les contraintes.
startTime	string	Heure à laquelle la tâche a commencé à s’exécuter. « En cours d’exécution » correspond à l’état en cours d’exécution. Par conséquent, si la tâche spécifie des fichiers de ressources ou des packages, l’heure de début reflète l’heure à laquelle la tâche a commencé à télécharger ou à déployer ces fichiers. Si la tâche a été redémarrée ou retentée, il s’agit de l’heure la plus récente à laquelle la tâche a commencé à s’exécuter. Cette propriété est présente uniquement pour les tâches qui sont dans l’état en cours d’exécution ou terminé.

TaskExecutionResult

Résultat de l’exécution de la tâche.

Nom	Type	Description
failure	string	Une erreur s’est produite lors du traitement de la tâche. L’échec peut s’être produit avant le lancement du processus de tâche, pendant l’exécution du processus de tâche ou après la sortie du processus de tâche.
success	string	La tâche s’est exécutée avec succès.

TaskFailureInformation

Informations sur un échec de tâche.

Nom	Type	Description
category	ErrorCategory	Catégorie de l’erreur de tâche.
code	string	Identificateur de l’erreur de tâche. Les codes sont invariants et sont destinés à être consommés par programme.
details	NameValuePair[]	Liste des détails supplémentaires liés à l’erreur.
message	string	Message décrivant l’erreur de tâche, destiné à être adapté à l’affichage dans une interface utilisateur.

TaskInformation

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

Nom	Type	Description
executionInfo	TaskExecutionInformation	Informations sur l’exécution de la tâche.
jobId	string	ID du travail auquel appartient la tâche.
subtaskId	integer	ID de la sous-tâche si la tâche est une tâche multi-instance.
taskId	string	ID de la tâche.
taskState	TaskState	État actuel de la tâche.
taskUrl	string	URL de la tâche.

TaskState

État de la tâche.

Nom	Type	Description
active	string	La tâche est mise en file d’attente et peut s’exécuter, mais n’est pas actuellement affectée à un nœud de calcul. Une tâche entre dans cet état lors de sa création, lorsqu’elle est activée après avoir été désactivée ou lorsqu’elle attend une nouvelle tentative après une exécution ayant échoué.
completed	string	La tâche n’est plus éligible à l’exécution, généralement parce que la tâche s’est terminée correctement, ou que la tâche a échoué et a épuisé sa limite de nouvelle tentative. Une tâche est également marquée comme terminée si une erreur s’est produite lors du lancement de la tâche ou de la fin de la tâche.
preparing	string	La tâche a été affectée à un nœud de calcul, mais attend qu’une tâche de préparation du travail requise se termine sur le nœud de calcul. Si la tâche de préparation du travail réussit, la tâche passe à l’exécution. Si la tâche de préparation du travail échoue, la tâche revient à active et peut être affectée à un autre nœud de calcul.
running	string	La tâche s’exécute sur un nœud de calcul. Cela inclut la préparation au niveau des tâches, comme le téléchargement de fichiers de ressources ou le déploiement de packages spécifiés sur la tâche. Cela ne signifie pas nécessairement que la ligne de commande de tâche a commencé à s’exécuter.

UserIdentity

Définition de l’identité de l’utilisateur sous laquelle la tâche est exécutée.

Nom	Type	Description
autoUser	AutoUserSpecification	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	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

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

Nom	Type	Description
imageReference	ImageReference	Référence à l’image de la Place de marché de la machine virtuelle Azure.
scaleSetVmResourceId	string	ID de ressource de la machine virtuelle actuelle du groupe de machines virtuelles identiques du nœud de calcul. Défini uniquement si le compte Batch a été créé avec sa propriété poolAllocationMode définie sur « UserSubscription ».