你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

ITaskOperations.AddCollectionWithHttpMessagesAsync 方法

定义

命名空间:

Microsoft.Azure.Batch.Protocol

程序集:

Microsoft.Azure.Batch.dll

包:

Microsoft.Azure.Batch v16.2.0

Source:

ITaskOperations.cs

将 Tasks 的集合添加到指定的作业。

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

参数

jobId

String

要向其添加 Task 集合的作业的 ID。

value

IList<TaskAddParameter>

要添加的任务的集合。 任务的最大计数为 100。 此集合的总序列化大小必须小于 1MB。 如果大于 1MB (例如，如果每个任务有 100 个资源文件或环境变量) ，则请求将失败并显示代码“RequestBodyTooLarge”，并且应再次重试且任务数较少。

taskAddCollectionOptions

TaskAddCollectionOptions

操作的其他参数

customHeaders

Dictionary<String,List<String>>

将添加到请求的标头。

cancellationToken

CancellationToken

取消标记。

返回

Task<AzureOperationResponse<TaskAddCollectionResult,TaskAddCollectionHeaders>>

例外

BatchErrorException

当操作返回无效状态代码时引发

SerializationException

无法反序列化响应时引发

ValidationException

当所需参数为 null 时引发

注解

请注意，每个任务必须具有唯一的 ID。 Batch 服务可能不会返回每个任务的结果，其顺序与在此请求中提交任务的顺序相同。 如果在请求期间服务器超时或连接关闭，则请求可能已部分或完全处理，或者根本没有处理。 在这种情况下，用户应该重新发出该请求。 请注意，重新发出请求时，用户应正确处理故障。 例如，应在重试期间使用相同的任务 ID，以便如果前面的操作成功，重试不会意外创建额外的任务。 如果响应包含任何未能添加的任务，客户端可以重试请求。 在重试中，最有效的方法是仅重新提交未能添加的任务，并省略第一次尝试时已成功添加的任务。 任务从添加到完成的最长生存期为 180 天。 如果任务在添加后的 180 天内未完成，Batch 服务将终止该任务，并保留其当时处于的任何状态。