About resource types
A resource is an individual data entity with a unique identifier. The list below describes the different resource types that you can interact with using the API.
The assets resource type stores digital representations of objects or groups of objects from the physical world. Assets are organized in hierarchies. For example, a water pump asset can be part of a subsystem asset on an oil platform asset.
Assets connect related data from different sources, and are core to identifying all the data that is relevant to an entity (contextualization) in Cognite Data Fusion. All other resource types, for example time series, events and files, should be connected to at least one asset, and each asset can be connected to many resources and resource types.
The time series resource type stores a series of data points in time order. Examples of a time series is the temperature of a water pump asset, the monthly precipitation in a location and the daily average number of manufacturing defects.
The events resource type stores information that happen over a period of time. Events have a start time and an end time and can be related to multiple assets. For example, an event can describe two hours of maintenance on a water pump and associated pipes, or a future time period for when the pump is scheduled for inspection.
The files resource type stores documents that contain information that is related to one or more assets. For example, a file can contain a piping and instrumentation diagram (P&ID) that shows how multiple assets are connected.
The 3D model resource type stores files that provide visual and geometrical data and context to assets. For example, we can connect a pump asset with a 3D model of the plant floor where it's placed. Seeing asset data rendered in 3D helps you quickly find the sensor data you are interested in.
Note: The 3D model resource type is currently in preview and is not yet generally available. The feature is subject to change, and we do not recommend that you use it in production systems.