TaskOperationsExtensions.AddCollectionAsync Méthode

Référence

Définition

Espace de noms:: Microsoft.Azure.Batch.Protocol

Assembly:: Microsoft.Azure.Batch.dll

Paquet:: Microsoft.Azure.Batch v16.2.0

Source:: TaskOperationsExtensions.cs

Important

Certaines informations portent sur la préversion du produit qui est susceptible d’être en grande partie modifiée avant sa publication. Microsoft exclut toute garantie, expresse ou implicite, concernant les informations fournies ici.

Ajoute une collection de tâches au travail spécifié.

public static System.Threading.Tasks.Task<Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult> AddCollectionAsync (this Microsoft.Azure.Batch.Protocol.ITaskOperations operations, string jobId, System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> value, Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions taskAddCollectionOptions = default, System.Threading.CancellationToken cancellationToken = default);

static member AddCollectionAsync : Microsoft.Azure.Batch.Protocol.ITaskOperations * string * System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> * Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult>

<Extension()>
Public Function AddCollectionAsync (operations As ITaskOperations, jobId As String, value As IList(Of TaskAddParameter), Optional taskAddCollectionOptions As TaskAddCollectionOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of TaskAddCollectionResult)

Paramètres

operations: ITaskOperations

Groupe d’opérations pour cette méthode d’extension.

jobId: String

ID du travail auquel la collection de tâches doit être ajoutée.

value: IList<TaskAddParameter>

Collection de tâches à ajouter. Le nombre maximal de tâches est de 100. La taille totale sérialisée de cette collection doit être inférieure à 1 Mo. Si elle est supérieure à 1 Mo (par exemple, si chaque tâche a 100 de fichiers de ressources ou de variables d’environnement), la requête échoue avec le code « RequestBodyTooLarge » et doit être retentée avec moins de tâches.

taskAddCollectionOptions: TaskAddCollectionOptions

Paramètres supplémentaires pour l’opération

cancellationToken: CancellationToken

Jeton d'annulation.

Retours

Task<TaskAddCollectionResult>

Remarques

Notez que chaque tâche doit avoir un ID unique. Le service Batch peut ne pas retourner les résultats de chaque tâche dans le même ordre que celui que les tâches ont été envoyées dans cette demande. Si le serveur expire ou si la connexion est fermée pendant la demande, la demande a peut-être été partiellement ou entièrement traitée, ou pas du tout. Dans ce cas, l'utilisateur doit renouveler la demande. Notez qu’il incombe à l’utilisateur de gérer correctement les échecs lors de la réécriture d’une demande. Par exemple, vous devez utiliser les mêmes ID de tâche pendant une nouvelle tentative afin que si l’opération précédente a réussi, la nouvelle tentative ne crée pas de tâches supplémentaires de manière inattendue. Si la réponse contient des tâches qui n’ont pas pu être ajoutées, un client peut réessayer la demande. Dans une nouvelle tentative, il est plus efficace de renvoyer uniquement les tâches qui n’ont pas pu être ajoutées et d’omettre les tâches qui ont été ajoutées avec succès lors de la première tentative. La durée de vie maximale d’une tâche de l’addition à la fin est de 180 jours. Si une tâche n’est pas terminée dans les 180 jours suivant son ajout, elle est arrêtée par le service Batch et laissée dans l’état dans lequel elle se trouvait à ce moment-là.

S’applique à

Partager via