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 |
Examples
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"}}]
JSON Output (fields, Hive 0.12.0 and later)
Version: Hive 0.12.0 and later
Starting in Hive release 0.12.0, the fields parameter returns user arguments as well as status information (HIVE-5031).
[{"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", "userargs" => { "callback" => null, "define" => [], "enablelog" => "false", "execute" => "select a,rand(b) from mynums", "file" => null, "files" => [], "statusdir" => null, "user.name" => "hadoopqa", }, }]
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