Querying historical asset property values
You can use the Amazon IoT SiteWise API GetAssetPropertyValueHistory operation to query the historical values of an asset property.
To identify an asset property, specify one of the following:
-
The
assetId
andpropertyId
of the asset property that data is sent to. -
The
propertyAlias
, which is a data stream alias (for example,/company/windfarm/3/turbine/7/temperature
). To use this option, you must first set your asset property's alias. To set property aliases, see Mapping industrial data streams to asset properties.
Pass the following parameters to refine your results:
-
startDate
– The exclusive start of the range from which to query historical data, expressed in seconds in Unix epoch time. -
endDate
– The inclusive end of the range from which to query historical data, expressed in seconds in Unix epoch time. -
maxResults
– The maximum number of results to return in one request. Defaults to20
results. -
nextToken
– A pagination token returned from a previous call of this operation. -
timeOrdering
– The ordering to apply to the returned values:ASCENDING
orDESCENDING
. -
qualities
– The quality to filter results by:GOOD
,BAD
, orUNCERTAIN
.