KillSemanticJob - DataWorks

使用 RunSemanticJob 或 ListSemanticJobRuns 返回的 ExecutorJobId 停止指定執行。呼叫成功僅表示停止請求已受理，最終狀態請透過 GetSemanticJobDetail 查詢。

介面說明

向執行器發起停止指定語意任務執行的請求，適用於任務長時間執行、需要人工中止或資源回收的場景。

從 RunSemanticJob 或 ListSemanticJobRuns 獲取 ExecutorJobId，並使用任務的 ProjectId。
可按需傳入 RetryTimes。
呼叫後使用 GetSemanticJobDetail 輪詢最終狀態，必要時讀取 GetSemanticJobLog 診斷。

介面成功僅表示停止請求已被處理，不等同於任務已經進入終態。

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作

存取層級

資源類型

條件關鍵字

關聯操作

dataworks:KillSemanticJob

update

*全部資源。

*

無

名稱	類型	必填	描述	樣本值
ExecutorJobId	string	是	待停止執行的執行器任務識別碼，使用 RunSemanticJob 回應的 Data.ExecutorJobId 或 ListSemanticJobRuns 記錄中的 ExecutorJobId。	exec-job-demo
ProjectId	integer	是	待停止任務所屬的 DataWorks 工作空間 ID，使用 CreateSemanticJob 回應或 ListSemanticJobs 清單項目的 ProjectId。	100
RetryTimes	integer	否	向執行器發起停止請求時使用的重試次數。通常可省略；傳入時使用非負整數，並在呼叫後透過 GetSemanticJobDetail 確認最終狀態。	1

請根據各請求欄位的說明建構呼叫參數。

名稱	類型	描述	樣本值
	object	停止執行請求的標準回應。Data 僅表示請求處理結果，不表示任務已經進入終態。
RequestId	string	請求 ID。用於定位日誌和排查問題。	676271D6-53B4-57BE-89FA-72F7AE1418DF
Success	boolean	請求是否成功。
Data	boolean	停止請求是否已被執行器受理；返回 true 後仍應使用 GetSemanticJobDetail 查詢最終狀態。

回應欄位含義和後續呼叫關係請參閱各欄位說明。

正常返回樣本

JSON格式

{
  "RequestId": "676271D6-53B4-57BE-89FA-72F7AE1418DF",
  "Success": false,
  "Data": false
}

訪問錯誤中心查看更多錯誤碼。

更多資訊，參考變更詳情。