Execute SAS code in a session

post/sessions/{sessionId}/jobs

Internal-Use Only

Executes SAS code in the specified session. Code is always submitted asynchronously. URLs are returned that contain endpoints. The Location header contains the URI of the job resource. You might submit the code directly in a request or as a reference to a File service resource.

Request Samples

application/vnd.sas.compute.job.request+json
1

Response Samples

201
application/vnd.sas.compute.job+json
1{
2  "listingStatistics": {
3    "lineCount": 5,
4    "modifiedTimeStamp": "2017-02-20T19:17:33Z"
5  },
6  "logStatistics": {
7    "lineCount": 45,
8    "modifiedTimeStamp": "2017-02-20T19:17:33Z"
9  },
10  "completedTimeStamp": "2016-05-20T16:16:10Z",
11  "creationTimeStamp": "2016-05-20T16:16:10Z",
12  "id": "0",
13  "jobConditionCode": 0,
14  "links": [
15    {
16      "href": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0",
17      "method": "GET",
18      "rel": "self",
19      "type": "application/vnd.sas.compute.job",
20      "uri": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0"
21    },
22    {
23      "href": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/state",
24      "method": "GET",
25      "rel": "state",
26      "type": "text/plain",
27      "uri": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/state"
28    },
29    {
30      "href": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/state?value=canceled",
31      "method": "PUT",
32      "rel": "cancel",
33      "uri": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/state?value=canceled"
34    },
35    {
36      "href": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0",
37      "method": "DELETE",
38      "rel": "delete",
39      "uri": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0"
40    },
41    {
42      "href": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/log",
43      "itemType": "application/vnd.sas.compute.log.line",
44      "method": "GET",
45      "rel": "log",
46      "type": "application/vnd.sas.collection",
47      "uri": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/log"
48    },
49    {
50      "href": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/listing",
51      "itemType": "application/vnd.sas.compute.log.line",
52      "method": "GET",
53      "rel": "listing",
54      "type": "application/vnd.sas.collection",
55      "uri": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/listing"
56    },
57    {
58      "href": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/results",
59      "method": "GET",
60      "rel": "results",
61      "type": "application/vnd.sas.compute.result",
62      "uri": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000/jobs/0/results"
63    },
64    {
65      "href": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000",
66      "method": "GET",
67      "rel": "up",
68      "type": "application/vnd.sas.compute.session",
69      "uri": "/compute/sessions/4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000"
70    }
71  ],
72  "sessionId": "4c6775e3-50f3-4c72-80a3-a7e1069876dc-ses0000",
73  "state": "completed",
74  "version": 1
75}

Path Parameters

Name	Type	Required	Description
sessionId	string	true	Specifies the ID of the session.

Request Body

Specifies the job submission request.

Provides an object that you use to request a new job in a Compute session.

Example:

{"version":2,"name":"MyOptions","description":"Getting the options for my session.","code":["proc options;","run;"],"attributes":{"resetLogLineNumbers":false}}

Name	Type	Required	Description
version	integer<int32>	false	Specifies the version number of this representation schema. This is version 3.
name	string	false	Specifies an optional name that is associated with this job.
description	string	false	Specifies an optional description for this job.
environment	SAS Environment	false	Provides the SAS options and initialization code that is used by the Compute service and its sessions.
variables	object	false	Specifies input variables for this request.
code	array [string]	false
codeUri	string	false	Specifies a URI path to a resource reference from the Files service. You must specify code or codeUri.
resources	array [External Resource]	false	Specifies the resources that are requested for this job.
attributes	object	false	Specifies the attributes that modify the behavior of this job request. See example for details. Support for these attributes was added in version 2.

Responses

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