Update source definition with transfer object

put/providers/{providerId}/sourceDefinitions/{sourceDefinitionId}

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
200OK

The request succeeded. The imported or updated source definition returned in resource summary format.

Schema
400Bad Request

The request was invalid. There is a mismatch in the transfer object content and one of the following requested resources:

  • The provider.
  • The data source definition.
Schema
404Not Found

No provider exists at the requested path.

Schema
406Not Acceptable

This is an example of an error that could be returned for unsupported requested media type.

Schema
412Precondition Failed

The ETag provided does not match the current version of the object.

Schema
428Precondition Required

Required If-Match header is missing.

Schema