Partager via


JobAddParameter interface

Interface représentant JobAddParameter.

Propriétés

commonEnvironmentSettings

Liste des paramètres courants des variables d’environnement. Ces variables d’environnement sont définies pour toutes les tâches du travail (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 le travail.

displayName

Nom complet du travail. Le nom complet n’a pas besoin d’être unique et peut contenir des caractères Unicode pouvant atteindre une longueur maximale de 1024.

id

Chaîne qui identifie de façon unique le travail dans le compte. L’ID peut contenir n’importe quelle combinaison de caractères alphanumériques, y compris des traits d’union et des traits de soulignement, et ne peut pas contenir plus de 64 caractères. L’ID est respectant la casse et ne respecte pas la casse (autrement dit, vous n’avez peut-être pas deux ID au sein d’un compte qui diffèrent uniquement par cas).

jobManagerTask

Détails d’une tâche du Gestionnaire de travaux à lancer au démarrage du travail. Si le travail ne spécifie pas de tâche du Gestionnaire de travaux, l’utilisateur doit ajouter explicitement des tâches au travail. 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. L’objectif classique de la tâche du Gestionnaire de travaux est de contrôler et/ou de surveiller l’exécution du travail, par exemple en choisissant les tâches supplémentaires à exécuter, en déterminant quand le travail est terminé, etc. (Toutefois, une tâche du Gestionnaire de travaux n’est pas limitée à ces activités - il s’agit d’une tâche à part entière dans le système et d’effectuer les actions requises pour le travail.) Par exemple, une tâche du Gestionnaire de travaux peut télécharger un fichier spécifié en tant que paramètre, analyser le contenu de ce fichier et envoyer des tâches supplémentaires en fonction de ce contenu.

jobPreparationTask

Tâche de préparation du travail. 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. 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 qui ont exécuté la tâche de préparation du travail. L’objectif principal de la tâche de mise en production du travail consiste à annuler les modifications apportées aux nœuds de calcul 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.

metadata

Liste des paires nom-valeur associées au travail 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

Action que le service Batch doit effectuer lorsque toutes les tâches du travail 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 quand une tâche dans le travail échoue. Une tâche est considérée comme ayant é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 du travail.

priority

Priorité du travail. 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.

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 courants des variables d’environnement. Ces variables d’environnement sont définies pour toutes les tâches du travail (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 le travail.

constraints?: JobConstraints

Valeur de propriété

displayName

Nom complet du travail. Le nom complet 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

id

Chaîne qui identifie de façon unique le travail dans le compte. L’ID peut contenir n’importe quelle combinaison de caractères alphanumériques, y compris des traits d’union et des traits de soulignement, et ne peut pas contenir plus de 64 caractères. L’ID est respectant la casse et ne respecte pas la casse (autrement dit, vous n’avez peut-être pas deux ID au sein d’un compte qui diffèrent uniquement par cas).

id: string

Valeur de propriété

string

jobManagerTask

Détails d’une tâche du Gestionnaire de travaux à lancer au démarrage du travail. Si le travail ne spécifie pas de tâche du Gestionnaire de travaux, l’utilisateur doit ajouter explicitement des tâches au travail. 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. L’objectif classique de la tâche du Gestionnaire de travaux est de contrôler et/ou de surveiller l’exécution du travail, par exemple en choisissant les tâches supplémentaires à exécuter, en déterminant quand le travail est terminé, etc. (Toutefois, une tâche du Gestionnaire de travaux n’est pas limitée à ces activités - il s’agit d’une tâche à part entière dans le système et d’effectuer les actions requises pour le travail.) Par exemple, une tâche du Gestionnaire de travaux peut télécharger un fichier spécifié en tant que paramètre, analyser le contenu de ce fichier et envoyer des tâches supplémentaires en fonction de ce contenu.

jobManagerTask?: JobManagerTask

Valeur de propriété

jobPreparationTask

Tâche de préparation du travail. 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. 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 qui ont exécuté la tâche de préparation du travail. L’objectif principal de la tâche de mise en production du travail consiste à annuler les modifications apportées aux nœuds de calcul 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.

jobReleaseTask?: JobReleaseTask

Valeur de propriété

metadata

Liste des paires nom-valeur associées au travail 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

Action que le service Batch doit effectuer lorsque toutes les tâches du travail 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 quand une tâche dans le travail échoue. Une tâche est considérée comme ayant é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 du travail.

poolInfo: PoolInformation

Valeur de propriété

priority

Priorité du travail. 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.

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