X-Git-Url: https://git.arvados.org/arvados.git/blobdiff_plain/dc021c3b57dcdebe464c148d55f9990a74e8246b..095e176632bbf81d28a239742a1ecce12404bd2d:/doc/api/methods/jobs.html.textile.liquid
diff --git a/doc/api/methods/jobs.html.textile.liquid b/doc/api/methods/jobs.html.textile.liquid
index 13fa838767..75d7368c8e 100644
--- a/doc/api/methods/jobs.html.textile.liquid
+++ b/doc/api/methods/jobs.html.textile.liquid
@@ -11,7 +11,9 @@ Copyright (C) The Arvados Authors. All rights reserved.
SPDX-License-Identifier: CC-BY-SA-3.0
{% endcomment %}
-p=. *Legacy. This endpoint is read-only and disabled by default in new installations.*
+{% include 'notebox_begin_warning' %}
+This is a legacy API. This endpoint is deprecated, disabled by default in new installations, and slated to be removed entirely in a future major release of Arvados. It is replaced by "container requests.":container_requests.html
+{% include 'notebox_end' %}
API endpoint base: @https://{{ site.arvados_api_host }}/arvados/v1/jobs@
@@ -57,7 +59,7 @@ See "Specifying Git versions":#script_version below for more detail about accept
h3(#script_version). Specifying Git versions
-The script_version attribute and arvados_sdk_version runtime constraint are typically given as a branch, tag, or commit hash, but there are many more ways to specify a Git commit. The "specifying revisions" section of the "gitrevisions manual page":http://git-scm.com/docs/gitrevisions.html has a definitive list. Arvados accepts Git versions in any format listed there that names a single commit (not a tree, a blob, or a range of commits). However, some kinds of names can be expected to resolve differently in Arvados than they do in your local repository. For example, HEAD@{1}
refers to the local reflog, and @origin/master@ typically refers to a remote branch: neither is likely to work as desired if given as a Git version.
+The script_version attribute and arvados_sdk_version runtime constraint are typically given as a branch, tag, or commit hash, but there are many more ways to specify a Git commit. The "specifying revisions" section of the "gitrevisions manual page":http://git-scm.com/docs/gitrevisions.html has a definitive list. Arvados accepts Git versions in any format listed there that names a single commit (not a tree, a blob, or a range of commits). However, some kinds of names can be expected to resolve differently in Arvados than they do in your local repository. For example, HEAD@{1}
refers to the local reflog, and @origin/main@ typically refers to a remote branch: neither is likely to work as desired if given as a Git version.
h3. Runtime constraints
@@ -138,14 +140,14 @@ notextile.
{ "job": { "script": "hash.py", "repository": "you/you", - "script_version": "master", + "script_version": "main", "script_parameters": { "input": "c1bad4b39ca5a924e481008009d94e32+210" } @@ -170,14 +172,14 @@ Run using exactly the version "d00220fb38d4b85ca8fc28a8151702a2b9d1dec5". Arvado }
{ "job": { "script": "hash.py", "repository": "you/you", - "script_version": "master", + "script_version": "main", "script_parameters": { "input": "c1bad4b39ca5a924e481008009d94e32+210" } @@ -195,7 +197,7 @@ The same behavior, using filters: "job": { "script": "hash.py", "repository": "you/you", - "script_version": "master", + "script_version": "main", "script_parameters": { "input": "c1bad4b39ca5a924e481008009d94e32+210" } @@ -208,14 +210,14 @@ The same behavior, using filters: }
{ "job": { "script": "monte-carlo.py", "repository": "you/you", - "script_version": "master", + "script_version": "main", "nondeterministic": true, "script_parameters": { "input": "c1bad4b39ca5a924e481008009d94e32+210"