Copyright | (c) 2013-2023 Brendan Hay |
---|---|
License | Mozilla Public License, v. 2.0. |
Maintainer | Brendan Hay |
Stability | auto-generated |
Portability | non-portable (GHC extensions) |
Safe Haskell | Safe-Inferred |
Language | Haskell2010 |
Gets the history of an asset property's values. For more information, see Querying historical values in the IoT SiteWise User Guide.
To identify an asset property, you must specify one of the following:
- The
assetId
andpropertyId
of an asset property. - A
propertyAlias
, which is a data stream alias (for example,/company/windfarm/3/turbine/7/temperature
). To define an asset property's alias, see UpdateAssetProperty.
This operation returns paginated results.
Synopsis
- data GetAssetPropertyValueHistory = GetAssetPropertyValueHistory' {}
- newGetAssetPropertyValueHistory :: GetAssetPropertyValueHistory
- getAssetPropertyValueHistory_assetId :: Lens' GetAssetPropertyValueHistory (Maybe Text)
- getAssetPropertyValueHistory_endDate :: Lens' GetAssetPropertyValueHistory (Maybe UTCTime)
- getAssetPropertyValueHistory_maxResults :: Lens' GetAssetPropertyValueHistory (Maybe Natural)
- getAssetPropertyValueHistory_nextToken :: Lens' GetAssetPropertyValueHistory (Maybe Text)
- getAssetPropertyValueHistory_propertyAlias :: Lens' GetAssetPropertyValueHistory (Maybe Text)
- getAssetPropertyValueHistory_propertyId :: Lens' GetAssetPropertyValueHistory (Maybe Text)
- getAssetPropertyValueHistory_qualities :: Lens' GetAssetPropertyValueHistory (Maybe (NonEmpty Quality))
- getAssetPropertyValueHistory_startDate :: Lens' GetAssetPropertyValueHistory (Maybe UTCTime)
- getAssetPropertyValueHistory_timeOrdering :: Lens' GetAssetPropertyValueHistory (Maybe TimeOrdering)
- data GetAssetPropertyValueHistoryResponse = GetAssetPropertyValueHistoryResponse' {}
- newGetAssetPropertyValueHistoryResponse :: Int -> GetAssetPropertyValueHistoryResponse
- getAssetPropertyValueHistoryResponse_nextToken :: Lens' GetAssetPropertyValueHistoryResponse (Maybe Text)
- getAssetPropertyValueHistoryResponse_httpStatus :: Lens' GetAssetPropertyValueHistoryResponse Int
- getAssetPropertyValueHistoryResponse_assetPropertyValueHistory :: Lens' GetAssetPropertyValueHistoryResponse [AssetPropertyValue]
Creating a Request
data GetAssetPropertyValueHistory Source #
See: newGetAssetPropertyValueHistory
smart constructor.
GetAssetPropertyValueHistory' | |
|
Instances
newGetAssetPropertyValueHistory :: GetAssetPropertyValueHistory Source #
Create a value of GetAssetPropertyValueHistory
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
GetAssetPropertyValueHistory
, getAssetPropertyValueHistory_assetId
- The ID of the asset.
GetAssetPropertyValueHistory
, getAssetPropertyValueHistory_endDate
- The inclusive end of the range from which to query historical data,
expressed in seconds in Unix epoch time.
$sel:maxResults:GetAssetPropertyValueHistory'
, getAssetPropertyValueHistory_maxResults
- The maximum number of results to return for each paginated request.
Default: 100
GetAssetPropertyValueHistory
, getAssetPropertyValueHistory_nextToken
- The token to be used for the next set of paginated results.
GetAssetPropertyValueHistory
, getAssetPropertyValueHistory_propertyAlias
- The alias that identifies the property, such as an OPC-UA server data
stream path (for example,
/company/windfarm/3/turbine/7/temperature
). For more
information, see
Mapping industrial data streams to asset properties
in the IoT SiteWise User Guide.
GetAssetPropertyValueHistory
, getAssetPropertyValueHistory_propertyId
- The ID of the asset property.
GetAssetPropertyValueHistory
, getAssetPropertyValueHistory_qualities
- The quality by which to filter asset data.
GetAssetPropertyValueHistory
, getAssetPropertyValueHistory_startDate
- The exclusive start of the range from which to query historical data,
expressed in seconds in Unix epoch time.
GetAssetPropertyValueHistory
, getAssetPropertyValueHistory_timeOrdering
- The chronological sorting order of the requested information.
Default: ASCENDING
Request Lenses
getAssetPropertyValueHistory_assetId :: Lens' GetAssetPropertyValueHistory (Maybe Text) Source #
The ID of the asset.
getAssetPropertyValueHistory_endDate :: Lens' GetAssetPropertyValueHistory (Maybe UTCTime) Source #
The inclusive end of the range from which to query historical data, expressed in seconds in Unix epoch time.
getAssetPropertyValueHistory_maxResults :: Lens' GetAssetPropertyValueHistory (Maybe Natural) Source #
The maximum number of results to return for each paginated request.
Default: 100
getAssetPropertyValueHistory_nextToken :: Lens' GetAssetPropertyValueHistory (Maybe Text) Source #
The token to be used for the next set of paginated results.
getAssetPropertyValueHistory_propertyAlias :: Lens' GetAssetPropertyValueHistory (Maybe Text) Source #
The alias that identifies the property, such as an OPC-UA server data
stream path (for example,
/company/windfarm/3/turbine/7/temperature
). For more
information, see
Mapping industrial data streams to asset properties
in the IoT SiteWise User Guide.
getAssetPropertyValueHistory_propertyId :: Lens' GetAssetPropertyValueHistory (Maybe Text) Source #
The ID of the asset property.
getAssetPropertyValueHistory_qualities :: Lens' GetAssetPropertyValueHistory (Maybe (NonEmpty Quality)) Source #
The quality by which to filter asset data.
getAssetPropertyValueHistory_startDate :: Lens' GetAssetPropertyValueHistory (Maybe UTCTime) Source #
The exclusive start of the range from which to query historical data, expressed in seconds in Unix epoch time.
getAssetPropertyValueHistory_timeOrdering :: Lens' GetAssetPropertyValueHistory (Maybe TimeOrdering) Source #
The chronological sorting order of the requested information.
Default: ASCENDING
Destructuring the Response
data GetAssetPropertyValueHistoryResponse Source #
See: newGetAssetPropertyValueHistoryResponse
smart constructor.
GetAssetPropertyValueHistoryResponse' | |
|
Instances
newGetAssetPropertyValueHistoryResponse Source #
Create a value of GetAssetPropertyValueHistoryResponse
with all optional fields omitted.
Use generic-lens or optics to modify other optional fields.
The following record fields are available, with the corresponding lenses provided for backwards compatibility:
GetAssetPropertyValueHistory
, getAssetPropertyValueHistoryResponse_nextToken
- The token for the next set of results, or null if there are no
additional results.
$sel:httpStatus:GetAssetPropertyValueHistoryResponse'
, getAssetPropertyValueHistoryResponse_httpStatus
- The response's http status code.
GetAssetPropertyValueHistoryResponse
, getAssetPropertyValueHistoryResponse_assetPropertyValueHistory
- The asset property's value history.
Response Lenses
getAssetPropertyValueHistoryResponse_nextToken :: Lens' GetAssetPropertyValueHistoryResponse (Maybe Text) Source #
The token for the next set of results, or null if there are no additional results.
getAssetPropertyValueHistoryResponse_httpStatus :: Lens' GetAssetPropertyValueHistoryResponse Int Source #
The response's http status code.
getAssetPropertyValueHistoryResponse_assetPropertyValueHistory :: Lens' GetAssetPropertyValueHistoryResponse [AssetPropertyValue] Source #
The asset property's value history.