Toggle menu

copyevents()

Description

This function copies events from a history and places them at the end of the same history. The copies have the same timestamps and ordering as the originals.

Events can only be copied if the history is sealed and the History worker is in maintenance mode.

Parameters

NameTypeDescription
idstring, optionalThe unique internally generated key that identifies this history. Do not specify id and label parameters together
labelastring/int/real/bool, required if id is not setThe first part of the unique compound key that identifies this history
labelbstring/int/real/bool/null, optionalThe second (optional) part of the unique compound key that identifies this history
labelcstring/int/real/bool/null, optionalThe third (optional) part of the unique compound key that identifies this history
labeldstring/int/real/bool/null, optionalThe fourth (optional) part of the unique compound key that identifies this history
labelestring/int/real/bool/null, optionalThe fifth (optional) part of the unique compound key that identifies this history
topint, optional

Copy the first top events of the history

skipint, optionalDo not copy events in the first skip events of the history
startint, optionalDo not copy events before event number start in the history
lengthint, optionalCopy at most length events in the history

Returns

The id of the history and the number of events copied.

"result": {
    "historyid": "B1DF88CD-459C-454C-9264-B424EC12E999",
    "events": 52
}

Last modified on 27 June 2023

Share this page

Facebook icon Twitter icon email icon

Print

print icon