Use this resource to retrieve the history of specified assets based on an internal ID or alias.
Get history of specified assets by time range (v2)
Retrieves all the change events of specified assets for a specific time range based on an internal ID or alias.
GET request
To retrieve all the change events of specified assets for a specific time range based on an internal ID or alias, submit a GET request with the following URI:
/rdm-service/external/v2/assets/audit
GET request query parameters
You can append query parameters to the URI to specify the time range, page number, page size, and modification type.
The following table describes the query parameters:
Parameter
Description
from
Start date and time of the time range, which is inclusive. Time range must be in the following ISO-8601 format: yyyy-MM-dd'T'HH:mm:ss'Z'. For example, you might use 2019-12-12T14:04:04Z.
to
End date and time of the time range, which is exclusive. Time range must be in the following ISO-8601 format: yyyy-MM-dd’T’HH:mm:ss’Z'. For example, you might use 2019-12-15T14:04:04Z.
page
Optional. Page number to display. Default is 0.
pageSize
Optional. Number of records to display per page. Default value is 100. Maximum value is 10000.
assetType
Optional. Type of asset. Set the value to REFERENCEDATASET, CODELIST, CROSSWALK, HIERARCHY, or ALL.
modificationType
Optional. Type of modification. Value can be CREATE, UPDATE, or DELETE.
GET response
The response contains the change events of specified assets for a time range.
The following table describes the attributes in the response body:
Attribute
Type
Description
pageSize
Number
Number of records displayed on each page.
page
Number
Page number that is displayed.
numberOfElements
Number
Total number of assets found.
lastPage
Boolean
Indicates whether the current page is the last page in the total result.
firstPage
Boolean
Indicates whether the current page is the first page in the total result.
content
Array
Includes the list of modification events.
asset
Object
Includes details about the assets.
id
String
ID of the asset. For more information, see Asset IDs.
name
String
Name of the asset.
internalId
String
Unique identifier of the asset.
alias
String
Alternative identifier of the asset.
assetType
String
Type of the asset.
modificationType
String
Type of change made to the assets. Value can be CREATE, UPDATE, or DELETE.
fieldChanges
Object
Includes details about the previous and new values of the fields with changes.
attributeChanges
Object
Includes details about the previous and new values of the attributes with changes.
eventTime
String
Date and time when the assets were last updated.
userName
String
User name of the user who initiated the modification.
GET example
To retrieve all the change events of specified assets for a specific time range based on an internal ID or alias, you might use the following request:
GET https://use4-mdm.dm-us.informaticacloud.com/rdm-service/external/v2/assets/audit?from=2023-01-01T00:00:00Z&to=2024-01-01T00:00:00Z HTTP/1.1 Accept: application/json IDS-SESSION-ID: XXXXXXXXXXXXXXXXXXXXXX
The following sample response shows the change events of the specified assets from 2023-01-01T00:00:00Z to 2024-01-01T00:00:00Z:
HTTP/1.1 200 OK Content-Type: application/json;charset=UTF-8 Content-Length: 2752