Both sides previous revisionPrevious revisionNext revision | Previous revision |
wiki:oarextratime [2016/11/08 14:03] – [REST API] neyron | wiki:oarwalltime [2020/02/18 12:17] (current) – neyron |
---|
====== oarextratime ====== | ====== oarextratime ====== |
| |
Coming with OAR 2.5.8, oarextratime is a new OAR command. | Coming with OAR 2.5.8, oarwalltime is a new OAR command. |
| |
| This page talk about oarextratime, which was the former name for oarwalltime. |
| |
| One could just exchange the two words. |
| |
===== Usage ===== | ===== Usage ===== |
For ref, the [[rest-api-specs]] page. | For ref, the [[rest-api-specs]] page. |
| |
Extratime now use the /oarapi-priv/jobs/<jobid> URL with GET or (POST or PUT) | Extratime now uses the /oarapi-priv/jobs/<jobid> URL with GET or (POST or PUT <- both do the same...) |
| |
Extratime syntax in a job query output: GET /oarapi-priv/jobs/<jobid>.json | *Extratime syntax in a job query output: GET /oarapi-priv/jobs/<jobid>.json |
* ''possible'': possible requests in seconds, 0 if not request is possible (for any cause) | * ''possible'': possible requests in seconds, 0 if not request is possible (for any cause) |
* ''pending'': pending requests in seconds to be handled by the scheduler | * ''pending'': pending requests in seconds to be handled by the scheduler |
* ''granted'': granted extratime in seconds | * ''granted'': granted extratime in seconds |
* ''granted_with_delaying_next_jobs'': part of ''granted'' (in seconds) that was granted with ''delay_next_jobs'' = ''YES'', does not show up if equal to 0. | * ''granted_with_delaying_next_jobs'': part of ''granted'' (in seconds) that was granted with ''delay_next_jobs'' = ''YES'', does not show up if equal to 0. |
* ''delay_next_jobs'': ''FORBIDDEN'' if not allowed, ''YES'' if allowed and requested and ''pending'' > 0, ''NO'' if not requested and ''pending'' > 0, does not show up si ''pending'' = 0 | * ''delay_next_jobs'': ''FORBIDDEN'' if not allowed, ''YES'' if allowed and requested and ''pending'' > 0, ''NO'' if not requested and ''pending'' > 0, does not show up si ''pending'' = 0 |
| |
Extratime request syntax in a job update: POST /oarapi-priv/jobs/<jobid>.json -d ''{ ... }'' | * Extratime request syntax in a job update: POST /oarapi-priv/jobs/<jobid>.json -d ''{ ... }'' |
* ''duration'': requested duration of extratime in seconds, mandatory | * ''duration'': requested duration of extratime in seconds, mandatory |
* ''delay_next_jobs'': ''YES'' or ''NO'' (default if not set) | * ''delay_next_jobs'': ''YES'' or ''NO'' (default if not set) |
| |
==== Querying a job that does not exist === | ==== Querying a job that does not exist === |