All Products
Search
Document Center

MaxCompute:GetJobInfo - 查看作业的基础信息

Last Updated:Aug 20, 2026

查看单个作业的基础信息。

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

The table below describes the authorization required to call this API. You can define it in a Resource Access Management (RAM) policy. The table's columns are detailed below:

  • Action: The actions can be used in the Action element of RAM permission policy statements to grant permissions to perform the operation.

  • API: The API that you can call to perform the action.

  • Access level: The predefined level of access granted for each API. Valid values: create, list, get, update, and delete.

  • Resource type: The type of the resource that supports authorization to perform the action. It indicates if the action supports resource-level permission. The specified resource must be compatible with the action. Otherwise, the policy will be ineffective.

    • For APIs with resource-level permissions, required resource types are marked with an asterisk (*). Specify the corresponding Alibaba Cloud Resource Name (ARN) in the Resource element of the policy.

    • For APIs without resource-level permissions, it is shown as All Resources. Use an asterisk (*) in the Resource element of the policy.

  • Condition key: The condition keys defined by the service. The key allows for granular control, applying to either actions alone or actions associated with specific resources. In addition to service-specific condition keys, Alibaba Cloud provides a set of common condition keys applicable across all RAM-supported services.

  • Dependent action: The dependent actions required to run the action. To complete the action, the RAM user or the RAM role must have the permissions to perform all dependent actions.

Action

Access level

Resource type

Condition key

Dependent action

odps:GetJobInfo

get

*Job

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

None None

Request syntax

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

Path Parameters

Parameter

Type

Required

Description

Example

instanceId

string

Yes

作业 ID。

20230410****60gg

Request parameters

Parameter

Type

Required

Description

Example

No parameters required.

Response elements

Element

Type

Description

Example

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

智能诊断结果标签。

SubscriptionLackResource

scene

string

智能诊断结果场景。

LackResource

type

string

智能诊断结果类型。

warning

summary

string

智能诊断结果简述。

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

description

string

智能诊断结果详情。

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

数据倾斜、数据膨胀节点信息。只有当诊断场景为数据倾斜、数据膨胀时返回此参数。

string

数据倾斜、数据膨胀节点信息。

"jobinsight_data_skew_node": "Worker M1#10000_0"

jobSubStatusList

array<object>

作业生命周期的子状态列表。

object

作业子状态信息。

code

integer

子状态的编码。

1010

startTime

string

子状态的开始时间。

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

description

string

子状态的描述。

Waiting for scheduling

Examples

Success response

JSON format

{
  "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"
      }
    ]
  }
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.