Update a job request

put/jobRequests/{jobRequestId}
Internal-Use Only

Updates an existing job request via a full replacement of the resource. The ID field might not be modified by this operation.

Request Samples

1

Response Samples

1{
2  "creationTimeStamp": "2018-03-12T19:37:28.318Z",
3  "modifiedTimeStamp": "2018-03-12T19:51:07.178Z",
4  "createdBy": "user1",
5  "modifiedBy": "user1",
6  "version": 3,
7  "id": "f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
8  "name": "sashelp.class distribution",
9  "description": "ods output with age 14 cutoff",
10  "jobDefinitionUri": "/jobDefinitions/definitions/dabd2a63-ae2f-4559-b110-ad989ff642a5",
11  "arguments": {
12    "_contextName": "SAS Job Execution compute context",
13    "AGE": "14"
14  },
15  "properties": [],
16  "links": [
17    {
18      "method": "GET",
19      "rel": "self",
20      "href": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
21      "uri": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
22      "type": "application/vnd.sas.job.execution.job.request"
23    },
24    {
25      "method": "GET",
26      "rel": "export",
27      "href": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
28      "uri": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
29      "type": "application/vnd.sas.transfer.object"
30    },
31    {
32      "method": "DELETE",
33      "rel": "delete",
34      "href": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
35      "uri": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b"
36    },
37    {
38      "method": "PUT",
39      "rel": "update",
40      "href": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
41      "uri": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
42      "type": "application/vnd.sas.job.execution.job.request"
43    },
44    {
45      "method": "PUT",
46      "rel": "import",
47      "href": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
48      "uri": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b",
49      "type": "application/vnd.sas.transfer.object",
50      "responseType": "application/vnd.sas.summary"
51    },
52    {
53      "method": "GET",
54      "rel": "up",
55      "href": "/jobExecution/jobRequests",
56      "uri": "/jobExecution/jobRequests",
57      "type": "application/vnd.sas.collection",
58      "itemType": "application/vnd.sas.job.execution.job.request"
59    },
60    {
61      "method": "GET",
62      "rel": "jobs",
63      "href": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b/jobs",
64      "uri": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b/jobs",
65      "type": "application/vnd.sas.collection",
66      "itemType": "application/vnd.sas.job.execution.job"
67    },
68    {
69      "method": "POST",
70      "rel": "submitJob",
71      "href": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b/jobs",
72      "uri": "/jobExecution/jobRequests/f9c52f58-9639-45ae-b24c-23cfff0b2f5b/jobs",
73      "responseType": "application/vnd.sas.job.execution.job"
74    }
75  ]
76}

Path Parameters

NameTypeRequiredDescription
jobRequestId
string
true

The ID of the job request.

Query Parameters

NameTypeRequiredDescription
parentFolderUri
string
false

The URI of the parent folder in which to save the job request. If the job request is in a different folder, it is moved to the specified parent folder.

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.

If-Match
string
false

The entity tag obtained from the most recent ETag response header of this job request. Must match the current entity tag for the job request.

If-Unmodified-Since
string
false

Ignored when If-Match is specified. The timestamp obtained from the most recent Last-Modified response header of this job request. Must be later than or equal to the timestamp when the job request was last modified.

Request Body

The job request to be updated.

The job request.

NameTypeRequiredDescription
id
string
false

The unique identifier for the job request. This is only required for a persisted job request.

name
string
false

The name of the job request.

description
string
false

The description of the job request.

creationTimeStamp
string<date-time>
false

The timestamp when the job request was created. It uses the format YYYY-MM-DDThh:mm:ss.sssZ. This is set only on a persisted job request.

modifiedTimeStamp
string<date-time>
false

The timestamp when the job request was last modified. It uses the format YYYY-MM-DDThh:mm:ss.sssZ. This is set only on a persisted job request.

createdBy
string
false

The name of the user who created the job request. This is set only on a persisted job request.

modifiedBy
string
false

The name of the last user who modified this object. This is set only on a persisted job request

jobDefinitionUri
string
false

The URI of the job definition that is to be executed. Either the jobDefinitionUri or the jobDefinition property must be set in a job request submitted to Job Execution service for execution.

jobDefinition
Job Definition Schema
false

The job definition.

expiresAfter
string
false

The duration of time (in W3C XML duration format) after the completion of the job when the job must be deleted by the Job Execution service. If a value is specified for this property, it overrides any value specified by the provider's /commons/settings endpoint for the job request. For a job request that is embedded in the application/vnd.sas.job.execution.job media type, if a value is not already set for the expiresAfter property, the value is set by the Job Execution service to the provider's value, if one exists.

arguments
object
false

The values of the arguments are name-value pairs specified as a map of string keys and values. Values can be supplied for parameters not defined in the job definition. The maximum name length is 100. Hibernate does not persist a map entry with a null value. Therefore, a persisted Job Request does not contain such entries. For a job request that is embedded in the 'application/vnd.sas.job.execution.job' media type, this value is set by the Job Execution service and contains the complete set of arguments to use in the execution by the provider. Arguments that already exist in the original job request are left unchanged. If there are arguments in the job definition that do not exist in the original job request arguments map, those arguments and any default values, including null values, are added to the arguments map. However, because the Job object is persisted before being sent to the provider, no entries for such null-value arguments in the Job are sent to the provider (because of the Hibernate behavior of not persisting map/collection entries with null values). The Job Execution service also guarantees that any required argument has an associated non-null value.

properties
array [Resource Property]
false

The value of properties are name-value pairs specified as a map of string keys and values. The maximum name length is 100.

createdByApplication
string
false

The application that created the job request. The value is typically from the spring.application.name property. The value is used as the "creator" in the routing key of the Job State Change events, and if it is not present in the job request the value "jobExecution" is used. Valid characters are [a-zA-Z0-9] and the hyphen.

<= 64 characters
links
array [Link]
false

Links that apply to this object. Includes "self", "alternate", "export", "delete", "update", "import", "up", "jobs" and "submitJob".

version
integer
false

The version number of the representation. The current version is 3.

Responses

StatusMeaningDescription
200OKThe request succeeded. The job request definition updated successfully.HeadersSchema
400Bad RequestThe request was not valid. This occurs when the user provides an ID in the request that does not match the ID in the path of the URL.Schema
404Not FoundNo job request exists at the requested path.Schema
412Precondition FailedThe `If-Match` request header did not match the resource's entity tag, or the `If-Unmodified-Since` request header was earlier than the resource's last modified timestamp.Schema
415Unsupported Media TypeThe requested media type is not supported.Schema
428Precondition RequiredThe request was missing an `If-Match` or `If-Unmodified-Since` header.Schema