[ARVADOS] updated: 4e0ddde525c5568dfb5e09e8530be484b6ea5995
git at public.curoverse.com
git at public.curoverse.com
Fri Apr 11 16:29:45 EDT 2014
Summary of changes:
doc/api/schema/Job.html.textile.liquid | 19 +++++++++++++++----
1 files changed, 15 insertions(+), 4 deletions(-)
via 4e0ddde525c5568dfb5e09e8530be484b6ea5995 (commit)
from 18afe83690fd311ff7019abdad7b63a02574d9a8 (commit)
Those revisions listed above that are new to this repository have
not appeared on any other notification email; so we list those
revisions in full, below.
commit 4e0ddde525c5568dfb5e09e8530be484b6ea5995
Author: Peter Amstutz <peter.amstutz at curoverse.com>
Date: Fri Apr 11 16:29:38 2014 -0400
Updated Job section of API documentation regarding repository and
nondeterministic attributes. refs #2488
diff --git a/doc/api/schema/Job.html.textile.liquid b/doc/api/schema/Job.html.textile.liquid
index 47f8785..54e1b27 100644
--- a/doc/api/schema/Job.html.textile.liquid
+++ b/doc/api/schema/Job.html.textile.liquid
@@ -22,14 +22,23 @@ API endpoint base: @https://{{ site.arvados_api_host }}/arvados/v1/jobs@
h3. Additional parameters for "Create" method
table(table table-bordered table-condensed).
-|_. Parameter name|_. Type|_. Description|
-|allow_duplicate|boolean|If true, a new job is submitted even if an identical job has already been submitted (and has not failed). If false or not supplied, a new job will _not_ be submitted and the existing job will be returned in the API response.|
+|_. Attribute |_. Type|_. Accepted values |_. Required|_. Description|
+|script |string |filename |yes |The actual script that will be run by crunch. Must be the name of an executable file in the crunch_scripts/ directory at the git revision specified by script_version.|
+|script_version |string |git branch, tag, or version hash |yes |The code version to run, which is available in the specified repository. May be a git hash or tag to specify an exact version, or a branch. If it is a branch, use the branch head.|
+|repository |string |name of git repository hosted by Arvados |yes |The repository to search for script_version.|
+|script_parameters |object |any JSON object |yes |The input parameters for the job, with the parameter names as keys mapping to parameter values.|
+|minimum_script_version |string |git branch, tag, or version hash |no |The minimum acceptable script version when deciding whether to re-use a past job.|
+|exclude_script_versions|array of strings|git branch, tag, or version hash|no |Script versions to exclude when deciding whether to re-use a past job.|
+|nondeterministic |boolean | |no |If true, never re-use a past job, and flag this job so it will never be considered for re-use.|
+|no_reuse |boolean | |no |If true, do not re-use a past job, but this job may be re-used.|
+
+See the "job and pipeline reference":{{site.baseurl}}/user/reference/job-and-pipeline-reference.html for more information.
h3. Queue
<pre>
GET https://{{ site.arvados_api_host }}/arvados/v1/jobs/queue
-
+
POST https://{{ site.arvados_api_host }}/arvados/v1/jobs/queue
_method=GET
where[owner_uuid]=xyzzy-tpzed-a4lcehql0dv2u25
@@ -50,7 +59,8 @@ table(table table-bordered table-condensed).
|runtime_constraints{}|list|Constraints that must be satisfied by the job/task scheduler in order to run the job.|See below.|
|script|string|Name of crunch script in @/crunch_scripts/@||
|script_parameters{}|list|Parameters passed to MapReduce script||
-|script_version|string|git commit/tree used when running the job|This can be submitted as an unambiguous prefix of a commit sha1, "repository:tag", or "repository:branch". Before the job starts, Arvados will resolve it to a full 40-character git commit sha1.|
+|script_version|string|The git ref of the the git commit used to run the job.| When the job starts, Arvados updates this field to the precise git commit hash used by the job.|
+|repository |string |The repository from which the script_version will be fetched.|
|cancelled_by_client_uuid|string|API client ID|Is null if job has not been cancelled|
|cancelled_by_user_uuid|string|Authenticated user ID|Is null if job has not been cancelled|
|cancelled_at|datetime|When job was cancelled|Is null if job has not been cancelled|
@@ -62,6 +72,7 @@ table(table table-bordered table-condensed).
|log|string|||
|tasks_summary|Hash|||
|output|string|||
+|nondeterministic |boolean |Indicates whether this job is a candidate for re-use|If true, this job will never be considered for re-use.|
h3. Runtime constraints
-----------------------------------------------------------------------
hooks/post-receive
--
More information about the arvados-commits
mailing list