libZSservicesZSamazonka-iotsitewiseZSamazonka-iotsitewise
Copyright(c) 2013-2021 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay <brendan.g.hay+amazonka@gmail.com>
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellNone

Amazonka.IoTSiteWise.Lens

Contents

Description

 
Synopsis

Operations

ListProjects

listProjects_nextToken :: Lens' ListProjects (Maybe Text) Source #

The token to be used for the next set of paginated results.

listProjects_maxResults :: Lens' ListProjects (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listProjectsResponse_nextToken :: Lens' ListProjectsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

listProjectsResponse_projectSummaries :: Lens' ListProjectsResponse [ProjectSummary] Source #

A list that summarizes each project in the portal.

DeleteProject

deleteProject_clientToken :: Lens' DeleteProject (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

UpdateProject

updateProject_clientToken :: Lens' UpdateProject (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

updateProject_projectDescription :: Lens' UpdateProject (Maybe Text) Source #

A new description for the project.

updateProject_projectId :: Lens' UpdateProject Text Source #

The ID of the project to update.

updateProject_projectName :: Lens' UpdateProject Text Source #

A new friendly name for the project.

PutLoggingOptions

DescribeAssetModel

describeAssetModelResponse_assetModelArn :: Lens' DescribeAssetModelResponse Text Source #

The ARN of the asset model, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

describeAssetModelResponse_assetModelProperties :: Lens' DescribeAssetModelResponse [AssetModelProperty] Source #

The list of asset properties for the asset model.

This object doesn't include properties that you define in composite models. You can find composite model properties in the assetModelCompositeModels object.

describeAssetModelResponse_assetModelHierarchies :: Lens' DescribeAssetModelResponse [AssetModelHierarchy] Source #

A list of asset model hierarchies that each contain a childAssetModelId and a hierarchyId (named id). A hierarchy specifies allowed parent/child asset relationships for an asset model.

describeAssetModelResponse_assetModelCreationDate :: Lens' DescribeAssetModelResponse UTCTime Source #

The date the asset model was created, in Unix epoch time.

describeAssetModelResponse_assetModelLastUpdateDate :: Lens' DescribeAssetModelResponse UTCTime Source #

The date the asset model was last updated, in Unix epoch time.

describeAssetModelResponse_assetModelStatus :: Lens' DescribeAssetModelResponse AssetModelStatus Source #

The current status of the asset model, which contains a state and any error message.

DescribeAssetProperty

describeAssetPropertyResponse_assetProperty :: Lens' DescribeAssetPropertyResponse (Maybe Property) Source #

The asset property's definition, alias, and notification state.

This response includes this object for normal asset properties. If you describe an asset property in a composite model, this response includes the asset property information in compositeModel.

describeAssetPropertyResponse_compositeModel :: Lens' DescribeAssetPropertyResponse (Maybe CompositeModelProperty) Source #

The composite asset model that declares this asset property, if this asset property exists in a composite model.

ListTagsForResource

listTagsForResourceResponse_tags :: Lens' ListTagsForResourceResponse (Maybe (HashMap Text Text)) Source #

The list of key-value pairs that contain metadata for the resource. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

GetAssetPropertyValue

getAssetPropertyValue_propertyAlias :: Lens' GetAssetPropertyValue (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.

DeleteAccessPolicy

deleteAccessPolicy_clientToken :: Lens' DeleteAccessPolicy (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

deleteAccessPolicy_accessPolicyId :: Lens' DeleteAccessPolicy Text Source #

The ID of the access policy to be deleted.

UpdateAccessPolicy

updateAccessPolicy_clientToken :: Lens' UpdateAccessPolicy (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

updateAccessPolicy_accessPolicyIdentity :: Lens' UpdateAccessPolicy Identity Source #

The identity for this access policy. Choose an Amazon Web Services SSO user, an Amazon Web Services SSO group, or an IAM user.

updateAccessPolicy_accessPolicyResource :: Lens' UpdateAccessPolicy Resource Source #

The IoT SiteWise Monitor resource for this access policy. Choose either a portal or a project.

updateAccessPolicy_accessPolicyPermission :: Lens' UpdateAccessPolicy Permission Source #

The permission level for this access policy. Note that a project ADMINISTRATOR is also known as a project owner.

DescribeGateway

describeGatewayResponse_gatewayArn :: Lens' DescribeGatewayResponse Text Source #

The ARN of the gateway, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:gateway/${GatewayId}

describeGatewayResponse_gatewayCapabilitySummaries :: Lens' DescribeGatewayResponse [GatewayCapabilitySummary] Source #

A list of gateway capability summaries that each contain a namespace and status. Each gateway capability defines data sources for the gateway. To retrieve a capability configuration's definition, use DescribeGatewayCapabilityConfiguration.

describeGatewayResponse_creationDate :: Lens' DescribeGatewayResponse UTCTime Source #

The date the gateway was created, in Unix epoch time.

describeGatewayResponse_lastUpdateDate :: Lens' DescribeGatewayResponse UTCTime Source #

The date the gateway was last updated, in Unix epoch time.

DescribeAsset

describeAssetResponse_assetArn :: Lens' DescribeAssetResponse Text Source #

The ARN of the asset, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

describeAssetResponse_assetModelId :: Lens' DescribeAssetResponse Text Source #

The ID of the asset model that was used to create the asset.

describeAssetResponse_assetProperties :: Lens' DescribeAssetResponse [AssetProperty] Source #

The list of asset properties for the asset.

This object doesn't include properties that you define in composite models. You can find composite model properties in the assetCompositeModels object.

describeAssetResponse_assetHierarchies :: Lens' DescribeAssetResponse [AssetHierarchy] Source #

A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships.

describeAssetResponse_assetCreationDate :: Lens' DescribeAssetResponse UTCTime Source #

The date the asset was created, in Unix epoch time.

describeAssetResponse_assetLastUpdateDate :: Lens' DescribeAssetResponse UTCTime Source #

The date the asset was last updated, in Unix epoch time.

describeAssetResponse_assetStatus :: Lens' DescribeAssetResponse AssetStatus Source #

The current status of the asset, which contains a state and any error message.

ListDashboards

listDashboards_nextToken :: Lens' ListDashboards (Maybe Text) Source #

The token to be used for the next set of paginated results.

listDashboards_maxResults :: Lens' ListDashboards (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listDashboardsResponse_nextToken :: Lens' ListDashboardsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

listDashboardsResponse_dashboardSummaries :: Lens' ListDashboardsResponse [DashboardSummary] Source #

A list that summarizes each dashboard in the project.

ListAccessPolicies

listAccessPolicies_resourceId :: Lens' ListAccessPolicies (Maybe Text) Source #

The ID of the resource. This parameter is required if you specify resourceType.

listAccessPolicies_resourceType :: Lens' ListAccessPolicies (Maybe ResourceType) Source #

The type of resource (portal or project). This parameter is required if you specify resourceId.

listAccessPolicies_identityType :: Lens' ListAccessPolicies (Maybe IdentityType) Source #

The type of identity (Amazon Web Services SSO user, Amazon Web Services SSO group, or IAM user). This parameter is required if you specify identityId.

listAccessPolicies_nextToken :: Lens' ListAccessPolicies (Maybe Text) Source #

The token to be used for the next set of paginated results.

listAccessPolicies_iamArn :: Lens' ListAccessPolicies (Maybe Text) Source #

The ARN of the IAM user. For more information, see IAM ARNs in the IAM User Guide. This parameter is required if you specify IAM for identityType.

listAccessPolicies_identityId :: Lens' ListAccessPolicies (Maybe Text) Source #

The ID of the identity. This parameter is required if you specify USER or GROUP for identityType.

listAccessPolicies_maxResults :: Lens' ListAccessPolicies (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listAccessPoliciesResponse_nextToken :: Lens' ListAccessPoliciesResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

DescribeProject

describeProjectResponse_projectArn :: Lens' DescribeProjectResponse Text Source #

The ARN of the project, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:project/${ProjectId}

describeProjectResponse_portalId :: Lens' DescribeProjectResponse Text Source #

The ID of the portal that the project is in.

describeProjectResponse_projectCreationDate :: Lens' DescribeProjectResponse UTCTime Source #

The date the project was created, in Unix epoch time.

describeProjectResponse_projectLastUpdateDate :: Lens' DescribeProjectResponse UTCTime Source #

The date the project was last updated, in Unix epoch time.

GetAssetPropertyValueHistory

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_timeOrdering :: Lens' GetAssetPropertyValueHistory (Maybe TimeOrdering) Source #

The chronological sorting order of the requested information.

Default: ASCENDING

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_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_nextToken :: Lens' GetAssetPropertyValueHistory (Maybe Text) Source #

The token to be used for the next set of paginated results.

getAssetPropertyValueHistory_maxResults :: Lens' GetAssetPropertyValueHistory (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 100

getAssetPropertyValueHistoryResponse_nextToken :: Lens' GetAssetPropertyValueHistoryResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

CreateDashboard

