amazonka-iotsitewise-2.0: Amazon IoT SiteWise SDK.
Copyright(c) 2013-2023 Brendan Hay
LicenseMozilla Public License, v. 2.0.
MaintainerBrendan Hay
Stabilityauto-generated
Portabilitynon-portable (GHC extensions)
Safe HaskellSafe-Inferred
LanguageHaskell2010

Amazonka.IoTSiteWise.Lens

Contents

Description

 
Synopsis

Operations

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.

AssociateTimeSeriesToAssetProperty

associateTimeSeriesToAssetProperty_clientToken :: Lens' AssociateTimeSeriesToAssetProperty (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.

associateTimeSeriesToAssetProperty_assetId :: Lens' AssociateTimeSeriesToAssetProperty Text Source #

The ID of the asset in which the asset property was created.

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.

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.

BatchGetAssetPropertyAggregates

batchGetAssetPropertyAggregates_maxResults :: Lens' BatchGetAssetPropertyAggregates (Maybe Natural) Source #

The maximum number of results to return for each paginated request. A result set is returned in the two cases, whichever occurs first.

  • The size of the result set is less than 1 MB.
  • The number of data points in the result set is less than the value of maxResults. The maximum value of maxResults is 4000.

batchGetAssetPropertyAggregates_nextToken :: Lens' BatchGetAssetPropertyAggregates (Maybe Text) Source #

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

batchGetAssetPropertyAggregates_entries :: Lens' BatchGetAssetPropertyAggregates [BatchGetAssetPropertyAggregatesEntry] Source #

The list of asset property aggregate entries for the batch get request. You can specify up to 16 entries per request.

batchGetAssetPropertyAggregatesResponse_nextToken :: Lens' BatchGetAssetPropertyAggregatesResponse (Maybe Text) Source #

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

batchGetAssetPropertyAggregatesResponse_errorEntries :: Lens' BatchGetAssetPropertyAggregatesResponse [BatchGetAssetPropertyAggregatesErrorEntry] Source #

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

batchGetAssetPropertyAggregatesResponse_successEntries :: Lens' BatchGetAssetPropertyAggregatesResponse [BatchGetAssetPropertyAggregatesSuccessEntry] Source #

A list of entries that were processed successfully by this batch request. Each success entry contains the entryId of the entry that succeeded and the latest query result.

batchGetAssetPropertyAggregatesResponse_skippedEntries :: Lens' BatchGetAssetPropertyAggregatesResponse [BatchGetAssetPropertyAggregatesSkippedEntry] Source #

A list of entries that were not processed by this batch request. because these entries had been completely processed by previous paginated requests. Each skipped entry contains the entryId of the entry that skipped.

BatchGetAssetPropertyValue

batchGetAssetPropertyValue_nextToken :: Lens' BatchGetAssetPropertyValue (Maybe Text) Source #

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

batchGetAssetPropertyValue_entries :: Lens' BatchGetAssetPropertyValue [BatchGetAssetPropertyValueEntry] Source #

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

batchGetAssetPropertyValueResponse_nextToken :: Lens' BatchGetAssetPropertyValueResponse (Maybe Text) Source #

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

batchGetAssetPropertyValueResponse_errorEntries :: Lens' BatchGetAssetPropertyValueResponse [BatchGetAssetPropertyValueErrorEntry] Source #

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

batchGetAssetPropertyValueResponse_successEntries :: Lens' BatchGetAssetPropertyValueResponse [BatchGetAssetPropertyValueSuccessEntry] Source #

A list of entries that were processed successfully by this batch request. Each success entry contains the entryId of the entry that succeeded and the latest query result.

batchGetAssetPropertyValueResponse_skippedEntries :: Lens' BatchGetAssetPropertyValueResponse [BatchGetAssetPropertyValueSkippedEntry] Source #

A list of entries that were not processed by this batch request. because these entries had been completely processed by previous paginated requests. Each skipped entry contains the entryId of the entry that skipped.

