Get a filtered list of jobs associated with the job request
post/jobRequests/{jobRequestId}/jobs
Returns a collection of application/vnd.sas.job.execution.job resources that were submitted using the specified job request. This particular call takes the filter in the body of the request to allow large filters that exceed standard URL length limits. Standard paging, filtering, and sorting options are specified in the Parameters section.
1{2 "links": [3 {4 "method": "POST",5 "rel": "collection",6 "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4/jobs",7 "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4/jobs",8 "type": "text/plain",9 "responseType": "application/vnd.sas.collection",10 "responseItemType": "application/vnd.sas.job.execution.job"11 },12 {13 "method": "POST",14 "rel": "self",15 "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4/jobs",16 "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4/jobs",17 "type": "text/plain",18 "responseType": "application/vnd.sas.collection",19 "responseItemType": "application/vnd.sas.job.execution.job"20 },21 {22 "method": "POST",23 "rel": "up",24 "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4/",25 "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4/",26 "type": "text/plain",27 "responseType": "application/vnd.sas.collection",28 "responseItemType": "application/vnd.sas.job.execution.job"29 },30 {31 "method": "POST",32 "rel": "submitJob",33 "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4/jobs",34 "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4/jobs",35 "responseType": "application/vnd.sas.job.execution.job"36 }37 ],38 "name": "jobs",39 "accept": "application/vnd.sas.job.execution.job",40 "start": 0,41 "count": 2,42 "items": [43 {44 "creationTimeStamp": "2022-04-12T20:25:53.936Z",45 "modifiedTimeStamp": "2022-04-12T20:26:14.424Z",46 "createdBy": "user1",47 "modifiedBy": "user1",48 "version": 4,49 "id": "2f52eecc-054b-45b0-837c-b3c21c6115a2",50 "jobRequest": {51 "creationTimeStamp": "2022-04-11T21:36:15.155Z",52 "modifiedTimeStamp": "2022-04-11T21:36:15.155Z",53 "createdBy": "sas.catalog",54 "modifiedBy": "sas.catalog",55 "version": 3,56 "id": "3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",57 "name": "List Catalogs",58 "jobDefinition": {59 "creationTimeStamp": "0001-01-01T00:00:00.000Z",60 "modifiedTimeStamp": "0001-01-01T00:00:00.000Z",61 "version": 1,62 "name": "List Catalogs",63 "type": "Compute",64 "parameters": [],65 "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",66 "properties": []67 },68 "arguments": {69 "_contextName": "SAS Job Execution compute context"70 },71 "properties": [],72 "createdByApplication": "jobExecution",73 "links": [74 {75 "method": "GET",76 "rel": "self",77 "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",78 "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",79 "type": "application/vnd.sas.job.execution.job.request"80 }81 ]82 },83 "state": "completed",84 "endTimeStamp": "2022-04-12T20:26:14.423Z",85 "heartbeatTimeStamp": "2022-04-12T20:25:54.349Z",86 "submittedByApplication": "jobExecution",87 "heartbeatInterval": 600,88 "elapsedTime": 20487,89 "results": {90 "COMPUTE_CONTEXT": "SAS Studio compute context",91 "1BCC3AB5-DC93-1040-8B87-B95E92D48DC5.log.txt": "/files/files/9ad6e3f4-998a-4512-922b-985ffa2f35bd",92 "#LN00007": "/files/files/596eb924-93c7-48c8-a79c-b206f6f06df9",93 "#LN00006": "/files/files/76962281-348a-4f57-978b-d3e42cd0677b",94 "COMPUTE_JOB": "1BCC3AB5-DC93-1040-8B87-B95E92D48DC5",95 "COMPUTE_SESSION": "13a661bb-68cc-4061-b49c-c989422c7199-ses0000 ended."96 },97 "logLocation": "/files/files/e685b834-ca4a-4de5-97e1-53474c3cfe7e",98 "links": [99 {100 "method": "GET",101 "rel": "self",102 "href": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2",103 "uri": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2",104 "type": "application/vnd.sas.job.execution.job"105 },106 {107 "method": "GET",108 "rel": "state",109 "href": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2/state",110 "uri": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2/state",111 "type": "text/plain"112 },113 {114 "method": "PUT",115 "rel": "update",116 "href": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2",117 "uri": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2",118 "type": "application/vnd.sas.job.execution.job",119 "responseType": "application/vnd.sas.job.execution.job"120 },121 {122 "method": "DELETE",123 "rel": "delete",124 "href": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2",125 "uri": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2"126 },127 {128 "method": "PUT",129 "rel": "updateState",130 "href": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2/state",131 "uri": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2/state",132 "type": "text/plain"133 },134 {135 "method": "POST",136 "rel": "updateHeartbeatTimeStamp",137 "href": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2/heartbeatTimeStamp",138 "uri": "/jobExecution/jobs/2f52eecc-054b-45b0-837c-b3c21c6115a2/heartbeatTimeStamp",139 "type": "text/plain"140 },141 {142 "method": "GET",143 "rel": "jobRequest",144 "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",145 "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",146 "type": "application/vnd.sas.job.execution.job.request"147 },148 {149 "method": "GET",150 "rel": "log",151 "href": "/files/files/e685b834-ca4a-4de5-97e1-53474c3cfe7e",152 "uri": "/files/files/e685b834-ca4a-4de5-97e1-53474c3cfe7e"153 }154 ]155 },156 {157 "creationTimeStamp": "2022-04-12T20:25:09.668Z",158 "modifiedTimeStamp": "2022-04-12T20:25:30.334Z",159 "createdBy": "user1",160 "modifiedBy": "user1",161 "version": 4,162 "id": "f47d224c-5951-47df-b188-488635e04706",163 "jobRequest": {164 "creationTimeStamp": "2022-04-11T21:36:15.155Z",165 "modifiedTimeStamp": "2022-04-11T21:36:15.155Z",166 "createdBy": "sas.catalog",167 "modifiedBy": "sas.catalog",168 "version": 3,169 "id": "3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",170 "name": "List Catalogs",171 "jobDefinition": {172 "creationTimeStamp": "0001-01-01T00:00:00.000Z",173 "modifiedTimeStamp": "0001-01-01T00:00:00.000Z",174 "version": 1,175 "name": "List Catalogs",176 "type": "Compute",177 "parameters": [],178 "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",179 "properties": []180 },181 "arguments": {182 "_contextName": "SAS Job Execution compute context"183 },184 "properties": [],185 "createdByApplication": "jobExecution",186 "links": [187 {188 "method": "GET",189 "rel": "self",190 "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",191 "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",192 "type": "application/vnd.sas.job.execution.job.request"193 }194 ]195 },196 "state": "completed",197 "endTimeStamp": "2022-04-12T20:25:30.333Z",198 "heartbeatTimeStamp": "2022-04-12T20:25:10.755Z",199 "submittedByApplication": "jobExecution",200 "heartbeatInterval": 600,201 "elapsedTime": 20665,202 "results": {203 "COMPUTE_CONTEXT": "SAS Studio compute context",204 "#LN00007": "/files/files/3dd98070-7e7c-4790-9520-8c3457788d4d",205 "#LN00006": "/files/files/6b607655-ec5d-4f80-b328-dcb44c193e21",206 "COMPUTE_JOB": "57E97ADB-4900-A241-A0B1-90DD5E96D781",207 "COMPUTE_SESSION": "b7260a74-e5f6-42fa-bcd9-431b98544148-ses0000 ended.",208 "57E97ADB-4900-A241-A0B1-90DD5E96D781.log.txt": "/files/files/1b327089-72e3-4a93-a7e5-ea7615abfead"209 },210 "logLocation": "/files/files/030e858d-47f4-45eb-b9b4-2073257d16b8",211 "links": [212 {213 "method": "GET",214 "rel": "self",215 "href": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706",216 "uri": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706",217 "type": "application/vnd.sas.job.execution.job"218 },219 {220 "method": "GET",221 "rel": "state",222 "href": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706/state",223 "uri": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706/state",224 "type": "text/plain"225 },226 {227 "method": "PUT",228 "rel": "update",229 "href": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706",230 "uri": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706",231 "type": "application/vnd.sas.job.execution.job",232 "responseType": "application/vnd.sas.job.execution.job"233 },234 {235 "method": "DELETE",236 "rel": "delete",237 "href": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706",238 "uri": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706"239 },240 {241 "method": "PUT",242 "rel": "updateState",243 "href": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706/state",244 "uri": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706/state",245 "type": "text/plain"246 },247 {248 "method": "POST",249 "rel": "updateHeartbeatTimeStamp",250 "href": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706/heartbeatTimeStamp",251 "uri": "/jobExecution/jobs/f47d224c-5951-47df-b188-488635e04706/heartbeatTimeStamp",252 "type": "text/plain"253 },254 {255 "method": "GET",256 "rel": "jobRequest",257 "href": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",258 "uri": "/jobExecution/jobRequests/3c6338bf-a2a0-4d2a-89d2-22d64ffb69e4",259 "type": "application/vnd.sas.job.execution.job.request"260 },261 {262 "method": "GET",263 "rel": "log",264 "href": "/files/files/030e858d-47f4-45eb-b9b4-2073257d16b8",265 "uri": "/files/files/030e858d-47f4-45eb-b9b4-2073257d16b8"266 }267 ]268 }269 ],270 "limit": 10,271 "version": 2272}
| Name | Type | Required | Description |
|---|---|---|---|
limit | integer | false | Represents the maximum number of jobs to return in this page of results. The actual number of returned jobs might be less if the collection has been exhausted. The default is 10. |
sortBy | string<sort-criteria> | false | This determines the sort order of the returned jobs. The default sort order is descending on the creationTimeStamp field. the following sorts are examples: Sort ascending by ID: /jobExecution/jobRequests/{jobRequestId}/jobs?sortBy=id:ascending Sort descending by ID: /jobExecution/jobRequests/{jobRequestId}/jobs?sortBy=id:descending |
start | integer | false | Represents the zero-based index of the first job to return. The default is 0 (zero). |
| 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. |
| Status | Meaning | Description | ||
|---|---|---|---|---|
| 200 | OK | The request succeeded. The jobs (if any) are returned in a resource collection. | Schema | |
| 400 | Bad Request | The request was not valid. An invalid request occurs in the following scenarios: <ul> <li>A negative start value is provided. </li> <li>A negative limit value is provided.</li> <li>An unsupported field is specified in the sortBy parameter.</li> </ul> | Schema | |
| 404 | Not Found | No job request exists at the requested path. | Schema |