createDashboard_clientToken :: Lens' CreateDashboard (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

createDashboard_tags :: Lens' CreateDashboard (Maybe (HashMap Text Text)) Source #

A list of key-value pairs that contain metadata for the dashboard. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

createDashboard_projectId :: Lens' CreateDashboard Text Source #

The ID of the project in which to create the dashboard.

createDashboard_dashboardName :: Lens' CreateDashboard Text Source #

A friendly name for the dashboard.

createDashboard_dashboardDefinition :: Lens' CreateDashboard Text Source #

The dashboard definition specified in a JSON literal. For detailed information, see Creating dashboards (CLI) in the IoT SiteWise User Guide.

createDashboardResponse_dashboardArn :: Lens' CreateDashboardResponse Text Source #

The ARN of the dashboard, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:dashboard/${DashboardId}

CreateAccessPolicy

createAccessPolicy_clientToken :: Lens' CreateAccessPolicy (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

createAccessPolicy_tags :: Lens' CreateAccessPolicy (Maybe (HashMap Text Text)) Source #

A list of key-value pairs that contain metadata for the access policy. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

createAccessPolicy_accessPolicyIdentity :: Lens' CreateAccessPolicy Identity Source #

The identity for this access policy. Choose an Amazon Web Services SSO user, an Amazon Web Services SSO group, or an IAM user.

createAccessPolicy_accessPolicyResource :: Lens' CreateAccessPolicy Resource Source #

The IoT SiteWise Monitor resource for this access policy. Choose either a portal or a project.

createAccessPolicy_accessPolicyPermission :: Lens' CreateAccessPolicy Permission Source #

The permission level for this access policy. Note that a project ADMINISTRATOR is also known as a project owner.

createAccessPolicyResponse_accessPolicyArn :: Lens' CreateAccessPolicyResponse Text Source #

The ARN of the access policy, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:access-policy/${AccessPolicyId}

CreateAssetModel

createAssetModel_clientToken :: Lens' CreateAssetModel (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

createAssetModel_assetModelProperties :: Lens' CreateAssetModel (Maybe [AssetModelPropertyDefinition]) Source #

The property definitions of the asset model. For more information, see Asset properties in the IoT SiteWise User Guide.

You can specify up to 200 properties per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

createAssetModel_assetModelCompositeModels :: Lens' CreateAssetModel (Maybe [AssetModelCompositeModelDefinition]) Source #

The composite asset models that are part of this asset model. Composite asset models are asset models that contain specific properties. Each composite model has a type that defines the properties that the composite model supports. Use composite asset models to define alarms on this asset model.

createAssetModel_assetModelHierarchies :: Lens' CreateAssetModel (Maybe [AssetModelHierarchyDefinition]) Source #

The hierarchy definitions of the asset model. Each hierarchy specifies an asset model whose assets can be children of any other assets created from this asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

You can specify up to 10 hierarchies per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

createAssetModel_tags :: Lens' CreateAssetModel (Maybe (HashMap Text Text)) Source #

A list of key-value pairs that contain metadata for the asset model. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

createAssetModel_assetModelName :: Lens' CreateAssetModel Text Source #

A unique, friendly name for the asset model.

createAssetModelResponse_assetModelId :: Lens' CreateAssetModelResponse Text Source #

The ID of the asset model. You can use this ID when you call other IoT SiteWise APIs.

createAssetModelResponse_assetModelArn :: Lens' CreateAssetModelResponse Text Source #

The ARN of the asset model, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

createAssetModelResponse_assetModelStatus :: Lens' CreateAssetModelResponse AssetModelStatus Source #

The status of the asset model, which contains a state (CREATING after successfully calling this operation) and any error message.

BatchAssociateProjectAssets

batchAssociateProjectAssets_clientToken :: Lens' BatchAssociateProjectAssets (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

batchAssociateProjectAssets_projectId :: Lens' BatchAssociateProjectAssets Text Source #

The ID of the project to which to associate the assets.

batchAssociateProjectAssets_assetIds :: Lens' BatchAssociateProjectAssets (NonEmpty Text) Source #

The IDs of the assets to be associated to the project.

ListAssetModels

listAssetModels_nextToken :: Lens' ListAssetModels (Maybe Text) Source #

The token to be used for the next set of paginated results.

listAssetModels_maxResults :: Lens' ListAssetModels (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listAssetModelsResponse_nextToken :: Lens' ListAssetModelsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

ListAssociatedAssets

listAssociatedAssets_hierarchyId :: Lens' ListAssociatedAssets (Maybe Text) Source #

The ID of the hierarchy by which child assets are associated to the asset. To find a hierarchy ID, use the DescribeAsset or DescribeAssetModel operations. This parameter is required if you choose CHILD for traversalDirection.

For more information, see Asset hierarchies in the IoT SiteWise User Guide.

listAssociatedAssets_traversalDirection :: Lens' ListAssociatedAssets (Maybe TraversalDirection) Source #

The direction to list associated assets. Choose one of the following options:

  • CHILD – The list includes all child assets associated to the asset. The hierarchyId parameter is required if you choose CHILD.
  • PARENT – The list includes the asset's parent asset.

Default: CHILD

listAssociatedAssets_nextToken :: Lens' ListAssociatedAssets (Maybe Text) Source #

The token to be used for the next set of paginated results.

listAssociatedAssets_maxResults :: Lens' ListAssociatedAssets (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listAssociatedAssetsResponse_nextToken :: Lens' ListAssociatedAssetsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

BatchPutAssetPropertyValue

batchPutAssetPropertyValue_entries :: Lens' BatchPutAssetPropertyValue [PutAssetPropertyValueEntry] Source #

The list of asset property value entries for the batch put request. You can specify up to 10 entries per request.

batchPutAssetPropertyValueResponse_errorEntries :: Lens' BatchPutAssetPropertyValueResponse [BatchPutAssetPropertyErrorEntry] Source #

A list of the errors (if any) associated with the batch put request. Each error entry contains the entryId of the entry that failed.

DeleteAsset

deleteAsset_clientToken :: Lens' DeleteAsset (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

deleteAsset_assetId :: Lens' DeleteAsset Text Source #

The ID of the asset to delete.

deleteAssetResponse_assetStatus :: Lens' DeleteAssetResponse AssetStatus Source #

The status of the asset, which contains a state (DELETING after successfully calling this operation) and any error message.

UpdateAsset

updateAsset_clientToken :: Lens' UpdateAsset (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

updateAsset_assetId :: Lens' UpdateAsset Text Source #

The ID of the asset to update.

updateAsset_assetName :: Lens' UpdateAsset Text Source #

A unique, friendly name for the asset.

updateAssetResponse_assetStatus :: Lens' UpdateAssetResponse AssetStatus Source #

The status of the asset, which contains a state (UPDATING after successfully calling this operation) and any error message.

DeleteGateway

deleteGateway_gatewayId :: Lens' DeleteGateway Text Source #

The ID of the gateway to delete.

DescribeAccessPolicy

describeAccessPolicyResponse_accessPolicyArn :: Lens' DescribeAccessPolicyResponse Text Source #

The ARN of the access policy, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:access-policy/${AccessPolicyId}

describeAccessPolicyResponse_accessPolicyIdentity :: Lens' DescribeAccessPolicyResponse Identity Source #

The identity (Amazon Web Services SSO user, Amazon Web Services SSO group, or IAM user) to which this access policy applies.

describeAccessPolicyResponse_accessPolicyResource :: Lens' DescribeAccessPolicyResponse Resource Source #

The IoT SiteWise Monitor resource (portal or project) to which this access policy provides access.

describeAccessPolicyResponse_accessPolicyPermission :: Lens' DescribeAccessPolicyResponse Permission Source #

The access policy permission. Note that a project ADMINISTRATOR is also known as a project owner.

describeAccessPolicyResponse_accessPolicyCreationDate :: Lens' DescribeAccessPolicyResponse UTCTime Source #

The date the access policy was created, in Unix epoch time.

describeAccessPolicyResponse_accessPolicyLastUpdateDate :: Lens' DescribeAccessPolicyResponse UTCTime Source #

The date the access policy was last updated, in Unix epoch time.

UpdateGateway

updateGateway_gatewayId :: Lens' UpdateGateway Text Source #

The ID of the gateway to update.

updateGateway_gatewayName :: Lens' UpdateGateway Text Source #

A unique, friendly name for the gateway.

ListProjectAssets

listProjectAssets_nextToken :: Lens' ListProjectAssets (Maybe Text) Source #

The token to be used for the next set of paginated results.

listProjectAssets_maxResults :: Lens' ListProjectAssets (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listProjectAssetsResponse_nextToken :: Lens' ListProjectAssetsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

listProjectAssetsResponse_assetIds :: Lens' ListProjectAssetsResponse [Text] Source #

A list that contains the IDs of each asset associated with the project.

CreateGateway

createGateway_tags :: Lens' CreateGateway (Maybe (HashMap Text Text)) Source #

A list of key-value pairs that contain metadata for the gateway. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

createGateway_gatewayName :: Lens' CreateGateway Text Source #

