TaskOperationsExtensions.AddCollectionAsync Método

Referência

Definição

Namespace:: Microsoft.Azure.Batch.Protocol

Assembly:: Microsoft.Azure.Batch.dll

Pacote:: Microsoft.Azure.Batch v16.2.0

Origem:: TaskOperationsExtensions.cs

Importante

Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.

Adiciona uma coleção de Tarefas ao Trabalho 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

O grupo de operações para esse método de extensão.

jobId: String

A ID do trabalho ao qual a coleção Task deve ser adicionada.

value: IList<TaskAddParameter>

A coleção de Tarefas a serem adicionadas. A contagem máxima de Tarefas é de 100. O tamanho total serializado dessa coleção deve ser menor que 1 MB. Se for maior que 1 MB (por exemplo, se cada Tarefa tiver 100 arquivos de recurso ou variáveis de ambiente), a solicitação falhará com o código 'RequestBodyTooLarge' e deverá ser repetida novamente com menos Tarefas.

taskAddCollectionOptions: TaskAddCollectionOptions

Parâmetros adicionais para a operação

cancellationToken: CancellationToken

O token de cancelamento.

Retornos

Task<TaskAddCollectionResult>

Comentários

Observe que cada Tarefa deve ter uma ID exclusiva. O serviço lote pode não retornar os resultados de cada Tarefa na mesma ordem em que as Tarefas foram enviadas nesta solicitação. Se o servidor atingir o tempo limite ou a conexão for fechada durante a solicitação, a solicitação poderá ter sido parcial ou totalmente processada ou não. Nesses casos, o usuário deve emitir novamente a solicitação. Observe que cabe ao usuário lidar corretamente com falhas ao emitir novamente uma solicitação. Por exemplo, você deve usar as mesmas IDs de Tarefa durante uma repetição para que, se a operação anterior tiver sido bem-sucedida, a repetição não criará tarefas extras inesperadamente. Se a resposta contiver tarefas que não foram adicionadas, um cliente poderá repetir a solicitação. Em uma repetição, é mais eficiente reenviar somente Tarefas que não foram adicionadas e omitir Tarefas que foram adicionadas com êxito na primeira tentativa. O tempo de vida máximo de uma Tarefa desde a adição até a conclusão é de 180 dias. Se uma Tarefa não tiver sido concluída dentro de 180 dias após ser adicionada, ela será encerrada pelo serviço do Lote e deixada em qualquer estado em que estava naquele momento.

Aplica-se a

Compartilhar via