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

TaskOperationsExtensions.AddCollectionAsync 方法

定义

命名空间:

Microsoft.Azure.Batch.Protocol

程序集:

Microsoft.Azure.Batch.dll

包:

Microsoft.Azure.Batch v16.2.0

Source:

TaskOperationsExtensions.cs

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

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)

参数

operations

ITaskOperations

此扩展方法的操作组。

jobId

String

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

value

IList<TaskAddParameter>

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

taskAddCollectionOptions

TaskAddCollectionOptions

操作的其他参数

cancellationToken

CancellationToken

取消标记。

返回

Task<TaskAddCollectionResult>

注解

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