Updated on 2024-12-10 GMT+08:00

Querying exe Object Details (Deprecated)

Function

This API is used to query detailed information about the exe object of a job. This API is incompatible with Sahara.

URI

  • Format

    GET /v1.1/{project_id}/job-exes/{job_exe_id}

  • Parameter description
    Table 1 URI parameters

    Parameter

    Mandatory

    Description

    project_id

    Yes

    Explanation

    The project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

    Constraints

    N/A

    Value range

    N/A

    Default value

    N/A

    job_exe_id

    Yes

    Explanation

    The job ID.

    Constraints

    N/A

    Value range

    N/A

    Default value

    N/A

Request Parameters

None

Response Parameters

Table 2 Response parameter

Parameter

Type

Description

job_execution

Object

Explanation

Job details. For details, see Table 3.

Constraints

N/A

Value range

N/A

Default value

N/A

Table 3 job_execution parameters

Parameter

Type

Description

id

String

Explanation

Job ID

Constraints

N/A

Value range

N/A

Default value

N/A

create_at

Long

Explanation

Creation time, which is a 13-bit timestamp.

Constraints

N/A

Value range

N/A

Default value

N/A

update_at

Long

Explanation

Update time, which is a 13-bit timestamp.

Constraints

N/A

Value range

N/A

Default value

N/A

tenant_id

String

Explanation

The project ID. For details about how to obtain the project ID, see Obtaining a Project ID.

Constraints

N/A

Value range

N/A

Default value

N/A

job_id

String

Explanation

The job ID.

Constraints

N/A

Value range

N/A

Default value

N/A

job_name

String

Explanation

Job name

Constraints

N/A

Value range

N/A

Default value

N/A

start_time

Long

Explanation

Start time of job execution, which is a 13-bit timestamp.

Constraints

N/A

Value range

N/A

Default value

N/A

end_time

Long

Explanation

End time of job execution, which is a 13-bit timestamp.

Constraints

N/A

Value range

N/A

Default value

N/A

cluster_id

String

Explanation

Cluster ID of a job

Constraints

N/A

Value range

N/A

Default value

N/A

group_id

String

Explanation

Group ID of a job

Constraints

N/A

Value range

N/A

Default value

N/A

jar_path

String

Explanation

Path of the .jar file or .sql file for program execution

Constraints

N/A

Value range

N/A

Default value

N/A

input

String

Explanation

Address for inputting data

Constraints

N/A

Value range

N/A

Default value

N/A

output

String

Explanation

Address for outputting data

Constraints

N/A

Value range

N/A

Default value

N/A

job_log

String

Explanation

Address for storing job logs

Constraints

N/A

Value range

N/A

Default value

N/A

job_type

Integer

Explanation

Job type code

Constraints

N/A

Value range

  • 1: MapReduce
  • 2: Spark
  • 3: Hive Script
  • 4: HiveSQL (not supported currently)
  • 5: DistCp
  • 6: Spark Script
  • 7: Spark SQL (not supported in this API currently)

Default value

N/A

file_action

String

Explanation

Data import and export

Constraints

N/A

Value range

N/A

Default value

N/A

arguments

String

Explanation

Key parameters for program execution.

Constraints

This parameter is specified by a function in your program. MRS is responsible for passing the parameter only.

Value range

This parameter can be empty.

Default value

N/A

hql

String

Explanation

HiveQL statement

Constraints

N/A

Value range

N/A

Default value

N/A

job_state

Integer

Explanation

Job status code

Constraints

N/A

Value range

  • -1: Terminated
  • 2: Running
  • 3: Completed
  • 4: Abnormal

Default value

N/A

job_final_status

Integer

Explanation

Final job status

Constraints

N/A

Value range

  • 0: unfinished
  • 1: terminated due to an execution error
  • 2: executed successfully
  • 3: canceled

Default value

N/A

hive_script_path

String

Explanation

Address of the Hive script

Constraints

N/A

Value range

N/A

Default value

N/A

create_by

String

Explanation

User ID for creating jobs

Constraints

N/A

Value range

N/A

Default value

N/A

finished_step

Integer

Explanation

Number of completed steps

Constraints

N/A

Value range

N/A

Default value

N/A

job_main_id

String

Explanation

Main ID of a job

Constraints

N/A

Value range

N/A

Default value

N/A

job_step_id

String

Explanation

Step ID of a job

Constraints

N/A

Value range

N/A

Default value

N/A

postpone_at

Long

Explanation

Delay time, which is a 13-bit timestamp.

Constraints

N/A

Value range

N/A

Default value

N/A

step_name

String

Explanation

Step name of a job

Constraints

N/A

Value range

N/A

Default value

N/A

step_num

Integer

Explanation

Number of steps

Constraints

N/A

Value range

N/A

Default value

N/A

task_num

Integer

Explanation

Number of tasks

Constraints

N/A

Value range

N/A

Default value

N/A

update_by

String

Explanation

User ID for updating jobs

Constraints

N/A

Value range

N/A

Default value

N/A

spend_time

Float

Explanation

Duration of job execution (unit: s)

Constraints

N/A

Value range

N/A

Default value

N/A

step_seq

Integer

Explanation

Step sequence of a job

Constraints

N/A

Value range

N/A

Default value

N/A

progress

String

Explanation

Job execution progress

Constraints

N/A

Value range

N/A

Default value

N/A

Example request

Query the execution object details.

GET https://{endpoint}/v1.1/{project_id}/job-exes/{job_exe_id}

Example Response

Status code: 200

The exe object details are queried.

{
  "job_execution" : {
    "id" : "632863d5-15d4-4691-9dc1-1a72340cb097",
    "create_at" : "1484240559176",
    "update_at" : "1484240559176",
    "tenant_id" : "3f99e3319a8943ceb15c584f3325d064",
    "job_id" : "632863d5-15d4-4691-9dc1-1a72340cb097",
    "job_name" : "hive_script",
    "start_time" : "1484240559176",
    "end_time" : null,
    "cluster_id" : "8b1d55f6-150e-45e2-8347-b2ca608d366b",
    "group_id" : "632863d5-15d4-4691-9dc1-1a72340cb097",
    "jar_path" : "s3a://jp-test1/program/Hivescript.sql",
    "input" : "s3a://jp-test1/input/",
    "output" : "s3a://jp-test1/output/",
    "job_log" : "s3a://jp-test1/joblogs/",
    "job_type" : "3",
    "file_action" : "",
    "arguments" : "wordcount",
    "hql" : null,
    "job_state" : "3",
    "job_final_status" : "1",
    "hive_script_path" : "s3a://jp-test1/program/Hivescript.sql",
    "create_by" : "3f99e3319a8943ceb15c584f3325d064",
    "finished_step" : "0",
    "job_main_id" : "",
    "job_step_id" : "",
    "postpone_at" : "1484240558705",
    "step_name" : "",
    "step_num" : "0",
    "task_num" : "0",
    "update_by" : "3f99e3319a8943ceb15c584f3325d064",
    "spend_time" : null,
    "step_seq" : "222",
    "progress" : "first progress"
  }
}

Status Code

Table 4 describes the status code of this API.

Table 4 Status code

Status code

Description

200

The exe object details are queried successfully.

For the description about error status codes, see Status Codes.

Error Codes

For details, see Error Codes.