Update a View Definition by its ID

put/views/{viewId}
Internal-Use Only

Update a View Definition by its ID.

Request Samples

1

Response Samples

1{
2  "creationTimeStamp": "2022-03-23T14:36:42.145Z",
3  "createdBy": "sasuser",
4  "modifiedTimeStamp": "2022-03-23T14:36:42.145Z",
5  "modifiedBy": "sasuser",
6  "id": "a8fc4c97-b6b0-4026-81cc-c47af69ac56e",
7  "links": [
8    {
9      "method": "GET",
10      "rel": "self",
11      "href": "/catalog/views/a8fc4c97-b6b0-4026-81cc-c47af69ac56e",
12      "uri": "/catalog/views/a8fc4c97-b6b0-4026-81cc-c47af69ac56e",
13      "type": "application/vnd.sas.metadata.definition.view"
14    },
15    {
16      "method": "GET",
17      "rel": "up",
18      "href": "/catalog/views",
19      "uri": "/catalog/views",
20      "type": "application/vnd.sas.collection",
21      "itemType": "application/vnd.sas.metadata.definition.view"
22    },
23    {
24      "method": "PUT",
25      "rel": "update",
26      "href": "/catalog/views/a8fc4c97-b6b0-4026-81cc-c47af69ac56e",
27      "uri": "/catalog/views/a8fc4c97-b6b0-4026-81cc-c47af69ac56e",
28      "type": "application/vnd.sas.metadata.definition.view",
29      "responseType": "application/vnd.sas.metadata.definition.view"
30    },
31    {
32      "method": "DELETE",
33      "rel": "delete",
34      "href": "/catalog/views/a8fc4c97-b6b0-4026-81cc-c47af69ac56e",
35      "uri": "/catalog/views/a8fc4c97-b6b0-4026-81cc-c47af69ac56e"
36    }
37  ],
38  "version": 1,
39  "name": "dataSetColumns",
40  "label": "Dataset with Columns",
41  "description": "Dataset and columns",
42  "query": "match (t:dataSet)-[r:dataSetDataField]->(c:dataField)"
43}

Path Parameters

NameTypeRequiredDescription
viewId
string
true

The ID of the View Definition

Header Parameters

NameTypeRequiredDescription
Content-Type
string
true

The representation in the request body.

Allowed values:
application/vnd.sas.metadata.definition.view+jsonapplication/json
Default:
application/vnd.sas.metadata.definition.view+json
If-Match
string
true

The ETag that was returned from a GET, POST, PUT, PATCH, or HEAD of this object. If the ETag does not match, the update will fail.

Accept
string
false

The desired representation for the response.

Allowed values:
application/vnd.sas.metadata.definition.view+jsonapplication/json
Default:
application/vnd.sas.metadata.definition.view+json

Request Body

Information about a view definition

NameTypeRequiredDescription
id
string
true

the unique identity of this view. Immutable after creation.

name
string
true

The name of the view; the maximum length is 100.

label
string
false

A label for the view; the maximum length is 100.

description
string
false

A description for the view; the maximum length is 1000.

query
string
true

The view query; the maximum length is 1000.

links
array [Link]
false

The links that apply to the view definition.

Responses

StatusMeaningDescription
200OKThe request succeeded.HeadersSchema
400Bad RequestBad request (the request is not well-formed).Schema
401UnauthorizedNot authenticated.Schema
403ForbiddenThe user does not have permission to complete this request.Schema
404Not FoundThe specified resource was not found.Schema
406Not AcceptableNot Acceptable. Include an Accept header with a supported value on the request.Schema
412Precondition FailedPrecondition failed. The target has changed since it was last fetched.Schema
415Unsupported Media TypeUnsupported Media Type. Include a Content-Type header with a supported value in the request.Schema
428Precondition RequiredPrecondition required. Include an If-Match header with the request.Schema