BatchJobSpecification interface

Paquet:

@azure-rest/batch

Spécifie les détails des travaux à créer selon une planification.

Propriétés

allowTaskPreemption	Indique si les tâches de ce travail peuvent être préemptées par d’autres travaux à priorité élevée. (Cette propriété n’est pas disponible par défaut. Pour plus d’informations, contactez le support technique) Si la valeur est définie sur True, les autres tâches de haute priorité soumises au système seront prioritaires et pourront remettre en file d’attente les tâches de cette tâche. Vous pouvez mettre à jour l’autorisation allowTaskPreemption d’un travail après sa création à l’aide de l’API de travail de mise à jour.
commonEnvironmentSettings	Liste des paramètres de variable d’environnement courants. Ces variables d’environnement sont définies pour toutes les tâches dans les travaux créés dans cette planification (y compris le Gestionnaire de travaux, la préparation du travail et les tâches de mise en production du travail). Les tâches individuelles peuvent remplacer un paramètre d’environnement spécifié ici en spécifiant le même nom de paramètre avec une valeur différente.
constraints	Contraintes d’exécution pour les travaux créés sous cette planification.
displayName	Nom complet des travaux créés dans cette planification. Le nom n’a pas besoin d’être unique et peut contenir des caractères Unicode pouvant atteindre une longueur maximale de 1024.
jobManagerTask	Détails d’une tâche du Gestionnaire de travaux à lancer lorsqu’un travail est démarré sous cette planification. Si le travail ne spécifie pas de tâche du Gestionnaire de travaux, l’utilisateur doit ajouter explicitement des tâches au travail à l’aide de l’API Tâche. Si le travail spécifie une tâche du Gestionnaire de travaux, le service Batch crée la tâche du Gestionnaire de travaux lors de la création du travail et tente de planifier la tâche du Gestionnaire de travaux avant de planifier d’autres tâches dans le travail.
jobPreparationTask	Tâche de préparation du travail pour les travaux créés sous cette planification. Si un travail a une tâche de préparation du travail, le service Batch exécute la tâche de préparation du travail sur un nœud avant de démarrer les tâches de ce travail sur ce nœud de calcul.
jobReleaseTask	Tâche de mise en production du travail pour les travaux créés sous cette planification. L’objectif principal de la tâche de mise en production du travail consiste à annuler les modifications apportées aux nœuds effectués par la tâche de préparation du travail. Les exemples d’activités incluent la suppression de fichiers locaux ou l’arrêt des services qui ont été démarrés dans le cadre de la préparation du travail. Impossible de spécifier une tâche de mise en production du travail sans spécifier également une tâche de préparation du travail. Le service Batch exécute la tâche de mise en production du travail sur les nœuds de calcul qui ont exécuté la tâche de préparation du travail.
maxParallelTasks	Nombre maximal de tâches qui peuvent être exécutées en parallèle pour le travail. (Cette propriété n’est pas disponible par défaut. Veuillez contacter le support pour plus d’informations) La valeur de maxParallelTasks doit être -1 ou supérieure à 0 si spécifiée. Si elle n’est pas spécifiée, la valeur par défaut est -1, ce qui signifie qu’il n’existe aucune limite au nombre de tâches qui peuvent être exécutées simultanément. Vous pouvez mettre à jour maxParallelTasks d’un travail après sa création à l’aide de l’API de travail de mise à jour.
metadata	Liste des paires nom-valeur associées à chaque travail créé sous cette planification en tant que métadonnées. Le service Batch n’affecte aucune signification aux métadonnées ; il s’agit uniquement de l’utilisation du code utilisateur.
networkConfiguration	(Cette propriété n’est pas disponible par défaut. Veuillez contacter le support pour plus d’informations) La configuration réseau du Job.
onAllTasksComplete	L’action que le service Batch doit effectuer lorsque toutes les tâches d’un travail créé sous cette planification sont dans l’état terminé. Notez que si un travail ne contient aucune tâche, toutes les tâches sont considérées comme terminées. Cette option est donc la plus couramment utilisée avec une tâche du Gestionnaire de travaux ; si vous souhaitez utiliser l’arrêt automatique du travail sans gestionnaire de travaux, vous devez initialement définir onAllTasksComplete sur noaction et mettre à jour les propriétés de travail pour définir onAllTasksComplete pour terminer la tâche une fois que vous avez terminé d’ajouter des tâches. La valeur par défaut est noaction. Valeurs possibles : « noaction », « terminatejob »
onTaskFailure	Action que le service Batch doit effectuer lorsqu’une tâche échoue dans un travail créé sous cette planification. Une tâche est considérée comme ayant échoué si elle a échoué en cas d’échec. Un failureInfo est défini si la tâche se termine avec un code de sortie autre que zéro après avoir épuisé son nombre de nouvelles tentatives, ou s’il y a eu une erreur lors du démarrage de la tâche, par exemple en raison d’une erreur de téléchargement de fichier de ressources. La valeur par défaut est noaction. Valeurs possibles : « noaction », « performexitoptionsjobaction »
poolInfo	Pool sur lequel le service Batch exécute les tâches des travaux créés sous cette planification.
priority	Priorité des travaux créés sous cette planification. Les valeurs de priorité peuvent aller de -1000 à 1 000, avec -1000 étant la priorité la plus basse et 1000 étant la priorité la plus élevée. La valeur par défaut est 0. Cette priorité est utilisée comme valeur par défaut pour tous les travaux sous la planification du travail. Vous pouvez mettre à jour la priorité d’un travail après sa création à l’aide de l’API de travail de mise à jour.
usesTaskDependencies	Indique si les tâches du travail peuvent définir des dépendances entre elles. La valeur par défaut est false.

