Get a job

get/jobs/{jobId}
Internal-Use Only

Returns information about one job based on its unique ID. After the job execution has completed, various execution artifacts can be obtained from the results member of the returned job (application/vnd.sas.job.execution.job). The items returned in the results map are provider specific. A log, if available, can be obtained from the logLocation member of the job.

Request Samples

1

Response Samples

1{
2 "creationTimeStamp": "2018-03-12T18:48:29.471Z",
3 "modifiedTimeStamp": "2018-03-12T18:48:42.753Z",
4 "createdBy": "user1",
5 "modifiedBy": "user1",
6 "version": 3,
7 "id": "6efcf389-7d63-4929-b532-13be28460eea",
8 "jobRequest": {
9 "version": 3,
10 "name": "proc print",
11 "description": "ods output",
12 "jobDefinitionUri": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af",
13 "jobDefinition": {
14 "creationTimeStamp": "2018-03-12T18:46:31.665Z",
15 "modifiedTimeStamp": "2018-03-12T18:46:31.666Z",
16 "createdBy": "user1",
17 "modifiedBy": "user1",
18 "version": 2,
19 "id": "aa3065a0-8ef6-42d1-965d-e77652aea7af",
20 "name": "Simple proc print",
21 "type": "Compute",
22 "parameters": [
23 {
24 "version": 1,
25 "name": "_contextName",
26 "defaultValue": "SAS Job Execution compute context",
27 "type": "CHARACTER",
28 "label": "Context Name",
29 "required": false
30 }
31 ],
32 "code": "ods html style=HTMLBlue;\nproc print data=sashelp.class; run; quit;\nods html close;",
33 "links": [
34 {
35 "method": "GET",
36 "rel": "self",
37 "href": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af",
38 "uri": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af",
39 "type": "application/vnd.sas.job.definition"
40 },
41 {
42 "method": "PUT",
43 "rel": "update",
44 "href": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af",
45 "uri": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af",
46 "type": "application/vnd.sas.job.definition",
47 "responseType": "application/vnd.sas.job.definition"
48 },
49 {
50 "method": "DELETE",
51 "rel": "delete",
52 "href": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af",
53 "uri": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af"
54 }
55 ],
56 "properties": []
57 },
58 "arguments": {
59 "_contextName": "SAS Job Execution compute context"
60 },
61 "properties": [],
62 "createdByApplication": "jobExecution"
63 },
64 "state": "completed",
65 "endTimeStamp": "2018-03-12T18:48:42.753Z",
66 "submittedByApplication": "jobExecution",
67 "heartbeatInterval": 0,
68 "elapsedTime": 13282,
69 "results": {
70 "COMPUTE_CONTEXT": "SAS Job Execution compute context",
71 "sashtml.htm": "/files/files/4908deb5-1b61-4473-a54a-aa02710b611b",
72 "D4363A55-6BC1-1C49-B559-8CFFC570DCF3.log.txt": "/files/files/96fb540c-b6be-4fc0-b2c1-3dbb5a3873f4",
73 "D4363A55-6BC1-1C49-B559-8CFFC570DCF3.list": "/files/files/f5e9d616-ad1b-49cf-a96c-26d2d2bfb567",
74 "COMPUTE_JOB": "D4363A55-6BC1-1C49-B559-8CFFC570DCF3",
75 "D4363A55-6BC1-1C49-B559-8CFFC570DCF3.list.txt": "/files/files/fcc792d1-bb57-4456-89fe-651c94d9f536",
76 "COMPUTE_SESSION": "53cd7934-767d-4823-8fd0-24f0fe9af953-ses0000 Ended."
77 },
78 "logLocation": "/files/files/3303a3eb-2a6c-4123-9f9b-7d20993edd2b",
79 "links": [
80 {
81 "method": "GET",
82 "rel": "self",
83 "href": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea",
84 "uri": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea",
85 "type": "application/vnd.sas.job.execution.job"
86 },
87 {
88 "method": "GET",
89 "rel": "state",
90 "href": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea/state",
91 "uri": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea/state",
92 "type": "text/plain"
93 },
94 {
95 "method": "PUT",
96 "rel": "update",
97 "href": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea",
98 "uri": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea",
99 "type": "application/vnd.sas.job.execution.job",
100 "responseType": "application/vnd.sas.job.execution.job"
101 },
102 {
103 "method": "DELETE",
104 "rel": "delete",
105 "href": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea",
106 "uri": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea"
107 },
108 {
109 "method": "PUT",
110 "rel": "updateState",
111 "href": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea/state",
112 "uri": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea/state",
113 "type": "text/plain"
114 },
115 {
116 "method": "POST",
117 "rel": "updateHeartbeatTimeStamp",
118 "href": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea/heartbeatTimeStamp",
119 "uri": "/jobExecution/jobs/6efcf389-7d63-4929-b532-13be28460eea/heartbeatTimeStamp",
120 "type": "text/plain"
121 },
122 {
123 "method": "GET",
124 "rel": "jobDefinition",
125 "href": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af",
126 "uri": "/jobDefinitions/definitions/aa3065a0-8ef6-42d1-965d-e77652aea7af",
127 "type": "application/vnd.sas.job.definition"
128 },
129 {
130 "method": "GET",
131 "rel": "log",
132 "href": "/files/files/3303a3eb-2a6c-4123-9f9b-7d20993edd2b",
133 "uri": "/files/files/3303a3eb-2a6c-4123-9f9b-7d20993edd2b"
134 }
135 ]
136}

Path Parameters

NameTypeRequiredDescription
jobId
string
true

The ID of job.

Header Parameters

NameTypeRequiredDescription
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

StatusMeaningDescription
200OKThe request succeeded.HeadersSchema
404Not FoundNo job exists at the requested path.Schema