ITaskOperations.AddCollectionWithHttpMessagesAsync Método

Definición

Espacio de nombres:

Microsoft.Azure.Batch.Protocol

Ensamblado:

Microsoft.Azure.Batch.dll

Paquete:

Microsoft.Azure.Batch v16.2.0

Source:

ITaskOperations.cs

Agrega una colección de Tareas al trabajo especificado.

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))

Parámetros

jobId

String

Identificador del trabajo al que se va a agregar la colección Task.

value

IList<TaskAddParameter>

Colección de Tareas que se va a agregar. El recuento máximo de tareas es 100. El tamaño serializado total de esta colección debe ser inferior a 1 MB. Si es mayor que 1 MB (por ejemplo, si cada tarea tiene 100 archivos de recursos o variables de entorno), se producirá un error en la solicitud con el código "RequestBodyTooLarge" y se volverá a intentar con menos tareas.

taskAddCollectionOptions

TaskAddCollectionOptions

Parámetros adicionales para la operación

customHeaders

Dictionary<String,List<String>>

Encabezados que se agregarán a la solicitud.

cancellationToken

CancellationToken

Token de cancelación.

Devoluciones

Task<AzureOperationResponse<TaskAddCollectionResult,TaskAddCollectionHeaders>>

Excepciones

BatchErrorException

Se produce cuando la operación devolvió un código de estado no válido

SerializationException

Se produce cuando no se puede deserializar la respuesta

ValidationException

Se produce cuando un parámetro obligatorio es NULL

Comentarios

Tenga en cuenta que cada tarea debe tener un identificador único. Es posible que el servicio Batch no devuelva los resultados de cada tarea en el mismo orden en que se enviaron las tareas en esta solicitud. Si el servidor agota el tiempo de espera o la conexión se cierra durante la solicitud, es posible que la solicitud se haya procesado parcialmente o totalmente, o no en absoluto. En tales casos, el usuario debe volver a emitir la solicitud. Tenga en cuenta que el usuario debe controlar correctamente los errores al volver a emitir una solicitud. Por ejemplo, debe usar los mismos identificadores de tarea durante un reintento para que, si la operación anterior se realizó correctamente, el reintento no creará tareas adicionales de forma inesperada. Si la respuesta contiene cualquier tarea que no se pudo agregar, un cliente puede reintentar la solicitud. En un reintento, es más eficaz volver a enviar solo las tareas que no se pudieron agregar y omitir las tareas que se agregaron correctamente en el primer intento. La duración máxima de una tarea a partir de la finalización es de 180 días. Si una tarea no se ha completado en un plazo de 180 días después de agregarla, el servicio Batch finalizará y se dejará en cualquier estado en el que estuviera en ese momento.