Détails de la propriété

allowTaskPreemption

Indique si les tâches de ce travail peuvent être préemptées par d’autres travaux à priorité élevée. (Cette propriété n’est pas disponible par défaut. Pour plus d’informations, contactez le support technique) Si la valeur est définie sur True, les autres tâches de haute priorité soumises au système seront prioritaires et pourront remettre en file d’attente les tâches de cette tâche. Vous pouvez mettre à jour l’autorisation allowTaskPreemption d’un travail après sa création à l’aide de l’API de travail de mise à jour.

allowTaskPreemption?: boolean

Valeur de propriété

boolean

commonEnvironmentSettings

Liste des paramètres de variable d’environnement courants. Ces variables d’environnement sont définies pour toutes les tâches dans les travaux créés dans cette planification (y compris le Gestionnaire de travaux, la préparation du travail et les tâches de mise en production du travail). Les tâches individuelles peuvent remplacer un paramètre d’environnement spécifié ici en spécifiant le même nom de paramètre avec une valeur différente.

commonEnvironmentSettings?: EnvironmentSetting[]

Valeur de propriété

EnvironmentSetting[]

constraints

Contraintes d’exécution pour les travaux créés sous cette planification.

constraints?: BatchJobConstraints

Valeur de propriété

BatchJobConstraints

displayName

Nom complet des travaux créés dans cette planification. Le nom n’a pas besoin d’être unique et peut contenir des caractères Unicode pouvant atteindre une longueur maximale de 1024.

displayName?: string

Valeur de propriété

string

jobManagerTask

Détails d’une tâche du Gestionnaire de travaux à lancer lorsqu’un travail est démarré sous cette planification. Si le travail ne spécifie pas de tâche du Gestionnaire de travaux, l’utilisateur doit ajouter explicitement des tâches au travail à l’aide de l’API Tâche. Si le travail spécifie une tâche du Gestionnaire de travaux, le service Batch crée la tâche du Gestionnaire de travaux lors de la création du travail et tente de planifier la tâche du Gestionnaire de travaux avant de planifier d’autres tâches dans le travail.

jobManagerTask?: BatchJobManagerTask

Valeur de propriété

BatchJobManagerTask

jobPreparationTask

Tâche de préparation du travail pour les travaux créés sous cette planification. Si un travail a une tâche de préparation du travail, le service Batch exécute la tâche de préparation du travail sur un nœud avant de démarrer les tâches de ce travail sur ce nœud de calcul.

jobPreparationTask?: BatchJobPreparationTask

Valeur de propriété

BatchJobPreparationTask

jobReleaseTask

