Partager via


JobSpecification interface

Interface représentant JobSpecification.

Propriétés

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.

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

Configuration réseau du travail.

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. Les valeurs possibles sont les suivantes : '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. Les valeurs possibles sont les suivantes : « 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é

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é

constraints

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

constraints?: JobConstraints

Valeur de propriété

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?: JobManagerTask

Valeur de propriété

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?: JobPreparationTask

Valeur de propriété

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?: JobReleaseTask

Valeur de propriété

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?: MetadataItem[]

Valeur de propriété

networkConfiguration

Configuration réseau du travail.

networkConfiguration?: JobNetworkConfiguration

Valeur de propriété

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. Les valeurs possibles sont les suivantes : 'noAction', 'terminateJob'

onAllTasksComplete?: OnAllTasksComplete

Valeur de propriété

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. Les valeurs possibles sont les suivantes : « noAction », « performExitOptionsJobAction »

onTaskFailure?: OnTaskFailure

Valeur de propriété

poolInfo

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

poolInfo: PoolInformation

Valeur de propriété

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