JobAddParameter interface
Interface représentant JobAddParameter.
Propriétés
| common |
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. |
| display |
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). |
| job |
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. |
| job |
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. |
| job |
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. |
| network |
Configuration réseau du travail. |
| on |
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' |
| on |
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 » |
| pool |
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. |
| uses |
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