Partager via

ComputeNode Classe

  • Référence

Un nœud de calcul dans le service Batch.

Héritage
Model
ComputeNode

Constructeur

ComputeNode(*, id: str = None, url: str = None, state=None, scheduling_state=None, state_transition_time=None, last_boot_time=None, allocation_time=None, ip_address: str = None, affinity_id: str = None, vm_size: str = None, total_tasks_run: int = None, running_tasks_count: int = None, running_task_slots_count: int = None, total_tasks_succeeded: int = None, recent_tasks=None, start_task=None, start_task_info=None, certificate_references=None, errors=None, is_dedicated: bool = None, endpoint_configuration=None, node_agent_info=None, virtual_machine_info=None, **kwargs)

Paramètres

id
str
Obligatoire

Chaque nœud de calcul ajouté à un pool se voit attribuer 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.

url
str
Obligatoire
state
str ou ComputeNodeState
Obligatoire

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’il a été préempté seront replanifiées lorsqu’un autre nœud de calcul sera disponible. Les valeurs possibles sont les suivantes : « idle », « rebooting », « reimaging », « running », « inutilisable », « creating », « starting », « waitingForStartTask », « startTaskFailed », « unknown », « leavingPool », « offline », « preempted »

scheduling_state
str ou SchedulingState
Obligatoire

Les valeurs possibles sont les suivantes : « enabled », « disabled »

state_transition_time
datetime
Obligatoire
last_boot_time
datetime
Obligatoire

Cette propriété peut ne pas être présente si l’état du nœud de calcul est inutilisable.

allocation_time
datetime
Obligatoire

Il s’agit de l’heure à laquelle le nœud de calcul a été initialement alloué et ne change pas une fois défini. Il n’est pas mis à jour lorsque le nœud de calcul est réparé ou préempté.

ip_address
str
Obligatoire

Chaque nœud de calcul ajouté à un pool se voit attribuer 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 de nouveaux nœuds de calcul.

affinity_id
str
Obligatoire

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.

vm_size
str
Obligatoire

Pour plus d’informations sur les tailles disponibles des 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).

total_tasks_run
int
Obligatoire

Nombre total de tâches de travail effectué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 ou les tâches de démarrage.

running_tasks_count
int
Obligatoire

Nombre total de tâches de travail 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 ou les tâches de démarrage.

running_task_slots_count
int
Obligatoire

Nombre total d’emplacements de planification utilisés par les tâches de travail 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 ou les tâches de démarrage.

total_tasks_succeeded
int
Obligatoire

Nombre total de tâches de travail qui se sont terminé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 ou les tâches de démarrage.

recent_tasks
list[TaskInformation]
Obligatoire

Cette propriété est présente uniquement si au moins une tâche s’est exécutée sur ce nœud de calcul depuis qu’elle a été affectée au pool.

start_task
StartTask
Obligatoire

Tâche spécifiée pour s’exécuter sur le nœud de calcul à mesure qu’il rejoint le pool.

start_task_info
StartTaskInformation
Obligatoire

Informations d’exécution sur l’exécution de StartTask sur le nœud de calcul.