BatchGetAssetPropertyValueHistory

batchGetAssetPropertyValueHistory_maxResults :: Lens' BatchGetAssetPropertyValueHistory (Maybe Natural) Source #

The maximum number of results to return for each paginated request. A result set is returned in the two cases, whichever occurs first.

  • The size of the result set is less than 1 MB.
  • The number of data points in the result set is less than the value of maxResults. The maximum value of maxResults is 4000.

batchGetAssetPropertyValueHistory_nextToken :: Lens' BatchGetAssetPropertyValueHistory (Maybe Text) Source #

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

batchGetAssetPropertyValueHistory_entries :: Lens' BatchGetAssetPropertyValueHistory [BatchGetAssetPropertyValueHistoryEntry] Source #

The list of asset property historical value entries for the batch get request. You can specify up to 16 entries per request.

batchGetAssetPropertyValueHistoryResponse_nextToken :: Lens' BatchGetAssetPropertyValueHistoryResponse (Maybe Text) Source #

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

batchGetAssetPropertyValueHistoryResponse_errorEntries :: Lens' BatchGetAssetPropertyValueHistoryResponse [BatchGetAssetPropertyValueHistoryErrorEntry] Source #

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

batchGetAssetPropertyValueHistoryResponse_successEntries :: Lens' BatchGetAssetPropertyValueHistoryResponse [BatchGetAssetPropertyValueHistorySuccessEntry] Source #

A list of entries that were processed successfully by this batch request. Each success entry contains the entryId of the entry that succeeded and the latest query result.

batchGetAssetPropertyValueHistoryResponse_skippedEntries :: Lens' BatchGetAssetPropertyValueHistoryResponse [BatchGetAssetPropertyValueHistorySkippedEntry] Source #

A list of entries that were not processed by this batch request. because these entries had been completely processed by previous paginated requests. Each skipped entry contains the entryId of the entry that skipped.

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.

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 IAM Identity Center user, an IAM Identity Center 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}

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 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.

CreateAssetModel

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_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_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_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.

CreateBulkImportJob

createBulkImportJob_jobName :: Lens' CreateBulkImportJob Text Source #

The unique name that helps identify the job request.

createBulkImportJob_jobRoleArn :: Lens' CreateBulkImportJob Text Source #

The ARN of the IAM role that allows IoT SiteWise to read Amazon S3 data.

createBulkImportJob_files :: Lens' CreateBulkImportJob [File] Source #

The files in the specified Amazon S3 bucket that contain your data.

createBulkImportJob_errorReportLocation :: Lens' CreateBulkImportJob ErrorReportLocation Source #

The Amazon S3 destination where errors associated with the job creation request are saved.

createBulkImportJob_jobConfiguration :: Lens' CreateBulkImportJob JobConfiguration Source #

Contains the configuration information of a job, such as the file format used to save data in Amazon S3.

createBulkImportJobResponse_jobName :: Lens' CreateBulkImportJobResponse Text Source #

The unique name that helps identify the job request.

createBulkImportJobResponse_jobStatus :: Lens' CreateBulkImportJobResponse JobStatus Source #

The status of the bulk import job can be one of following values.

  • PENDING – IoT SiteWise is waiting for the current bulk import job to finish.
  • CANCELLED – The bulk import job has been canceled.
  • RUNNING – IoT SiteWise is processing your request to import your data from Amazon S3.
  • COMPLETED – IoT SiteWise successfully completed your request to import data from Amazon S3.
  • FAILED – IoT SiteWise couldn't process your request to import data from Amazon S3. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.
  • COMPLETED_WITH_FAILURES – IoT SiteWise completed your request to import data from Amazon S3 with errors. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

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}

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}

CreatePortal

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_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_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 IAM Identity Center (successor to Single Sign-On) to authenticate users and manage user permissions. Before you can create a portal that uses IAM Identity Center, you must enable IAM Identity Center. For more information, see Enabling IAM Identity Center 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.

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

