View a markdown version of this page

CancelJob - Amazon Location Service

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

CancelJob

CancelJob操作会停止正在运行或待处理的作业。只能取消处于 “待处理” 或 “运行中” 状态的作业。取消是异步的,因此您应监控任务状态以确认已完成。已取消的作业可能会在输出位置显示部分结果,具体取决于处理期间取消的时间。

有关更多信息,请参阅CancelJob亚马逊定位服务 API 参考》。

有关此 API 的请求、响应和 CLI 命令示例,请参阅如何取消任务

使用案例

  • 停止不必要的处理:取消以错误的配置提交的作业、由于业务需求变化而不再需要的任务,或者是错误启动的任务。这样可以防止资源浪费和不必要的费用。

  • 资源和成本优化:当需要处理优先级较高的任务时,取消优先级较低的作业,从而腾出处理能力。

了解请求

CancelJob请求只需要一个参数即可确定要取消哪个任务。这种简单的请求结构便于停止处理不再需要的作业。

该请求包含以下参数:

Job 识别

指定要取消哪个任务的必填参数。

  • JobId:要取消的任务的唯一标识符。必须是 1-100 个字符匹配的模式[-._\w]+。这与创建任务时StartJob操作返回的标识符相同。只能取消处于PendingRunning状态的作业。

了解响应

CancelJob响应确认取消请求并提供任务的更新状态。由于取消是异步的,因此您应使用该GetJob操作来监控任务,直到任务达到Cancelled状态。

响应包括以下字段:

Job 识别

正在取消的任务的唯一标识符。

  • JobId:唯一的任务标识符。

  • JobArn: 正在取消的任务的亚马逊资源名称 (ARN)。

取消状态

取消请求后的当前工作状态。

  • Status: 取消请求后立即显示的 Job 状态。通常Cancelling表示取消正在进行中。取消完成Cancelled后,状态将转换为。GetJob用于监视此过渡。

注意

已取消的作业可能会在输出位置显示部分结果,具体取决于处理期间取消的时间。检查输出位置,确定取消完成之前是否写入了部分数据。您需要为取消任务之前处理并写入输出存储桶的记录数量付费。