Submit a job using the specified job request

post/jobRequests/{jobRequestId}/jobs

Internal-Use Only

Submits a job using the job request specified in the path parameter jobRequestId. The body for this request must be empty. The returned job stores the following members from the specified job request in its jobRequest member to allow for future retrieval: ID, createdBy, creationTimeStamp, modifiedBy, and modifiedTimeStamp.

Request Samples

Response Samples

201
application/vnd.sas.job.execution.job+json
1{
2  "creationTimeStamp": "2022-04-12T19:52:42.297Z",
3  "modifiedTimeStamp": "2022-04-12T19:52:47.855Z",
4  "createdBy": "user1",
5  "modifiedBy": "user1",
6  "version": 4,
7  "id": "5324e52f-4b1b-46b8-bbf9-a039c1091fab",
8  "jobRequest": {
9    "creationTimeStamp": "2022-04-11T21:36:15.155Z",
10    "modifiedTimeStamp": "2022-04-11T21:36:15.155Z",
11    "createdBy": "sas.catalog",
12    "modifiedBy": "sas.catalog",
13    "version": 3,
14    "id": "3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",
15    "name": "List Catalogs",
16    "jobDefinition": {
17      "creationTimeStamp": "0001-01-01T00:00:00.000Z",
18      "modifiedTimeStamp": "0001-01-01T00:00:00.000Z",
19      "version": 1,
20      "name": "List Catalogs",
21      "type": "Compute",
22      "parameters": [],
23      "code": "%macro web_list_catalogs(library);\n\t%let library=%upcase(&library);\n    proc sql ;\n        create table work.catalogs as select memname as Catalog, memtype as \n            Type, engine as Engine from sashelp.vmember where \n            libname=\"&library\" and memtype=\"CATALOG\";\n        run;\n        title \"Catalogs in &library\";\n\n    proc print data=work.catalogs;\n    run;\n%mend;\n\n%web_list_catalogs(SASHELP);\n",
24      "properties": []
25    },
26    "arguments": {
27      "_contextName": "SAS Job Execution compute context"
28    },
29    "properties": [],
30    "createdByApplication": "jobExecution",
31    "links": [
32      {
33        "method": "GET",
34        "rel": "self",
35        "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",
36        "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",
37        "type": "application/vnd.sas.job.execution.job.request"
38      }
39    ]
40  },
41  "state": "running",
42  "heartbeatTimeStamp": "2022-04-12T19:52:47.840Z",
43  "submittedByApplication": "jobExecution",
44  "heartbeatInterval": 600,
45  "elapsedTime": 5608,
46  "results": {},
47  "links": [
48    {
49      "method": "GET",
50      "rel": "self",
51      "href": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab",
52      "uri": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab",
53      "type": "application/vnd.sas.job.execution.job"
54    },
55    {
56      "method": "GET",
57      "rel": "state",
58      "href": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab/state",
59      "uri": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab/state",
60      "type": "text/plain"
61    },
62    {
63      "method": "PUT",
64      "rel": "update",
65      "href": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab",
66      "uri": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab",
67      "type": "application/vnd.sas.job.execution.job",
68      "responseType": "application/vnd.sas.job.execution.job"
69    },
70    {
71      "method": "DELETE",
72      "rel": "delete",
73      "href": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab",
74      "uri": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab"
75    },
76    {
77      "method": "PUT",
78      "rel": "updateState",
79      "href": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab/state",
80      "uri": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab/state",
81      "type": "text/plain"
82    },
83    {
84      "method": "POST",
85      "rel": "updateHeartbeatTimeStamp",
86      "href": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab/heartbeatTimeStamp",
87      "uri": "/jobExecution/jobs/5324e52f-4b1b-46b8-bbf9-a039c1091fab/heartbeatTimeStamp",
88      "type": "text/plain"
89    },
90    {
91      "method": "GET",
92      "rel": "jobRequest",
93      "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",
94      "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",
95      "type": "application/vnd.sas.job.execution.job.request"
96    }
97  ]
98}

Path Parameters

Name	Type	Required	Description
jobRequestId	string	true	The ID of the job request.

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. Do note the misspelled "sumbitter" query described below.
sumbitter	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. Do note the misspelling in the query parameter name to reflect the misspelling in the version 3 implementation. This misspelled query parameter is now deprecated and the correctly spelled "submitter" has been implemented and documented (see previous entry). If both query parameters are specified, then their values must be the same.

Header Parameters

Name	Type	Required	Description
Delegate-Domain	string	false	Name of a credential domain of type OAuth2.0. The credential secret is retrieved to impersonate a group-managed service account for the current request.

Responses

Status	Meaning	Description
201	Created	The job request was created.	Headers	Schema
400	Bad Request	The request was not valid.		Schema
404	Not Found	No job request exists at the requested path.		Schema