Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: clarify "completed" description per HIVE-6307

Job Information — GET jobs/:jobid

Table of Contents

Description

Check the status of a job and get related job information given its job ID. Substitute ":jobid" with the job ID received when the job was created.

...

Name

Description

status

A JSON object containing the job status information. See the Hadoop documentation (Class JobStatus) for more information.

profile

A JSON object containing the job profile information. See the Hadoop documentation (Class JobProfile) for more information.

id

The job ID.

parentId

The parent job ID.

percentComplete

The job completion percentage, for example "75% complete".

exitValue

The job's exit value.

user

User name of the job creator.

callback

The callback URL, if any.

completed

A string representing completed status , for example "done"of the process launched by the Launcher task. For example when a MapReduce job is submitted via WebHCat, the Launcher invokes a "hadoop jar" command and then when that process exits the completed string is set to "done". Note that this is not the same as the job status (see status).

userargs

A JSON object repesenting the argument names and values for the job submission request.

Example

Curl Command

No Format

% curl -s 'http://localhost:50111/templeton/v1/jobs/job_201112212038_0003?user.name=ctdean'

JSON Output

No Format

{
 "status": {
            "startTime": 1324529476131,
            "username": "ctdean",
            "jobID": {
                      "jtIdentifier": "201112212038",
                      "id": 4
                     },
            "jobACLs": {
                       },
            "schedulingInfo": "NA",
            "failureInfo": "NA",
            "jobId": "job_201112212038_0004",
            "jobPriority": "NORMAL",
            "runState": 2,
            "jobComplete": true
           },
 "profile": {
             "url": "http://localhost:50030/jobdetails.jsp?jobid=job_201112212038_0004",
             "jobID": {
                       "jtIdentifier": "201112212038",
                        "id": 4
                      },
             "user": "ctdean",
             "queueName": "default",
             "jobFile": "hdfs://localhost:9000/tmp/hadoop-ctdean/mapred/staging/ctdean/.staging/job_201112212038_0004/job.xml",
             "jobName": "PigLatin:DefaultJobName",
             "jobId": "job_201112212038_0004"
            },
 "id": "job_201112212038_0004",
 "parentId": "job_201112212038_0003",
 "percentComplete": "100% complete",
 "exitValue": 0,
 "user": "ctdean",
 "callback": null,
 "completed": "done",
 "userargs" => {
    "callback"  => null,
    "define"    => [],
    "execute"   => "select a,rand(b) from mynums",
    "file"      => null,
    "statusdir" => null,
    "user.name" => "hadoopqa",
  },

}
Panel
titleColorindigo
titleBGColorsilver
titleNavigation Links

Previous: GET jobs
Next: DELETE jobs/:jobid

General: WebHCat ReferenceWebHCat ManualHCatalog ManualHive Wiki HomeHive Project Site

Replaces deprecated resource: GET queue/:jobid
Old version of deprecated resource (HCatalog 0.5.0): GET queue/:jobid