HCatalog
 

GET queue/:jobid

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.

URL

http://www.myserver.com/templeton/v1/queue/:jobid

Parameters

NameDescriptionRequired?Default
:jobid The job ID to check. This is the ID received when the job was created. Required None

Results

NameDescription
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".

Example

Curl Command

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

JSON Output

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