IoTSiteWise class
Welcome to the IoT SiteWise API Reference. IoT SiteWise is an Amazon Web Services service that connects Industrial Internet of Things (IIoT) devices to the power of the Amazon Web Services Cloud. For more information, see the IoT SiteWise User Guide. For information about IoT SiteWise quotas, see Quotas in the IoT SiteWise User Guide.
Constructors
- IoTSiteWise({required String region, AwsClientCredentials? credentials, AwsClientCredentialsProvider? credentialsProvider, Client? client, String? endpointUrl, bool useFipsEndpoint = false, bool useDualStackEndpoint = false, bool disableHostPrefix = false})
-
factory
Properties
- hashCode → int
-
The hash code for this object.
no setterinherited
- runtimeType → Type
-
A representation of the runtime type of the object.
no setterinherited
Methods
-
associateAssets(
{required String assetId, required String childAssetId, required String hierarchyId, String? clientToken}) → Future< void> - Associates a child asset with the given parent asset through a hierarchy defined in the parent asset's model. For more information, see Associating assets in the IoT SiteWise User Guide.
-
associateTimeSeriesToAssetProperty(
{required String alias, required String assetId, required String propertyId, String? clientToken}) → Future< void> - Associates a time series (data stream) with an asset property.
-
batchAssociateDataSegmentsToDataset(
{required List< AssociateDataSegmentEntry> associateDataSegmentEntries, required String datasetId, required String workspaceName, String? clientToken}) → Future<BatchAssociateDataSegmentsToDatasetResponse> - Associates a batch of data segments with a curated dataset. Data segments are time-bounded slices of time series data selected from source session datasets. Data segments that belong to the same time series can't overlap in time, regardless of which dataset they belong to.
-
batchAssociateProjectAssets(
{required List< String> assetIds, required String projectId, String? clientToken}) → Future<BatchAssociateProjectAssetsResponse> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
batchDeleteDatasetDataSegments(
{required String datasetId, required List< DeleteDataSegmentEntry> deleteDataSegmentEntries, required String workspaceName, String? clientToken}) → Future<BatchDeleteDatasetDataSegmentsResponse> - Deletes a batch of data segments from a session dataset. Deleting a data segment deletes the underlying time series data for the segment's time range.
-
batchDisassociateDataSegmentsFromDataset(
{required String datasetId, required List< DisassociateDataSegmentEntry> disassociateDataSegmentEntries, required String workspaceName, String? clientToken}) → Future<BatchDisassociateDataSegmentsFromDatasetResponse> - Disassociates a batch of data segments from a curated dataset. Disassociating a data segment doesn't delete the underlying data in the source session dataset.
-
batchDisassociateProjectAssets(
{required List< String> assetIds, required String projectId, String? clientToken}) → Future<BatchDisassociateProjectAssetsResponse> - Disassociates a group (batch) of assets from an IoT SiteWise Monitor project.
-
batchGetAssetPropertyAggregates(
{required List< BatchGetAssetPropertyAggregatesEntry> entries, int? maxResults, String? nextToken}) → Future<BatchGetAssetPropertyAggregatesResponse> - Gets aggregated values (for example, average, minimum, and maximum) for one or more asset properties. For more information, see Querying aggregates in the IoT SiteWise User Guide.
-
batchGetAssetPropertyValue(
{required List< BatchGetAssetPropertyValueEntry> entries, String? nextToken}) → Future<BatchGetAssetPropertyValueResponse> - Gets the current value for one or more asset properties. For more information, see Querying current values in the IoT SiteWise User Guide.
-
batchGetAssetPropertyValueHistory(
{required List< BatchGetAssetPropertyValueHistoryEntry> entries, int? maxResults, String? nextToken}) → Future<BatchGetAssetPropertyValueHistoryResponse> - Gets the historical values for one or more asset properties. For more information, see Querying historical values in the IoT SiteWise User Guide.
-
batchPutAssetPropertyValue(
{required List< PutAssetPropertyValueEntry> entries, bool? enablePartialEntryProcessing}) → Future<BatchPutAssetPropertyValueResponse> - Sends a list of asset property values to IoT SiteWise. Each value is a timestamp-quality-value (TQV) data point. For more information, see Ingesting data using the API in the IoT SiteWise User Guide.
-
cancelEnrichmentJob(
{required String jobId, required String workspaceName}) → Future< CancelEnrichmentJobResponse> - Cancels a running or pending enrichment job. This is an idempotent operation—calling it multiple times with the same jobId is safe and returns the current status.
-
cancelPipelineExecution(
{required String pipelineExecutionId, required String pipelineName, required String workspaceName, String? reason}) → Future< CancelPipelineExecutionResponse> - Cancels a pipeline execution in the specified workspace. If the execution is not in a terminal state (such as NOT_STARTED or RUNNING), it transitions to CANCELLING and asynchronously to CANCELLED. This operation is idempotent: calling it on an execution that is already CANCELLING or CANCELLED returns success with the current state. Calling it on a terminal execution (SUCCEEDED or FAILED) returns a conflict error. You can optionally provide a reason; it is returned in the stateDetails field when you describe the execution.
-
cancelQuery(
{required String queryId, required String workspaceName}) → Future< CancelQueryResponse> - Cancels a running query.
-
close(
) → void - Closes the internal HTTP client if none was provided at creation. If a client was passed as a constructor argument, this becomes a noop.
-
createAccessPolicy(
{required Identity accessPolicyIdentity, required Permission accessPolicyPermission, required Resource accessPolicyResource, String? clientToken, Map< String, String> ? tags}) → Future<CreateAccessPolicyResponse> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
createApplication(
{required String idcInstanceArn, required String name, required String workspaceName, String? clientToken, String? description, Map< String, String> ? tags}) → Future<CreateApplicationResponse> - Creates a new application for the workspace and IdC application provided
-
createAsset(
{required String assetModelId, required String assetName, String? assetDescription, String? assetExternalId, String? assetId, String? clientToken, Map< String, String> ? tags}) → Future<CreateAssetResponse> - Creates an asset from an existing asset model. For more information, see Creating assets in the IoT SiteWise User Guide.
-
createAssetModel(
{required String assetModelName, List< AssetModelCompositeModelDefinition> ? assetModelCompositeModels, String? assetModelDescription, String? assetModelExternalId, List<AssetModelHierarchyDefinition> ? assetModelHierarchies, String? assetModelId, List<AssetModelPropertyDefinition> ? assetModelProperties, AssetModelType? assetModelType, String? clientToken, Map<String, String> ? tags}) → Future<CreateAssetModelResponse> - Creates an asset model from specified property and hierarchy definitions. You create assets from asset models. With asset models, you can easily create assets of the same type that have standardized definitions. Each asset created from a model inherits the asset model's property and hierarchy definitions. For more information, see Defining asset models in the IoT SiteWise User Guide.
-
createAssetModelCompositeModel(
{required String assetModelCompositeModelName, required String assetModelCompositeModelType, required String assetModelId, String? assetModelCompositeModelDescription, String? assetModelCompositeModelExternalId, String? assetModelCompositeModelId, List< AssetModelPropertyDefinition> ? assetModelCompositeModelProperties, String? clientToken, String? composedAssetModelId, String? ifMatch, String? ifNoneMatch, AssetModelVersionType? matchForVersionType, String? parentAssetModelCompositeModelId}) → Future<CreateAssetModelCompositeModelResponse> -
Creates a custom composite model from specified property and hierarchy
definitions. There are two types of custom composite models,
inlineandcomponent-model-based. -
createBulkImportJob(
{required ErrorReportLocation errorReportLocation, required List< File> files, required String jobName, required String jobRoleArn, bool? adaptiveIngestion, String? datasetId, bool? deleteFilesAfterImport, JobConfiguration? jobConfiguration, String? workspaceName}) → Future<CreateBulkImportJobResponse> - Defines a job to ingest data to IoT SiteWise from Amazon S3. For more information, see Create a bulk import job (CLI) in the Amazon Simple Storage Service User Guide.
-
createComputationModel(
{required ComputationModelConfiguration computationModelConfiguration, required Map< String, ComputationModelDataBindingValue> computationModelDataBinding, required String computationModelName, String? clientToken, String? computationModelDescription, Map<String, String> ? tags}) → Future<CreateComputationModelResponse> - Create a computation model with a configuration and data binding.
-
createDashboard(
{required String dashboardDefinition, required String dashboardName, required String projectId, String? clientToken, String? dashboardDescription, Map< String, String> ? tags}) → Future<CreateDashboardResponse> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
createDataset(
{required String datasetName, required DatasetSource datasetSource, String? clientToken, DatasetConfig? datasetConfig, String? datasetDescription, String? datasetId, DatasetTypeEnum? datasetType, Map< String, String> ? metadata, Map<String, String> ? tags, String? workspaceName}) → Future<CreateDatasetResponse> - Creates a dataset. Session and curated datasets are created in a workspace. A session dataset contains data segments of time series data, and a curated dataset curates data segments selected from source session datasets. A dataset that connects to an external datasource is created outside of a workspace.
-
createDatasetExportJob(
{required String destinationS3Uri, required ExportErrorReportLocation errorReportLocation, required ProcessingInput input, required String workspaceName, String? clientToken}) → Future< CreateDatasetExportJobResponse> - Starts an asynchronous job that exports dataset and time-series data from a workspace to Amazon S3. The operation returns a jobId immediately; poll DescribeDatasetExportJob to track progress and ListDatasetExportJobs to enumerate a workspace's jobs.
-
createEnrichmentJob(
{required EnrichmentJobConfiguration jobConfiguration, required String workspaceName, String? clientToken}) → Future< CreateEnrichmentJobResponse> - Creates an asynchronous enrichment job to analyze time-series sensor data. The operation returns immediately with job details while processing continues in the background.
-
createGateway(
{required String gatewayName, required GatewayPlatform gatewayPlatform, String? gatewayVersion, Map< String, String> ? tags}) → Future<CreateGatewayResponse> - Creates a gateway, which is a virtual or edge device that delivers industrial data streams from local servers to IoT SiteWise. For more information, see Ingesting data using a gateway in the IoT SiteWise User Guide.
-
createPipeline(
{required List< ComputeNode> computations, required String pipelineName, required String workspaceName, String? clientToken, String? description, Map<String, String> ? environmentVariables, Map<String, String> ? tags}) → Future<CreatePipelineResponse> - Creates a new pipeline in the specified workspace. A pipeline defines a directed acyclic graph (DAG) of compute nodes, where each node references a task and can declare dependencies on other nodes. Cyclic dependencies are not allowed. Nodes without dependencies run in parallel, while nodes with dependencies wait for all upstream nodes to complete successfully before starting.
-
createPortal(
{required String portalContactEmail, required String portalName, required String roleArn, Alarms? alarms, String? clientToken, String? notificationSenderEmail, AuthMode? portalAuthMode, String? portalDescription, ImageFile? portalLogoImageFile, PortalType? portalType, Map< String, PortalTypeEntry> ? portalTypeConfiguration, Map<String, String> ? tags}) → Future<CreatePortalResponse> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
createProject(
{required String portalId, required String projectName, String? clientToken, String? projectDescription, Map< String, String> ? tags}) → Future<CreateProjectResponse> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
createTask(
{required TaskConfiguration taskConfiguration, required String taskName, required String workspaceName, String? clientToken, String? description, Map< String, String> ? tags}) → Future<CreateTaskResponse> - Creates a new task in the specified workspace. A task defines a reusable containerized compute workload that can be referenced by one or more pipeline compute nodes.
-
createWorkspace(
{required WorkspaceEncryptionConfiguration encryptionConfiguration, required String workspaceName, String? clientToken, Map< String, String> ? tags, String? workspaceDescription}) → Future<CreateWorkspaceResponse> -
Creates a workspace in IoT SiteWise. A workspace isolates its resources,
such as datasets, time series, pipelines, and tasks, and their data from
other workspaces, and has its own quotas and throttling limits. You must
specify an encryption configuration when you create a workspace. The
operation returns immediately with the workspace in the
CREATINGstate. Provisioning completes asynchronously, after which the workspace state isACTIVE, orFAILEDif provisioning doesn't complete. -
deleteAccessPolicy(
{required String accessPolicyId, String? clientToken}) → Future< void> - Deletes an access policy that grants the specified identity access to the specified IoT SiteWise Monitor resource. You can use this operation to revoke access to an IoT SiteWise Monitor resource.
-
deleteApplication(
{required String id, required String workspaceName}) → Future< void> - Deletes an application by ID
-
deleteAsset(
{required String assetId, String? clientToken}) → Future< DeleteAssetResponse> - Deletes an asset. This action can't be undone. For more information, see Deleting assets and models in the IoT SiteWise User Guide.
-
deleteAssetModel(
{required String assetModelId, String? clientToken, String? ifMatch, String? ifNoneMatch, AssetModelVersionType? matchForVersionType}) → Future< DeleteAssetModelResponse> - Deletes an asset model. This action can't be undone. You must delete all assets created from an asset model before you can delete the model. Also, you can't delete an asset model if a parent asset model exists that contains a property formula expression that depends on the asset model that you want to delete. For more information, see Deleting assets and models in the IoT SiteWise User Guide.
-
deleteAssetModelCompositeModel(
{required String assetModelCompositeModelId, required String assetModelId, String? clientToken, String? ifMatch, String? ifNoneMatch, AssetModelVersionType? matchForVersionType}) → Future< DeleteAssetModelCompositeModelResponse> - Deletes a composite model. This action can't be undone. You must delete all assets created from a composite model before you can delete the model. Also, you can't delete a composite model if a parent asset model exists that contains a property formula expression that depends on the asset model that you want to delete. For more information, see Deleting assets and models in the IoT SiteWise User Guide.
-
deleteAssetModelInterfaceRelationship(
{required String assetModelId, required String interfaceAssetModelId, String? clientToken}) → Future< DeleteAssetModelInterfaceRelationshipResponse> - Deletes an interface relationship between an asset model and an interface asset model.
-
deleteComputationModel(
{required String computationModelId, String? clientToken}) → Future< DeleteComputationModelResponse> - Deletes a computation model. This action can't be undone.
-
deleteDashboard(
{required String dashboardId, String? clientToken}) → Future< void> - Deletes a dashboard from IoT SiteWise Monitor.
-
deleteDataset(
{required String datasetId, String? clientToken, String? workspaceName}) → Future< DeleteDatasetResponse> - Deletes a dataset. This can't be undone. Deleting a session dataset also deletes the underlying time series data in the session. You can't delete a session dataset while a curated dataset references its data segments. First delete the curated dataset or disassociate the data segments. Deleting a curated dataset doesn't delete the underlying data in the source session datasets.
-
deleteGateway(
{required String gatewayId}) → Future< void> - Deletes a gateway from IoT SiteWise. When you delete a gateway, some of the gateway's files remain in your gateway's file system.
-
deletePipeline(
{required String pipelineName, required String workspaceName}) → Future< DeletePipelineResponse> - Deletes a pipeline from the specified workspace. A pipeline cannot be deleted if it has any active executions. Wait for all executions to complete before attempting to delete the pipeline, or use CancelPipelineExecution to stop a running execution.
-
deletePortal(
{required String portalId, String? clientToken}) → Future< DeletePortalResponse> - Deletes a portal from IoT SiteWise Monitor.
-
deleteProject(
{required String projectId, String? clientToken}) → Future< void> - Deletes a project from IoT SiteWise Monitor.
-
deleteTask(
{required String taskName, required String workspaceName}) → Future< DeleteTaskResponse> - Deletes a task from the specified workspace. A task cannot be deleted if it is currently referenced by any existing pipeline. Remove the task from all pipelines before attempting to delete it.
-
deleteTimeSeries(
{String? alias, String? assetId, String? clientToken, String? propertyId, String? workspaceName}) → Future< void> - Deletes a time series (data stream). If you delete a time series that's associated with an asset property, the asset property still exists, but the time series will no longer be associated with this asset property. You can't delete a time series until all of its data segments have been deleted from session datasets.
-
deleteWorkspace(
{required String workspaceName, String? clientToken}) → Future< DeleteWorkspaceResponse> - Deletes a workspace. Before you delete a workspace, you must delete all resources contained in or associated with the workspace, such as datasets, time series, pipelines, and tasks.
-
describeAccessPolicy(
{required String accessPolicyId}) → Future< DescribeAccessPolicyResponse> - Describes an access policy, which specifies an identity's access to an IoT SiteWise Monitor portal or project.
-
describeAction(
{required String actionId}) → Future< DescribeActionResponse> - Retrieves information about an action.
-
describeApplication(
{required String id, required String workspaceName}) → Future< DescribeApplicationResponse> - Retrieves Application details based on the ID
-
describeAsset(
{required String assetId, bool? excludeProperties}) → Future< DescribeAssetResponse> - Retrieves information about an asset.
-
describeAssetCompositeModel(
{required String assetCompositeModelId, required String assetId}) → Future< DescribeAssetCompositeModelResponse> -
Retrieves information about an asset composite model (also known as an
asset component). An
AssetCompositeModelis an instance of anAssetModelCompositeModel. If you want to see information about the model this is based on, call DescribeAssetModelCompositeModel. -
describeAssetModel(
{required String assetModelId, String? assetModelVersion, bool? excludeProperties}) → Future< DescribeAssetModelResponse> - Retrieves information about an asset model. This includes details about the asset model's properties, hierarchies, composite models, and any interface relationships if the asset model implements interfaces.
-
describeAssetModelCompositeModel(
{required String assetModelCompositeModelId, required String assetModelId, String? assetModelVersion}) → Future< DescribeAssetModelCompositeModelResponse> - Retrieves information about an asset model composite model (also known as an asset model component). For more information, see Custom composite models (Components) in the IoT SiteWise User Guide.
-
describeAssetModelInterfaceRelationship(
{required String assetModelId, required String interfaceAssetModelId}) → Future< DescribeAssetModelInterfaceRelationshipResponse> - Retrieves information about an interface relationship between an asset model and an interface asset model.
-
describeAssetProperty(
{required String assetId, required String propertyId}) → Future< DescribeAssetPropertyResponse> - Retrieves information about an asset property. This operation doesn't return the value of the asset property. To get the value of an asset property, use GetAssetPropertyValue.
-
describeBulkImportJob(
{required String jobId, String? workspaceName}) → Future< DescribeBulkImportJobResponse> - Retrieves information about a bulk import job request. For more information, see Describe a bulk import job (CLI) in the Amazon Simple Storage Service User Guide.
-
describeComputationModel(
{required String computationModelId, String? computationModelVersion}) → Future< DescribeComputationModelResponse> - Retrieves information about a computation model.
-
describeComputationModelExecutionSummary(
{required String computationModelId, String? resolveToResourceId, ResolveToResourceType? resolveToResourceType}) → Future< DescribeComputationModelExecutionSummaryResponse> - Retrieves information about the execution summary of a computation model.
-
describeDashboard(
{required String dashboardId}) → Future< DescribeDashboardResponse> - Retrieves information about a dashboard.
-
describeDataset(
{required String datasetId, String? datasetVersion, String? workspaceName}) → Future< DescribeDatasetResponse> - Retrieves information about a dataset.
-
describeDatasetExportJob(
{required String jobId, required String workspaceName}) → Future< DescribeDatasetExportJobResponse> - Retrieves information about a dataset export job.
-
describeDefaultEncryptionConfiguration(
) → Future< DescribeDefaultEncryptionConfigurationResponse> - Retrieves information about the default encryption configuration for the Amazon Web Services account in the default or specified Region. For more information, see Key management in the IoT SiteWise User Guide.
-
describeEnrichmentJob(
{required String jobId, required String workspaceName}) → Future< DescribeEnrichmentJobResponse> - Retrieves detailed information about a specific enrichment job, including its current status, configuration, and timestamps.
-
describeExecution(
{required String executionId}) → Future< DescribeExecutionResponse> - Retrieves information about the execution.
-
describeGateway(
{required String gatewayId}) → Future< DescribeGatewayResponse> - Retrieves information about a gateway.
-
describeGatewayCapabilityConfiguration(
{required String capabilityNamespace, required String gatewayId}) → Future< DescribeGatewayCapabilityConfigurationResponse> - Each gateway capability defines data sources for a gateway. This is the namespace of the gateway capability.
-
describeLoggingOptions(
{String? workspaceName}) → Future< DescribeLoggingOptionsResponse> - Retrieves the current IoT SiteWise logging options.
-
describePipeline(
{required String pipelineName, required String workspaceName, String? pipelineVersion}) → Future< DescribePipelineResponse> - Retrieves detailed information about a specific pipeline in a workspace.
-
describePipelineExecution(
{required String pipelineExecutionId, required String pipelineName, required String workspaceName, int? maxResults, String? nextToken}) → Future< DescribePipelineExecutionResponse> - Retrieves detailed information about a specific pipeline execution, including the overall execution status and the status of each individual compute node. Use this operation to monitor execution progress and inspect per-node results, environment variables, and error details.
-
describePortal(
{required String portalId}) → Future< DescribePortalResponse> - Retrieves information about a portal.
-
describeProject(
{required String projectId}) → Future< DescribeProjectResponse> - Retrieves information about a project.
-
describeQuery(
{required String queryId, required String workspaceName}) → Future< DescribeQueryResponse> - Retrieves information about a query, including its status.
-
describeSearch(
{required String searchId, required String workspaceName}) → Future< DescribeSearchResponse> -
Returns the current status and metadata of a single search, including the
query that was submitted, the search type, and — when the search has
failed — the reason. Use this to poll a search started with
StartSearchuntil it reaches a terminal status (SUCCEEDEDorFAILED). -
describeStorageConfiguration(
) → Future< DescribeStorageConfigurationResponse> - Retrieves information about the storage configuration for IoT SiteWise.
-
describeTask(
{required String taskName, required String workspaceName, String? taskVersion}) → Future< DescribeTaskResponse> - Retrieves detailed information about a specific task in a workspace.
-
describeTimeSeries(
{String? alias, String? assetId, String? propertyId, String? workspaceName}) → Future< DescribeTimeSeriesResponse> - Retrieves information about a time series (data stream).
-
describeWorkspace(
{required String workspaceName}) → Future< DescribeWorkspaceResponse> - Retrieves information about a workspace.
-
disassociateAssets(
{required String assetId, required String childAssetId, required String hierarchyId, String? clientToken}) → Future< void> - Disassociates a child asset from the given parent asset through a hierarchy defined in the parent asset's model.
-
disassociateTimeSeriesFromAssetProperty(
{required String alias, required String assetId, required String propertyId, String? clientToken}) → Future< void> - Disassociates a time series (data stream) from an asset property.
-
executeAction(
{required String actionDefinitionId, required ActionPayload actionPayload, required TargetResource targetResource, String? clientToken, ResolveTo? resolveTo}) → Future< ExecuteActionResponse> - Executes an action on a target resource.
-
executeQuery(
{required String queryStatement, String? clientToken, int? maxResults, String? nextToken}) → Future< ExecuteQueryResponse> - Run SQL queries to retrieve metadata and time-series data from asset models, assets, measurements, metrics, transforms, and aggregates.
-
getAssetPropertyAggregates(
{required List< AggregateType> aggregateTypes, required DateTime endDate, required String resolution, required DateTime startDate, String? assetId, int? maxResults, String? nextToken, String? propertyAlias, String? propertyId, List<Quality> ? qualities, TimeOrdering? timeOrdering}) → Future<GetAssetPropertyAggregatesResponse> - Gets aggregated values for an asset property. For more information, see Querying aggregates in the IoT SiteWise User Guide.
-
getAssetPropertyValue(
{String? assetId, String? propertyAlias, String? propertyId}) → Future< GetAssetPropertyValueResponse> - Gets an asset property's current value. For more information, see Querying current values in the IoT SiteWise User Guide.
-
getAssetPropertyValueHistory(
{String? assetId, DateTime? endDate, int? maxResults, String? nextToken, String? propertyAlias, String? propertyId, List< Quality> ? qualities, DateTime? startDate, TimeOrdering? timeOrdering}) → Future<GetAssetPropertyValueHistoryResponse> - Gets the history of an asset property's values. For more information, see Querying historical values in the IoT SiteWise User Guide.
-
getCaptureData(
{required TimeInNanos endTime, required TimeInNanos startTime, required String workspaceName, FormatSettings? formatSettings, String? nextToken, String? propertyAlias, String? timeSeriesId}) → Future< GetCaptureDataResponse> - Retrieves video data for a specific time range.
-
getInterpolatedAssetPropertyValues(
{required int endTimeInSeconds, required int intervalInSeconds, required Quality quality, required int startTimeInSeconds, required String type, String? assetId, int? endTimeOffsetInNanos, int? intervalWindowInSeconds, int? maxResults, String? nextToken, String? propertyAlias, String? propertyId, int? startTimeOffsetInNanos}) → Future< GetInterpolatedAssetPropertyValuesResponse> - Get interpolated values for an asset property for a specified time interval, during a period of time. If your time series is missing data points during the specified time interval, you can use interpolation to estimate the missing data.
-
getQueryResults(
{required String queryId, required String workspaceName, int? maxResults, String? nextToken}) → Future< GetQueryResultsResponse> - Retrieves the paginated results of a query. Returns empty rows if the query is not yet complete.
-
getSearchResults(
{required String searchId, required String workspaceName, int? maxResults, String? nextToken}) → Future< GetSearchResultsResponse> -
Retrieves the ranked results of a search, ordered by descending relevance
score. Results are available only after the search has reached the
SUCCEEDEDstatus. Calling this on a search that exists but has not yet completed returnsInvalidRequestException, while calling it on a search that does not exist returnsResourceNotFoundException. The response is paginated: whennextTokenis present, pass it on a subsequent call to retrieve the next page. -
invokeAssistant(
{required String message, String? conversationId, bool? enableTrace}) → Future< InvokeAssistantResponse> - Invokes SiteWise Assistant to start or continue a conversation.
-
listAccessPolicies(
{String? iamArn, String? identityId, IdentityType? identityType, int? maxResults, String? nextToken, String? resourceId, ResourceType? resourceType}) → Future< ListAccessPoliciesResponse> - Retrieves a paginated list of access policies for an identity (an IAM Identity Center user, an IAM Identity Center group, or an IAM user) or an IoT SiteWise Monitor resource (a portal or project).
-
listActions(
{required String targetResourceId, required TargetResourceType targetResourceType, int? maxResults, String? nextToken, String? resolveToResourceId, ResolveToResourceType? resolveToResourceType}) → Future< ListActionsResponse> - Retrieves a paginated list of actions for a specific target resource.
-
listApplications(
{int? maxResults, String? nextToken}) → Future< ListApplicationsResponse> - Retrieves a paginated list of existing applications
-
listAssetModelCompositeModels(
{required String assetModelId, String? assetModelVersion, int? maxResults, String? nextToken}) → Future< ListAssetModelCompositeModelsResponse> - Retrieves a paginated list of composite models associated with the asset model
-
listAssetModelProperties(
{required String assetModelId, String? assetModelVersion, ListAssetModelPropertiesFilter? filter, int? maxResults, String? nextToken}) → Future< ListAssetModelPropertiesResponse> - Retrieves a paginated list of properties associated with an asset model. If you update properties associated with the model before you finish listing all the properties, you need to start all over again.
-
listAssetModels(
{List< AssetModelType> ? assetModelTypes, String? assetModelVersion, int? maxResults, String? nextToken}) → Future<ListAssetModelsResponse> - Retrieves a paginated list of summaries of all asset models.
-
listAssetProperties(
{required String assetId, ListAssetPropertiesFilter? filter, int? maxResults, String? nextToken}) → Future< ListAssetPropertiesResponse> - Retrieves a paginated list of properties associated with an asset. If you update properties associated with the model before you finish listing all the properties, you need to start all over again.
-
listAssetRelationships(
{required String assetId, required TraversalType traversalType, int? maxResults, String? nextToken}) → Future< ListAssetRelationshipsResponse> - Retrieves a paginated list of asset relationships for an asset. You can use this operation to identify an asset's root asset and all associated assets between that asset and its root.
-
listAssets(
{String? assetModelId, ListAssetsFilter? filter, int? maxResults, String? nextToken}) → Future< ListAssetsResponse> - Retrieves a paginated list of asset summaries.
-
listAssociatedAssets(
{required String assetId, String? hierarchyId, int? maxResults, String? nextToken, TraversalDirection? traversalDirection}) → Future< ListAssociatedAssetsResponse> - Retrieves a paginated list of associated assets.
-
listBulkImportJobs(
{ListBulkImportJobsFilter? filter, int? maxResults, String? nextToken, String? workspaceName}) → Future< ListBulkImportJobsResponse> - Retrieves a paginated list of bulk import job requests. For more information, see List bulk import jobs (CLI) in the IoT SiteWise User Guide.
-
listCompositionRelationships(
{required String assetModelId, int? maxResults, String? nextToken}) → Future< ListCompositionRelationshipsResponse> -
Retrieves a paginated list of composition relationships for an asset model
of type
COMPONENT_MODEL. -
listComputationModelDataBindingUsages(
{required DataBindingValueFilter dataBindingValueFilter, int? maxResults, String? nextToken}) → Future< ListComputationModelDataBindingUsagesResponse> - Lists all data binding usages for computation models. This allows to identify where specific data bindings are being utilized across the computation models. This track dependencies between data sources and computation models.
-
listComputationModelResolveToResources(
{required String computationModelId, int? maxResults, String? nextToken}) → Future< ListComputationModelResolveToResourcesResponse> - Lists all distinct resources that are resolved from the executed actions of the computation model.
-
listComputationModels(
{ComputationModelType? computationModelType, int? maxResults, String? nextToken}) → Future< ListComputationModelsResponse> - Retrieves a paginated list of summaries of all computation models.
-
listDashboards(
{required String projectId, int? maxResults, String? nextToken}) → Future< ListDashboardsResponse> - Retrieves a paginated list of dashboards for an IoT SiteWise Monitor project.
-
listDatasetDataSegmentRelationships(
{required String datasetId, required String workspaceName, int? maxResults, String? nextToken}) → Future< ListDatasetDataSegmentRelationshipsResponse> -
Retrieves a paginated list of data segment relationships for a session
dataset. Use this operation to find the curated datasets that reference
data segments of the specified session dataset. Use the
nextTokenparameter to retrieve additional results. -
listDatasetDataSegments(
{required String datasetId, required String workspaceName, String? datasetVersion, int? maxResults, String? nextToken}) → Future< ListDatasetDataSegmentsResponse> -
Retrieves a paginated list of data segments associated with a dataset. Use
the
nextTokenparameter to retrieve additional results. -
listDatasetExportJobs(
{required String workspaceName, DatasetExportJobFilter? filter, int? maxResults, String? nextToken}) → Future< ListDatasetExportJobsResponse> - Retrieves a paginated list of dataset export jobs for a workspace.
-
listDatasets(
{required DatasetSourceType sourceType, DatasetTypeEnum? datasetType, int? maxResults, String? nextToken, String? workspaceName}) → Future< ListDatasetsResponse> - Retrieves a paginated list of datasets for a specific target resource.
-
listEnrichmentJobs(
{required String workspaceName, String? datasetId, DateTime? endDate, JobType? jobType, int? maxResults, String? nextToken, String? propertyAlias, DateTime? startDate, EnrichmentJobStatus? status, String? timeSeriesId}) → Future< ListEnrichmentJobsResponse> - Lists enrichment jobs within a workspace with optional filtering and pagination. Results are ordered by createdAt timestamp descending (newest first).
-
listExecutions(
{required String targetResourceId, required TargetResourceType targetResourceType, String? actionType, int? maxResults, String? nextToken, String? resolveToResourceId, ResolveToResourceType? resolveToResourceType}) → Future< ListExecutionsResponse> - Retrieves a paginated list of summaries of all executions.
-
listGateways(
{int? maxResults, String? nextToken}) → Future< ListGatewaysResponse> - Retrieves a paginated list of gateways.
-
listInterfaceRelationships(
{required String interfaceAssetModelId, int? maxResults, String? nextToken}) → Future< ListInterfaceRelationshipsResponse> - Retrieves a paginated list of asset models that have a specific interface asset model applied to them.
-
listPipelineExecutions(
{required String pipelineName, required String workspaceName, DateTime? endTimeAfter, DateTime? endTimeBefore, int? maxResults, String? nextToken, DateTime? startTimeAfter, DateTime? startTimeBefore, PipelineExecutionState? state}) → Future< ListPipelineExecutionsResponse> - Lists pipeline executions for a specific pipeline in a workspace. Supports filtering by state and time range. State can be combined with either startTime or endTime filters. Time range filters are grouped: use startTime filters (startTimeAfter, startTimeBefore) or endTime filters (endTimeAfter, endTimeBefore), but not both. Combining startTime and endTime filters returns an InvalidRequestException. Note: endTime filters only return executions in terminal states, as in-progress executions have no endTime.
-
listPipelines(
{required String workspaceName, int? maxResults, String? nextToken}) → Future< ListPipelinesResponse> - Lists pipelines in a workspace. To get complete details about a pipeline, use DescribePipeline.
-
listPortals(
{int? maxResults, String? nextToken}) → Future< ListPortalsResponse> - Retrieves a paginated list of IoT SiteWise Monitor portals.
-
listProjectAssets(
{required String projectId, int? maxResults, String? nextToken}) → Future< ListProjectAssetsResponse> - Retrieves a paginated list of assets associated with an IoT SiteWise Monitor project.
-
listProjects(
{required String portalId, int? maxResults, String? nextToken}) → Future< ListProjectsResponse> - Retrieves a paginated list of projects for an IoT SiteWise Monitor portal.
-
listQueries(
{required String workspaceName, String? filter, int? maxResults, String? nextToken}) → Future< ListQueriesResponse> - Retrieves a paginated list of queries for a workspace.
-
listSearches(
{required String workspaceName, ListSearchesFilters? listSearchesFilters, int? maxResults, String? nextToken}) → Future< ListSearchesResponse> -
Lists the searches in a workspace, most recently started first. Results
can be narrowed with optional filters (status, search type, group, and
started-at time range) and are paginated: when
nextTokenis present, pass it on a subsequent call to retrieve the next page. -
listTagsForResource(
{required String resourceArn}) → Future< ListTagsForResourceResponse> - Retrieves the list of tags for an IoT SiteWise resource.
-
listTasks(
{required String workspaceName, int? maxResults, String? nextToken}) → Future< ListTasksResponse> - Lists tasks in a workspace. To get complete details about a task, use DescribeTask.
-
listTimeSeries(
{String? aliasPrefix, String? assetId, int? maxResults, String? nextToken, ListTimeSeriesType? timeSeriesType, String? workspaceName}) → Future< ListTimeSeriesResponse> - Retrieves a paginated list of time series (data streams).
-
listWorkspaces(
{int? maxResults, String? nextToken}) → Future< ListWorkspacesResponse> -
Retrieves a paginated list of workspaces. Use the
nextTokenparameter to retrieve additional results. -
noSuchMethod(
Invocation invocation) → dynamic -
Invoked when a nonexistent method or property is accessed.
inherited
-
putAssetModelInterfaceRelationship(
{required String assetModelId, required String interfaceAssetModelId, required PropertyMappingConfiguration propertyMappingConfiguration, String? clientToken}) → Future< PutAssetModelInterfaceRelationshipResponse> - Creates or updates an interface relationship between an asset model and an interface asset model. This operation applies an interface to an asset model.
-
putDefaultEncryptionConfiguration(
{required EncryptionType encryptionType, String? kmsKeyId}) → Future< PutDefaultEncryptionConfigurationResponse> - Sets the default encryption configuration for the Amazon Web Services account. For more information, see Key management in the IoT SiteWise User Guide.
-
putLoggingOptions(
{required LoggingOptions loggingOptions, String? workspaceName}) → Future< void> - Sets logging options for IoT SiteWise.
-
putStorageConfiguration(
{required StorageType storageType, bool? disallowIngestNullNaN, DisassociatedDataStorageState? disassociatedDataStorage, MultiLayerStorage? multiLayerStorage, RetentionPeriod? retentionPeriod, WarmTierState? warmTier, WarmTierRetentionPeriod? warmTierRetentionPeriod}) → Future< PutStorageConfigurationResponse> - Configures storage settings for IoT SiteWise.
-
startPipelineExecution(
{required String pipelineName, required String workspaceName, String? clientToken, ExecutionEnvironmentVariables? executionEnvironmentVariableOverrides, int? executionPriority}) → Future< StartPipelineExecutionResponse> - Starts execution of a pipeline in the specified workspace. Each compute node runs according to the DAG dependency order defined in the pipeline. Nodes without dependencies start immediately, while dependent nodes wait for all upstream nodes to complete successfully.
-
startQuery(
{required String queryStatement, required String workspaceName, String? clientToken}) → Future< StartQueryResponse> - Starts an asynchronous SQL query against workspace telemetry, annotations, data segment, and dataset data.
-
startSearch(
{required String queryStatement, required String workspaceName, String? clientToken, String? groupId, SearchFilters? searchFilters, SearchType? searchType}) → Future< StartSearchResponse> -
Starts an asynchronous search over the data in a workspace. The search
runs in the background; the response returns immediately with a
searchIdand an initial status ofQUEUED. UseDescribeSearchto poll for completion andGetSearchResultsto retrieve the results once the search reachesSUCCEEDED. The request is idempotent onclientToken: repeating a call with the same token returns the original search instead of starting a new one. -
tagResource(
{required String resourceArn, required Map< String, String> tags}) → Future<void> - Adds tags to an IoT SiteWise resource. If a tag already exists for the resource, this operation updates the tag's value.
-
toString(
) → String -
A string representation of this object.
inherited
-
untagResource(
{required String resourceArn, required List< String> tagKeys}) → Future<void> - Removes a tag from an IoT SiteWise resource.
-
updateAccessPolicy(
{required String accessPolicyId, required Identity accessPolicyIdentity, required Permission accessPolicyPermission, required Resource accessPolicyResource, String? clientToken}) → Future< void> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
updateAsset(
{required String assetId, required String assetName, String? assetDescription, String? assetExternalId, String? clientToken}) → Future< UpdateAssetResponse> - Updates an asset's name. For more information, see Updating assets and models in the IoT SiteWise User Guide.
-
updateAssetModel(
{required String assetModelId, required String assetModelName, List< AssetModelCompositeModel> ? assetModelCompositeModels, String? assetModelDescription, String? assetModelExternalId, List<AssetModelHierarchy> ? assetModelHierarchies, List<AssetModelProperty> ? assetModelProperties, String? clientToken, String? ifMatch, String? ifNoneMatch, AssetModelVersionType? matchForVersionType}) → Future<UpdateAssetModelResponse> - Updates an asset model and all of the assets that were created from the model. Each asset created from the model inherits the updated asset model's property and hierarchy definitions. For more information, see Updating assets and models in the IoT SiteWise User Guide.
-
updateAssetModelCompositeModel(
{required String assetModelCompositeModelId, required String assetModelCompositeModelName, required String assetModelId, String? assetModelCompositeModelDescription, String? assetModelCompositeModelExternalId, List< AssetModelProperty> ? assetModelCompositeModelProperties, String? clientToken, String? ifMatch, String? ifNoneMatch, AssetModelVersionType? matchForVersionType}) → Future<UpdateAssetModelCompositeModelResponse> - Updates a composite model and all of the assets that were created from the model. Each asset created from the model inherits the updated asset model's property and hierarchy definitions. For more information, see Updating assets and models in the IoT SiteWise User Guide.
-
updateAssetProperty(
{required String assetId, required String propertyId, String? clientToken, String? propertyAlias, PropertyNotificationState? propertyNotificationState, String? propertyUnit}) → Future< void> - Updates an asset property's alias and notification state.
-
updateComputationModel(
{required ComputationModelConfiguration computationModelConfiguration, required Map< String, ComputationModelDataBindingValue> computationModelDataBinding, required String computationModelId, required String computationModelName, String? clientToken, String? computationModelDescription}) → Future<UpdateComputationModelResponse> - Updates the computation model.
-
updateDashboard(
{required String dashboardDefinition, required String dashboardId, required String dashboardName, String? clientToken, String? dashboardDescription}) → Future< void> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
updateDataset(
{required String datasetId, required String datasetName, required DatasetSource datasetSource, String? clientToken, DatasetConfig? datasetConfig, String? datasetDescription, Map< String, String> ? metadata, String? workspaceName}) → Future<UpdateDatasetResponse> - Updates a dataset.
-
updateGateway(
{required String gatewayId, required String gatewayName}) → Future< void> - Updates a gateway's name.
-
updateGatewayCapabilityConfiguration(
{required String capabilityConfiguration, required String capabilityNamespace, required String gatewayId}) → Future< UpdateGatewayCapabilityConfigurationResponse> - Updates a gateway capability configuration or defines a new capability configuration. Each gateway capability defines data sources for a gateway.
-
updatePipeline(
{required String pipelineName, required String workspaceName, List< ComputeNode> ? computations, String? description, Map<String, String> ? environmentVariables}) → Future<UpdatePipelineResponse> - Updates an existing pipeline in the specified workspace. Only the fields provided in the request are updated; fields not included in the request are preserved unchanged. You can update the pipeline description, environment variables, and the list of compute nodes independently.
-
updatePortal(
{required String portalContactEmail, required String portalId, required String portalName, required String roleArn, Alarms? alarms, String? clientToken, String? notificationSenderEmail, String? portalDescription, Image? portalLogoImage, PortalType? portalType, Map< String, PortalTypeEntry> ? portalTypeConfiguration}) → Future<UpdatePortalResponse> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
updateProject(
{required String projectId, required String projectName, String? clientToken, String? projectDescription}) → Future< void> - The IoT SiteWise Monitor feature will no longer be open to new customers starting November 7, 2025. If you would like to use the IoT SiteWise Monitor feature, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see IoT SiteWise Monitor availability change.
-
updateTask(
{required String taskName, required String workspaceName, String? description, TaskConfiguration? taskConfiguration}) → Future< UpdateTaskResponse> - Updates an existing task in the specified workspace. Only the fields provided in the request are updated; fields not included in the request are preserved unchanged.
-
updateWorkspace(
{required String workspaceName, String? clientToken, WorkspaceEncryptionConfiguration? encryptionConfiguration, String? workspaceDescription}) → Future< UpdateWorkspaceResponse> -
Updates a workspace. You can update only workspaces in the
ACTIVEorFAILEDstate. Fields that you omit from the request are left unchanged. To recover a workspace in theFAILEDstate, call this operation and supply its encryption configuration again.
Operators
-
operator ==(
Object other) → bool -
The equality operator.
inherited