ITaskOperations.AddCollectionWithHttpMessagesAsync Método

Referência

Definição

Namespace:: Microsoft.Azure.Batch.Protocol

Assembly:: Microsoft.Azure.Batch.dll

Pacote:: Microsoft.Azure.Batch v16.2.0

Origem:: ITaskOperations.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 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

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

customHeaders: Dictionary<String,List<String>>

Os cabeçalhos que serão adicionados à solicitação.

cancellationToken: CancellationToken

O token de cancelamento.

Retornos

Task<AzureOperationResponse<TaskAddCollectionResult,TaskAddCollectionHeaders>>

Exceções

BatchErrorException

Gerado quando a operação retornou um código de status inválido

SerializationException

Gerado quando não é possível desserializar a resposta

ValidationException

Gerado quando um parâmetro necessário é nulo

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