All Products
Search
Document Center

MaxCompute:GetJobInfo

Last Updated:Jun 16, 2025

Queries the basic information about a job.

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

The following table shows the authorization information corresponding to the API. The authorization information can be used in the Action policy element to grant a RAM user or RAM role the permissions to call this API operation. Description:

  • Operation: the value that you can use in the Action element to specify the operation on a resource.
  • Access level: the access level of each operation. The levels are read, write, and list.
  • Resource type: the type of the resource on which you can authorize the RAM user or the RAM role to perform the operation. Take note of the following items:
    • For mandatory resource types, indicate with a prefix of * .
    • If the permissions cannot be granted at the resource level, All Resources is used in the Resource type column of the operation.
  • Condition Key: the condition key that is defined by the cloud service.
  • Associated operation: other operations that the RAM user or the RAM role must have permissions to perform to complete the operation. To complete the operation, the RAM user or the RAM role must have the permissions to perform the associated operations.
OperationAccess levelResource typeCondition keyAssociated operation
odps:GetJobInfoget
*Job
acs:odps:{#regionId}:{#accountId}:job/{#instanceId}
    none
none

Request syntax

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

Request parameters

ParameterTypeRequiredDescriptionExample
instanceIdstringYes

The job ID.

20230410****60gg

Response parameters

ParameterTypeDescriptionExample
object

The response parameters.

requestIdstring

The request ID.

0be3e0bb16654558425251398e27a9
httpCodeinteger

The HTTP status code.

  • 1xx: informational response. The request is received and is being processed.
  • 2xx: success. The request is successfully received, understood, and accepted by the server.
  • 3xx: redirection. The request is redirected, and further actions are required to complete the request.
  • 4xx: client error. The request contains invalid request parameters and syntaxes, or specific request conditions cannot be met.
  • 5xx: server error. The server cannot meet requirements due to other reasons.
200
errorCodestring

The error code.

OBJECT_NOT_EXIST
errorMsgstring

The error message.

This object does not exist.
dataobject

The returned result.

tenantIdstring

The tenant ID.

4784****5249
regionstring

The region ID.

cn-shanghai
instanceIdstring

The job ID.

20230410****60gg
jobOwnerstring

The owner of the job.

ALIYUN$7632***@aliyun.com
projectstring

The project name.

dp_cdm_prod
jobTypestring

The type of the job.

SQL
prioritylong

The priority of the job.

1
statusstring

The job status.

running
quotaNicknamestring

The nickname of the computing quota that is used by the job.

os_bigdata
quotaTypestring

The quota type.

subscription
cuUsagelong

The amount of resources consumed by the job. This parameter is returned only for jobs that are complete.Unit: 100*Core*s.

10
memoryUsagelong

The number of memory consumed by the job. This parameter is returned only for jobs that are complete.Unit: MB*s.

40
submittedAtTimelong

The time when the job was submitted.

1672112013
waitingTimelong

The wait time, which is the duration from the time the job is submitted to the time the job starts to run.

100
runningAtTimelong

The start time, which is the time when the job received the first batch of computing resources. For jobs that run for a short period of time or do not consume computing resources, such as the jobs that involve DDL statements, the job submission time is used instead.

1672112113
runningTimelong

The execution duration, which is the duration from the start time to the end time of the job.

800
endAtTimelong

The end time of the job.

1672112913
totalTimelong

The total duration from the time a job is submitted to the time the job is terminated.

900
signaturestring

The signature of the SQL job. You can use the signature to find the instances on which each time an SQL statement is executed.

20c1efb4a7caca1865f4aa784bb500efae74af04
extPlantFromstring

The upstream platform.

platform_3
extNodeIdstring

The ID of the ancestor node.

node_4
extNodeOnDutystring

The Alibaba Cloud account ID of the task owner.

duty_2
inputBytesdouble

The amount of data scanned by the job.

1234
sceneResultsarray<object>

The intelligent diagnostics result.

sceneResultobject

The intelligent diagnostics result.

sceneTagstring

The intelligent diagnostics result tag.

SubscriptionLackResource
scenestring

The intelligent diagnostics result scenario.

LackResource
typestring

The intelligent diagnostics result type.

warning
summarystring

The intelligent diagnostics result summary.

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

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.
paramsobject

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"
jobSubStatusListarray<object>

The substatuses of the job lifecycle.

jobSubStatusListobject

The substatus of the job.

codeinteger

The encoding of the substatus.

1010
startTimestring

The start time of the substatus.

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

The description of the substatus.

Waiting for scheduling

Examples

Sample success responses

JSONformat

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

For a list of error codes, visit the Service error codes.