Get current and previous revisions of an entity Instance

get/instances/{instanceId}/history

Internal-Use Only

Returns current and previous revisions of an entity instance; the endpoint is undefined for other kinds of instances. This collection does not support filtering or sorting; but it does support pagination controls. Elements are sorted based on their descending modification timestamp; the current revision is at the top of the list. Elements in the collection cannot be modified via the REST API.

Request Samples

Response Samples

200
application/json
1{
2  "version": 2,
3  "accept": "application/vnd.sas.metadata.instance.entity",
4  "count": 1,
5  "start": 0,
6  "limit": 10,
7  "name": "history",
8  "items": [
9    {
10      "creationTimeStamp": "2021-10-04T12:27:29.317Z",
11      "createdBy": "sasuser",
12      "modifiedTimeStamp": "2021-10-04T12:27:29.317Z",
13      "modifiedBy": "sasuser",
14      "id": "965ce303-33b3-924f-9144-f30d09b6576a",
15      "version": 1,
16      "instanceType": "entity",
17      "definition": "sasTable",
18      "name": "AACOMP",
19      "type": "sasTable",
20      "links": [
21        {
22          "method": "GET",
23          "rel": "historyArchive",
24          "href": "/catalog/instances/965ce303-33b3-924f-9144-f30d09b6576a/history/965ce303-33b3-924f-9144-f30d09b6576a",
25          "uri": "/catalog/instances/965ce303-33b3-924f-9144-f30d09b6576a/history/965ce303-33b3-924f-9144-f30d09b6576a",
26          "type": "application/vnd.sas.metadata.instance.archive",
27          "responseType": "application/vnd.sas.metadata.instance.archive"
28        }
29      ],
30      "attributes": {
31        "analysisTimeStamp": "2021-10-04T12:27:26.331Z",
32        "columnCount": 4,
33        "completenessPercent": 100,
34        "creator": "sas",
35        "dataLocale": "ENUSA",
36        "dataSize": 458752,
37        "dateCreated": "2021-09-28T08:03:09.972Z",
38        "dateModified": "2021-09-28T08:03:09.972Z",
39        "encoding": "us-ascii  ASCII (ANSI)",
40        "extension": "sas7bdat",
41        "informationPrivacy": "private",
42        "isView": false,
43        "reviewStatus": "none",
44        "rowCount": 2020,
45        "runStatus": "new",
46        "sourceSystem": "SAS"
47      },
48      "resourceId": "/dataTables/dataSources/Compute~fs~c4785dba-e8f7-452b-881e-55379dc53f44~fs~SASHELP/tables/AACOMP"
49    }
50  ],
51  "links": [
52    {
53      "method": "GET",
54      "rel": "self",
55      "href": "/catalog/instances/965ce303-33b3-924f-9144-f30d09b6576a/history?start=0&limit=10",
56      "uri": "/catalog/instances/965ce303-33b3-924f-9144-f30d09b6576a/history?start=0&limit=10",
57      "type": "application/vnd.sas.collection",
58      "itemType": "application/vnd.sas.metadata.instance.entity"
59    },
60    {
61      "method": "GET",
62      "rel": "collection",
63      "href": "/catalog/instances/965ce303-33b3-924f-9144-f30d09b6576a/history",
64      "uri": "/catalog/instances/965ce303-33b3-924f-9144-f30d09b6576a/history",
65      "type": "application/vnd.sas.collection",
66      "itemType": "application/vnd.sas.metadata.instance.entity"
67    },
68    {
69      "method": "GET",
70      "rel": "up",
71      "href": "/catalog/instances/965ce303-33b3-924f-9144-f30d09b6576a",
72      "uri": "/catalog/instances/965ce303-33b3-924f-9144-f30d09b6576a",
73      "type": "application/vnd.sas.metadata.instance.entity+json"
74    }
75  ]
76}

Path Parameters

Name	Type	Required	Description
instanceId	string	true	The ID of the Instance

Query Parameters

Name	Type	Required	Description
limit	integer	false	Maximum number of objects to return. Defaults to 10.
start	integer	false	0-based Offset of first object to return. Defaults to 0.

Header Parameters

Name	Type	Required	Description
Accept	string	false	The desired representation for the response. Allowed values: application/vnd.sas.collection+jsonapplication/json Default: application/vnd.sas.collection+json
Accept-Item	string	false	The desired item representation for collections. Allowed values: application/vnd.sas.metadata.instance.entity+jsonapplication/json Default: application/vnd.sas.metadata.instance.entity+json

Responses

Status	Meaning	Description
200	OK	OK.	Headers	Schema
400	Bad Request	Bad request (the request is not well-formed).		Schema
401	Unauthorized	Not authenticated.		Schema
403	Forbidden	The user does not have permission to complete this request.		Schema
404	Not Found	The specified resource was not found.		Schema
406	Not Acceptable	Not Acceptable. Include an Accept header with a supported value on the request.		Schema