A unique, friendly name for the gateway.

createGateway_gatewayPlatform :: Lens' CreateGateway GatewayPlatform Source #

The gateway's platform. You can only specify one platform in a gateway.

createGatewayResponse_gatewayId :: Lens' CreateGatewayResponse Text Source #

The ID of the gateway device. You can use this ID when you call other IoT SiteWise APIs.

createGatewayResponse_gatewayArn :: Lens' CreateGatewayResponse Text Source #

The ARN of the gateway, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:gateway/${GatewayId}

DescribeStorageConfiguration

describeStorageConfigurationResponse_lastUpdateDate :: Lens' DescribeStorageConfigurationResponse (Maybe UTCTime) Source #

The date the storage configuration was last updated, in Unix epoch time.

describeStorageConfigurationResponse_storageType :: Lens' DescribeStorageConfigurationResponse StorageType Source #

The type of storage that you specified for your data. The storage type can be one of the following values:

  • SITEWISE_DEFAULT_STORAGE – IoT SiteWise replicates your data into a service managed database.
  • MULTI_LAYER_STORAGE – IoT SiteWise replicates your data into a service managed database and saves a copy of your raw data and metadata in an Amazon S3 object that you specified.

CreateAsset

createAsset_clientToken :: Lens' CreateAsset (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

createAsset_tags :: Lens' CreateAsset (Maybe (HashMap Text Text)) Source #

A list of key-value pairs that contain metadata for the asset. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

createAsset_assetName :: Lens' CreateAsset Text Source #

A unique, friendly name for the asset.

createAsset_assetModelId :: Lens' CreateAsset Text Source #

The ID of the asset model from which to create the asset.

createAssetResponse_assetId :: Lens' CreateAssetResponse Text Source #

The ID of the asset. This ID uniquely identifies the asset within IoT SiteWise and can be used with other IoT SiteWise APIs.

createAssetResponse_assetArn :: Lens' CreateAssetResponse Text Source #

The ARN of the asset, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

createAssetResponse_assetStatus :: Lens' CreateAssetResponse AssetStatus Source #

The status of the asset, which contains a state (CREATING after successfully calling this operation) and any error message.

AssociateAssets

associateAssets_clientToken :: Lens' AssociateAssets (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

associateAssets_hierarchyId :: Lens' AssociateAssets Text Source #

The ID of a hierarchy in the parent asset's model. Hierarchies allow different groupings of assets to be formed that all come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

associateAssets_childAssetId :: Lens' AssociateAssets Text Source #

The ID of the child asset to be associated.

GetInterpolatedAssetPropertyValues

getInterpolatedAssetPropertyValues_propertyAlias :: Lens' GetInterpolatedAssetPropertyValues (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.

getInterpolatedAssetPropertyValues_nextToken :: Lens' GetInterpolatedAssetPropertyValues (Maybe Text) Source #

The token to be used for the next set of paginated results.

getInterpolatedAssetPropertyValues_intervalWindowInSeconds :: Lens' GetInterpolatedAssetPropertyValues (Maybe Natural) Source #

The query interval for the window in seconds. IoT SiteWise computes each interpolated value by using data points from the timestamp of each interval minus the window to the timestamp of each interval plus the window. If not specified, the window is between the start time minus the interval and the end time plus the interval.

  • If you specify a value for the intervalWindowInSeconds parameter, the type parameter must be LINEAR_INTERPOLATION.
  • If no data point is found during the specified query window, IoT SiteWise won't return an interpolated value for the interval. This indicates that there's a gap in the ingested data points.

For example, you can get the interpolated temperature values for a wind turbine every 24 hours over a duration of 7 days. If the interpolation starts on July 1, 2021, at 9 AM with a window of 2 hours, IoT SiteWise uses the data points from 7 AM (9 AM - 2 hours) to 11 AM (9 AM + 2 hours) on July 2, 2021 to compute the first interpolated value, uses the data points from 7 AM (9 AM - 2 hours) to 11 AM (9 AM + 2 hours) on July 3, 2021 to compute the second interpolated value, and so on.

getInterpolatedAssetPropertyValues_maxResults :: Lens' GetInterpolatedAssetPropertyValues (Maybe Natural) Source #

The maximum number of results to return for each paginated request. If not specified, the default value is 10.

getInterpolatedAssetPropertyValues_startTimeInSeconds :: Lens' GetInterpolatedAssetPropertyValues Natural Source #

The exclusive start of the range from which to interpolate data, expressed in seconds in Unix epoch time.

getInterpolatedAssetPropertyValues_endTimeInSeconds :: Lens' GetInterpolatedAssetPropertyValues Natural Source #

The inclusive end of the range from which to interpolate data, expressed in seconds in Unix epoch time.

getInterpolatedAssetPropertyValues_quality :: Lens' GetInterpolatedAssetPropertyValues Quality Source #

The quality of the asset property value. You can use this parameter as a filter to choose only the asset property values that have a specific quality.

getInterpolatedAssetPropertyValues_intervalInSeconds :: Lens' GetInterpolatedAssetPropertyValues Natural Source #

The time interval in seconds over which to interpolate data. Each interval starts when the previous one ends.

getInterpolatedAssetPropertyValues_type :: Lens' GetInterpolatedAssetPropertyValues Text Source #

The interpolation type.

Valid values: LINEAR_INTERPOLATION | LOCF_INTERPOLATION

  • LINEAR_INTERPOLATION – Estimates missing data using linear interpolation.

    For example, you can use this operation to return the interpolated temperature values for a wind turbine every 24 hours over a duration of 7 days. If the interpolation starts on July 1, 2021, at 9 AM, IoT SiteWise returns the first interpolated value on July 2, 2021, at 9 AM, the second interpolated value on July 3, 2021, at 9 AM, and so on.

  • LOCF_INTERPOLATION – Estimates missing data using last observation carried forward interpolation

    If no data point is found for an interval, IoT SiteWise returns the last observed data point for the previous interval and carries forward this interpolated value until a new data point is found.

    For example, you can get the state of an on-off valve every 24 hours over a duration of 7 days. If the interpolation starts on July 1, 2021, at 9 AM, IoT SiteWise returns the last observed data point between July 1, 2021, at 9 AM and July 2, 2021, at 9 AM as the first interpolated value. If no data point is found after 9 AM on July 2, 2021, IoT SiteWise uses the same interpolated value for the rest of the days.

getInterpolatedAssetPropertyValuesResponse_nextToken :: Lens' GetInterpolatedAssetPropertyValuesResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

DescribeGatewayCapabilityConfiguration

describeGatewayCapabilityConfiguration_gatewayId :: Lens' DescribeGatewayCapabilityConfiguration Text Source #

The ID of the gateway that defines the capability configuration.

describeGatewayCapabilityConfiguration_capabilityNamespace :: Lens' DescribeGatewayCapabilityConfiguration Text Source #

The namespace of the capability configuration. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:version, where version is a number such as 1.

describeGatewayCapabilityConfigurationResponse_capabilityConfiguration :: Lens' DescribeGatewayCapabilityConfigurationResponse Text Source #

The JSON document that defines the gateway capability's configuration. For more information, see Configuring data sources (CLI) in the IoT SiteWise User Guide.

describeGatewayCapabilityConfigurationResponse_capabilitySyncStatus :: Lens' DescribeGatewayCapabilityConfigurationResponse CapabilitySyncStatus Source #

The synchronization status of the capability configuration. The sync status can be one of the following:

  • IN_SYNC – The gateway is running the capability configuration.
  • OUT_OF_SYNC – The gateway hasn't received the capability configuration.
  • SYNC_FAILED – The gateway rejected the capability configuration.

PutDefaultEncryptionConfiguration

putDefaultEncryptionConfiguration_kmsKeyId :: Lens' PutDefaultEncryptionConfiguration (Maybe Text) Source #

The Key ID of the customer managed customer master key (CMK) used for KMS encryption. This is required if you use KMS_BASED_ENCRYPTION.

putDefaultEncryptionConfigurationResponse_kmsKeyArn :: Lens' PutDefaultEncryptionConfigurationResponse (Maybe Text) Source #

The Key ARN of the KMS CMK used for KMS encryption if you use KMS_BASED_ENCRYPTION.

putDefaultEncryptionConfigurationResponse_configurationStatus :: Lens' PutDefaultEncryptionConfigurationResponse ConfigurationStatus Source #

The status of the account configuration. This contains the ConfigurationState. If there is an error, it also contains the ErrorDetails.

DeletePortal

deletePortal_clientToken :: Lens' DeletePortal (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

deletePortal_portalId :: Lens' DeletePortal Text Source #

The ID of the portal to delete.

deletePortalResponse_portalStatus :: Lens' DeletePortalResponse PortalStatus Source #

The status of the portal, which contains a state (DELETING after successfully calling this operation) and any error message.

ListAssetRelationships

listAssetRelationships_nextToken :: Lens' ListAssetRelationships (Maybe Text) Source #

The token to be used for the next set of paginated results.