Tâche de mise en production du travail pour les travaux créés sous cette planification. L’objectif principal de la tâche de mise en production du travail consiste à annuler les modifications apportées aux nœuds effectués par la tâche de préparation du travail. Les exemples d’activités incluent la suppression de fichiers locaux ou l’arrêt des services qui ont été démarrés dans le cadre de la préparation du travail. Impossible de spécifier une tâche de mise en production du travail sans spécifier également une tâche de préparation du travail. Le service Batch exécute la tâche de mise en production du travail sur les nœuds de calcul qui ont exécuté la tâche de préparation du travail.

jobReleaseTask?: BatchJobReleaseTask

Valeur de propriété

BatchJobReleaseTask

maxParallelTasks

Nombre maximal de tâches qui peuvent être exécutées en parallèle pour le travail. (Cette propriété n’est pas disponible par défaut. Veuillez contacter le support pour plus d’informations) La valeur de maxParallelTasks doit être -1 ou supérieure à 0 si spécifiée. Si elle n’est pas spécifiée, la valeur par défaut est -1, ce qui signifie qu’il n’existe aucune limite au nombre de tâches qui peuvent être exécutées simultanément. Vous pouvez mettre à jour maxParallelTasks d’un travail après sa création à l’aide de l’API de travail de mise à jour.

maxParallelTasks?: number

Valeur de propriété

number

metadata

Liste des paires nom-valeur associées à chaque travail créé sous cette planification en tant que métadonnées. Le service Batch n’affecte aucune signification aux métadonnées ; il s’agit uniquement de l’utilisation du code utilisateur.

metadata?: BatchMetadataItem[]

Valeur de propriété

BatchMetadataItem[]

networkConfiguration

(Cette propriété n’est pas disponible par défaut. Veuillez contacter le support pour plus d’informations) La configuration réseau du Job.

networkConfiguration?: BatchJobNetworkConfiguration

Valeur de propriété

BatchJobNetworkConfiguration

onAllTasksComplete

L’action que le service Batch doit effectuer lorsque toutes les tâches d’un travail créé sous cette planification sont dans l’état terminé. Notez que si un travail ne contient aucune tâche, toutes les tâches sont considérées comme terminées. Cette option est donc la plus couramment utilisée avec une tâche du Gestionnaire de travaux ; si vous souhaitez utiliser l’arrêt automatique du travail sans gestionnaire de travaux, vous devez initialement définir onAllTasksComplete sur noaction et mettre à jour les propriétés de travail pour définir onAllTasksComplete pour terminer la tâche une fois que vous avez terminé d’ajouter des tâches. La valeur par défaut est noaction.

Valeurs possibles : « noaction », « terminatejob »

onAllTasksComplete?: string

Valeur de propriété

string

onTaskFailure

Action que le service Batch doit effectuer lorsqu’une tâche échoue dans un travail créé sous cette planification. Une tâche est considérée comme ayant échoué si elle a échoué en cas d’échec. Un failureInfo est défini si la tâche se termine avec un code de sortie autre que zéro après avoir épuisé son nombre de nouvelles tentatives, ou s’il y a eu une erreur lors du démarrage de la tâche, par exemple en raison d’une erreur de téléchargement de fichier de ressources. La valeur par défaut est noaction.

Valeurs possibles : « noaction », « performexitoptionsjobaction »

onTaskFailure?: string

Valeur de propriété

string

poolInfo

Pool sur lequel le service Batch exécute les tâches des travaux créés sous cette planification.

poolInfo: BatchPoolInfo

Valeur de propriété

BatchPoolInfo

priority

Priorité des travaux créés sous cette planification. Les valeurs de priorité peuvent aller de -1000 à 1 000, avec -1000 étant la priorité la plus basse et 1000 étant la priorité la plus élevée. La valeur par défaut est 0. Cette priorité est utilisée comme valeur par défaut pour tous les travaux sous la planification du travail. Vous pouvez mettre à jour la priorité d’un travail après sa création à l’aide de l’API de travail de mise à jour.

priority?: number

Valeur de propriété

number

usesTaskDependencies

Indique si les tâches du travail peuvent définir des dépendances entre elles. La valeur par défaut est false.

usesTaskDependencies?: boolean

Valeur de propriété

boolean