任务运行 - Amazon Glue
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

任务运行

任务运行 API 介绍与在 Amazon Glue 中开启、停止或查看任务运行以及重置任务书签相关的数据类型和 API。您可以在 90 天内访问工作流和任务运行的任务运行历史记录。

数据类型

JobRun 结构

包含有关任务运行的信息。

字段
  • Id – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    此任务运行的 ID。

  • Attempt – 数字(整数)。

    尝试运行此任务的次数。

  • PreviousRunId – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    此任务以前运行时的 ID。例如,StartJobRun 操作中指定的 JobRunId

  • TriggerName – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    启动此任务运行的触发器的名称。

  • JobName – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    此运行中使用的任务定义的名称。

  • JobMode – UTF-8 字符串(有效值:SCRIPT="" | VISUAL="" | NOTEBOOK="")。

    描述任务是如何创建的模式。有效值为:

    • SCRIPT – 该任务使用 Amazon Glue Studio 脚本编辑器创建。

    • VISUAL – 该任务使用 Amazon Glue Studio 可视化编辑器创建。

    • NOTEBOOK – 该任务使用交互式会话笔记本创建。

    JobMode 字段缺失或为空时,SCRIPT 将指定为默认值。

  • StartedOn – 时间戳。

    此任务运行的启动日期和时间。

  • LastModifiedOn – 时间戳。

    此作业运行的上次修改时间。

  • CompletedOn – 时间戳。

    此任务运行的完成日期和时间。

  • JobRunState - UTF-8 字符串(有效值:STARTING | RUNNING | STOPPING | STOPPED | SUCCEEDED | FAILED | TIMEOUT | ERROR | WAITING | EXPIRED)。

    任务运行的当前状态。有关异常终止的任务的状态的更多信息,请参阅 Amazon Glue 任务运行状态

  • Arguments – 键值对的映射数组。

    每个键是一个 UTF-8 字符串。

    每个值是一个 UTF-8 字符串。

    与此运行关联的任务参数。对于此任务运行,它们会替换任务定义本身中的默认参数集。

    可以在此处指定您自己的任务执行脚本使用的参数以及 Amazon Glue 本身使用的参数。

    可能会记录任务参数。不要将明文密钥作为参数传递。如果您想要将密钥保留在任务内,则请通过 Amazon Glue 连接、Amazon Secrets Manager 或其他密钥管理机制检索密钥。

    有关如何指定和使用您自己的任务参数的信息,请参阅开发人员指南中的在 Python 中调用 Amazon Glue API 主题。

    有关在配置 Spark 作业时可以为该字段提供的参数的信息,请参阅《开发人员指南》中的 Special Parameters Used by Amazon Glue 主题。

    有关在配置 Spark 作业时可以为该字段提供的参数的信息,请参阅《开发人员指南》中的 Using job parameters in Ray jobs

  • ErrorMessage – UTF-8 字符串。

    与此任务运行关联的错误消息。

  • PredecessorRunsPredecessor 对象的数组。

    此任务运行的前身列表。

  • AllocatedCapacity – 数字(整数)。

    此字段已弃用。请改用 MaxCapacity

    分配给此 JobRun 的 Amazon Glue 数据处理单元(DPU)的数量。可以分配 2 到 100 个 DPU;默认值为 10。DPU 是对处理能力的相对度量,它由 4 个 vCPU 的计算容量和 16GB 内存组成。有关更多信息,请参阅 Amazon Glue 价格页面

  • ExecutionTime – 数字(整数)。

    作业运行使用资源的时间长度 (以秒为单位)。

  • Timeout - 数字(整数),至少为 1。

    JobRun 超时(分钟) 这是任务运行在终止并进入 TIMEOUT 状态前可以使用资源的最长时间。此值会覆盖父任务中设置的超时值。

    流式传输任务的超时值必须小于 7 天或 10080 分钟。如果将该值留空,则如果您尚未设置维护窗口,则该任务将在 7 天后重新启动。如果您设置了维护时段,则该任务将在 7 天后的维护时段内重新启动。

  • MaxCapacity – 数字(double)。

    对于 Glue 版本 1.0 或更早版本的任务,使用标准工件类型,表示此任务运行时可分配的 Amazon Glue 数据处理单元(DPU)的数量。DPU 是对处理能力的相对度量,它由 4 个 vCPU 的计算容量和 16GB 内存组成。有关更多信息,请参阅 Amazon Glue 价格页面

    对于 Glue 版本 2.0+ 作业,不能指定 Maximum capacity。而应指定 Worker typeNumber of workers

    如果使用 WorkerTypeNumberOfWorkers,请勿设置 MaxCapacity

    可为 MaxCapacity 分配的值取决于您运行的是 Python shell 作业、Apache Spark ETL 作业,还是 Apache Spark 流 ETL 作业:

    • 当您指定 Python shell 作业 (JobCommand.Name="pythonshell"),您可以分配 0.0625 或 1 DPU。默认值为 0.0625 DPU。

    • 当您指定 Apache Spark ETL 作业 (JobCommand.Name="glueetl") 或 Apache Spark 流 ETL 作业 (JobCommand.Name="gluestreaming") 时,您可以分配 2 到 100 个 DPU。默认为 10 个 DPU。此任务类型不能具有小数 DPU 分配。

  • WorkerType – UTF-8 字符串(有效值:Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

    任务运行时分配的预定义工作线程的类型。接受 G.1X、G.2X、G.4X、G.8X 或 G.025X for Spark 作业的值。接受 Ray 作业的值 Z.2X。

    • 对于 G.1X 工作线程类型,每个工作线程映射到 1 个 DPU(4 个 vCPU,16GB 内存),84GB 磁盘(34GB 可用空间),并且每个工作线程提供 1 个执行程序。我们建议将这种工作线程类型用于数据转换、联接和查询等工作负载,以提供一种可扩展且经济实惠的方式来运行大多数作业。

    • 对于 G.2X 工作线程类型,每个工作线程映射到 2 个 DPU(8 个 vCPU,32GB 内存),128GB 磁盘(77GB 可用空间),并且每个工作线程提供 1 个执行程序。我们建议将这种工作线程类型用于数据转换、联接和查询等工作负载,以提供一种可扩展且经济实惠的方式来运行大多数作业。

    • 对于 G.4X 工作线程类型,每个工作线程映射到 4 个 DPU(16 个 vCPU,64GB 内存),256GB 磁盘(235GB 可用空间),并且每个工作线程提供 1 个执行程序。对于工作负载包含要求最高的转换、聚合、联接和查询的作业,我们建议使用这种工作线程类型。此工作线程类型仅适用于以下 Amazon 区域的 Amazon Glue 3.0 版或更高版本的 Spark ETL 作业:美国东部(俄亥俄州)、美国东部(弗吉尼亚州北部)、美国西部(俄勒冈州)、亚太地区(新加坡)、亚太地区(悉尼)、亚太地区(东京)、加拿大(中部)、欧洲地区(法兰克福)、欧洲地区(爱尔兰)和欧洲地区(斯德哥尔摩)。

    • 对于 G.8X 工作线程类型,每个工作线程映射到 8 个 DPU(32 个 vCPU,128GB 内存),512GB 磁盘(487GB 可用空间),并且每个工作线程提供 1 个执行程序。对于工作负载包含要求最高的转换、聚合、联接和查询的作业,我们建议使用这种工作线程类型。此工作线程类型仅适用于 Amazon Glue 3.0 版或更高版本的 Spark ETL 作业,其区域与 G.4X 工作线程类型支持的 Amazon 区域相同。

    • 对于 G.025X 工作线程类型,每个工作线程映射到 0.25 个 DPU(2 个 vCPU,4GB 内存),84GB 磁盘(34GB 可用空间),并且每个工作线程提供 1 个执行程序。我们建议为低容量串流任务使用此 Worker 类型。此 Worker 类型仅适用于 Amazon Glue 版本 3.0 串流任务。

    • 对于 Z.2X 工作线程类型,每个工作线程映射到 2 个 M-DPU(8 个 vCPU,64GB 内存),128GB 磁盘(120GB 可用空间),基于自动缩放器,最多提供 8 个 Ray 工作线程。

  • NumberOfWorkers – 数字(整数)。

    任务运行时分配的定义 workerType 的工作线程数。

  • SecurityConfiguration – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    运行该任务将使用的 SecurityConfiguration 结构的名称。

  • LogGroupName – UTF-8 字符串。

    用于进行安全日志记录的日志组的名称,可在 Amazon CloudWatch 中使用 Amazon KMS 进行服务器端加密。此名称可以是 /aws-glue/jobs/,在这种情况下,默认加密为 NONE。如果您添加角色名称和 SecurityConfiguration 名称(换句话说,/aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/),则该安全配置将用于加密该日志组。

  • NotificationProperty – 一个 NotificationProperty 对象。

    指定任务运行通知的配置属性。

  • GlueVersion – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Custom string pattern #20 匹配。

    在 Spark 作业中,GlueVersion 确定作业中 Amazon Glue 可用的 Apache Spark 和 Python 版本。Python 版本指示了 Spark 类型的任务支持的版本。

    Ray 作业应将 GlueVersion 设置为 4.0 或更高。但是,Ray 作业中可用的 Ray、Python 和其他库的版本由 Job 命令的 Runtime 参数决定。

    有关可用的 Amazon Glue 版本以及相应的 Spark 和 Python 版本的更多信息,请参阅开发人员指南中的 Glue 版本

    在未指定 Glue 版本的情况下创建的任务默认为 Glue 0.9。

  • DPUSeconds – 数字(double)。

    此字段可针对使用 FLEX 执行类运行的任务设置,也可以在启用自动扩缩功能时设置,等于任务运行生命周期内每个执行器运行的总时间(以秒为单位)乘以 DPU 因子(G.1X 个工作线程时为 1,G.2X 个工作线程时为 2,G.025X 个工作线程时为 0.25)。此值可能不同于弹性伸缩任务中的 executionEngineRuntime * MaxCapacity,因为在给定时间运行的执行程序数量可能少于 MaxCapacity。因此,DPUSeconds 的值可能小于 executionEngineRuntime * MaxCapacity

  • ExecutionClass – UTF-8 字符串,长度不超过 16 个字节(有效值:FLEX="" | STANDARD="")。

    指示任务是使用标准执行类还是灵活执行类运行的。标准执行类非常适合需要快速任务启动和专用资源的时间敏感型工作负载。

    灵活执行类适用于启动和完成时间可能不同的时间不敏感型作业。

    只有具有 Amazon Glue 版本 3.0 和以上版本以及命令类型 glueetl 的任务才允许将 ExecutionClass 设置为 FLEX。灵活的执行类可用于 Spark 任务。

  • MaintenanceWindow – UTF-8 字符串,与 Custom string pattern #30 匹配。

    此字段指定一周中的某一天和一小时,作为流式传输任务的维护时段。Amazon Glue 会定期执行维护活动。在这些维护时段内,Amazon Glue 需要重新启动您的流式传输任务。

    Amazon Glue 将在指定维护时段后的 3 小时内重新启动任务。例如,如果您将维护时段设置为 GMT 时间星期一上午 10:00,则您的任务将在 GMT 时间上午 10:00 至下午 1:00 之间重新启动。

Predecessor 结构

在触发此任务运行的条件触发器的谓词中使用的任务运行。

字段
  • JobName – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    任务运行前身使用的任务定义的名称。

  • RunId – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    任务运行前身的任务运行 ID。

JobBookmarkEntry 结构

定义任务可以恢复处理的点。

字段
  • JobName – UTF-8 字符串。

    相关任务的名称。

  • Version – 数字(整数)。

    任务的版本。

  • Run – 数字(整数)。

    运行 ID 号。

  • Attempt – 数字(整数)。

    尝试 ID 号。

  • PreviousRunId – UTF-8 字符串。

    与上次任务运行关联的唯一运行标识符。

  • RunId – UTF-8 字符串。

    运行 ID 号。

  • JobBookmark – UTF-8 字符串。

    书签本身。

BatchStopJobRunSuccessfulSubmission 结构

记录成功的对停止指定 JobRun 的请求。

字段
  • JobName – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    已停止的任务运行中使用的任务定义的名称。

  • JobRunId – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    已停止的任务运行的 JobRunId

BatchStopJobRunError 结构

记录在尝试停止指定的任务运行时出现的错误。

字段
  • JobName – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    相关任务运行中使用的任务业定义的名称。

  • JobRunId – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    相关任务运行的 JobRunId

  • ErrorDetail – 一个 ErrorDetail 对象。

    指定有关遇到的错误的详细信息。

NotificationProperty 结构

指定通知的配置属性。

字段
  • NotifyDelayAfter - 数字(整数),至少为 1。

    在作业运行开始后,发送作业运行延迟通知之前等待的分钟数。

操作

StartJobRun 操作(Python:start_job_run)

使用任务定义启动任务运行。

请求
  • JobName必填:UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    要使用的任务定义的名称。

  • JobRunId – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    要重试的以前的 JobRun 的 ID。

  • Arguments – 键值对的映射数组。

    每个键是一个 UTF-8 字符串。

    每个值是一个 UTF-8 字符串。

    与此运行关联的任务参数。对于此任务运行,它们会替换任务定义本身中的默认参数集。

    可以在此处指定您自己的任务执行脚本使用的参数以及 Amazon Glue 本身使用的参数。

    可能会记录任务参数。不要将明文密钥作为参数传递。如果您想要将密钥保留在任务内,则请通过 Amazon Glue 连接、Amazon Secrets Manager 或其他密钥管理机制检索密钥。

    有关如何指定和使用您自己的任务参数的信息,请参阅开发人员指南中的在 Python 中调用 Amazon Glue API 主题。

    有关在配置 Spark 作业时可以为该字段提供的参数的信息,请参阅《开发人员指南》中的 Special Parameters Used by Amazon Glue 主题。

    有关在配置 Spark 作业时可以为该字段提供的参数的信息,请参阅《开发人员指南》中的 Using job parameters in Ray jobs

  • AllocatedCapacity – 数字(整数)。

    此字段已弃用。请改用 MaxCapacity

    要分配给此 JobRun 的 Amazon Glue 数据处理单元(DPU)的数量。您可以分配至少 2 个 DPU;默认值为 10。DPU 是对处理能力的相对度量,它由 4 个 vCPU 的计算容量和 16GB 内存组成。有关更多信息,请参阅 Amazon Glue 价格页面

  • Timeout - 数字(整数),至少为 1。

    JobRun 超时(分钟) 这是任务运行在终止并进入 TIMEOUT 状态前可以使用资源的最长时间。此值会覆盖父任务中设置的超时值。

    流式传输任务的超时值必须小于 7 天或 10080 分钟。如果将该值留空,则如果您尚未设置维护窗口,则该任务将在 7 天后重新启动。如果您设置了维护时段,则该任务将在 7 天后的维护时段内重新启动。

  • MaxCapacity – 数字(double)。

    对于 Glue 版本 1.0 或更早版本的任务,使用标准工件类型,表示此任务运行时可分配的 Amazon Glue 数据处理单元(DPU)的数量。DPU 是对处理能力的相对度量,它由 4 个 vCPU 的计算容量和 16GB 内存组成。有关更多信息,请参阅 Amazon Glue 价格页面

    对于 Glue 版本 2.0+ 作业,不能指定 Maximum capacity。而应指定 Worker typeNumber of workers

    如果使用 WorkerTypeNumberOfWorkers,请勿设置 MaxCapacity

    可为 MaxCapacity 分配的值取决于您运行的是 Python shell 作业、Apache Spark ETL 作业,还是 Apache Spark 流 ETL 作业:

    • 当您指定 Python shell 作业 (JobCommand.Name="pythonshell"),您可以分配 0.0625 或 1 DPU。默认值为 0.0625 DPU。

    • 当您指定 Apache Spark ETL 作业 (JobCommand.Name="glueetl") 或 Apache Spark 流 ETL 作业 (JobCommand.Name="gluestreaming") 时,您可以分配 2 到 100 个 DPU。默认为 10 个 DPU。此任务类型不能具有小数 DPU 分配。

  • SecurityConfiguration – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    运行该任务将使用的 SecurityConfiguration 结构的名称。

  • NotificationProperty – 一个 NotificationProperty 对象。

    指定任务运行通知的配置属性。

  • WorkerType – UTF-8 字符串(有效值:Standard="" | G.1X="" | G.2X="" | G.025X="" | G.4X="" | G.8X="" | Z.2X="")。

    任务运行时分配的预定义工作线程的类型。接受 G.1X、G.2X、G.4X、G.8X 或 G.025X for Spark 作业的值。接受 Ray 作业的值 Z.2X。

    • 对于 G.1X 工作线程类型,每个工作线程映射到 1 个 DPU(4 个 vCPU,16GB 内存),84GB 磁盘(34GB 可用空间),并且每个工作线程提供 1 个执行程序。我们建议将这种工作线程类型用于数据转换、联接和查询等工作负载,以提供一种可扩展且经济实惠的方式来运行大多数作业。

    • 对于 G.2X 工作线程类型,每个工作线程映射到 2 个 DPU(8 个 vCPU,32GB 内存),128GB 磁盘(77GB 可用空间),并且每个工作线程提供 1 个执行程序。我们建议将这种工作线程类型用于数据转换、联接和查询等工作负载,以提供一种可扩展且经济实惠的方式来运行大多数作业。

    • 对于 G.4X 工作线程类型,每个工作线程映射到 4 个 DPU(16 个 vCPU,64GB 内存),256GB 磁盘(235GB 可用空间),并且每个工作线程提供 1 个执行程序。对于工作负载包含要求最高的转换、聚合、联接和查询的作业,我们建议使用这种工作线程类型。此工作线程类型仅适用于以下 Amazon 区域的 Amazon Glue 3.0 版或更高版本的 Spark ETL 作业:美国东部(俄亥俄州)、美国东部(弗吉尼亚州北部)、美国西部(俄勒冈州)、亚太地区(新加坡)、亚太地区(悉尼)、亚太地区(东京)、加拿大(中部)、欧洲地区(法兰克福)、欧洲地区(爱尔兰)和欧洲地区(斯德哥尔摩)。

    • 对于 G.8X 工作线程类型,每个工作线程映射到 8 个 DPU(32 个 vCPU,128GB 内存),512GB 磁盘(487GB 可用空间),并且每个工作线程提供 1 个执行程序。对于工作负载包含要求最高的转换、聚合、联接和查询的作业,我们建议使用这种工作线程类型。此工作线程类型仅适用于 Amazon Glue 3.0 版或更高版本的 Spark ETL 作业,其区域与 G.4X 工作线程类型支持的 Amazon 区域相同。

    • 对于 G.025X 工作线程类型,每个工作线程映射到 0.25 个 DPU(2 个 vCPU,4GB 内存),84GB 磁盘(34GB 可用空间),并且每个工作线程提供 1 个执行程序。我们建议为低容量串流任务使用此 Worker 类型。此 Worker 类型仅适用于 Amazon Glue 版本 3.0 串流任务。

    • 对于 Z.2X 工作线程类型,每个工作线程映射到 2 个 M-DPU(8 个 vCPU,64GB 内存),128GB 磁盘(120GB 可用空间),基于自动缩放器,最多提供 8 个 Ray 工作线程。

  • NumberOfWorkers – 数字(整数)。

    任务运行时分配的定义 workerType 的工作线程数。

  • ExecutionClass – UTF-8 字符串,长度不超过 16 个字节(有效值:FLEX="" | STANDARD="")。

    指示任务是使用标准执行类还是灵活执行类运行的。标准执行类非常适合需要快速任务启动和专用资源的时间敏感型工作负载。

    灵活执行类适用于启动和完成时间可能不同的时间不敏感型作业。

    只有具有 Amazon Glue 版本 3.0 和以上版本以及命令类型 glueetl 的任务才允许将 ExecutionClass 设置为 FLEX。灵活的执行类可用于 Spark 任务。

响应
  • JobRunId – UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    分配给此任务运行的 ID。

错误
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

  • ResourceNumberLimitExceededException

  • ConcurrentRunsExceededException

BatchStopJobRun 操作(Python:batch_stop_job_run)

停止指定的任务定义的一个或多次任务运行。

请求
  • JobName必填:UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    要停止其任务运行的任务定义的名称。

  • JobRunIds必填:UTF-8 字符串数组,不少于 1 个或不超过 25 个字符串。

    应为该任务定义停止的 JobRunIds 列表。

响应
  • SuccessfulSubmissionsBatchStopJobRunSuccessfulSubmission 对象的数组。

    已成功提交的要停止的 JobRun 列表。

  • ErrorsBatchStopJobRunError 对象的数组。

    尝试停止 JobRuns 时遇到的错误列表,包括遇到每个错误的 JobRunId 和有关错误的详细信息。

错误
  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

GetJobRun 操作(Python:get_job_run)

检索给定任务运行的元数据。您可以在 90 天内访问工作流和任务运行的任务运行历史记录。

请求
  • JobName必填:UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    正在运行的任务定义的名称。

  • RunId必填:UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    任务运行的 ID。

  • PredecessorsIncluded – 布尔值。

    如果应返回运行前身的列表,则为 True。

响应
  • JobRun – 一个 JobRun 对象。

    请求的任务运行元数据。

错误
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

GetJobRuns 操作(Python:get_job_runs)

检索给定任务定义的所有运行的元数据。

请求
  • JobName必填:UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。

    要检索其所有任务运行的作业定义的名称。

  • NextToken – UTF-8 字符串。

    延续标记 (如果这是延续调用)。

  • MaxResults – 数字(整数),不小于 1 或大于 200。

    响应的最大大小。

响应
  • JobRunsJobRun 对象的数组。

    任务运行元数据对象的列表。

  • NextToken – UTF-8 字符串。

    延续令牌(如果尚未返回所有请求的任务运行)。

错误
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

GetJobBookmark 操作(Python:get_job_bookmark)

返回有关任务书签条目的信息。

更多有关启用和使用作业书签的信息,请参阅:

请求
  • JobName必填:UTF-8 字符串。

    相关任务的名称。

  • Version – 数字(整数)。

    任务的版本。

  • RunId – UTF-8 字符串。

    与此任务运行关联的唯一运行标识符。

响应
  • JobBookmarkEntry – 一个 JobBookmarkEntry 对象。

    用于定义任务可以恢复处理的点的结构。

错误
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException

  • ValidationException

GetJobBookmarks 操作(Python:get_job_bookmarks)

返回有关任务书签条目的信息。该列表按版本号递减的顺序排列。

更多有关启用和使用作业书签的信息,请参阅:

请求
  • JobName必填:UTF-8 字符串。

    相关任务的名称。

  • MaxResults – 数字(整数)。

    响应的最大大小。

  • NextToken – 数字(整数)。

    延续标记 (如果这是延续调用)。

响应
  • JobBookmarkEntriesJobBookmarkEntry 对象的数组。

    用于定义任务可以恢复处理的点的任务书签条目列表。

  • NextToken – 数字(整数)。

    延续令牌,如果返回所有条目,则其值为 1;如果未返回所有请求的任务运行,则其值 > 1。

错误
  • InvalidInputException

  • EntityNotFoundException

  • InternalServiceException

  • OperationTimeoutException

ResetJobBookmark 操作(Python:reset_job_bookmark)

重置书签条目。

更多有关启用和使用作业书签的信息,请参阅:

请求
  • JobName必填:UTF-8 字符串。

    相关任务的名称。

  • RunId – UTF-8 字符串。

    与此任务运行关联的唯一运行标识符。

响应
  • JobBookmarkEntry – 一个 JobBookmarkEntry 对象。

    重置的书签条目。

错误
  • EntityNotFoundException

  • InvalidInputException

  • InternalServiceException

  • OperationTimeoutException