listAssetRelationships_maxResults :: Lens' ListAssetRelationships (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

listAssetRelationships_traversalType :: Lens' ListAssetRelationships TraversalType Source #

The type of traversal to use to identify asset relationships. Choose the following option:

  • PATH_TO_ROOT – Identify the asset's parent assets up to the root asset. The asset that you specify in assetId is the first result in the list of assetRelationshipSummaries, and the root asset is the last result.

listAssetRelationshipsResponse_nextToken :: Lens' ListAssetRelationshipsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

UpdatePortal

updatePortal_clientToken :: Lens' UpdatePortal (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

updatePortal_portalDescription :: Lens' UpdatePortal (Maybe Text) Source #

A new description for the portal.

updatePortal_notificationSenderEmail :: Lens' UpdatePortal (Maybe Text) Source #

The email address that sends alarm notifications.

updatePortal_alarms :: Lens' UpdatePortal (Maybe Alarms) Source #

Contains the configuration information of an alarm created in an IoT SiteWise Monitor portal. You can use the alarm to monitor an asset property and get notified when the asset property value is outside a specified range. For more information, see Monitoring with alarms in the IoT SiteWise Application Guide.

updatePortal_portalId :: Lens' UpdatePortal Text Source #

The ID of the portal to update.

updatePortal_portalName :: Lens' UpdatePortal Text Source #

A new friendly name for the portal.

updatePortal_portalContactEmail :: Lens' UpdatePortal Text Source #

The Amazon Web Services administrator's contact email address.

updatePortal_roleArn :: Lens' UpdatePortal Text Source #

The ARN of a service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

updatePortalResponse_portalStatus :: Lens' UpdatePortalResponse PortalStatus Source #

The status of the portal, which contains a state (UPDATING after successfully calling this operation) and any error message.

ListPortals

listPortals_nextToken :: Lens' ListPortals (Maybe Text) Source #

The token to be used for the next set of paginated results.

listPortals_maxResults :: Lens' ListPortals (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listPortalsResponse_nextToken :: Lens' ListPortalsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

DeleteDashboard

deleteDashboard_clientToken :: Lens' DeleteDashboard (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

deleteDashboard_dashboardId :: Lens' DeleteDashboard Text Source #

The ID of the dashboard to delete.

UpdateDashboard

updateDashboard_clientToken :: Lens' UpdateDashboard (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

updateDashboard_dashboardId :: Lens' UpdateDashboard Text Source #

The ID of the dashboard to update.

updateDashboard_dashboardName :: Lens' UpdateDashboard Text Source #

A new friendly name for the dashboard.

updateDashboard_dashboardDefinition :: Lens' UpdateDashboard Text Source #

The new dashboard definition, as specified in a JSON literal. For detailed information, see Creating dashboards (CLI) in the IoT SiteWise User Guide.

PutStorageConfiguration

putStorageConfiguration_multiLayerStorage :: Lens' PutStorageConfiguration (Maybe MultiLayerStorage) Source #

Identifies a storage destination. If you specified MULTI_LAYER_STORAGE for the storage type, you must specify a MultiLayerStorage object.

putStorageConfiguration_storageType :: Lens' PutStorageConfiguration StorageType Source #

The type of storage that you specified for your data. The storage type can be one of the following values:

  • SITEWISE_DEFAULT_STORAGE – IoT SiteWise replicates your data into a service managed database.
  • MULTI_LAYER_STORAGE – IoT SiteWise replicates your data into a service managed database and saves a copy of your raw data and metadata in an Amazon S3 object that you specified.

putStorageConfigurationResponse_storageType :: Lens' PutStorageConfigurationResponse StorageType Source #

The type of storage that you specified for your data. The storage type can be one of the following values:

  • SITEWISE_DEFAULT_STORAGE – IoT SiteWise replicates your data into a service managed database.
  • MULTI_LAYER_STORAGE – IoT SiteWise replicates your data into a service managed database and saves a copy of your raw data and metadata in an Amazon S3 object that you specified.

CreatePortal

createPortal_portalAuthMode :: Lens' CreatePortal (Maybe AuthMode) Source #

The service to use to authenticate users to the portal. Choose from the following options:

  • SSO – The portal uses Amazon Web Services Single Sign On to authenticate users and manage user permissions. Before you can create a portal that uses Amazon Web Services SSO, you must enable Amazon Web Services SSO. For more information, see Enabling Amazon Web Services SSO in the IoT SiteWise User Guide. This option is only available in Amazon Web Services Regions other than the China Regions.
  • IAM – The portal uses Identity and Access Management to authenticate users and manage user permissions. This option is only available in the China Regions.

You can't change this value after you create a portal.

Default: SSO

createPortal_clientToken :: Lens' CreatePortal (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

createPortal_notificationSenderEmail :: Lens' CreatePortal (Maybe Text) Source #

The email address that sends alarm notifications.

If you use the IoT Events managed Lambda function to manage your emails, you must verify the sender email address in Amazon SES.

createPortal_alarms :: Lens' CreatePortal (Maybe Alarms) Source #

Contains the configuration information of an alarm created in an IoT SiteWise Monitor portal. You can use the alarm to monitor an asset property and get notified when the asset property value is outside a specified range. For more information, see Monitoring with alarms in the IoT SiteWise Application Guide.

createPortal_portalLogoImageFile :: Lens' CreatePortal (Maybe ImageFile) Source #

A logo image to display in the portal. Upload a square, high-resolution image. The image is displayed on a dark background.

createPortal_tags :: Lens' CreatePortal (Maybe (HashMap Text Text)) Source #

A list of key-value pairs that contain metadata for the portal. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

createPortal_portalName :: Lens' CreatePortal Text Source #

A friendly name for the portal.

createPortal_portalContactEmail :: Lens' CreatePortal Text Source #

The Amazon Web Services administrator's contact email address.

createPortal_roleArn :: Lens' CreatePortal Text Source #

The ARN of a service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

createPortalResponse_portalArn :: Lens' CreatePortalResponse Text Source #

The ARN of the portal, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}

createPortalResponse_portalStartUrl :: Lens' CreatePortalResponse Text Source #

The URL for the IoT SiteWise Monitor portal. You can use this URL to access portals that use Amazon Web Services SSO for authentication. For portals that use IAM for authentication, you must use the IoT SiteWise console to get a URL that you can use to access the portal.

createPortalResponse_portalStatus :: Lens' CreatePortalResponse PortalStatus Source #

The status of the portal, which contains a state (CREATING after successfully calling this operation) and any error message.

createPortalResponse_ssoApplicationId :: Lens' CreatePortalResponse Text Source #

The associated Amazon Web Services SSO application ID, if the portal uses Amazon Web Services SSO.

TagResource

tagResource_resourceArn :: Lens' TagResource Text Source #

The ARN of the resource to tag.

tagResource_tags :: Lens' TagResource (HashMap Text Text) Source #

A list of key-value pairs that contain metadata for the resource. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

BatchDisassociateProjectAssets

batchDisassociateProjectAssets_clientToken :: Lens' BatchDisassociateProjectAssets (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

batchDisassociateProjectAssets_projectId :: Lens' BatchDisassociateProjectAssets Text Source #

The ID of the project from which to disassociate the assets.

batchDisassociateProjectAssets_assetIds :: Lens' BatchDisassociateProjectAssets (NonEmpty Text) Source #

The IDs of the assets to be disassociated from the project.

GetAssetPropertyAggregates

getAssetPropertyAggregates_timeOrdering :: Lens' GetAssetPropertyAggregates (Maybe TimeOrdering) Source #

The chronological sorting order of the requested information.

Default: ASCENDING

getAssetPropertyAggregates_propertyAlias :: Lens' GetAssetPropertyAggregates (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.

getAssetPropertyAggregates_nextToken :: Lens' GetAssetPropertyAggregates (Maybe Text) Source #

The token to be used for the next set of paginated results.

getAssetPropertyAggregates_maxResults :: Lens' GetAssetPropertyAggregates (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 100

getAssetPropertyAggregates_resolution :: Lens' GetAssetPropertyAggregates Text Source #

The time interval over which to aggregate data.

getAssetPropertyAggregates_startDate :: Lens' GetAssetPropertyAggregates UTCTime Source #

The exclusive start of the range from which to query historical data, expressed in seconds in Unix epoch time.

getAssetPropertyAggregates_endDate :: Lens' GetAssetPropertyAggregates UTCTime Source #

The inclusive end of the range from which to query historical data, expressed in seconds in Unix epoch time.

getAssetPropertyAggregatesResponse_nextToken :: Lens' GetAssetPropertyAggregatesResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

UntagResource

untagResource_resourceArn :: Lens' UntagResource Text Source #

The ARN of the resource to untag.

untagResource_tagKeys :: Lens' UntagResource [Text] Source #

A list of keys for tags to remove from the resource.

DeleteAssetModel

deleteAssetModel_clientToken :: Lens' DeleteAssetModel (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

deleteAssetModel_assetModelId :: Lens' DeleteAssetModel Text Source #

The ID of the asset model to delete.

