Imports historical metrics data for a specific thing through a CVS file.
Note that, depending on the size of the provided CSV, a data-import may require several minutes to complete.
Checkout periodically the data-import status, by calling the get data-import by id method issuing the data-import identifier.
Here is an example of the CSV file:
TIMESTAMP,<metric-name>,<metric-name>,<metric-name>
1751882400000,25,true,"foo bar"
1751882430000,26.5,false,"abc"
- The TIMESTAMP column must contain UTC values (long) in ascending order.
- The column header for a metric should be the name of the metric itself.
Limitations:
- It is possible to import historical data for any raw and computed (derived and counter) metric.
- The file provided cannot exceed the size of 10 MiB and 50.000 rows.
- Only one import per thing can be performed at a time.
- Completed imports are automatically remoded after 30 days.
Required permissions: IMPORT_DATA.
The name of the target tenant (e.g. acme).
The identifier of the thing whose data-imports must be retrieve.
The index (1-based) of the row containing the CSV header.
The details of the scheduled data-import.
The CSV file to import. In the alternative, a ZIP containing the CSV file can be provided.
Successful created.
The bean providing data-import details.
The data-import unique identifier.
The timestamp UTC the data-import has been scheduled.
The data-import status.
Request data not valid.
The error response.
User not authenticated.
The error response.
User not authorized.
The error response.
API call rate limit exeeded.
The error response.
Internal server error.
The error response.