全部產品
Search
文件中心

DataWorks:StopInstance

更新時間:Oct 10, 2026

呼叫StopInstance終止執行個體。

介面說明

執行個體終止機制與注意事項:

  1. 執行個體終止為非同步操作。發起終止請求不代表執行個體已立即停止。請在請求後持續查詢執行個體狀態,確認終止結果;涉及外部運算資源時,還需核實遠端作業的實際狀態。

  2. DataWorks 執行個體狀態不一定與遠端作業狀態一致。對於依賴外部運算資源的任務(如 MaxCompute、EMR、SSH 等),DataWorks 透過用戶端向遠端發起終止請求。受網路異常、用戶端相容性等因素影響,可能出現 DataWorks 執行個體已標記為失敗,但遠端作業仍在執行的情況。因此,不能僅依據 DataWorks 執行個體狀態判斷遠端作業已終止。請到對應運算平台核查,必要時手動終止,避免作業持續執行或產生額外資源消耗。

  3. 公用排程資源群組下的 MaxCompute 任務需特別關注。DataWorks 公用排程資源群組即將下線,受相關元件版本及相容性限制,部分 MaxCompute 任務的終止指令可能無法在遠端生效。遇到此類情況,請前往 MaxCompute 查詢對應 Instance 的實際狀態;若仍在執行,需在 MaxCompute 端執行 Kill 操作,並再次確認其已終止。

調試

您可以在OpenAPI Explorer中直接運行該介面,免去您計算簽名的困擾。運行成功後,OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

當前API暫無授權資訊透出。

請求參數

名稱

類型

必填

描述

樣本值

InstanceId

integer

是

執行個體的 ID。您可以呼叫 ListInstances 取得。

1234

ProjectEnv

string

是

工作空間的環境,包括 PROD 和 DEV。

枚舉值:

  • PROD :

    生產環境。

  • DEV :

    開發環境。

PROD

返回參數

名稱

類型

描述

樣本值

object

HttpStatusCode

integer

HTTP 狀態碼。

200

Data

boolean

呼叫停止執行個體介面後,回傳的結果詳細資訊。

true

ErrorMessage

string

錯誤資訊。

The connection does not exist.

RequestId

string

請求的 ID。用於定位日誌,排查問題。

E6F0DBDD-5AD****

ErrorCode

string

錯誤碼。

Invalid.Tenant.ConnectionNotExists

Success

boolean

呼叫是否成功。

true

樣本

正常返回樣本

JSON格式

{
  "HttpStatusCode": 200,
  "Data": true,
  "ErrorMessage": "The connection does not exist.",
  "RequestId": "E6F0DBDD-5AD****",
  "ErrorCode": "Invalid.Tenant.ConnectionNotExists",
  "Success": true
}

錯誤碼

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

變更歷史

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