Submit multiple jobs using the specified job requests

post/jobRequests/@selection/jobs

Internal-Use Only

Submits jobs using the job-request URIs specified in the body resource selection. The request body identifies the job requests to submit. The selection type must be URI and the resources must be an array of URIs that identify the job requests. The items in the response MUST match 1-to-1 with the items in the request. If the job is submitted successfully, the corresponding item in the response is an application/vnd.sas.job.execution.job object. If the job submission failed, the corresponding item in the response is an application/vnd.sas.error object.

Request Samples

application/vnd.sas.selection+json
1

Response Samples

200
application/vnd.sas.collection+json
submitJobsSampleResponse
1{
2  "links": [],
3  "name": "items",
4  "items": [
5    {
6      "creationTimeStamp": "2021-11-09T13:51:33.352Z",
7      "modifiedTimeStamp": "2021-11-09T13:51:33.794Z",
8      "createdBy": "user1",
9      "modifiedBy": "user1",
10      "version": 4,
11      "id": "1b891edb-69a0-412c-b0d0-482f14882455",
12      "jobRequest": {
13        "creationTimeStamp": "2021-11-09T13:49:08.793Z",
14        "modifiedTimeStamp": "2021-11-09T13:49:08.793Z",
15        "createdBy": "user1",
16        "modifiedBy": "user1",
17        "version": 3,
18        "id": "7a49c947-9023-4636-94d6-935a7d2715a7",
19        "name": "Update tasks",
20        "description": "Job that will update tasks.",
21        "jobDefinition": {
22          "version": 1,
23          "name": "Update tasks",
24          "type": "Compute",
25          "parameters": [
26            {
27              "version": 1,
28              "name": "_contextName",
29              "defaultValue": "SAS Job Execution compute context",
30              "type": "CHARACTER",
31              "label": "Context Name",
32              "required": false
33            }
34          ],
35          "code": "data a;x=1;do while (x < 50) ;  call sleep(30000);end;run;quit;\n;",
36          "properties": []
37        },
38        "arguments": {
39          "_contextName": "SAS Job Execution compute context"
40        },
41        "properties": [],
42        "createdByApplication": "jobExecution",
43        "links": [
44          {
45            "method": "GET",
46            "rel": "self",
47            "href": "/jobExecution/jobRequests/7a49c947-9023-4636-94d6-935a7d2715a7",
48            "uri": "/jobExecution/jobRequests/7a49c947-9023-4636-94d6-935a7d2715a7",
49            "type": "application/vnd.sas.job.execution.job.request"
50          }
51        ]
52      },
53      "state": "running",
54      "heartbeatTimeStamp": "2021-11-09T13:51:33.788Z",
55      "submittedByApplication": "jobExecution",
56      "heartbeatInterval": 600,
57      "elapsedTime": 515,
58      "results": {},
59      "links": [
60        {
61          "method": "GET",
62          "rel": "self",
63          "href": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455",
64          "uri": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455",
65          "type": "application/vnd.sas.job.execution.job"
66        },
67        {
68          "method": "GET",
69          "rel": "state",
70          "href": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455/state",
71          "uri": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455/state",
72          "type": "text/plain"
73        },
74        {
75          "method": "PUT",
76          "rel": "update",
77          "href": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455",
78          "uri": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455",
79          "type": "application/vnd.sas.job.execution.job",
80          "responseType": "application/vnd.sas.job.execution.job"
81        },
82        {
83          "method": "DELETE",
84          "rel": "delete",
85          "href": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455",
86          "uri": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455"
87        },
88        {
89          "method": "PUT",
90          "rel": "updateState",
91          "href": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455/state",
92          "uri": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455/state",
93          "type": "text/plain"
94        },
95        {
96          "method": "POST",
97          "rel": "updateHeartbeatTimeStamp",
98          "href": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455/heartbeatTimeStamp",
99          "uri": "/jobExecution/jobs/1b891edb-69a0-412c-b0d0-482f14882455/heartbeatTimeStamp",
100          "type": "text/plain"
101        },
102        {
103          "method": "GET",
104          "rel": "jobRequest",
105          "href": "/jobExecution/jobRequests/7a49c947-9023-4636-94d6-935a7d2715a7",
106          "uri": "/jobExecution/jobRequests/7a49c947-9023-4636-94d6-935a7d2715a7",
107          "type": "application/vnd.sas.job.execution.job.request"
108        }
109      ]
110    },
111    {
112      "creationTimeStamp": "2021-11-09T13:51:33.909Z",
113      "modifiedTimeStamp": "2021-11-09T13:51:34.340Z",
114      "createdBy": "user1",
115      "modifiedBy": "user1",
116      "version": 4,
117      "id": "f3b188cc-3fde-43bd-a848-c1482fa5e588",
118      "jobRequest": {
119        "creationTimeStamp": "2021-11-09T13:50:16.194Z",
120        "modifiedTimeStamp": "2021-11-09T13:50:16.194Z",
121        "createdBy": "user1",
122        "modifiedBy": "user1",
123        "version": 3,
124        "id": "a43f3071-707e-45d1-a750-5e7b06bc98c6",
125        "name": "Monthly Results",
126        "description": "Monthly results.",
127        "jobDefinition": {
128          "version": 1,
129          "name": "Monthly Results",
130          "type": "Compute",
131          "parameters": [
132            {
133              "version": 1,
134              "name": "_contextName",
135              "defaultValue": "SAS Job Execution compute context",
136              "type": "CHARACTER",
137              "label": "Context Name",
138              "required": false
139            }
140          ],
141          "code": "data a;x=1;do while (x < 50) ;  call sleep(30000);end;run;quit;\n;",
142          "properties": []
143        },
144        "arguments": {
145          "_contextName": "SAS Job Execution compute context"
146        },
147        "properties": [],
148        "createdByApplication": "jobExecution",
149        "links": [
150          {
151            "method": "GET",
152            "rel": "self",
153            "href": "/jobExecution/jobRequests/a43f3071-707e-45d1-a750-5e7b06bc98c6",
154            "uri": "/jobExecution/jobRequests/a43f3071-707e-45d1-a750-5e7b06bc98c6",
155            "type": "application/vnd.sas.job.execution.job.request"
156          }
157        ]
158      },
159      "state": "running",
160      "heartbeatTimeStamp": "2021-11-09T13:51:34.333Z",
161      "submittedByApplication": "jobExecution",
162      "heartbeatInterval": 600,
163      "elapsedTime": 475,
164      "results": {},
165      "links": [
166        {
167          "method": "GET",
168          "rel": "self",
169          "href": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588",
170          "uri": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588",
171          "type": "application/vnd.sas.job.execution.job"
172        },
173        {
174          "method": "GET",
175          "rel": "state",
176          "href": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588/state",
177          "uri": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588/state",
178          "type": "text/plain"
179        },
180        {
181          "method": "PUT",
182          "rel": "update",
183          "href": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588",
184          "uri": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588",
185          "type": "application/vnd.sas.job.execution.job",
186          "responseType": "application/vnd.sas.job.execution.job"
187        },
188        {
189          "method": "DELETE",
190          "rel": "delete",
191          "href": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588",
192          "uri": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588"
193        },
194        {
195          "method": "PUT",
196          "rel": "updateState",
197          "href": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588/state",
198          "uri": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588/state",
199          "type": "text/plain"
200        },
201        {
202          "method": "POST",
203          "rel": "updateHeartbeatTimeStamp",
204          "href": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588/heartbeatTimeStamp",
205          "uri": "/jobExecution/jobs/f3b188cc-3fde-43bd-a848-c1482fa5e588/heartbeatTimeStamp",
206          "type": "text/plain"
207        },
208        {
209          "method": "GET",
210          "rel": "jobRequest",
211          "href": "/jobExecution/jobRequests/a43f3071-707e-45d1-a750-5e7b06bc98c6",
212          "uri": "/jobExecution/jobRequests/a43f3071-707e-45d1-a750-5e7b06bc98c6",
213          "type": "application/vnd.sas.job.execution.job.request"
214        }
215      ]
216    }
217  ],
218  "version": 2
219}

Query Parameters

Name	Type	Required	Description
submitter	string	false	Persisted in the `submittedByApplication` member of the created Job and used as the submitter portion of the job state change event routing key. Only characters in the set [a-zA-Z0-9] and hyphen are valid with a maximum of 64 characters.

Request Body

The representation of a selection of zero or more resources.

Name	Type	Required	Description
name	string	false	The ID of the selection.
type	string	false	Specifies whether the resources array contains IDs, URIs, or both. If "id", the array contains resource identifiers only. This is the default if "type" is omitted. If "uri", the array contains resource URIs. If "mixed", the array contains a mixture of identifiers and URIs. Allowed values: idurimixed
template	string<uri>	false	A URI template in which the {id} parameter can be replaced with a value from the "resources" array in order to yield the URI of the identified resource.
resources	array [string]	true	The selected resources as an array of resource IDs or URIs.
links	array [Link]	false	The links that apply to the selection.
version	integer	true	The schema version number of this media type. This representation is version 1.

Responses

Status	Meaning	Description
200	OK	The request succeeded.		Schema
400	Bad Request	The request was not valid. An invalid request occurs in the following scenarios: <ul> <li>An empty or missing body.</li><li>An invalid resource selection type in the body. The supported type is URI.<li></ul>		Schema