Update source definition with transfer object

put/providers/{providerId}/sourceDefinitions/{sourceDefinitionId}
Internal-Use Only

Updates a source definition using the transfer object. If no existing source definition is found, a new source definition is created. Either way, all other source definition properties are preserved.

Request Samples

1

Response Samples

1{
2  "creationTimeStamp": "0001-01-01T00:00:00Z",
3  "modifiedTimeStamp": "0001-01-01T00:00:00Z",
4  "createdBy": "sasjoe",
5  "modifiedBy": "anonymousUse",
6  "id": "ea1a9f8a-5013-4c89-8298-78c95659782e",
7  "name": "sourceDefName1",
8  "version": 2,
9  "links": [
10    {
11      "method": "GET",
12      "rel": "self",
13      "href": "/dataSources/providers/Compute/sourceDefinitions/ea1a9f8a-5013-4c89-8298-78c95659782e",
14      "uri": "/dataSources/providers/Compute/sourceDefinitions/ea1a9f8a-5013-4c89-8298-78c95659782e",
15      "type": "application/vnd.sas.data.source.definition"
16    },
17    {
18      "method": "PUT",
19      "rel": "update",
20      "href": "/dataSources/providers/Compute/sourceDefinitions/ea1a9f8a-5013-4c89-8298-78c95659782e",
21      "uri": "/dataSources/providers/Compute/sourceDefinitions/ea1a9f8a-5013-4c89-8298-78c95659782e",
22      "type": "application/vnd.sas.data.source.definition"
23    },
24    {
25      "method": "DELETE",
26      "rel": "delete",
27      "href": "/dataSources/providers/Compute/sourceDefinitions/ea1a9f8a-5013-4c89-8298-78c95659782e",
28      "uri": "/dataSources/providers/Compute/sourceDefinitions/ea1a9f8a-5013-4c89-8298-78c95659782e"
29    },
30    {
31      "method": "GET",
32      "rel": "up",
33      "href": "/dataSources/providers/Compute/sourceDefinitions",
34      "uri": "/dataSources/providers/Compute/sourceDefinitions",
35      "type": "application/vnd.sas.collection",
36      "itemType": "application/vnd.sas.data.source.definition"
37    },
38    {
39      "method": "GET",
40      "rel": "provider",
41      "href": "/dataSources/providers/Compute",
42      "uri": "/dataSources/providers/Compute",
43      "type": "application/vnd.sas.data.provider"
44    }
45  ]
46}

Path Parameters

NameTypeRequiredDescription
providerId
string
true

The ID for the provider.

sourceDefinitionId
string
true

The ID for the source definition.

Header Parameters

NameTypeRequiredDescription
If-Match
string
false

The etag that was returned from a GET, POST, or PUT of this data source definition.

Request Body

Source definition to be imported.

Information about a transfer object.

NameTypeRequiredDescription
version
integer
false

The version number of the transfer object.

id
string
false

The unique transfer object identifier.

summary
object
false

The details of the source definition.

content
string
false

The encoded data of the transfer object.

connectors
array [object]
false

Items that are associated with the transfer object.

Responses

StatusMeaningDescription
200OKThe request succeeded. The imported or updated source definition returned in resource summary format.Schema
400Bad RequestThe request was invalid. There is a mismatch in the transfer object content and one of the following requested resources: <ul> <li>The provider.</li> <li>The data source definition.</li> </ul> Schema
404Not FoundNo provider exists at the requested path.Schema
406Not AcceptableThis is an example of an error that could be returned for unsupported requested media type.Schema
412Precondition FailedThe ETag provided does not match the current version of the object.Schema
428Precondition RequiredRequired If-Match header is missing.Schema