certificate_references
list[CertificateReference]
Obligatoire

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 la tâche et une variable d’environnement AZ_BATCH_CERTIFICATES_DIR est fournie à la tâche pour rechercher cet emplacement. Pour les certificats avec une visibilité de « remoteUser », un répertoire « certs » est créé dans le répertoire de base de l’utilisateur (par exemple, /home/{nom-utilisateur}/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 .

errors
list[ComputeNodeError]
Obligatoire
is_dedicated
bool
Obligatoire

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

endpoint_configuration
ComputeNodeEndpointConfiguration
Obligatoire

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

node_agent_info
NodeAgentInformation
Obligatoire

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.

virtual_machine_info
VirtualMachineInfo
Obligatoire

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

Méthodes

as_dict

Retourne un dictée qui peut être JSONify à l’aide de json.dump.

L’utilisation avancée peut éventuellement utiliser un rappel comme paramètre :

La clé est le nom d’attribut utilisé dans Python. Attr_desc est un dictée de métadonnées. Contient actuellement « type » avec le type msrest et « key » avec la clé encodée RestAPI. Value est la valeur actuelle dans cet objet.

La chaîne retournée sera utilisée pour sérialiser la clé. Si le type de retour est une liste, cela est considéré comme un dicté de résultat hiérarchique.

Consultez les trois exemples de ce fichier :

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Si vous souhaitez une sérialisation XML, vous pouvez passer les kwargs is_xml=True.
deserialize

Analysez un str à l’aide de la syntaxe RestAPI et retournez un modèle.
enable_additional_properties_sending
from_dict

L’analyse d’un dicté à l’aide de l’extracteur de clé donné retourne un modèle.

Par défaut, considérez les extracteurs de clés (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor et last_rest_key_case_insensitive_extractor)
is_xml_model
serialize

Retourne le JSON qui serait envoyé à Azure à partir de ce modèle.

Il s’agit d’un alias pour as_dict(full_restapi_key_transformer, keep_readonly=False).

Si vous souhaitez une sérialisation XML, vous pouvez passer les kwargs is_xml=True.
validate

Validez ce modèle de manière récursive et retournez une liste de ValidationError.

as_dict

Retourne un dictée qui peut être JSONify à l’aide de json.dump.

L’utilisation avancée peut éventuellement utiliser un rappel comme paramètre :

La clé est le nom d’attribut utilisé dans Python. Attr_desc est un dictée de métadonnées. Contient actuellement « type » avec le type msrest et « key » avec la clé encodée RestAPI. Value est la valeur actuelle dans cet objet.

La chaîne retournée sera utilisée pour sérialiser la clé. Si le type de retour est une liste, cela est considéré comme un dicté de résultat hiérarchique.

Consultez les trois exemples de ce fichier :

  • attribute_transformer

  • full_restapi_key_transformer

  • last_restapi_key_transformer

Si vous souhaitez une sérialisation XML, vous pouvez passer les kwargs is_xml=True.

as_dict(keep_readonly=True, key_transformer=<function attribute_transformer>, **kwargs)

Paramètres

key_transformer
<xref:function>

Fonction de transformateur de clé.

keep_readonly
valeur par défaut: True

Retours

Objet compatible JSON de dict

Type de retour

dict

deserialize

Analysez un str à l’aide de la syntaxe RestAPI et retournez un modèle.

deserialize(data, content_type=None)

Paramètres

data
str
Obligatoire

Str utilisant la structure RestAPI. JSON par défaut.

content_type
str
valeur par défaut: None

JSON par défaut, définissez application/xml si XML.

Retours

Une instance de ce modèle

Exceptions

DeserializationError if something went wrong

enable_additional_properties_sending 

enable_additional_properties_sending()

from_dict

L’analyse d’un dicté à l’aide de l’extracteur de clé donné retourne un modèle.

Par défaut, considérez les extracteurs de clés (rest_key_case_insensitive_extractor, attribute_key_case_insensitive_extractor et last_rest_key_case_insensitive_extractor)

from_dict(data, key_extractors=None, content_type=None)

Paramètres

data
dict
Obligatoire

Dict utilisant la structure RestAPI

content_type
str
valeur par défaut: None

JSON par défaut, définissez application/xml si XML.

key_extractors
valeur par défaut: None

Retours

Une instance de ce modèle

Exceptions

DeserializationError if something went wrong

is_xml_model 

is_xml_model()

serialize

Retourne le JSON qui serait envoyé à Azure à partir de ce modèle.

Il s’agit d’un alias pour as_dict(full_restapi_key_transformer, keep_readonly=False).

Si vous souhaitez une sérialisation XML, vous pouvez passer les kwargs is_xml=True.

serialize(keep_readonly=False, **kwargs)

Paramètres

keep_readonly
bool
valeur par défaut: False

Si vous souhaitez sérialiser les attributs readonly

Retours

Objet compatible JSON de dict

Type de retour

dict

validate

Validez ce modèle de manière récursive et retournez une liste de ValidationError.

validate()

Retours

Liste des erreurs de validation

Type de retour

list