ITaskOperations.AddCollectionWithHttpMessagesAsync 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:: ITaskOperations.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 System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult,Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionHeaders>> AddCollectionWithHttpMessagesAsync (string jobId, System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> value, Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions taskAddCollectionOptions = default, System.Collections.Generic.Dictionary<string,System.Collections.Generic.List<string>> customHeaders = default, System.Threading.CancellationToken cancellationToken = default);

abstract member AddCollectionWithHttpMessagesAsync : string * System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> * Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions * System.Collections.Generic.Dictionary<string, System.Collections.Generic.List<string>> * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Microsoft.Rest.Azure.AzureOperationResponse<Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult, Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionHeaders>>

Public Function AddCollectionWithHttpMessagesAsync (jobId As String, value As IList(Of TaskAddParameter), Optional taskAddCollectionOptions As TaskAddCollectionOptions = Nothing, Optional customHeaders As Dictionary(Of String, List(Of String)) = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of AzureOperationResponse(Of TaskAddCollectionResult, TaskAddCollectionHeaders))

Paramètres

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 sérialisée totale 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 demande échoue avec le code « RequestBodyTooLarge » et doit être retentée à nouveau avec moins de tâches.

taskAddCollectionOptions: TaskAddCollectionOptions

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

customHeaders: Dictionary<String,List<String>>

En-têtes qui seront ajoutés à la demande.

cancellationToken: CancellationToken

Jeton d'annulation.

Retours

Task<AzureOperationResponse<TaskAddCollectionResult,TaskAddCollectionHeaders>>

Exceptions

BatchErrorException

Levée lorsque l’opération a retourné un code de status non valide

SerializationException

Levée en cas d’impossibilité de désérialiser la réponse

ValidationException

Levée lorsqu’un paramètre obligatoire a la valeur Null

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 l’ordre dans lequel 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 appartient à 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 lors d’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’ajout à l’achèvement 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