deleteAssetModelResponse_assetModelStatus :: Lens' DeleteAssetModelResponse AssetModelStatus Source #

The status of the asset model, which contains a state (DELETING after successfully calling this operation) and any error message.

UpdateAssetModel

updateAssetModel_clientToken :: Lens' UpdateAssetModel (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

updateAssetModel_assetModelProperties :: Lens' UpdateAssetModel (Maybe [AssetModelProperty]) Source #

The updated property definitions of the asset model. For more information, see Asset properties in the IoT SiteWise User Guide.

You can specify up to 200 properties per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

updateAssetModel_assetModelCompositeModels :: Lens' UpdateAssetModel (Maybe [AssetModelCompositeModel]) Source #

The composite asset models that are part of this asset model. Composite asset models are asset models that contain specific properties. Each composite model has a type that defines the properties that the composite model supports. Use composite asset models to define alarms on this asset model.

updateAssetModel_assetModelHierarchies :: Lens' UpdateAssetModel (Maybe [AssetModelHierarchy]) Source #

The updated hierarchy definitions of the asset model. Each hierarchy specifies an asset model whose assets can be children of any other assets created from this asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

You can specify up to 10 hierarchies per asset model. For more information, see Quotas in the IoT SiteWise User Guide.

updateAssetModel_assetModelId :: Lens' UpdateAssetModel Text Source #

The ID of the asset model to update.

updateAssetModel_assetModelName :: Lens' UpdateAssetModel Text Source #

A unique, friendly name for the asset model.

updateAssetModelResponse_assetModelStatus :: Lens' UpdateAssetModelResponse AssetModelStatus Source #

The status of the asset model, which contains a state (UPDATING after successfully calling this operation) and any error message.

UpdateAssetProperty

updateAssetProperty_clientToken :: Lens' UpdateAssetProperty (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

updateAssetProperty_propertyNotificationState :: Lens' UpdateAssetProperty (Maybe PropertyNotificationState) Source #

The MQTT notification state (enabled or disabled) for this asset property. When the notification state is enabled, IoT SiteWise publishes property value updates to a unique MQTT topic. For more information, see Interacting with other services in the IoT SiteWise User Guide.

If you omit this parameter, the notification state is set to DISABLED.

updateAssetProperty_propertyAlias :: Lens' UpdateAssetProperty (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.

If you omit this parameter, the alias is removed from the property.

updateAssetProperty_assetId :: Lens' UpdateAssetProperty Text Source #

The ID of the asset to be updated.

updateAssetProperty_propertyId :: Lens' UpdateAssetProperty Text Source #

The ID of the asset property to be updated.

DescribeLoggingOptions

ListGateways

listGateways_nextToken :: Lens' ListGateways (Maybe Text) Source #

The token to be used for the next set of paginated results.

listGateways_maxResults :: Lens' ListGateways (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listGatewaysResponse_nextToken :: Lens' ListGatewaysResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

UpdateGatewayCapabilityConfiguration

updateGatewayCapabilityConfiguration_capabilityNamespace :: Lens' UpdateGatewayCapabilityConfiguration Text Source #

The namespace of the gateway capability configuration to be updated. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:version, where version is a number such as 1.

updateGatewayCapabilityConfiguration_capabilityConfiguration :: Lens' UpdateGatewayCapabilityConfiguration Text Source #

The JSON document that defines the configuration for the gateway capability. For more information, see Configuring data sources (CLI) in the IoT SiteWise User Guide.

updateGatewayCapabilityConfigurationResponse_capabilitySyncStatus :: Lens' UpdateGatewayCapabilityConfigurationResponse CapabilitySyncStatus Source #

The synchronization status of the capability configuration. The sync status can be one of the following:

  • IN_SYNC – The gateway is running the capability configuration.
  • OUT_OF_SYNC – The gateway hasn't received the capability configuration.
  • SYNC_FAILED – The gateway rejected the capability configuration.

After you update a capability configuration, its sync status is OUT_OF_SYNC until the gateway receives and applies or rejects the updated configuration.

DescribeDashboard

describeDashboardResponse_dashboardArn :: Lens' DescribeDashboardResponse Text Source #

The ARN of the dashboard, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:dashboard/${DashboardId}

describeDashboardResponse_projectId :: Lens' DescribeDashboardResponse Text Source #

The ID of the project that the dashboard is in.

describeDashboardResponse_dashboardDefinition :: Lens' DescribeDashboardResponse Text Source #

The dashboard's definition JSON literal. For detailed information, see Creating dashboards (CLI) in the IoT SiteWise User Guide.

describeDashboardResponse_dashboardCreationDate :: Lens' DescribeDashboardResponse UTCTime Source #

The date the dashboard was created, in Unix epoch time.

describeDashboardResponse_dashboardLastUpdateDate :: Lens' DescribeDashboardResponse UTCTime Source #

The date the dashboard was last updated, in Unix epoch time.

DescribePortal

describePortalResponse_portalAuthMode :: Lens' DescribePortalResponse (Maybe AuthMode) Source #

The service to use to authenticate users to the portal.

describePortalResponse_notificationSenderEmail :: Lens' DescribePortalResponse (Maybe Text) Source #

The email address that sends alarm notifications.

describePortalResponse_alarms :: Lens' DescribePortalResponse (Maybe Alarms) Source #

Contains the configuration information of an alarm created in an IoT SiteWise Monitor portal.

describePortalResponse_roleArn :: Lens' DescribePortalResponse (Maybe Text) Source #

The ARN of the service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

describePortalResponse_portalArn :: Lens' DescribePortalResponse Text Source #

The ARN of the portal, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:portal/${PortalId}

describePortalResponse_portalClientId :: Lens' DescribePortalResponse Text Source #

The Amazon Web Services SSO application generated client ID (used with Amazon Web Services SSO APIs). IoT SiteWise includes portalClientId for only portals that use Amazon Web Services SSO to authenticate users.

describePortalResponse_portalStartUrl :: Lens' DescribePortalResponse Text Source #

The URL for the IoT SiteWise Monitor portal. You can use this URL to access portals that use Amazon Web Services SSO for authentication. For portals that use IAM for authentication, you must use the IoT SiteWise console to get a URL that you can use to access the portal.

describePortalResponse_portalContactEmail :: Lens' DescribePortalResponse Text Source #

The Amazon Web Services administrator's contact email address.

describePortalResponse_portalStatus :: Lens' DescribePortalResponse PortalStatus Source #

The current status of the portal, which contains a state and any error message.

describePortalResponse_portalCreationDate :: Lens' DescribePortalResponse UTCTime Source #

The date the portal was created, in Unix epoch time.

describePortalResponse_portalLastUpdateDate :: Lens' DescribePortalResponse UTCTime Source #

The date the portal was last updated, in Unix epoch time.

CreateProject

createProject_clientToken :: Lens' CreateProject (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

createProject_tags :: Lens' CreateProject (Maybe (HashMap Text Text)) Source #

A list of key-value pairs that contain metadata for the project. For more information, see Tagging your IoT SiteWise resources in the IoT SiteWise User Guide.

createProject_portalId :: Lens' CreateProject Text Source #

The ID of the portal in which to create the project.

createProject_projectName :: Lens' CreateProject Text Source #

A friendly name for the project.

createProjectResponse_projectArn :: Lens' CreateProjectResponse Text Source #

The ARN of the project, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:project/${ProjectId}

DescribeDefaultEncryptionConfiguration

describeDefaultEncryptionConfigurationResponse_kmsKeyArn :: Lens' DescribeDefaultEncryptionConfigurationResponse (Maybe Text) Source #

The key ARN of the customer managed customer master key (CMK) used for KMS encryption if you use KMS_BASED_ENCRYPTION.

describeDefaultEncryptionConfigurationResponse_configurationStatus :: Lens' DescribeDefaultEncryptionConfigurationResponse ConfigurationStatus Source #

The status of the account configuration. This contains the ConfigurationState. If there's an error, it also contains the ErrorDetails.

ListAssets

listAssets_assetModelId :: Lens' ListAssets (Maybe Text) Source #

The ID of the asset model by which to filter the list of assets. This parameter is required if you choose ALL for filter.

listAssets_nextToken :: Lens' ListAssets (Maybe Text) Source #

The token to be used for the next set of paginated results.

listAssets_filter :: Lens' ListAssets (Maybe ListAssetsFilter) Source #

The filter for the requested list of assets. Choose one of the following options:

  • ALL – The list includes all assets for a given asset model ID. The assetModelId parameter is required if you filter by ALL.
  • TOP_LEVEL – The list includes only top-level assets in the asset hierarchy tree.

Default: ALL

listAssets_maxResults :: Lens' ListAssets (Maybe Natural) Source #

The maximum number of results to return for each paginated request.

Default: 50

listAssetsResponse_nextToken :: Lens' ListAssetsResponse (Maybe Text) Source #

The token for the next set of results, or null if there are no additional results.

DisassociateAssets

disassociateAssets_clientToken :: Lens' DisassociateAssets (Maybe Text) Source #

