Partager via


BatchJobUpdateOptions interface

Paramètres de mise à jour d’un travail Azure Batch.

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.

constraints

Contraintes d’exécution pour le travail. En cas d’omission, les contraintes d’exécution existantes restent inchangées.

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 au travail en tant que métadonnées. S’il est omis, les métadonnées de travail existantes restent inchangées.

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

Action que le service Batch doit effectuer lorsque toutes les tâches du travail sont dans l’état terminé. S’il est omis, le comportement d’achèvement reste inchangé. Il est possible que vous ne changez pas la valeur de terminatejob en aucune action, c’est-à-dire une fois que vous avez engagé l’arrêt automatique du travail, vous ne pouvez pas le désactiver à nouveau. Si vous essayez de le faire, la requête échoue avec une réponse d’erreur « valeur de propriété non valide » ; si vous appelez directement l’API REST, le code d’état HTTP est 400 (requête incorrecte).

Valeurs possibles : « noaction », « terminatejob »

poolInfo

Pool sur lequel le service Batch exécute les tâches du travail. Vous pouvez modifier le pool pour un travail uniquement lorsque le travail est désactivé. L’appel de travail patch échoue si vous incluez l’élément poolInfo et que le travail n’est pas désactivé. Si vous spécifiez une autoPoolSpecification dans poolInfo, seule la propriété keepAlive de l’autoPoolSpecification peut être mise à jour, puis uniquement si l’autoPoolSpecification a un poolLifetimeOption of Job (d’autres propriétés de travail peuvent être mises à jour normalement). S’il est omis, le travail continue à s’exécuter sur son pool actuel.

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. S’il est omis, la priorité du travail reste inchangée.

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

constraints

Contraintes d’exécution pour le travail. En cas d’omission, les contraintes d’exécution existantes restent inchangées.

constraints?: BatchJobConstraints

Valeur de propriété

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 au travail en tant que métadonnées. S’il est omis, les métadonnées de travail existantes restent inchangées.

metadata?: BatchMetadataItem[]

Valeur de propriété

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é

onAllTasksComplete

Action que le service Batch doit effectuer lorsque toutes les tâches du travail sont dans l’état terminé. S’il est omis, le comportement d’achèvement reste inchangé. Il est possible que vous ne changez pas la valeur de terminatejob en aucune action, c’est-à-dire une fois que vous avez engagé l’arrêt automatique du travail, vous ne pouvez pas le désactiver à nouveau. Si vous essayez de le faire, la requête échoue avec une réponse d’erreur « valeur de propriété non valide » ; si vous appelez directement l’API REST, le code d’état HTTP est 400 (requête incorrecte).

Valeurs possibles : « noaction », « terminatejob »

onAllTasksComplete?: string

Valeur de propriété

string

poolInfo

Pool sur lequel le service Batch exécute les tâches du travail. Vous pouvez modifier le pool pour un travail uniquement lorsque le travail est désactivé. L’appel de travail patch échoue si vous incluez l’élément poolInfo et que le travail n’est pas désactivé. Si vous spécifiez une autoPoolSpecification dans poolInfo, seule la propriété keepAlive de l’autoPoolSpecification peut être mise à jour, puis uniquement si l’autoPoolSpecification a un poolLifetimeOption of Job (d’autres propriétés de travail peuvent être mises à jour normalement). S’il est omis, le travail continue à s’exécuter sur son pool actuel.

poolInfo?: BatchPoolInfo

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. S’il est omis, la priorité du travail reste inchangée.

priority?: number

Valeur de propriété

number