Get a collection of contexts

get/contexts

Internal-Use Only

Returns a collection of context information based on the specified query parameters.

Request Samples

Response Samples

200
application/json
1{
2  "accept": "application/vnd.sas.batch.context",
3  "count": 2,
4  "items": [
5    {
6      "createdBy": "sas.batch",
7      "creationTimeStamp": "2022-06-13T11:37:12.501276Z",
8      "description": "Default Batch Context for commands",
9      "id": "83e4801d-8bc2-4a6e-aaa1-a11f68985798",
10      "isMultiServer": true,
11      "launcherContextId": "d9a8437d-7f6b-4fbd-ae84-938d83cb096c",
12      "links": [
13        {
14          "method": "GET",
15          "rel": "self",
16          "href": "/batch/contexts/83e4801d-8bc2-4a6e-aaa1-a11f68985798",
17          "uri": "/batch/contexts/83e4801d-8bc2-4a6e-aaa1-a11f68985798",
18          "type": "application/vnd.sas.batch.context"
19        },
20        {
21          "method": "DELETE",
22          "rel": "delete",
23          "href": "/batch/contexts/83e4801d-8bc2-4a6e-aaa1-a11f68985798",
24          "uri": "/batch/contexts/83e4801d-8bc2-4a6e-aaa1-a11f68985798"
25        },
26        {
27          "method": "GET",
28          "rel": "up",
29          "href": "/batch/contexts",
30          "uri": "/batch/contexts",
31          "type": "application/vnd.sas.collection",
32          "itemType": "application/vnd.sas.batch.context"
33        }
34      ],
35      "maxServers": 0,
36      "minServers": 2,
37      "modifiedBy": "sas.batch",
38      "modifiedTimeStamp": "2022-06-13T11:37:12.501276Z",
39      "name": "default-cmd",
40      "providerOptions": "",
41      "queueName": "",
42      "requiredResources": "",
43      "runServerAs": "myServiceAcct",
44      "sasOptions": "",
45      "serverTimeout": 600,
46      "version": 3
47    },
48    {
49      "createdBy": "sas.batch",
50      "creationTimeStamp": "2022-06-13T11:37:08.210222Z",
51      "description": "Default Batch Context",
52      "id": "6794ba8a-6aff-4989-ae77-93f67286aea2",
53      "isMultiServer": false,
54      "launcherContextId": "01a0ce1b-a704-4fd9-8475-11ec1e746a22",
55      "links": [
56        {
57          "method": "GET",
58          "rel": "self",
59          "href": "/batch/contexts/6794ba8a-6aff-4989-ae77-93f67286aea2",
60          "uri": "/batch/contexts/6794ba8a-6aff-4989-ae77-93f67286aea2",
61          "type": "application/vnd.sas.batch.context"
62        },
63        {
64          "method": "DELETE",
65          "rel": "delete",
66          "href": "/batch/contexts/6794ba8a-6aff-4989-ae77-93f67286aea2",
67          "uri": "/batch/contexts/6794ba8a-6aff-4989-ae77-93f67286aea2"
68        },
69        {
70          "method": "GET",
71          "rel": "up",
72          "href": "/batch/contexts",
73          "uri": "/batch/contexts",
74          "type": "application/vnd.sas.collection",
75          "itemType": "application/vnd.sas.batch.context"
76        }
77      ],
78      "maxServers": 0,
79      "minServers": 0,
80      "modifiedBy": "someuser",
81      "modifiedTimeStamp": "2022-06-13T12:30:39.113567Z",
82      "name": "default",
83      "providerOptions": "",
84      "queueName": "default",
85      "requiredResources": "gpuRequired",
86      "runServerAs": "",
87      "sasOptions": "-memsize 2048",
88      "serverTimeout": 300,
89      "version": 3
90    }
91  ],
92  "limit": 10,
93  "links": [
94    {
95      "method": "GET",
96      "rel": "collection",
97      "href": "/batch/contexts",
98      "uri": "/batch/contexts",
99      "type": "application/vnd.sas.collection",
100      "itemType": "application/vnd.sas.batch.context"
101    },
102    {
103      "method": "GET",
104      "rel": "self",
105      "href": "/batch/contexts?start=0&limit=10",
106      "uri": "/batch/contexts?start=0&limit=10",
107      "type": "application/vnd.sas.collection",
108      "itemType": "application/vnd.sas.batch.context"
109    }
110  ],
111  "name": "contexts",
112  "start": 0,
113  "version": 2
114}

Query Parameters

Name	Type	Required	Description
filter	string<filter-criteria>	false	Specifies the filter criteria for returned items.
limit	integer	false	Limits the maximum number of resource items to return. The default value is "10".
sortBy	string<sort-criteria>	false	Sorts returned items by the specified criteria.
start	integer	false	Returns the offset of the first resource item to return. The default value is "0".

Responses

Status	Meaning	Description
200	OK	The request succeeded.	Schema
400	Bad Request	The query contexts request is not valid due to one of the following reasons. <UL> <LI> The start or limit value is not a number. <LI> The start or limit value is less than 0. <LI> The filter parameter is not a valid value. <LI> The sortBy parameter is not a valid value. </UL> See the returned error response for more information.	Schema
406	Not Acceptable	The requested response type is not acceptable. See the returned error response for more information and acceptable response types.	Schema