Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Comment: add jobid and numrecords (HIVE-5519), fix ampersands

...

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

jobid

If jobid is present, only the records whose job ID is lexicographically greater than jobid are returned. For example, if jobid = "job_201312091733_0001", the jobs whose job ID is greater than "job_201312091733_0001" are returned. The number of records returned depends on the value of numrecords.

This parameter is not available in releases prior to Hive 0.13.0.

Optional in Hive 0.13.0+None
numrecords

If the jobid and numrecords parameters are present, the top numrecords records appearing after jobid will be returned after sorting the job ID list lexicographically. If the jobid parameter is missing and numrecords is present, the top numrecords will be returned after lexicographically sorting the job ID list. If the jobid parameter is present and numrecords is missing, all the records whose job ID is greater than jobid are returned.

This parameter is not available in releases prior to Hive 0.13.0.

Optional in Hive 0.13.0+All

The standard parameters are also accepted.

...

Returns an array of jobs either belonging to the user, or which the user has permission to view (showall="true"), based on the filter conditions specified by the user.

Every element inside the array includes:

...

No Format
% curl -s 'http://localhost:50111/templeton/v1/jobs?user.name=daijy&showall=true'

JSON Output (showall)

...

No Format
% curl -s 'http://localhost:50111/templeton/v1/jobs?user.name=daijy&fields=*'

JSON Output (fields)

...