你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
TaskOperationsExtensions.AddCollection 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
将 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
操作的其他参数
返回
注解
请注意,每个任务必须具有唯一的 ID。 Batch 服务可能不会按在此请求中提交任务的顺序返回每个任务的结果。 如果服务器在请求期间超时或连接关闭,则请求可能已部分或完全处理,或者根本不处理。 在这种情况下,用户应该重新发出该请求。 请注意,重新发出请求时,用户应正确处理故障。 例如,在重试期间应使用相同的任务 ID,以便如果上一个操作成功,重试不会意外创建额外的任务。 如果响应包含任何未能添加的任务,客户端可以重试请求。 在重试中,最高效的是仅重新提交未能添加的任务,并省略第一次尝试时已成功添加的任务。 任务从添加到完成的最长生存期为 180 天。 如果任务在添加后的 180 天内尚未完成,Batch 服务将终止该任务,并保留其当时处于的任何状态。