TaskOperationsExtensions.AddCollectionAsync Método

Referencia

Definición

Espacio de nombres:: Microsoft.Azure.Batch.Protocol

Ensamblado:: Microsoft.Azure.Batch.dll

Paquete:: Microsoft.Azure.Batch v16.3.1

Source:: TaskOperationsExtensions.cs

Importante

Parte de la información hace referencia a la versión preliminar del producto, que puede haberse modificado sustancialmente antes de lanzar la versión definitiva. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.

Agrega una colección de tareas al trabajo especificado.

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)

Parámetros

operations: ITaskOperations

Grupo de operaciones para este método de extensión.

jobId: String

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

value: IList<TaskAddParameter>

Colección de tareas que se van a agregar. El recuento máximo de tareas es 100. El tamaño total serializado 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

cancellationToken: CancellationToken

Token de cancelación.

Devoluciones

Task<TaskAddCollectionResult>

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 inesperadamente. 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 desde la adición hasta la finalización es de 180 días. Si el servicio Batch no ha completado una tarea en un plazo de 180 días a partir de la adición, el servicio Batch finalizará y dejará en cualquier estado en el que estuviera en ese momento.

Se aplica a

Compartir a través de