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

TaskOperationsExtensions.AddCollection 方法

定义

命名空间:

Microsoft.Azure.Batch.Protocol

程序集:

Microsoft.Azure.Batch.dll

包:

Microsoft.Azure.Batch v16.2.0

Source:

TaskOperationsExtensions.cs

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

public static Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult AddCollection (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);

static member AddCollection : Microsoft.Azure.Batch.Protocol.ITaskOperations * string * System.Collections.Generic.IList<Microsoft.Azure.Batch.Protocol.Models.TaskAddParameter> * Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionOptions -> Microsoft.Azure.Batch.Protocol.Models.TaskAddCollectionResult

<Extension()>
Public Function AddCollection (operations As ITaskOperations, jobId As String, value As IList(Of TaskAddParameter), Optional taskAddCollectionOptions As TaskAddCollectionOptions = Nothing) As TaskAddCollectionResult

参数

operations

ITaskOperations

此扩展方法的操作组。

jobId

String

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

value

IList<TaskAddParameter>

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

taskAddCollectionOptions

TaskAddCollectionOptions

操作的其他参数

返回

TaskAddCollectionResult

注解

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