全部產品
Search
文件中心

MaxCompute:GetJobInfo

更新時間:Jun 09, 2026

查看單個作業的基礎資訊。

調試

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

調試

授權資訊

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

  • 操作:是指具體的許可權點。

  • 存取層級:是指每個操作的存取層級,取值為寫入(Write)、讀取(Read)或列出(List)。

  • 資源類型:是指操作中支援授權的資源類型。具體說明如下:

    • 對於必選的資源類型,用前面加 * 表示。

    • 對於不支援資源級授權的操作,用全部資源表示。

  • 條件關鍵字:是指雲產品自身定義的條件關鍵字。

  • 關聯操作:是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權,操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

odps:GetJobInfo

get

*Job

acs:odps:{#regionId}:{#accountId}:job/{#instanceId}

請求文法

GET /api/v1/jobs/{instanceId}/info HTTP/1.1

路徑參數

名稱

類型

必填

描述

樣本值

instanceId

string

作業 ID。

20230410****60gg

請求參數

名稱

類型

必填

描述

樣本值

當前API無需請求參數

返回參數

名稱

類型

描述

樣本值

object

PopResult

requestId

string

請求 ID。

0be3e0bb16654558425251398e27a9

httpCode

integer

HTTP 狀態碼。

  • 1xx:資訊回應 - 請求已接收,正在處理中。

  • 2xx:成功 - 請求動作已被伺服器端成功接收、理解並接受。

  • 3xx:重新導向 - 請求被重新導向,採取進一步行動以完成請求。

  • 4xx:用戶端錯誤 - 請求包含錯誤請求參數、語法或特定請求條件無法滿足。

  • 5xx:伺服器端錯誤 - 伺服器由於其他原因無法滿足請求。

200

errorCode

string

錯誤碼。

OBJECT_NOT_EXIST

errorMsg

string

錯誤描述資訊。

This object does not exist.

data

object

返回結果。

tenantId

string

租戶 ID。

4784****5249

region

string

地域 ID。

cn-shanghai

instanceId

string

作業 ID。

20230410****60gg

jobOwner

string

作業 Owner。

ALIYUN$7632***@aliyun.com

project

string

專案名稱。

dp_cdm_prod

jobType

string

作業類型。

SQL

priority

integer

作業優先順序。

1

status

string

作業狀態。

running

quotaNickname

string

作業使用的計算配額(Quota)暱稱。

os_bigdata

quotaType

string

Quota 類型。

subscription

cuUsage

integer

作業消耗的 CU 時,僅執行結束的作業有此值。

10

memoryUsage

integer

作業消耗的記憶體時,僅執行結束的作業有此值。

40

submittedAtTime

integer

作業提交時間。

1672112013

waitingTime

integer

等待時長,作業從提交時間到開始執行時間的時長。

100

runningAtTime

integer

作業開始執行時間,特指作業取得第一份計算資源的時間。對於執行時間過短或不消耗計算資源(如 DDL 語句)的作業,以作業提交時間替代。

1672112113

runningTime

integer

執行時長,作業從開始執行時間到結束執行時間的時長。

800

endAtTime

integer

作業執行結束時間。

1672112913

totalTime

integer

總執行時長,作業從提交時間到結束時間總時長。

900

signature

string

SQL 作業簽名。可透過此簽名尋找 SQL 每次執行的 Instances。

20c1efb4a7caca1865f4aa784bb500efae74af04

extPlantFrom

string

上游平台。

platform_3

extNodeId

string

上游節點 ID。

node_4

extNodeOnDuty

string

任務負責人帳號 ID。

duty_2

inputBytes

number

作業掃描量

1234

sceneResults

array<object>

智慧診斷結果。

array<object>

智慧診斷結果。

sceneTag

string

The intelligent diagnostics result tag.

SubscriptionLackResource

scene

string

The intelligent diagnostics result scenario.

LackResource

type

string

The intelligent diagnostics result type.

warning

summary

string

The intelligent diagnostics result summary.

Insufficient computing resources available for the job. Click to view details.

description

string

The intelligent diagnostics result description.

This job uses annual and monthly computing resources. It may be that the job is waiting for resources due to the large amount of overall job running data, many resources requested, and low job priority. Please go to Resource Consumption to view the specific situation. You can also go to Cost Optimization to see if you need to adjust resource configuration.

params

object

Information about the nodes where data skew or data expansion is detected. This parameter is returned only when the diagnostics scenario is data skew or data expansion.

string

Information about the nodes where data skew or data expansion is detected.

"jobinsight_data_skew_node": "Worker M1#10000_0"

jobSubStatusList

array<object>

作業生命週期的子狀態列表。

object

作業子狀態資訊。

code

integer

The encoding of the substatus.

1010

startTime

string

The start time of the substatus.

2025-03-05 00:04:15.717364 +0800

description

string

The description of the substatus.

Waiting for scheduling

樣本

正常返回樣本

JSON格式

{
  "requestId": "0be3e0bb16654558425251398e27a9",
  "httpCode": 200,
  "errorCode": "OBJECT_NOT_EXIST",
  "errorMsg": "This object does not exist.",
  "data": {
    "tenantId": "4784****5249",
    "region": "cn-shanghai",
    "instanceId": "20230410****60gg",
    "jobOwner": "ALIYUN$7632***@aliyun.com\n",
    "project": "dp_cdm_prod",
    "jobType": "SQL\n",
    "priority": 1,
    "status": "running",
    "quotaNickname": "os_bigdata",
    "quotaType": "subscription",
    "cuUsage": 10,
    "memoryUsage": 40,
    "submittedAtTime": 1672112013,
    "waitingTime": 100,
    "runningAtTime": 1672112113,
    "runningTime": 800,
    "endAtTime": 1672112913,
    "totalTime": 900,
    "signature": "20c1efb4a7caca1865f4aa784bb500efae74af04",
    "extPlantFrom": "platform_3",
    "extNodeId": "node_4",
    "extNodeOnDuty": "duty_2",
    "inputBytes": 1234,
    "sceneResults": [
      {
        "sceneTag": "SubscriptionLackResource",
        "scene": "LackResource",
        "type": "warning",
        "summary": "\t\nInsufficient computing resources available for the job. Click to view details.",
        "description": "This job uses annual and monthly computing resources. It may be that the job is waiting for resources due to the large amount of overall job running data, many resources requested, and low job priority. Please go to Resource Consumption to view the specific situation. You can also go to Cost Optimization to see if you need to adjust resource configuration.",
        "params": {
          "key": "\"jobinsight_data_skew_node\": \"Worker M1#10000_0\"\n"
        }
      }
    ],
    "jobSubStatusList": [
      {
        "code": 1010,
        "startTime": "2025-03-05 00:04:15.717364 +0800",
        "description": "Waiting for scheduling"
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊,參考變更詳情