Contexts

Update a context

Updates the specified context with the contents of the request body.

put/contexts/{contextId}

Request

Base URL: https://example.com/batch
URL: https://example.com/batch/contexts/{contextId}
Auth: none declared

Path parameters

contextIdstring required

The ID of the context.

Headers

If-Matchstring

The value of the 'ETag' header that was returned from a GET or previous PUT of this context. The request must include either the If-Unmodified-Since header or the If-Match header.

If-Unmodified-Sincestring

The value of the 'Last-Modified' header that was returned from a GET or previous PUT of this context. The request must include either the If-Unmodified-Since header or the If-Match header.

Request body

createdBystring

The username of whoever created the resource.

modifiedBystring

The username of whoever last modified the resource.

creationTimeStampstring date-time

The timestamp for when the resource was created.

modifiedTimeStampstring date-time

The timestamp for when the resource was last modified.

descriptionstring

Specifies the description of the Batch context.

idstring

Specifies the ID of the context assigned by the Batch service.

isMultiServerboolean

Flag indicating that this context is for a reusable Batch server. Allowed in version 3 and later of the context.

launcherContextIdstring

Specifies the ID of the launcher context to use. Required if launcherContextName is not provided.

maxServersinteger

If this is a reusable Batch server, this is the maximum number of servers allowed to run. Allowed in version 3 and later of the context.

minServersinteger

If this is a reusable Batch server, this is the minimum number of servers always running. Allowed in version 3 and later of the context.

namestring

Specifies the name of the Batch context.

providerOptionsstring

Specifies options to pass to SAS Workload Orchestrator. Currently there are no options that can be set.

queueNamestring

Specifies the name of the SAS Workload Orchestrator queue to use if SAS Workload Management is part of the deployment.

runServerAsstring

Specifies the service-account user name to use when working with file sets and processing jobs. Allowed in version 2 and higher of the context.

requiredResourcesstring

Specifies SAS Workload Orchestrator tags that identify on which hosts this job can run if SAS Workload Management is part of the deployment.

sasOptionsstring

Specifies the SAS options to use on the SAS command line.

serverTimeoutinteger

If this is a reusable Batch server, this value is the number of seconds that the server waits for a job before terminating. The default is 300 seconds. Allowed in version 3 and later of the context.

versioninteger

Specifies the version number of this representation schema. This is version 1.

Example request

{
  "description": "Context for High Priority Jobs",
  "id": "e086b29a-2d19-4b97-a912-ee15951e1549",
  "isMultiServer": true,
  "launcherContextId": "9087b3f5-aced-4aa0-a491-b9d33ce197c2",
  "maxServers": 5,
  "minServers": 2,
  "name": "HighPriority",
  "providerOptions": "option1=17",
  "queueName": "High Priority",
  "runServerAs": "serviceAcctUser",
  "requiredResources": "gpuRequired",
  "sasOptions": "-memsize 0",
  "serverTimeout": 900
}

Response

The request succeeded.