本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

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

`CancelJob` 操作會停止執行中或待定的任務。只有處於**擱置**或**執行**中狀態的任務才能取消。取消是非同步的，因此您應該監控任務狀態以確認完成。已取消的任務可能會在輸出位置產生部分結果，具體取決於處理期間何時發生取消。

如需詳細資訊，請參閱《*Amazon Location Service API 參考*》中的 [CancelJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_CancelJob.html)。

如需此 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` 請求只需要單一參數，即可識別要取消的任務。這個簡單的請求結構可讓您輕鬆停止處理不再需要的任務。

請求包含下列參數：

**任務識別**  
指定要取消之任務的必要參數。  
+ `JobId`：要取消之任務的唯一識別符。必須是 1-100 個字元符合模式 `[-._\w]+`。這是建立任務時， `StartJob`操作傳回的相同識別符。只能取消處於 `Pending`或 `Running` 狀態的任務。

## 了解回應
<a name="cancel-job-response-details"></a>

`CancelJob` 回應會確認取消請求，並提供任務的更新狀態。由於取消是非同步的，因此您應該使用 `GetJob`操作來監控任務，直到達到 `Cancelled` 狀態為止。

回應包含下列欄位：

**任務識別**  
正在取消之任務的唯一識別符。  
+ `JobId`：唯一的任務識別符。
+ `JobArn`：正在取消之任務的 Amazon Resource Name (ARN)。

**取消狀態**  
取消請求後的目前任務狀態。  
+ `Status`：取消請求之後立即的工作狀態。通常`Cancelling`表示正在取消。當取消完成`Cancelled`時，狀態會轉換為 。使用 `GetJob` 監控此轉換。

**注意**  
已取消的任務可能會在輸出位置產生部分結果，具體取決於處理期間何時發生取消。檢查輸出位置，以判斷是否有任何部分資料在取消完成之前寫入。您需要支付在任務取消之前處理並寫入輸出儲存貯體的記錄數量的費用。