A unique case-sensitive identifier that you can provide to ensure the idempotency of the request. Don't reuse this client token if a new idempotent request is required.

disassociateAssets_assetId :: Lens' DisassociateAssets Text Source #

The ID of the parent asset from which to disassociate the child asset.

disassociateAssets_hierarchyId :: Lens' DisassociateAssets Text Source #

The ID of a hierarchy in the parent asset's model. Hierarchies allow different groupings of assets to be formed that all come from the same asset model. You can use the hierarchy ID to identify the correct asset to disassociate. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

disassociateAssets_childAssetId :: Lens' DisassociateAssets Text Source #

The ID of the child asset to disassociate.

Types

AccessPolicySummary

accessPolicySummary_lastUpdateDate :: Lens' AccessPolicySummary (Maybe UTCTime) Source #

The date the access policy was last updated, in Unix epoch time.

accessPolicySummary_creationDate :: Lens' AccessPolicySummary (Maybe UTCTime) Source #

The date the access policy was created, in Unix epoch time.

accessPolicySummary_identity :: Lens' AccessPolicySummary Identity Source #

The identity (an Amazon Web Services SSO user, an Amazon Web Services SSO group, or an IAM user).

accessPolicySummary_resource :: Lens' AccessPolicySummary Resource Source #

The IoT SiteWise Monitor resource (a portal or project).

accessPolicySummary_permission :: Lens' AccessPolicySummary Permission Source #

The permissions for the access policy. Note that a project ADMINISTRATOR is also known as a project owner.

AggregatedValue

aggregatedValue_quality :: Lens' AggregatedValue (Maybe Quality) Source #

The quality of the aggregated data.

aggregatedValue_timestamp :: Lens' AggregatedValue UTCTime Source #

The date the aggregating computations occurred, in Unix epoch time.

Aggregates

aggregates_maximum :: Lens' Aggregates (Maybe Double) Source #

The maximum value of the time series over a time interval window.

aggregates_average :: Lens' Aggregates (Maybe Double) Source #

The average (mean) value of the time series over a time interval window.

aggregates_count :: Lens' Aggregates (Maybe Double) Source #

The count of data points in the time series over a time interval window.

aggregates_minimum :: Lens' Aggregates (Maybe Double) Source #

The minimum value of the time series over a time interval window.

aggregates_standardDeviation :: Lens' Aggregates (Maybe Double) Source #

The standard deviation of the time series over a time interval window.

aggregates_sum :: Lens' Aggregates (Maybe Double) Source #

The sum of the time series over a time interval window.

Alarms

alarms_notificationLambdaArn :: Lens' Alarms (Maybe Text) Source #

The ARN of the Lambda function that manages alarm notifications. For more information, see Managing alarm notifications in the IoT Events Developer Guide.

alarms_alarmRoleArn :: Lens' Alarms Text Source #

The ARN of the IAM role that allows the alarm to perform actions and access Amazon Web Services resources and services, such as IoT Events.

AssetCompositeModel

assetCompositeModel_description :: Lens' AssetCompositeModel (Maybe Text) Source #

The description of the composite model.

assetCompositeModel_name :: Lens' AssetCompositeModel Text Source #

The name of the composite model.

assetCompositeModel_type :: Lens' AssetCompositeModel Text Source #

The type of the composite model. For alarm composite models, this type is AWS/ALARM.

assetCompositeModel_properties :: Lens' AssetCompositeModel [AssetProperty] Source #

The asset properties that this composite model defines.

AssetErrorDetails

AssetHierarchy

assetHierarchy_id :: Lens' AssetHierarchy (Maybe Text) Source #

The ID of the hierarchy. This ID is a hierarchyId.

assetHierarchy_name :: Lens' AssetHierarchy Text Source #

The hierarchy name provided in the CreateAssetModel or UpdateAssetModel API operation.

AssetHierarchyInfo

assetHierarchyInfo_childAssetId :: Lens' AssetHierarchyInfo (Maybe Text) Source #

The ID of the child asset in this asset relationship.

assetHierarchyInfo_parentAssetId :: Lens' AssetHierarchyInfo (Maybe Text) Source #

The ID of the parent asset in this asset relationship.

AssetModelCompositeModel

assetModelCompositeModel_properties :: Lens' AssetModelCompositeModel (Maybe [AssetModelProperty]) Source #

The asset property definitions for this composite model.

assetModelCompositeModel_type :: Lens' AssetModelCompositeModel Text Source #

The type of the composite model. For alarm composite models, this type is AWS/ALARM.

AssetModelCompositeModelDefinition

assetModelCompositeModelDefinition_type :: Lens' AssetModelCompositeModelDefinition Text Source #

The type of the composite model. For alarm composite models, this type is AWS/ALARM.

AssetModelHierarchy

assetModelHierarchy_id :: Lens' AssetModelHierarchy (Maybe Text) Source #

The ID of the asset model hierarchy. This ID is a hierarchyId.

assetModelHierarchy_name :: Lens' AssetModelHierarchy Text Source #

The name of the asset model hierarchy that you specify by using the CreateAssetModel or UpdateAssetModel API operation.

assetModelHierarchy_childAssetModelId :: Lens' AssetModelHierarchy Text Source #

The ID of the asset model. All assets in this hierarchy must be instances of the childAssetModelId asset model.

AssetModelHierarchyDefinition

assetModelHierarchyDefinition_name :: Lens' AssetModelHierarchyDefinition Text Source #

The name of the asset model hierarchy definition (as specified in the CreateAssetModel or UpdateAssetModel API operation).

AssetModelProperty

assetModelProperty_dataTypeSpec :: Lens' AssetModelProperty (Maybe Text) Source #

The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

assetModelProperty_id :: Lens' AssetModelProperty (Maybe Text) Source #

The ID of the asset model property.

assetModelProperty_unit :: Lens' AssetModelProperty (Maybe Text) Source #

The unit of the asset model property, such as Newtons or RPM.

assetModelProperty_name :: Lens' AssetModelProperty Text Source #

The name of the asset model property.

assetModelProperty_dataType :: Lens' AssetModelProperty PropertyDataType Source #

The data type of the asset model property.

assetModelProperty_type :: Lens' AssetModelProperty PropertyType Source #

The property type (see PropertyType).

AssetModelPropertyDefinition

assetModelPropertyDefinition_dataTypeSpec :: Lens' AssetModelPropertyDefinition (Maybe Text) Source #

The data type of the structure for this property. This parameter is required on properties that have the STRUCT data type.

The options for this parameter depend on the type of the composite model in which you define this property. Use AWS/ALARM_STATE for alarm state in alarm composite models.

assetModelPropertyDefinition_unit :: Lens' AssetModelPropertyDefinition (Maybe Text) Source #

The unit of the property definition, such as Newtons or RPM.

assetModelPropertyDefinition_dataType :: Lens' AssetModelPropertyDefinition PropertyDataType Source #

The data type of the property definition.

If you specify STRUCT, you must also specify dataTypeSpec to identify the type of the structure for this property.

assetModelPropertyDefinition_type :: Lens' AssetModelPropertyDefinition PropertyType Source #

The property definition type (see PropertyType). You can only specify one type in a property definition.

AssetModelStatus

assetModelStatus_error :: Lens' AssetModelStatus (Maybe ErrorDetails) Source #

Contains associated error information, if any.

assetModelStatus_state :: Lens' AssetModelStatus AssetModelState Source #

The current state of the asset model.

AssetModelSummary

assetModelSummary_id :: Lens' AssetModelSummary Text Source #

The ID of the asset model (used with IoT SiteWise APIs).

assetModelSummary_arn :: Lens' AssetModelSummary Text Source #

The ARN of the asset model, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}

assetModelSummary_creationDate :: Lens' AssetModelSummary UTCTime Source #

The date the asset model was created, in Unix epoch time.

assetModelSummary_lastUpdateDate :: Lens' AssetModelSummary UTCTime Source #

The date the asset model was last updated, in Unix epoch time.

assetModelSummary_status :: Lens' AssetModelSummary AssetModelStatus Source #

The current status of the asset model.

AssetProperty

assetProperty_dataTypeSpec :: Lens' AssetProperty (Maybe Text) Source #

The data type of the structure for this property. This parameter exists on properties that have the STRUCT data type.

assetProperty_notification :: Lens' AssetProperty (Maybe PropertyNotification) Source #

The asset property's notification topic and state. For more information, see UpdateAssetProperty.

assetProperty_alias :: Lens' AssetProperty (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.

assetProperty_unit :: Lens' AssetProperty (Maybe Text) Source #

The unit (such as Newtons or RPM) of the asset property.

assetProperty_id :: Lens' AssetProperty Text Source #

The ID of the asset property.

assetProperty_name :: Lens' AssetProperty Text Source #

The name of the property.

assetProperty_dataType :: Lens' AssetProperty PropertyDataType Source #

The data type of the asset property.

AssetPropertyValue

assetPropertyValue_quality :: Lens' AssetPropertyValue (Maybe Quality) Source #

