任务运行
任务运行 API 介绍与在 AWS 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
– 该任务使用 AWS Glue Studio 脚本编辑器创建。 -
VISUAL
– 该任务使用 AWS Glue Studio 可视化编辑器创建。 -
NOTEBOOK
– 该任务使用交互式会话笔记本创建。
当
JobMode
字段缺失或为空时,SCRIPT
将指定为默认值。 -
-
JobRunQueuingEnabled
– 布尔值。指定是否为作业运行启用作业运行排队。
值为 true 表示已为作业运行启用作业运行排队。如果为 false 或未填充任何选项,则不会启用作业运行排队。
-
StartedOn
– 时间戳。此任务运行的启动日期和时间。
-
LastModifiedOn
– 时间戳。此作业运行的上次修改时间。
-
CompletedOn
– 时间戳。此任务运行的完成日期和时间。
-
JobRunState
- UTF-8 字符串(有效值:STARTING
|RUNNING
|STOPPING
|STOPPED
|SUCCEEDED
|FAILED
|TIMEOUT
|ERROR
|WAITING
|EXPIRED
)。任务运行的当前状态。有关异常终止的任务的状态的更多信息,请参阅 AWS Glue 任务运行状态。
-
Arguments
– 键值对的映射数组。每个键是一个 UTF-8 字符串。
每个值是一个 UTF-8 字符串。
与此运行关联的任务参数。对于此任务运行,它们会替换任务定义本身中的默认参数集。
可以在此处指定您自己的任务执行脚本使用的参数以及 AWS Glue 本身使用的参数。
可能会记录任务参数。不要将明文密钥作为参数传递。如果您想要将密钥保留在任务内,则请通过 AWS Glue 连接、AWS Secrets Manager 或其他密钥管理机制检索密钥。
有关如何指定和使用您自己的任务参数的信息,请参阅开发人员指南中的在 Python 中调用 AWS Glue API 主题。
有关在配置 Spark 作业时可以为该字段提供的参数的信息,请参阅《开发人员指南》中的 Special Parameters Used by AWS Glue 主题。
有关在配置 Spark 作业时可以为该字段提供的参数的信息,请参阅《开发人员指南》中的 Using job parameters in Ray jobs。
-
ErrorMessage
– UTF-8 字符串。与此任务运行关联的错误消息。
-
PredecessorRuns
– Predecessor 对象的数组。此任务运行的前身列表。
-
AllocatedCapacity
– 数字(整数)。此字段已弃用。请改用
MaxCapacity
。分配给此 JobRun 的 AWS Glue 数据处理单元(DPU)的数量。可以分配 2 到 100 个 DPU;默认值为 10。DPU 是对处理能力的相对度量,它由 4 个 vCPU 的计算容量和 16GB 内存组成。有关更多信息,请参阅 AWS Glue 价格页面
。 -
ExecutionTime
– 数字(整数)。作业运行使用资源的时间长度 (以秒为单位)。
-
Timeout
- 数字(整数),至少为 1。JobRun
超时(分钟) 这是任务运行在终止并进入TIMEOUT
状态前可以使用资源的最长时间。此值会覆盖父任务中设置的超时值。流式传输任务的超时值必须小于 7 天或 10080 分钟。如果将该值留空,则如果您尚未设置维护窗口,则该任务将在 7 天后重新启动。如果您设置了维护时段,则该任务将在 7 天后的维护时段内重新启动。
-
MaxCapacity
– 数字(double)。对于 Glue 版本 1.0 或更早版本的任务,使用标准工件类型,表示此任务运行时可分配的 AWS Glue 数据处理单元(DPU)的数量。DPU 是对处理能力的相对度量,它由 4 个 vCPU 的计算容量和 16GB 内存组成。有关更多信息,请参阅 AWS Glue 价格页面
。 对于 Glue 版本 2.0+ 作业,不能指定
Maximum capacity
。而应指定Worker type
和Number of workers
。如果使用
WorkerType
和NumberOfWorkers
,请勿设置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 个执行程序。对于工作负载包含要求最高的转换、聚合、联接和查询的作业,我们建议使用这种工作线程类型。此工作线程类型仅适用于以下 AWS 区域的 AWS Glue 3.0 版或更高版本的 Spark ETL 作业:美国东部(俄亥俄州)、美国东部(弗吉尼亚州北部)、美国西部(俄勒冈州)、亚太地区(新加坡)、亚太地区(悉尼)、亚太地区(东京)、加拿大(中部)、欧洲地区(法兰克福)、欧洲地区(爱尔兰)和欧洲地区(斯德哥尔摩)。 -
对于
G.8X
工作线程类型,每个工作线程映射到 8 个 DPU(32 个 vCPU,128GB 内存),512GB 磁盘(487GB 可用空间),并且每个工作线程提供 1 个执行程序。对于工作负载包含要求最高的转换、聚合、联接和查询的作业,我们建议使用这种工作线程类型。此工作线程类型仅适用于 AWS Glue 3.0 版或更高版本的 Spark ETL 作业,其区域与G.4X
工作线程类型支持的 AWS 区域相同。 -
对于
G.025X
工作线程类型,每个工作线程映射到 0.25 个 DPU(2 个 vCPU,4GB 内存),84GB 磁盘(34GB 可用空间),并且每个工作线程提供 1 个执行程序。我们建议为低容量串流任务使用此 Worker 类型。此 Worker 类型仅适用于 AWS 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 中使用 AWS KMS 进行服务器端加密。此名称可以是
/aws-glue/jobs/
,在这种情况下,默认加密为NONE
。如果您添加角色名称和SecurityConfiguration
名称(换句话说,/aws-glue/jobs-yourRoleName-yourSecurityConfigurationName/
),则该安全配置将用于加密该日志组。 -
NotificationProperty
– 一个 NotificationProperty 对象。指定任务运行通知的配置属性。
-
GlueVersion
– UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Custom string pattern #20 匹配。在 Spark 作业中,
GlueVersion
确定作业中 AWS Glue 可用的 Apache Spark 和 Python 版本。Python 版本指示了 Spark 类型的任务支持的版本。Ray 作业应将
GlueVersion
设置为4.0
或更高。但是,Ray 作业中可用的 Ray、Python 和其他库的版本由 Job 命令的Runtime
参数决定。有关可用的 AWS 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=""
)。指示任务是使用标准执行类还是灵活执行类运行的。标准执行类非常适合需要快速任务启动和专用资源的时间敏感型工作负载。
灵活执行类适用于启动和完成时间可能不同的时间不敏感型作业。
只有具有 AWS Glue 版本 3.0 和以上版本以及命令类型
glueetl
的任务才允许将ExecutionClass
设置为FLEX
。灵活的执行类可用于 Spark 任务。 -
MaintenanceWindow
– UTF-8 字符串,与 Custom string pattern #30 匹配。此字段指定一周中的某一天和一小时,作为流式传输任务的维护时段。AWS Glue 会定期执行维护活动。在这些维护时段内,AWS Glue 需要重新启动您的流式传输任务。
AWS Glue 将在指定维护时段后的 3 小时内重新启动任务。例如,如果您将维护时段设置为 GMT 时间星期一上午 10:00,则您的任务将在 GMT 时间上午 10:00 至下午 1:00 之间重新启动。
-
ProfileName
– UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。与作业运行关联的 AWS Glue 使用情况配置文件名称。
-
StateDetail
– UTF-8 字符串,长度不超过 400000 个字节。此字段包含与作业运行状态相关的详细信息。此字段可以为空。
例如,当作业运行由于任务运行排队而处于等待状态时,该字段会包含作业运行处于该状态的原因。
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 匹配。要使用的任务定义的名称。
-
JobRunQueuingEnabled
– 布尔值。指定是否为作业运行启用作业运行排队。
值为 true 表示已为作业运行启用作业运行排队。如果为 false 或未填充任何选项,则不会启用作业运行排队。
-
JobRunId
– UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。要重试的以前的
JobRun
的 ID。 -
Arguments
– 键值对的映射数组。每个键是一个 UTF-8 字符串。
每个值是一个 UTF-8 字符串。
与此运行关联的任务参数。对于此任务运行,它们会替换任务定义本身中的默认参数集。
可以在此处指定您自己的任务执行脚本使用的参数以及 AWS Glue 本身使用的参数。
可能会记录任务参数。不要将明文密钥作为参数传递。如果您想要将密钥保留在任务内,则请通过 AWS Glue 连接、AWS Secrets Manager 或其他密钥管理机制检索密钥。
有关如何指定和使用您自己的任务参数的信息,请参阅开发人员指南中的在 Python 中调用 AWS Glue API 主题。
有关在配置 Spark 作业时可以为该字段提供的参数的信息,请参阅《开发人员指南》中的 Special Parameters Used by AWS Glue 主题。
有关在配置 Spark 作业时可以为该字段提供的参数的信息,请参阅《开发人员指南》中的 Using job parameters in Ray jobs。
-
AllocatedCapacity
– 数字(整数)。此字段已弃用。请改用
MaxCapacity
。要分配给此 JobRun 的 AWS Glue 数据处理单元(DPU)的数量。您可以分配至少 2 个 DPU;默认值为 10。DPU 是对处理能力的相对度量,它由 4 个 vCPU 的计算容量和 16GB 内存组成。有关更多信息,请参阅 AWS Glue 价格页面
。 -
Timeout
- 数字(整数),至少为 1。JobRun
超时(分钟) 这是任务运行在终止并进入TIMEOUT
状态前可以使用资源的最长时间。此值会覆盖父任务中设置的超时值。流式传输任务的超时值必须小于 7 天或 10080 分钟。如果将该值留空,则如果您尚未设置维护窗口,则该任务将在 7 天后重新启动。如果您设置了维护时段,则该任务将在 7 天后的维护时段内重新启动。
-
MaxCapacity
– 数字(double)。对于 Glue 版本 1.0 或更早版本的任务,使用标准工件类型,表示此任务运行时可分配的 AWS Glue 数据处理单元(DPU)的数量。DPU 是对处理能力的相对度量,它由 4 个 vCPU 的计算容量和 16GB 内存组成。有关更多信息,请参阅 AWS Glue 价格页面
。 对于 Glue 版本 2.0+ 作业,不能指定
Maximum capacity
。而应指定Worker type
和Number of workers
。如果使用
WorkerType
和NumberOfWorkers
,请勿设置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 个执行程序。对于工作负载包含要求最高的转换、聚合、联接和查询的作业,我们建议使用这种工作线程类型。此工作线程类型仅适用于以下 AWS 区域的 AWS Glue 3.0 版或更高版本的 Spark ETL 作业:美国东部(俄亥俄州)、美国东部(弗吉尼亚州北部)、美国西部(俄勒冈州)、亚太地区(新加坡)、亚太地区(悉尼)、亚太地区(东京)、加拿大(中部)、欧洲地区(法兰克福)、欧洲地区(爱尔兰)和欧洲地区(斯德哥尔摩)。 -
对于
G.8X
工作线程类型,每个工作线程映射到 8 个 DPU(32 个 vCPU,128GB 内存),512GB 磁盘(487GB 可用空间),并且每个工作线程提供 1 个执行程序。对于工作负载包含要求最高的转换、聚合、联接和查询的作业,我们建议使用这种工作线程类型。此工作线程类型仅适用于 AWS Glue 3.0 版或更高版本的 Spark ETL 作业,其区域与G.4X
工作线程类型支持的 AWS 区域相同。 -
对于
G.025X
工作线程类型,每个工作线程映射到 0.25 个 DPU(2 个 vCPU,4GB 内存),84GB 磁盘(34GB 可用空间),并且每个工作线程提供 1 个执行程序。我们建议为低容量串流任务使用此 Worker 类型。此 Worker 类型仅适用于 AWS Glue 版本 3.0 串流任务。 -
对于
Z.2X
工作线程类型,每个工作线程映射到 2 个 M-DPU(8 个 vCPU,64GB 内存),128GB 磁盘(120GB 可用空间),基于自动缩放器,最多提供 8 个 Ray 工作线程。
-
-
NumberOfWorkers
– 数字(整数)。任务运行时分配的定义
workerType
的工作线程数。 -
ExecutionClass
– UTF-8 字符串,长度不超过 16 个字节(有效值:FLEX=""
|STANDARD=""
)。指示任务是使用标准执行类还是灵活执行类运行的。标准执行类非常适合需要快速任务启动和专用资源的时间敏感型工作负载。
灵活执行类适用于启动和完成时间可能不同的时间不敏感型作业。
只有具有 AWS Glue 版本 3.0 和以上版本以及命令类型
glueetl
的任务才允许将ExecutionClass
设置为FLEX
。灵活的执行类可用于 Spark 任务。 -
ProfileName
– UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。与作业运行关联的 AWS Glue 使用情况配置文件名称。
响应
-
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
列表。
响应
-
SuccessfulSubmissions
– BatchStopJobRunSuccessfulSubmission 对象的数组。已成功提交的要停止的 JobRun 列表。
-
Errors
– BatchStopJobRunError 对象的数组。尝试停止
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)
检索给定任务定义的所有运行的元数据。
GetJobRuns
按时间顺序返回作业运行,首先返回最新作业。
请求
-
JobName
– 必填:UTF-8 字符串,长度不少于 1 个字节或超过 255 个字节,与 Single-line string pattern 匹配。要检索其所有任务运行的作业定义的名称。
-
NextToken
– UTF-8 字符串。延续标记 (如果这是延续调用)。
-
MaxResults
– 数字(整数),不小于 1 或大于 200。响应的最大大小。
响应
-
JobRuns
– JobRun 对象的数组。任务运行元数据对象的列表。
-
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
– 数字(整数)。延续标记 (如果这是延续调用)。
响应
-
JobBookmarkEntries
– JobBookmarkEntry 对象的数组。用于定义任务可以恢复处理的点的任务书签条目列表。
-
NextToken
– 数字(整数)。延续令牌,如果返回所有条目,则其值为 1;如果未返回所有请求的任务运行,则其值 > 1。
错误
InvalidInputException
EntityNotFoundException
InternalServiceException
OperationTimeoutException
ResetJobBookmark 操作(Python:reset_job_bookmark)
重置书签条目。
更多有关启用和使用作业书签的信息,请参阅:
请求
-
JobName
– 必填:UTF-8 字符串。相关任务的名称。
-
RunId
– UTF-8 字符串。与此任务运行关联的唯一运行标识符。
响应
-
JobBookmarkEntry
– 一个 JobBookmarkEntry 对象。重置的书签条目。
错误
EntityNotFoundException
InvalidInputException
InternalServiceException
OperationTimeoutException