Default: SSO

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 IAM Identity Center 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 IAM Identity Center application ID, if the portal uses IAM Identity Center.

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}

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.

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.

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.

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.

DeleteGateway

deleteGateway_gatewayId :: Lens' DeleteGateway Text Source #

The ID of the gateway to delete.

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.

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.

DeleteTimeSeries

deleteTimeSeries_alias :: Lens' DeleteTimeSeries (Maybe Text) Source #

The alias that identifies the time series.

deleteTimeSeries_assetId :: Lens' DeleteTimeSeries (Maybe Text) Source #

The ID of the asset in which the asset property was created.

deleteTimeSeries_clientToken :: Lens' DeleteTimeSeries (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.

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 (IAM Identity Center user, IAM Identity Center 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.

DescribeAsset

describeAsset_excludeProperties :: Lens' DescribeAsset (Maybe Bool) Source #

Whether or not to exclude asset properties from the response.

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.

DescribeAssetModel

describeAssetModel_excludeProperties :: Lens' DescribeAssetModel (Maybe Bool) Source #

Whether or not to exclude asset model properties from the response.

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.

DescribeBulkImportJob

describeBulkImportJobResponse_jobName :: Lens' DescribeBulkImportJobResponse Text Source #

The unique name that helps identify the job request.

describeBulkImportJobResponse_jobStatus :: Lens' DescribeBulkImportJobResponse JobStatus Source #

The status of the bulk import job can be one of following values.

  • PENDING – IoT SiteWise is waiting for the current bulk import job to finish.
  • CANCELLED – The bulk import job has been canceled.
  • RUNNING – IoT SiteWise is processing your request to import your data from Amazon S3.
  • COMPLETED – IoT SiteWise successfully completed your request to import data from Amazon S3.
  • FAILED – IoT SiteWise couldn't process your request to import data from Amazon S3. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.
  • COMPLETED_WITH_FAILURES – IoT SiteWise completed your request to import data from Amazon S3 with errors. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

describeBulkImportJobResponse_jobRoleArn :: Lens' DescribeBulkImportJobResponse Text Source #

The ARN of the IAM role that allows IoT SiteWise to read Amazon S3 data.

describeBulkImportJobResponse_files :: Lens' DescribeBulkImportJobResponse [File] Source #

The files in the specified Amazon S3 bucket that contain your data.

describeBulkImportJobResponse_errorReportLocation :: Lens' DescribeBulkImportJobResponse ErrorReportLocation Source #

The Amazon S3 destination where errors associated with the job creation request are saved.

describeBulkImportJobResponse_jobConfiguration :: Lens' DescribeBulkImportJobResponse JobConfiguration Source #

Contains the configuration information of a job, such as the file format used to save data in Amazon S3.

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.

DescribeDefaultEncryptionConfiguration

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

The key ARN of the customer managed key 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.

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.

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.

DescribeLoggingOptions

DescribePortal

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

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

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

The email address that sends alarm notifications.

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

The service to use to authenticate users to the 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 IAM Identity Center application generated client ID (used with IAM Identity Center APIs). IoT SiteWise includes portalClientId for only portals that use IAM Identity Center 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 IAM Identity Center 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.

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.

DescribeStorageConfiguration

describeStorageConfigurationResponse_disassociatedDataStorage :: Lens' DescribeStorageConfigurationResponse (Maybe DisassociatedDataStorageState) Source #

Contains the storage configuration for time series (data streams) that aren't associated with asset properties. The disassociatedDataStorage can be one of the following values:

  • ENABLED – IoT SiteWise accepts time series that aren't associated with asset properties.

    After the disassociatedDataStorage is enabled, you can't disable it.

  • DISABLED – IoT SiteWise doesn't accept time series (data streams) that aren't associated with asset properties.

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

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

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

describeStorageConfigurationResponse_retentionPeriod :: Lens' DescribeStorageConfigurationResponse (Maybe RetentionPeriod) Source #

How many days your data is kept in the hot tier. By default, your data is kept indefinitely in the hot tier.

describeStorageConfigurationResponse_storageType :: Lens' DescribeStorageConfigurationResponse StorageType Source #

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

  • SITEWISE_DEFAULT_STORAGE – IoT SiteWise saves your data into the hot tier. The hot tier is a service-managed database.
  • MULTI_LAYER_STORAGE – IoT SiteWise saves your data in both the cold tier and the hot tier. The cold tier is a customer-managed Amazon S3 bucket.

DescribeTimeSeries

describeTimeSeries_alias :: Lens' DescribeTimeSeries (Maybe Text) Source #

The alias that identifies the time series.

describeTimeSeries_assetId :: Lens' DescribeTimeSeries (Maybe Text) Source #

The ID of the asset in which the asset property was created.

describeTimeSeriesResponse_alias :: Lens' DescribeTimeSeriesResponse (Maybe Text) Source #

The alias that identifies the time series.

describeTimeSeriesResponse_assetId :: Lens' DescribeTimeSeriesResponse (Maybe Text) Source #

The ID of the asset in which the asset property was created.

describeTimeSeriesResponse_dataTypeSpec :: Lens' DescribeTimeSeriesResponse (Maybe Text) Source #

The data type of the structure for this time series. This parameter is required for time series that have the STRUCT data type.

The options for this parameter depend on the type of the composite model in which you created the asset property that is associated with your time series. Use AWS/ALARM_STATE for alarm state in alarm composite models.

describeTimeSeriesResponse_dataType :: Lens' DescribeTimeSeriesResponse PropertyDataType Source #

The data type of the time series.

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

describeTimeSeriesResponse_timeSeriesCreationDate :: Lens' DescribeTimeSeriesResponse UTCTime Source #

The date that the time series was created, in Unix epoch time.

describeTimeSeriesResponse_timeSeriesLastUpdateDate :: Lens' DescribeTimeSeriesResponse UTCTime Source #

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

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.

DisassociateTimeSeriesFromAssetProperty

disassociateTimeSeriesFromAssetProperty_clientToken :: Lens' DisassociateTimeSeriesFromAssetProperty (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.

disassociateTimeSeriesFromAssetProperty_assetId :: Lens' DisassociateTimeSeriesFromAssetProperty Text Source #

The ID of the asset in which the asset property was created.

GetAssetPropertyAggregates

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

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

Default: 100

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

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

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

The chronological sorting order of the requested information.

Default: ASCENDING

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.

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.

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_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_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

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

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

GetInterpolatedAssetPropertyValues

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 ranges between the start time minus the interval and the end time plus the interval.

  • If you specify a value for the intervalWindowInSeconds parameter, the value for the type parameter must be LINEAR_INTERPOLATION.
  • If a data point isn't 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 minus 2 hours) to 11 AM (9 AM plus 2 hours) on July 2, 2021 to compute the first interpolated value. Next, IoT SiteWise uses the data points from 7 AM (9 AM minus 2 hours) to 11 AM (9 AM plus 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_nextToken :: Lens' GetInterpolatedAssetPropertyValues (Maybe Text) Source #

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

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_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 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 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 a data point isn't 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.

ListAccessPolicies

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_identityType :: Lens' ListAccessPolicies (Maybe IdentityType) Source #

The type of identity (IAM Identity Center user, IAM Identity Center group, or IAM user). This parameter is required if you specify identityId.

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

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

Default: 50

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

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

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.

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

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

ListAssetModelProperties

listAssetModelProperties_filter :: Lens' ListAssetModelProperties (Maybe ListAssetModelPropertiesFilter) Source #

Filters the requested list of asset model properties. You can choose one of the following options:

  • ALL – The list includes all asset model properties for a given asset model ID.
  • BASE – The list includes only base asset model properties for a given asset model ID.

Default: BASE

listAssetModelProperties_maxResults :: Lens' ListAssetModelProperties (Maybe Natural) Source #

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

listAssetModelProperties_nextToken :: Lens' ListAssetModelProperties (Maybe Text) Source #

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

listAssetModelPropertiesResponse_nextToken :: Lens' ListAssetModelPropertiesResponse (Maybe Text) Source #

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

listAssetModelPropertiesResponse_assetModelPropertySummaries :: Lens' ListAssetModelPropertiesResponse [AssetModelPropertySummary] Source #

A list that summarizes the properties associated with the specified asset model.

ListAssetModels

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

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

Default: 50

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

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

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

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

ListAssetProperties

listAssetProperties_filter :: Lens' ListAssetProperties (Maybe ListAssetPropertiesFilter) Source #

Filters the requested list of asset properties. You can choose one of the following options:

  • ALL – The list includes all asset properties for a given asset model ID.
  • BASE – The list includes only base asset properties for a given asset model ID.

Default: BASE

listAssetProperties_maxResults :: Lens' ListAssetProperties (Maybe Natural) Source #

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

listAssetProperties_nextToken :: Lens' ListAssetProperties (Maybe Text) Source #

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

listAssetPropertiesResponse_nextToken :: Lens' ListAssetPropertiesResponse (Maybe Text) Source #

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

listAssetPropertiesResponse_assetPropertySummaries :: Lens' ListAssetPropertiesResponse [AssetPropertySummary] Source #

A list that summarizes the properties associated with the specified asset.

ListAssetRelationships

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

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

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

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

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.

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_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

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

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

listAssetsResponse_nextToken :: Lens' ListAssetsResponse (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_maxResults :: Lens' ListAssociatedAssets (Maybe Natural) Source #

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

Default: 50

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

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

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

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

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

ListBulkImportJobs

listBulkImportJobs_filter :: Lens' ListBulkImportJobs (Maybe ListBulkImportJobsFilter) Source #

You can use a filter to select the bulk import jobs that you want to retrieve.

listBulkImportJobs_maxResults :: Lens' ListBulkImportJobs (Maybe Natural) Source #

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

listBulkImportJobs_nextToken :: Lens' ListBulkImportJobs (Maybe Text) Source #

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

listBulkImportJobsResponse_nextToken :: Lens' ListBulkImportJobsResponse (Maybe Text) Source #

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

ListDashboards

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

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

Default: 50

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

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

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.

ListGateways

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

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

Default: 50

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

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

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

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

ListPortals

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

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

Default: 50

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

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

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

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

ListProjectAssets

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

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

Default: 50

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

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

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.

ListProjects

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

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

Default: 50

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

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

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.

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.

ListTimeSeries

listTimeSeries_aliasPrefix :: Lens' ListTimeSeries (Maybe Text) Source #

The alias prefix of the time series.

listTimeSeries_assetId :: Lens' ListTimeSeries (Maybe Text) Source #

The ID of the asset in which the asset property was created.

listTimeSeries_maxResults :: Lens' ListTimeSeries (Maybe Natural) Source #

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

listTimeSeries_nextToken :: Lens' ListTimeSeries (Maybe Text) Source #

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

listTimeSeries_timeSeriesType :: Lens' ListTimeSeries (Maybe ListTimeSeriesType) Source #

The type of the time series. The time series type can be one of the following values:

  • ASSOCIATED – The time series is associated with an asset property.
  • DISASSOCIATED – The time series isn't associated with any asset property.

listTimeSeriesResponse_nextToken :: Lens' ListTimeSeriesResponse (Maybe Text) Source #

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

PutDefaultEncryptionConfiguration

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

The Key ID of the customer managed key 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 key 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.

PutLoggingOptions

PutStorageConfiguration

putStorageConfiguration_disassociatedDataStorage :: Lens' PutStorageConfiguration (Maybe DisassociatedDataStorageState) Source #

Contains the storage configuration for time series (data streams) that aren't associated with asset properties. The disassociatedDataStorage can be one of the following values:

  • ENABLED – IoT SiteWise accepts time series that aren't associated with asset properties.

    After the disassociatedDataStorage is enabled, you can't disable it.

  • DISABLED – IoT SiteWise doesn't accept time series (data streams) that aren't associated with asset properties.

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

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 storage tier that you specified for your data. The storageType parameter can be one of the following values:

  • SITEWISE_DEFAULT_STORAGE – IoT SiteWise saves your data into the hot tier. The hot tier is a service-managed database.
  • MULTI_LAYER_STORAGE – IoT SiteWise saves your data in both the cold tier and the hot tier. The cold tier is a customer-managed Amazon S3 bucket.

putStorageConfigurationResponse_disassociatedDataStorage :: Lens' PutStorageConfigurationResponse (Maybe DisassociatedDataStorageState) Source #

Contains the storage configuration for time series (data streams) that aren't associated with asset properties. The disassociatedDataStorage can be one of the following values:

  • ENABLED – IoT SiteWise accepts time series that aren't associated with asset properties.

    After the disassociatedDataStorage is enabled, you can't disable it.

  • DISABLED – IoT SiteWise doesn't accept time series (data streams) that aren't associated with asset properties.

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

putStorageConfigurationResponse_storageType :: Lens' PutStorageConfigurationResponse StorageType Source #

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

  • SITEWISE_DEFAULT_STORAGE – IoT SiteWise saves your data into the hot tier. The hot tier is a service-managed database.
  • MULTI_LAYER_STORAGE – IoT SiteWise saves your data in both the cold tier and the hot tier. The cold tier is a customer-managed Amazon S3 bucket.

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.

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.

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 IAM Identity Center user, an IAM Identity Center 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.

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 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.

UpdateAssetModel

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

The unit of measure (such as Newtons or RPM) of the asset property. If you don't specify a value for this parameter, the service uses the value of the assetModelProperty in the asset model.

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.

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.

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.

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.

UpdatePortal

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

The email address that sends alarm notifications.

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

A new description for the portal.

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.

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.

Types

AccessPolicySummary

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

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

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

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

accessPolicySummary_identity :: Lens' AccessPolicySummary Identity Source #

The identity (an IAM Identity Center user, an IAM Identity Center 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_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_maximum :: Lens' Aggregates (Maybe Double) Source #

The maximum value of 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_id :: Lens' AssetCompositeModel (Maybe Text) Source #

The ID of the asset 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_id :: Lens' AssetModelCompositeModel (Maybe Text) Source #

The ID of the asset model composite model.

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.

AssetModelPropertySummary

assetModelPropertySummary_assetModelCompositeModelId :: Lens' AssetModelPropertySummary (Maybe Text) Source #

The ID of the composite model that contains the asset model property.

assetModelPropertySummary_dataTypeSpec :: Lens' AssetModelPropertySummary (Maybe Text) Source #

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

assetModelPropertySummary_unit :: Lens' AssetModelPropertySummary (Maybe Text) Source #

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

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_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_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_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.

AssetPropertySummary

assetPropertySummary_alias :: Lens' AssetPropertySummary (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.

assetPropertySummary_assetCompositeModelId :: Lens' AssetPropertySummary (Maybe Text) Source #

The ID of the composite model that contains the asset property.

assetPropertySummary_unit :: Lens' AssetPropertySummary (Maybe Text) Source #

The unit of measure (such as Newtons or RPM) 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_description :: Lens' AssetSummary (Maybe Text) Source #

A description for the asset.

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.

BatchGetAssetPropertyAggregatesEntry

batchGetAssetPropertyAggregatesEntry_assetId :: Lens' BatchGetAssetPropertyAggregatesEntry (Maybe Text) Source #

The ID of the asset in which the asset property was created.

batchGetAssetPropertyAggregatesEntry_propertyAlias :: Lens' BatchGetAssetPropertyAggregatesEntry (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.

batchGetAssetPropertyAggregatesEntry_timeOrdering :: Lens' BatchGetAssetPropertyAggregatesEntry (Maybe TimeOrdering) Source #

The chronological sorting order of the requested information.

Default: ASCENDING

batchGetAssetPropertyAggregatesEntry_startDate :: Lens' BatchGetAssetPropertyAggregatesEntry UTCTime Source #

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

batchGetAssetPropertyAggregatesEntry_endDate :: Lens' BatchGetAssetPropertyAggregatesEntry UTCTime Source #

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

BatchGetAssetPropertyAggregatesErrorEntry

BatchGetAssetPropertyAggregatesErrorInfo

BatchGetAssetPropertyAggregatesSkippedEntry

BatchGetAssetPropertyAggregatesSuccessEntry

batchGetAssetPropertyAggregatesSuccessEntry_aggregatedValues :: Lens' BatchGetAssetPropertyAggregatesSuccessEntry [AggregatedValue] Source #

The requested aggregated asset property values (for example, average, minimum, and maximum).

BatchGetAssetPropertyValueEntry

batchGetAssetPropertyValueEntry_assetId :: Lens' BatchGetAssetPropertyValueEntry (Maybe Text) Source #

The ID of the asset in which the asset property was created.

batchGetAssetPropertyValueEntry_propertyAlias :: Lens' BatchGetAssetPropertyValueEntry (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.

BatchGetAssetPropertyValueErrorEntry

BatchGetAssetPropertyValueErrorInfo

BatchGetAssetPropertyValueHistoryEntry

batchGetAssetPropertyValueHistoryEntry_assetId :: Lens' BatchGetAssetPropertyValueHistoryEntry (Maybe Text) Source #

The ID of the asset in which the asset property was created.

batchGetAssetPropertyValueHistoryEntry_endDate :: Lens' BatchGetAssetPropertyValueHistoryEntry (Maybe UTCTime) Source #

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

batchGetAssetPropertyValueHistoryEntry_propertyAlias :: Lens' BatchGetAssetPropertyValueHistoryEntry (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.

batchGetAssetPropertyValueHistoryEntry_startDate :: Lens' BatchGetAssetPropertyValueHistoryEntry (Maybe UTCTime) Source #

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

batchGetAssetPropertyValueHistoryEntry_timeOrdering :: Lens' BatchGetAssetPropertyValueHistoryEntry (Maybe TimeOrdering) Source #

The chronological sorting order of the requested information.

Default: ASCENDING

BatchGetAssetPropertyValueHistoryErrorEntry

BatchGetAssetPropertyValueHistoryErrorInfo

BatchGetAssetPropertyValueHistorySkippedEntry

BatchGetAssetPropertyValueHistorySuccessEntry

BatchGetAssetPropertyValueSkippedEntry

BatchGetAssetPropertyValueSuccessEntry

BatchPutAssetPropertyError

BatchPutAssetPropertyErrorEntry

CompositeModelProperty

compositeModelProperty_id :: Lens' CompositeModelProperty (Maybe Text) Source #

The ID of the composite model that contains the property.

compositeModelProperty_type :: Lens' CompositeModelProperty Text Source #

The type of the composite model that defines this property.

ConfigurationErrorDetails

ConfigurationStatus

Csv

csv_columnNames :: Lens' Csv (Maybe [ColumnName]) Source #

The column names specified in the .csv file.

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_creationDate :: Lens' DashboardSummary (Maybe UTCTime) Source #

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

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

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

DetailedError

ErrorDetails

ErrorReportLocation

errorReportLocation_bucket :: Lens' ErrorReportLocation Text Source #

The name of the Amazon S3 bucket to which errors associated with the bulk import job are sent.

errorReportLocation_prefix :: Lens' ErrorReportLocation Text Source #

Amazon S3 uses the prefix as a folder name to organize data in the bucket. Each Amazon S3 object has a key that is its unique identifier in the bucket. Each object in a bucket has exactly one key. The prefix must end with a forward slash (/). For more information, see Organizing objects using prefixes in the Amazon Simple Storage Service User Guide.

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.

File

file_versionId :: Lens' File (Maybe Text) Source #

The version ID to identify a specific version of the Amazon S3 object that contains your data.

file_bucket :: Lens' File Text Source #

The name of the Amazon S3 bucket from which data is imported.

file_key :: Lens' File Text Source #

The key of the Amazon S3 object that contains your data. Each object has a key that is a unique identifier. Each object has exactly one key.

FileFormat

fileFormat_csv :: Lens' FileFormat (Maybe Csv) Source #

The .csv file format.

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 IAM Identity Center 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 IAM Identity Center group identity.

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

An IAM Identity Center user identity.

Image

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

Undocumented member.

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

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

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

JobConfiguration

jobConfiguration_fileFormat :: Lens' JobConfiguration FileFormat Source #

The file format of the data in Amazon S3.

JobSummary

jobSummary_id :: Lens' JobSummary Text Source #

The ID of the job.

jobSummary_name :: Lens' JobSummary Text Source #

The unique name that helps identify the job request.

jobSummary_status :: Lens' JobSummary JobStatus Source #

The status of the bulk import job can be one of following values.

  • PENDING – IoT SiteWise is waiting for the current bulk import job to finish.
  • CANCELLED – The bulk import job has been canceled.
  • RUNNING – IoT SiteWise is processing your request to import your data from Amazon S3.
  • COMPLETED – IoT SiteWise successfully completed your request to import data from Amazon S3.
  • FAILED – IoT SiteWise couldn't process your request to import data from Amazon S3. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.
  • COMPLETED_WITH_FAILURES – IoT SiteWise completed your request to import data from Amazon S3 with errors. You can use logs saved in the specified error report location in Amazon S3 to troubleshoot issues.

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_creationDate :: Lens' PortalSummary (Maybe UTCTime) Source #

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

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

The date the portal was last updated, 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 IAM Identity Center 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_creationDate :: Lens' ProjectSummary (Maybe UTCTime) Source #

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

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

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

Property

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_notification :: Lens' Property (Maybe PropertyNotification) Source #

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

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_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.

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_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.

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

RetentionPeriod

retentionPeriod_numberOfDays :: Lens' RetentionPeriod (Maybe Natural) Source #

The number of days that your data is kept.

If you specified a value for this parameter, the unlimited parameter must be false.

retentionPeriod_unlimited :: Lens' RetentionPeriod (Maybe Bool) Source #

If true, your data is kept indefinitely.

If configured to true, you must not specify a value for the numberOfDays parameter.

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.

TimeSeriesSummary

timeSeriesSummary_alias :: Lens' TimeSeriesSummary (Maybe Text) Source #

The alias that identifies the time series.

timeSeriesSummary_assetId :: Lens' TimeSeriesSummary (Maybe Text) Source #

The ID of the asset in which the asset property was created.

timeSeriesSummary_dataTypeSpec :: Lens' TimeSeriesSummary (Maybe Text) Source #

The data type of the structure for this time series. This parameter is required for time series that have the STRUCT data type.

The options for this parameter depend on the type of the composite model in which you created the asset property that is associated with your time series. Use AWS/ALARM_STATE for alarm state in alarm composite models.

timeSeriesSummary_dataType :: Lens' TimeSeriesSummary PropertyDataType Source #

The data type of the time series.

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

timeSeriesSummary_timeSeriesCreationDate :: Lens' TimeSeriesSummary UTCTime Source #

The date that the time series was created, in Unix epoch time.

timeSeriesSummary_timeSeriesLastUpdateDate :: Lens' TimeSeriesSummary UTCTime Source #

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

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 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 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 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 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, 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 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 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 IAM Identity Center 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_booleanValue :: Lens' Variant (Maybe Bool) Source #

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

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

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

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

Asset property data of type integer (whole number).

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

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