The quality of the asset property value.

assetPropertyValue_value :: Lens' AssetPropertyValue Variant Source #

The value of the asset property (see Variant).

assetPropertyValue_timestamp :: Lens' AssetPropertyValue TimeInNanos Source #

The timestamp of the asset property value.

AssetRelationshipSummary

assetRelationshipSummary_hierarchyInfo :: Lens' AssetRelationshipSummary (Maybe AssetHierarchyInfo) Source #

The assets that are related through an asset hierarchy.

This object is present if the relationshipType is HIERARCHY.

assetRelationshipSummary_relationshipType :: Lens' AssetRelationshipSummary AssetRelationshipType Source #

The relationship type of the assets in this relationship. This value is one of the following:

  • HIERARCHY – The assets are related through an asset hierarchy. If you specify this relationship type, this asset relationship includes the hierarchyInfo object.

AssetStatus

assetStatus_error :: Lens' AssetStatus (Maybe ErrorDetails) Source #

Contains associated error information, if any.

assetStatus_state :: Lens' AssetStatus AssetState Source #

The current status of the asset.

AssetSummary

assetSummary_arn :: Lens' AssetSummary Text Source #

The ARN of the asset, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

assetSummary_name :: Lens' AssetSummary Text Source #

The name of the asset.

assetSummary_assetModelId :: Lens' AssetSummary Text Source #

The ID of the asset model used to create this asset.

assetSummary_creationDate :: Lens' AssetSummary UTCTime Source #

The date the asset was created, in Unix epoch time.

assetSummary_lastUpdateDate :: Lens' AssetSummary UTCTime Source #

The date the asset was last updated, in Unix epoch time.

assetSummary_status :: Lens' AssetSummary AssetStatus Source #

The current status of the asset.

assetSummary_hierarchies :: Lens' AssetSummary [AssetHierarchy] Source #

A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships.

AssociatedAssetsSummary

associatedAssetsSummary_arn :: Lens' AssociatedAssetsSummary Text Source #

The ARN of the asset, which has the following format.

arn:${Partition}:iotsitewise:${Region}:${Account}:asset/${AssetId}

associatedAssetsSummary_assetModelId :: Lens' AssociatedAssetsSummary Text Source #

The ID of the asset model used to create the asset.

associatedAssetsSummary_creationDate :: Lens' AssociatedAssetsSummary UTCTime Source #

The date the asset was created, in Unix epoch time.

associatedAssetsSummary_lastUpdateDate :: Lens' AssociatedAssetsSummary UTCTime Source #

The date the asset was last updated, in Unix epoch time.

associatedAssetsSummary_hierarchies :: Lens' AssociatedAssetsSummary [AssetHierarchy] Source #

A list of asset hierarchies that each contain a hierarchyId. A hierarchy specifies allowed parent/child asset relationships.

Attribute

attribute_defaultValue :: Lens' Attribute (Maybe Text) Source #

The default value of the asset model property attribute. All assets that you create from the asset model contain this attribute value. You can update an attribute's value after you create an asset. For more information, see Updating attribute values in the IoT SiteWise User Guide.

BatchPutAssetPropertyError

BatchPutAssetPropertyErrorEntry

CompositeModelProperty

compositeModelProperty_type :: Lens' CompositeModelProperty Text Source #

The type of the composite model that defines this property.

ConfigurationErrorDetails

ConfigurationStatus

CustomerManagedS3Storage

customerManagedS3Storage_s3ResourceArn :: Lens' CustomerManagedS3Storage Text Source #

The ARN of the Amazon S3 object. For more information about how to find the ARN for an Amazon S3 object, see Amazon S3 resources in the Amazon Simple Storage Service User Guide.

customerManagedS3Storage_roleArn :: Lens' CustomerManagedS3Storage Text Source #

The ARN of the Identity and Access Management role that allows IoT SiteWise to send data to Amazon S3.

DashboardSummary

dashboardSummary_lastUpdateDate :: Lens' DashboardSummary (Maybe UTCTime) Source #

The date the dashboard was last updated, in Unix epoch time.

dashboardSummary_creationDate :: Lens' DashboardSummary (Maybe UTCTime) Source #

The date the dashboard was created, in Unix epoch time.

DetailedError

ErrorDetails

ExpressionVariable

expressionVariable_name :: Lens' ExpressionVariable Text Source #

The friendly name of the variable to be used in the expression.

expressionVariable_value :: Lens' ExpressionVariable VariableValue Source #

The variable that identifies an asset property from which to use values.

ForwardingConfig

forwardingConfig_state :: Lens' ForwardingConfig ForwardingConfigState Source #

The forwarding state for the given property.

GatewayCapabilitySummary

gatewayCapabilitySummary_capabilityNamespace :: Lens' GatewayCapabilitySummary Text Source #

The namespace of the capability configuration. For example, if you configure OPC-UA sources from the IoT SiteWise console, your OPC-UA capability configuration has the namespace iotsitewise:opcuacollector:version, where version is a number such as 1.

gatewayCapabilitySummary_capabilitySyncStatus :: Lens' GatewayCapabilitySummary CapabilitySyncStatus Source #

The synchronization status of the capability configuration. The sync status can be one of the following:

  • IN_SYNC – The gateway is running the capability configuration.
  • OUT_OF_SYNC – The gateway hasn't received the capability configuration.
  • SYNC_FAILED – The gateway rejected the capability configuration.

GatewayPlatform

gatewayPlatform_greengrass :: Lens' GatewayPlatform (Maybe Greengrass) Source #

A gateway that runs on IoT Greengrass.

gatewayPlatform_greengrassV2 :: Lens' GatewayPlatform (Maybe GreengrassV2) Source #

A gateway that runs on IoT Greengrass V2.

GatewaySummary

gatewaySummary_gatewayCapabilitySummaries :: Lens' GatewaySummary (Maybe [GatewayCapabilitySummary]) Source #

A list of gateway capability summaries that each contain a namespace and status. Each gateway capability defines data sources for the gateway. To retrieve a capability configuration's definition, use DescribeGatewayCapabilityConfiguration.

gatewaySummary_gatewayId :: Lens' GatewaySummary Text Source #

The ID of the gateway device.

gatewaySummary_creationDate :: Lens' GatewaySummary UTCTime Source #

The date the gateway was created, in Unix epoch time.

gatewaySummary_lastUpdateDate :: Lens' GatewaySummary UTCTime Source #

The date the gateway was last updated, in Unix epoch time.

Greengrass

greengrass_groupArn :: Lens' Greengrass Text Source #

The ARN of the Greengrass group. For more information about how to find a group's ARN, see ListGroups and GetGroup in the IoT Greengrass API Reference.

GreengrassV2

greengrassV2_coreDeviceThingName :: Lens' GreengrassV2 Text Source #

The name of the IoT thing for your IoT Greengrass V2 core device.

GroupIdentity

groupIdentity_id :: Lens' GroupIdentity Text Source #

The Amazon Web Services SSO ID of the group.

IAMRoleIdentity

iAMRoleIdentity_arn :: Lens' IAMRoleIdentity Text Source #

The ARN of the IAM role. For more information, see IAM ARNs in the IAM User Guide.

IAMUserIdentity

iAMUserIdentity_arn :: Lens' IAMUserIdentity Text Source #

The ARN of the IAM user. For more information, see IAM ARNs in the IAM User Guide.

If you delete the IAM user, access policies that contain this identity include an empty arn. You can delete the access policy for the IAM user that no longer exists.

Identity

identity_group :: Lens' Identity (Maybe GroupIdentity) Source #

An Amazon Web Services SSO group identity.

identity_user :: Lens' Identity (Maybe UserIdentity) Source #

An Amazon Web Services SSO user identity.

Image

image_id :: Lens' Image (Maybe Text) Source #

The ID of an existing image. Specify this parameter to keep an existing image.

image_file :: Lens' Image (Maybe ImageFile) Source #

Undocumented member.

ImageFile

imageFile_data :: Lens' ImageFile ByteString Source #

The image file contents, represented as a base64-encoded string. The file size must be less than 1 MB.-- -- Note: This Lens automatically encodes and decodes Base64 data. -- The underlying isomorphism will encode to Base64 representation during -- serialisation, and decode from Base64 representation during deserialisation. -- This Lens accepts and returns only raw unencoded data.

imageFile_type :: Lens' ImageFile ImageFileType Source #

The file type of the image.

ImageLocation

imageLocation_url :: Lens' ImageLocation Text Source #

The URL where the image is available. The URL is valid for 15 minutes so that you can view and download the image

InterpolatedAssetPropertyValue

LoggingOptions

loggingOptions_level :: Lens' LoggingOptions LoggingLevel Source #

The IoT SiteWise logging verbosity level.

Measurement

measurement_processingConfig :: Lens' Measurement (Maybe MeasurementProcessingConfig) Source #

The processing configuration for the given measurement property. You can configure measurements to be kept at the edge or forwarded to the Amazon Web Services Cloud. By default, measurements are forwarded to the cloud.

