| Both sides previous revisionPrevious revisionNext revision | Previous revision |
| wiki:oarextratime [2016/11/08 15:03] – [REST API] neyron | wiki:oarwalltime [2020/02/18 13: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 === |
