[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