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

# CancelJob
<a name="cancel-job-api"></a>

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

有关更多信息，请参阅[CancelJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_CancelJob.html)《*亚马逊定位服务 API 参考*》。

有关此 API 的请求、响应和 CLI 命令示例，请参阅[如何取消任务](https://docs.aws.amazon.com/location/latest/developerguide/canceling-job.html)。

## 使用案例
<a name="cancel-job-use-cases"></a>
+ **停止不必要的处理：**取消以错误的配置提交的作业、由于业务需求变化而不再需要的任务，或者是错误启动的任务。这样可以防止资源浪费和不必要的费用。
+ **资源和成本优化：**当需要处理优先级较高的任务时，取消优先级较低的作业，从而腾出处理能力。

## 了解请求
<a name="cancel-job-request-parameters"></a>

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

该请求包含以下参数：

**Job 识别**  
指定要取消哪个任务的必填参数。  
+ `JobId`：要取消的任务的唯一标识符。必须是 1-100 个字符匹配的模式`[-._\w]+`。这与创建任务时`StartJob`操作返回的标识符相同。只能取消处于`Pending`或`Running`状态的作业。

## 了解响应
<a name="cancel-job-response-details"></a>

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

响应包括以下字段：

**Job 识别**  
正在取消的任务的唯一标识符。  
+ `JobId`：唯一的任务标识符。
+ `JobArn`: 正在取消的任务的亚马逊资源名称 (ARN)。

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

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