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

CloudTask 类

定义

Azure Batch任务。 任务是与作业关联的工作,并在计算节点上运行。

public class CloudTask : Microsoft.Azure.Batch.IInheritedBehaviors, Microsoft.Azure.Batch.IRefreshable
type CloudTask = class
    interface IRefreshable
    interface IInheritedBehaviors
Public Class CloudTask
Implements IInheritedBehaviors, IRefreshable
继承
CloudTask
实现

注解

在计算节点上触发恢复操作时,Batch 将重试任务。 恢复操作的示例包括 (但不限于重新启动运行不正常的计算节点或由于主机故障而消失的计算节点时) 。 由于恢复操作而导致的重试独立于 ,并且不计入 。MaxTaskRetryCount 即使 MaxTaskRetryCount 为 0,也可能由于恢复操作而发生内部重试。 因此,所有任务都应是幂等的。 这意味着任务需要容忍中断和重启,而不会导致任何损坏或重复数据。 对于长时间运行的任务,最佳做法是使用某种形式的检查点。 任务从添加到完成的最长生存期为 180 天。 如果任务在添加后的 180 天内尚未完成,Batch 服务将终止该任务,并保留其当时处于的任何状态。

构造函数

CloudTask()

支持模拟 CloudTask 类的默认构造函数。

CloudTask(String, String)

初始化 CloudTask 类的新实例。

属性

AffinityInformation

获取或设置一个位置提示,Batch 服务可以使用该提示来选择要启动任务的节点。

ApplicationPackageReferences

获取或设置 Batch 服务在运行命令行之前将部署到计算节点的应用程序包列表。

AuthenticationTokenSettings

获取或设置任务可用于执行 Batch 服务操作的身份验证令牌的设置。

CommandLine

获取或设置任务的命令行。

ComputeNodeInformation

获取有关运行任务的计算节点的信息。

Constraints

获取或设置应用于此任务的执行约束。

ContainerSettings

获取或设置运行任务的容器的设置。

CreationTime

获取任务的创建时间。

CustomBehaviors

获取或设置一个行为列表,这些行为修改或自定义通过此 CloudTask发出的 Batch 服务的请求。

DependsOn

获取或设置此 CloudTask 依赖的任何其他任务。 在成功完成所有依赖任务之前,不会计划该任务。

DisplayName

获取或设置任务的显示名称。

EnvironmentSettings

获取或设置任务的环境变量设置列表。

ETag

获取任务的 ETag。

ExecutionInformation

获取任务的执行信息。

ExitConditions

获取或设置 Batch 服务在任务完成时应如何响应。

FilesToStage

获取或设置要为任务暂转的文件列表。

Id

获取或设置任务的 ID。

LastModified

获取任务的上次修改时间。

MultiInstanceSettings

获取或设置有关如何运行多实例任务的信息。

OutputFiles

获取或设置运行命令行后 Batch 服务将从计算节点上传的文件列表。

PreviousState

获取任务的上一状态。

PreviousStateTransitionTime

获取任务进入其上一状态的时间。

RequiredSlots

获取或设置任务运行所需的计划槽数。

ResourceFiles

获取或设置 Batch 服务在运行命令行之前将下载到计算节点的文件列表。

State

获取任务的当前状态。

StateTransitionTime

获取任务进入其当前状态的时间。

Statistics

获取任务的资源使用情况统计信息。

Url

获取任务的 URL。

UserIdentity

获取或设置运行任务时所依据的用户标识。

方法

Commit(IEnumerable<BatchClientBehavior>)

将对此CloudTask的所有挂起更改提交到Azure Batch服务。

CommitAsync(IEnumerable<BatchClientBehavior>, CancellationToken)

将对此CloudTask的所有挂起更改提交到Azure Batch服务。

CopyNodeFileContentToStream(String, Stream, GetFileRequestByteRange, IEnumerable<BatchClientBehavior>)

将任务目录中文件的内容从 节点复制到给定 Stream的 。

CopyNodeFileContentToStreamAsync(String, Stream, GetFileRequestByteRange, IEnumerable<BatchClientBehavior>, CancellationToken)

将任务目录中文件的内容从 节点复制到给定 Stream的 。

CopyNodeFileContentToString(String, Encoding, GetFileRequestByteRange, IEnumerable<BatchClientBehavior>)

将计算节点上任务目录中的文件内容读入字符串。

CopyNodeFileContentToStringAsync(String, Encoding, GetFileRequestByteRange, IEnumerable<BatchClientBehavior>, CancellationToken)

将计算节点上任务目录中的文件内容读入字符串。

Delete(IEnumerable<BatchClientBehavior>)

删除此 CloudTask

DeleteAsync(IEnumerable<BatchClientBehavior>, CancellationToken)

删除此 CloudTask

GetNodeFile(String, IEnumerable<BatchClientBehavior>)

从计算节点上的 CloudTask目录获取指定的 NodeFile

GetNodeFileAsync(String, IEnumerable<BatchClientBehavior>, CancellationToken)

从计算节点上的 CloudTask目录获取指定的 NodeFile

ListNodeFiles(Nullable<Boolean>, DetailLevel, IEnumerable<BatchClientBehavior>)

枚举其计算节点上 的 目录中的文件 CloudTask

ListSubtasks(DetailLevel, IEnumerable<BatchClientBehavior>)

枚举多实例 CloudTask的子任务。

Reactivate(IEnumerable<BatchClientBehavior>)

重新激活此 CloudTask,即使重试计数已用尽,也允许它再次运行。

ReactivateAsync(IEnumerable<BatchClientBehavior>, CancellationToken)

重新激活此 CloudTask,即使重试计数已用尽,也允许它再次运行。

Refresh(DetailLevel, IEnumerable<BatchClientBehavior>)

刷新当前 CloudTask

RefreshAsync(DetailLevel, IEnumerable<BatchClientBehavior>, CancellationToken)

刷新当前 CloudTask

StageFiles()

暂存列表中列出的 FilesToStage 文件。

StageFilesAsync(ConcurrentDictionary<Type,IFileStagingArtifact>)

暂存列表中列出的 FilesToStage 文件。

Terminate(IEnumerable<BatchClientBehavior>)

终止此 CloudTask,将其标记为已完成。

TerminateAsync(IEnumerable<BatchClientBehavior>, CancellationToken)

终止此 CloudTask,将其标记为已完成。

扩展方法

GetOutputStoragePath(CloudTask, TaskOutputKind)

获取存储给定类型的文件的 Blob 名称前缀/文件夹

OutputStorage(CloudTask, BlobServiceClient)

TaskOutputStorage获取指定 CloudTask的 。

适用于