Querying Information About a Job

Updated on 2022-12-08 GMT+08:00

View PDF

Function

This API is used to query information about a specified job in an MRS cluster.

URI

Format
GET /v2/{project_id}/clusters/{cluster_id}/job-executions/{job_execution_id}

Parameter description

**Table 1** URI parameter description
Parameter	Mandatory	Description
project_id	Yes	Project ID. For details on how to obtain the project ID, see Obtaining a Project ID.
cluster_id	Yes	Cluster ID. For details on how to obtain the cluster ID, see Obtaining a Cluster ID.
job_execution_id	Yes	Job ID. For details on how to obtain the job ID, see Obtaining a Job ID.

Request

Request parameters

None.

Response

**Table 2** Response parameter description
Parameter	Type	Description
job_detail	Object	Job details. For details about the parameter, see Table 3.

**Table 3** Job parameter description
Parameter	Type	Description
job_id	String	Job ID.
user	String	Name of the user who submits a job.
job_name	String	Job name. It contains 1 to 64 characters. Only letters, digits, hyphens (-), and underscores (_) are allowed.
job_result	String	Final result of a job. FAILED: indicates that the job fails to be executed. KILLED: indicates that the job is manually terminated during execution. UNDEFINED: indicates that the job is being executed. SUCCEEDED: indicates that the job has been successfully executed.
job_state	String	Execution status of a job. FAILED: failed KILLED: indicates that the job is terminated. New: indicates that the job is created. NEW_SAVING: indicates that the job has been created and is being saved. SUBMITTED: indicates that the job is submitted. ACCEPTED: indicates that the job is accepted. RUNNING: indicates that the job is running. FINISHED: indicates that the job is completed.
job_progress	Float	Job execution progress.
job_type	String	Type of a job. MapReduce SparkSubmit SparkSubmit: Select SparkSubmit when you call an API to query a SparkPython job. HiveScript HiveSql DistCp, importing and exporting data SparkScript SparkSql Flink
started_time	Long	Start time to run a job. Unit: ms.
submitted_time	Long	Time when a job is submitted. Unit: ms.
finished_time	Long	End time to run a job. Unit: ms.
elapsed_time	Long	Running duration of a job. Unit: ms.
arguments	Array	Running parameter. The parameter contains a maximum of 4,096 characters, excluding special characters such as ;\|&>'<$, and can be left blank.
properties	Object	Configuration parameter, which is used to configure -d parameters. The parameter contains a maximum of 2,048 characters, excluding special characters such as ><\|'`&!\, and can be left blank.
launcher_id	String	Launcher job ID.
app_id	String	Actual job ID.

Example

Example request
None.

Example response

Example of a successful response

{
    "job_detail": {
        "job_id": "431b135e-c090-489f-b1db-0abe3822b855",
        "user": "xxxx",
        "job_name": "pyspark1",
        "job_result": "SUCCEEDED",
        "job_state": "FINISHED",
        "job_progress": 100,
        "job_type": "SparkSubmit",
        "started_time": 1564626578817,
        "submitted_time": 1564626561541,
        "finished_time": 1564626664930,
        "elapsed_time": 86113,
        "queue": "default",
        "arguments": "[--class, org.apache.spark.examples.SparkPi, --driver-memory, 512MB, --num-executors, 1, --executor-cores, 1, --master, yarn-cluster, obs://obs-test/jobs/spark/spark-examples_2.11-2.1.0.jar, 10000]",
        "launcher_id": "application_1564622673393_0006",
        "app_id": "application_1564622673393_0007",
        "properties": "{}"
    }
}

Example of a failed response

{
"error_msg": "Failed to query the job."
"error_code":"0162"
}

Status Code

For details about status codes, see Status Codes.

Parent topic: Job Object APIs

Previous topic: Adding and Executing a Job

Next topic: Querying a List of Jobs

Feedback

Was this page helpful?

Helpful Not helpful

Provide feedback

Thank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.

The system is busy. Please try again later.

Which of the following issues have you encountered?

Content is inconsistent with the product UI

Unclear descriptions

Lack of examples or code

Incorrect steps

Can't find what I need

Lack of best practices

Feedback (optional)

0/500

Select at least one type of issue, and enter your comments or suggestions.

Enter a maximum of 500 characters.

Submit Cancel

For any further questions, feel free to contact us through the chatbot.

Chatbot