MeasurementProcessingConfig

measurementProcessingConfig_forwardingConfig :: Lens' MeasurementProcessingConfig ForwardingConfig Source #

The forwarding configuration for the given measurement property.

Metric

metric_processingConfig :: Lens' Metric (Maybe MetricProcessingConfig) Source #

The processing configuration for the given metric property. You can configure metrics to be computed at the edge or in the Amazon Web Services Cloud. By default, metrics are forwarded to the cloud.

metric_expression :: Lens' Metric Text Source #

The mathematical expression that defines the metric aggregation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

For more information, see Quotas in the IoT SiteWise User Guide.

metric_variables :: Lens' Metric [ExpressionVariable] Source #

The list of variables used in the expression.

metric_window :: Lens' Metric MetricWindow Source #

The window (time interval) over which IoT SiteWise computes the metric's aggregation expression. IoT SiteWise computes one data point per window.

MetricProcessingConfig

metricProcessingConfig_computeLocation :: Lens' MetricProcessingConfig ComputeLocation Source #

The compute location for the given metric property.

MetricWindow

metricWindow_tumbling :: Lens' MetricWindow (Maybe TumblingWindow) Source #

The tumbling time interval window.

MonitorErrorDetails

MultiLayerStorage

multiLayerStorage_customerManagedS3Storage :: Lens' MultiLayerStorage CustomerManagedS3Storage Source #

Contains information about a customer managed Amazon S3 bucket.

PortalResource

PortalStatus

portalStatus_error :: Lens' PortalStatus (Maybe MonitorErrorDetails) Source #

Contains associated error information, if any.

portalStatus_state :: Lens' PortalStatus PortalState Source #

The current state of the portal.

PortalSummary

portalSummary_lastUpdateDate :: Lens' PortalSummary (Maybe UTCTime) Source #

The date the portal was last updated, in Unix epoch time.

portalSummary_creationDate :: Lens' PortalSummary (Maybe UTCTime) Source #

The date the portal was created, in Unix epoch time.

portalSummary_roleArn :: Lens' PortalSummary (Maybe Text) Source #

The ARN of the service role that allows the portal's users to access your IoT SiteWise resources on your behalf. For more information, see Using service roles for IoT SiteWise Monitor in the IoT SiteWise User Guide.

portalSummary_startUrl :: Lens' PortalSummary Text Source #

The URL for the IoT SiteWise Monitor portal. You can use this URL to access portals that use Amazon Web Services SSO for authentication. For portals that use IAM for authentication, you must use the IoT SiteWise console to get a URL that you can use to access the portal.

ProjectResource

ProjectSummary

projectSummary_lastUpdateDate :: Lens' ProjectSummary (Maybe UTCTime) Source #

The date the project was last updated, in Unix epoch time.

projectSummary_creationDate :: Lens' ProjectSummary (Maybe UTCTime) Source #

The date the project was created, in Unix epoch time.

Property

property_notification :: Lens' Property (Maybe PropertyNotification) Source #

The asset property's notification topic and state. For more information, see UpdateAssetProperty.

property_alias :: Lens' Property (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.

property_type :: Lens' Property (Maybe PropertyType) Source #

The property type (see PropertyType). A property contains one type.

property_unit :: Lens' Property (Maybe Text) Source #

The unit (such as Newtons or RPM) of the asset property.

property_id :: Lens' Property Text Source #

The ID of the asset property.

property_name :: Lens' Property Text Source #

The name of the property.

PropertyNotification

propertyNotification_topic :: Lens' PropertyNotification Text Source #

The MQTT topic to which IoT SiteWise publishes property value update notifications.

PropertyType

propertyType_attribute :: Lens' PropertyType (Maybe Attribute) Source #

Specifies an asset attribute property. An attribute generally contains static information, such as the serial number of an IIoT wind turbine.

propertyType_transform :: Lens' PropertyType (Maybe Transform) Source #

Specifies an asset transform property. A transform contains a mathematical expression that maps a property's data points from one form to another, such as a unit conversion from Celsius to Fahrenheit.

propertyType_metric :: Lens' PropertyType (Maybe Metric) Source #

Specifies an asset metric property. A metric contains a mathematical expression that uses aggregate functions to process all input data points over a time interval and output a single data point, such as to calculate the average hourly temperature.

propertyType_measurement :: Lens' PropertyType (Maybe Measurement) Source #

Specifies an asset measurement property. A measurement represents a device's raw sensor data stream, such as timestamped temperature values or timestamped power values.

PutAssetPropertyValueEntry

putAssetPropertyValueEntry_propertyAlias :: Lens' PutAssetPropertyValueEntry (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.

putAssetPropertyValueEntry_entryId :: Lens' PutAssetPropertyValueEntry Text Source #

The user specified ID for the entry. You can use this ID to identify which entries failed.

putAssetPropertyValueEntry_propertyValues :: Lens' PutAssetPropertyValueEntry [AssetPropertyValue] Source #

The list of property values to upload. You can specify up to 10 propertyValues array elements.

Resource

TimeInNanos

timeInNanos_offsetInNanos :: Lens' TimeInNanos (Maybe Natural) Source #

The nanosecond offset from timeInSeconds.

timeInNanos_timeInSeconds :: Lens' TimeInNanos Natural Source #

The timestamp date, in seconds, in the Unix epoch format. Fractional nanosecond data is provided by offsetInNanos.

Transform

transform_processingConfig :: Lens' Transform (Maybe TransformProcessingConfig) Source #

The processing configuration for the given transform property. You can configure transforms to be kept at the edge or forwarded to the Amazon Web Services Cloud. You can also configure transforms to be computed at the edge or in the cloud.

transform_expression :: Lens' Transform Text Source #

The mathematical expression that defines the transformation function. You can specify up to 10 variables per expression. You can specify up to 10 functions per expression.

For more information, see Quotas in the IoT SiteWise User Guide.

transform_variables :: Lens' Transform [ExpressionVariable] Source #

The list of variables used in the expression.

TransformProcessingConfig

transformProcessingConfig_computeLocation :: Lens' TransformProcessingConfig ComputeLocation Source #

The compute location for the given transform property.

TumblingWindow

tumblingWindow_offset :: Lens' TumblingWindow (Maybe Text) Source #

The offset for the tumbling window. The offset parameter accepts the following:

  • The offset time.

    For example, if you specify 18h for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

    • If you create the metric before or at 6:00 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.
    • If you create the metric after 6:00 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.
  • The ISO 8601 format.

    For example, if you specify PT18H for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

    • If you create the metric before or at 6:00 PM (UTC), you get the first aggregation result at 6 PM (UTC) on the day when you create the metric.
    • If you create the metric after 6:00 PM (UTC), you get the first aggregation result at 6 PM (UTC) the next day.
  • The 24-hour clock.

    For example, if you specify 00:03:00 for offset and 5m for interval, and you create the metric at 2 PM (UTC), you get the first aggregation result at 2:03 PM (UTC). You get the second aggregation result at 2:08 PM (UTC).

  • The offset time zone.

    For example, if you specify 2021-07-23T18:00-08 for offset and 1d for interval, IoT SiteWise aggregates data in one of the following ways:

    • If you create the metric before or at 6:00 PM (PST), you get the first aggregation result at 6 PM (PST) on the day when you create the metric.
    • If you create the metric after 6:00 PM (PST), you get the first aggregation result at 6 PM (PST) the next day.

tumblingWindow_interval :: Lens' TumblingWindow Text Source #

The time interval for the tumbling window. The interval time must be between 1 minute and 1 week.

IoT SiteWise computes the 1w interval the end of Sunday at midnight each week (UTC), the 1d interval at the end of each day at midnight (UTC), the 1h interval at the end of each hour, and so on.

When IoT SiteWise aggregates data points for metric computations, the start of each interval is exclusive and the end of each interval is inclusive. IoT SiteWise places the computed data point at the end of the interval.

UserIdentity

userIdentity_id :: Lens' UserIdentity Text Source #

The Amazon Web Services SSO ID of the user.

VariableValue

variableValue_hierarchyId :: Lens' VariableValue (Maybe Text) Source #

The ID of the hierarchy to query for the property ID. You can use the hierarchy's name instead of the hierarchy's ID.

You use a hierarchy ID instead of a model ID because you can have several hierarchies using the same model and therefore the same propertyId. For example, you might have separately grouped assets that come from the same asset model. For more information, see Asset hierarchies in the IoT SiteWise User Guide.

variableValue_propertyId :: Lens' VariableValue Text Source #

The ID of the property to use as the variable. You can use the property name if it's from the same asset model.

Variant

variant_integerValue :: Lens' Variant (Maybe Int) Source #

Asset property data of type integer (whole number).

variant_doubleValue :: Lens' Variant (Maybe Double) Source #

Asset property data of type double (floating point number).

variant_stringValue :: Lens' Variant (Maybe Text) Source #

Asset property data of type string (sequence of characters).

variant_booleanValue :: Lens' Variant (Maybe Bool) Source #

Asset property data of type Boolean (true or false).