List JobIDs — GET jobs
Description
Return a list of all job IDs.
Version: Hive 0.12.0 and later
GET jobs
is introduced in Hive release 0.12.0. It is equivalent to GET queue
in prior releases. GET queue
is now deprecated.
URL
http://
www.myserver.com/templeton/v1/jobs
Parameters
Name |
Description |
Required? |
Default |
---|---|---|---|
fields |
If fields set to "*", the request will return full details of the job. If fields is missing, will only return the job ID. Currently the value can only be "*", other values are not allowed and will throw exception. |
Optional |
None |
showall |
If showall is set to "true", the request will return all jobs the user has permission to view, not only the jobs belonging to the user. |
Optional |
false |
The standard parameters are also accepted.
Results
Returns an array of jobs either belonging to the user, or which the user has permission to view (showall="true").
Every element inside the array includes:
Name |
Description |
---|---|
id |
Job ID. |
detail |
Job details if showall is set to "true"; otherwise "null". For more information about what details it contains, check |
Example
Curl Command
% curl -s 'http://localhost:50111/templeton/v1/jobs?user.name=daijy'
JSON Output
[ {"id":"job_201304291205_0015","detail":null} ]
Curl Command (showall)
% curl -s 'http://localhost:50111/templeton/v1/jobs?user.name=daijy&showall=true'
JSON Output (showall)
[ {"id":"job_201304291205_0014","detail":null}, {"id":"job_201111111311_0015","detail":null}, ]
Curl Command (fields)
% curl -s 'http://localhost:50111/templeton/v1/jobs?user.name=daijy&fields=*'
JSON Output (fields)
[{"id":"job_201304291205_0015", "detail":{ "status":{ "jobACLs":{ "MODIFY_JOB":{"allAllowed":false,"aclstring":" "}, "VIEW_JOB":{"allAllowed":false,"aclstring":" "}}, "runState":2, "startTime":1367264912274, "schedulingInfo":"NA", "failureInfo":"NA", "jobPriority":"NORMAL", "username":"daijy", "jobID":{"id":16,"jtIdentifier":"201304291205"}, "jobId":"job_201304291205_0016", "jobComplete":true}, "profile":{ "user":"daijy", "jobFile":"hdfs://localhost:8020/Users/daijy/hadoop-1.0.3/tmp/mapred/staging/ daijy/.staging/job_201304291205_0016/job.xml", "url":"http://localhost:50030/jobdetails.jsp?jobid=job_201304291205_0016", "queueName":"default", "jobName":"word count", "jobID":{"id":16,"jtIdentifier":"201304291205"}, "jobId":"job_201304291205_0016"}, "id":"job_201304291205_0016", "parentId":"job_201304291205_0015", "percentComplete":"map 100% reduce 100%", "exitValue":0, "user":"daijy", "callback":"http://daijymacpro.local:57815/templeton/$jobId", "completed":"done"}}]
Previous: DELETE queue/:jobid
Next: GET jobs/:jobid
General: WebHCat Reference – WebHCat Manual – HCatalog Manual – Hive Wiki Home – Hive Project Site
Replaces deprecated resource: GET queue
Old version of deprecated resource (HCatalog 0.5.0): GET queue