IotSiteWiseClient

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.

Properties

Link copied to clipboard
abstract override val config: IotSiteWiseClient.Config

IotSiteWiseClient's configuration

Functions

Link copied to clipboard

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.

Link copied to clipboard

Associates a time series (data stream) with an asset property.

Link copied to clipboard

Associates a group (batch) of assets with an IoT SiteWise Monitor project.

Link copied to clipboard

Disassociates a group (batch) of assets from an IoT SiteWise Monitor project.

Link copied to clipboard

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.

Link copied to clipboard

Gets the current value for one or more asset properties. For more information, see Querying current values in the IoT SiteWise User Guide.

Link copied to clipboard

Gets the historical values for one or more asset properties. For more information, see Querying historical values in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard

Creates an access policy that grants the specified identity (IAM Identity Center user, IAM Identity Center group, or IAM user) access to the specified IoT SiteWise Monitor portal or project resource.

Link copied to clipboard
abstract suspend fun createAsset(input: CreateAssetRequest): CreateAssetResponse

Creates an asset from an existing asset model. For more information, see Creating assets in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard

Creates a custom composite model from specified property and hierarchy definitions. There are two types of custom composite models, inline and component-model-based.

Link copied to clipboard

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.

Link copied to clipboard

Creates a dashboard in an IoT SiteWise Monitor project.

Link copied to clipboard

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.

Link copied to clipboard

Creates a portal, which can contain projects and dashboards. IoT SiteWise Monitor uses IAM Identity Center or IAM to authenticate portal users and manage user permissions.

Link copied to clipboard

Creates a project in the specified portal.

Link copied to clipboard

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.

Link copied to clipboard
abstract suspend fun deleteAsset(input: DeleteAssetRequest): DeleteAssetResponse

Deletes an asset. This action can't be undone. For more information, see Deleting assets and models in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Deletes a dashboard from IoT SiteWise Monitor.

Link copied to clipboard

Deletes a gateway from IoT SiteWise. When you delete a gateway, some of the gateway's files remain in your gateway's file system.

Link copied to clipboard

Deletes a portal from IoT SiteWise Monitor.

Link copied to clipboard

Deletes a project from IoT SiteWise Monitor.

Link copied to clipboard
abstract suspend fun deleteTimeSeries(input: DeleteTimeSeriesRequest = DeleteTimeSeriesRequest { }): DeleteTimeSeriesResponse

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.

Link copied to clipboard

Describes an access policy, which specifies an identity's access to an IoT SiteWise Monitor portal or project.

Link copied to clipboard

Retrieves information about an action.

Link copied to clipboard

Retrieves information about an asset.

Link copied to clipboard

Retrieves information about an asset composite model (also known as an asset component). An AssetCompositeModel is an instance of an AssetModelCompositeModel. If you want to see information about the model this is based on, call DescribeAssetModelCompositeModel.

Link copied to clipboard

Retrieves information about an asset model.

Link copied to clipboard

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.

Link copied to clipboard

Retrieves information about an asset property.

Link copied to clipboard

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.

Link copied to clipboard

Retrieves information about a dashboard.

Link copied to clipboard

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.

Link copied to clipboard

Retrieves information about a gateway.

Link copied to clipboard

Retrieves information about a gateway capability configuration. Each gateway capability defines data sources for a gateway. A capability configuration can contain multiple data source configurations. If you define OPC-UA sources for a gateway in the IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To list all capability configurations for a gateway, use DescribeGateway.

Link copied to clipboard
abstract suspend fun describeLoggingOptions(input: DescribeLoggingOptionsRequest = DescribeLoggingOptionsRequest { }): DescribeLoggingOptionsResponse

Retrieves the current IoT SiteWise logging options.

Link copied to clipboard

Retrieves information about a portal.

Link copied to clipboard

Retrieves information about a project.

Link copied to clipboard
abstract suspend fun describeStorageConfiguration(input: DescribeStorageConfigurationRequest = DescribeStorageConfigurationRequest { }): DescribeStorageConfigurationResponse

Retrieves information about the storage configuration for IoT SiteWise.

Link copied to clipboard
abstract suspend fun describeTimeSeries(input: DescribeTimeSeriesRequest = DescribeTimeSeriesRequest { }): DescribeTimeSeriesResponse

Retrieves information about a time series (data stream).

Link copied to clipboard

Disassociates a child asset from the given parent asset through a hierarchy defined in the parent asset's model.

Link copied to clipboard

Disassociates a time series (data stream) from an asset property.

Link copied to clipboard

Executes an action on a target resource.

Link copied to clipboard

Run SQL queries to retrieve metadata and time-series data from asset models, assets, measurements, metrics, transforms, and aggregates.

Link copied to clipboard

Gets aggregated values for an asset property. For more information, see Querying aggregates in the IoT SiteWise User Guide.

Link copied to clipboard
abstract suspend fun getAssetPropertyValue(input: GetAssetPropertyValueRequest = GetAssetPropertyValueRequest { }): GetAssetPropertyValueResponse

Gets an asset property's current value. For more information, see Querying current values in the IoT SiteWise User Guide.

Link copied to clipboard
abstract suspend fun getAssetPropertyValueHistory(input: GetAssetPropertyValueHistoryRequest = GetAssetPropertyValueHistoryRequest { }): GetAssetPropertyValueHistoryResponse

Gets the history of an asset property's values. For more information, see Querying historical values in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard
abstract suspend fun listAccessPolicies(input: ListAccessPoliciesRequest = ListAccessPoliciesRequest { }): 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).

Link copied to clipboard
abstract suspend fun listActions(input: ListActionsRequest): ListActionsResponse

Retrieves a paginated list of actions for a specific target resource.

Link copied to clipboard

Retrieves a paginated list of composite models associated with the asset model

Link copied to clipboard

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.

Link copied to clipboard
abstract suspend fun listAssetModels(input: ListAssetModelsRequest = ListAssetModelsRequest { }): ListAssetModelsResponse

Retrieves a paginated list of summaries of all asset models.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard
abstract suspend fun listAssets(input: ListAssetsRequest = ListAssetsRequest { }): ListAssetsResponse

Retrieves a paginated list of asset summaries.

Link copied to clipboard

Retrieves a paginated list of associated assets.

Link copied to clipboard
abstract suspend fun listBulkImportJobs(input: ListBulkImportJobsRequest = ListBulkImportJobsRequest { }): 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.

Link copied to clipboard

Retrieves a paginated list of composition relationships for an asset model of type COMPONENT_MODEL.

Link copied to clipboard

Retrieves a paginated list of dashboards for an IoT SiteWise Monitor project.

Link copied to clipboard
abstract suspend fun listGateways(input: ListGatewaysRequest = ListGatewaysRequest { }): ListGatewaysResponse

Retrieves a paginated list of gateways.

Link copied to clipboard
abstract suspend fun listPortals(input: ListPortalsRequest = ListPortalsRequest { }): ListPortalsResponse

Retrieves a paginated list of IoT SiteWise Monitor portals.

Link copied to clipboard

Retrieves a paginated list of assets associated with an IoT SiteWise Monitor project.

Link copied to clipboard

Retrieves a paginated list of projects for an IoT SiteWise Monitor portal.

Link copied to clipboard

Retrieves the list of tags for an IoT SiteWise resource.

Link copied to clipboard
abstract suspend fun listTimeSeries(input: ListTimeSeriesRequest = ListTimeSeriesRequest { }): ListTimeSeriesResponse

Retrieves a paginated list of time series (data streams).

Link copied to clipboard

Sets the default encryption configuration for the Amazon Web Services account. For more information, see Key management in the IoT SiteWise User Guide.

Link copied to clipboard

Sets logging options for IoT SiteWise.

Link copied to clipboard

Configures storage settings for IoT SiteWise.

Link copied to clipboard
abstract suspend fun tagResource(input: TagResourceRequest): TagResourceResponse

Adds tags to an IoT SiteWise resource. If a tag already exists for the resource, this operation updates the tag's value.

Link copied to clipboard

Removes a tag from an IoT SiteWise resource.

Link copied to clipboard

Updates an existing access policy that specifies an identity's access to an IoT SiteWise Monitor portal or project resource.

Link copied to clipboard
abstract suspend fun updateAsset(input: UpdateAssetRequest): UpdateAssetResponse

Updates an asset's name. For more information, see Updating assets and models in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Updates an asset property's alias and notification state.

Link copied to clipboard

Updates an IoT SiteWise Monitor dashboard.

Link copied to clipboard

Updates a gateway's name.

Link copied to clipboard

Updates a gateway capability configuration or defines a new capability configuration. Each gateway capability defines data sources for a gateway. A capability configuration can contain multiple data source configurations. If you define OPC-UA sources for a gateway in the IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To list all capability configurations for a gateway, use DescribeGateway.

Link copied to clipboard

Updates an IoT SiteWise Monitor portal.

Link copied to clipboard

Updates an IoT SiteWise Monitor project.

Inherited functions

Link copied to clipboard

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.

Link copied to clipboard

Associates a time series (data stream) with an asset property.

Link copied to clipboard

Associates a group (batch) of assets with an IoT SiteWise Monitor project.

Link copied to clipboard

Disassociates a group (batch) of assets from an IoT SiteWise Monitor project.

Link copied to clipboard

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.

Link copied to clipboard

Gets the current value for one or more asset properties. For more information, see Querying current values in the IoT SiteWise User Guide.

Link copied to clipboard

Gets the historical values for one or more asset properties. For more information, see Querying historical values in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard
expect abstract fun close()
Link copied to clipboard

Creates an access policy that grants the specified identity (IAM Identity Center user, IAM Identity Center group, or IAM user) access to the specified IoT SiteWise Monitor portal or project resource.

Link copied to clipboard

Creates an asset from an existing asset model. For more information, see Creating assets in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard

Creates a custom composite model from specified property and hierarchy definitions. There are two types of custom composite models, inline and component-model-based.

Link copied to clipboard

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.

Link copied to clipboard

Creates a dashboard in an IoT SiteWise Monitor project.

Link copied to clipboard

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.

Link copied to clipboard

Creates a portal, which can contain projects and dashboards. IoT SiteWise Monitor uses IAM Identity Center or IAM to authenticate portal users and manage user permissions.

Link copied to clipboard

Creates a project in the specified portal.

Link copied to clipboard

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.

Link copied to clipboard

Deletes an asset. This action can't be undone. For more information, see Deleting assets and models in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Deletes a dashboard from IoT SiteWise Monitor.

Link copied to clipboard

Deletes a gateway from IoT SiteWise. When you delete a gateway, some of the gateway's files remain in your gateway's file system.

Link copied to clipboard

Deletes a portal from IoT SiteWise Monitor.

Link copied to clipboard

Deletes a project from IoT SiteWise Monitor.

Link copied to clipboard

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.

Link copied to clipboard

Describes an access policy, which specifies an identity's access to an IoT SiteWise Monitor portal or project.

Link copied to clipboard

Retrieves information about an action.

Link copied to clipboard

Retrieves information about an asset.

Link copied to clipboard

Retrieves information about an asset composite model (also known as an asset component). An AssetCompositeModel is an instance of an AssetModelCompositeModel. If you want to see information about the model this is based on, call DescribeAssetModelCompositeModel.

Link copied to clipboard

Retrieves information about an asset model.

Link copied to clipboard

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.

Link copied to clipboard

Retrieves information about an asset property.

Link copied to clipboard

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.

Link copied to clipboard

Retrieves information about a dashboard.

Link copied to clipboard

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.

Link copied to clipboard

Retrieves information about a gateway.

Link copied to clipboard

Retrieves information about a gateway capability configuration. Each gateway capability defines data sources for a gateway. A capability configuration can contain multiple data source configurations. If you define OPC-UA sources for a gateway in the IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To list all capability configurations for a gateway, use DescribeGateway.

Link copied to clipboard

Retrieves the current IoT SiteWise logging options.

Link copied to clipboard

Retrieves information about a portal.

Link copied to clipboard

Retrieves information about a project.

Link copied to clipboard

Retrieves information about the storage configuration for IoT SiteWise.

Link copied to clipboard

Retrieves information about a time series (data stream).

Link copied to clipboard

Disassociates a child asset from the given parent asset through a hierarchy defined in the parent asset's model.

Link copied to clipboard

Disassociates a time series (data stream) from an asset property.

Link copied to clipboard

Executes an action on a target resource.

Link copied to clipboard

Run SQL queries to retrieve metadata and time-series data from asset models, assets, measurements, metrics, transforms, and aggregates.

Link copied to clipboard

Gets aggregated values for an asset property. For more information, see Querying aggregates in the IoT SiteWise User Guide.

Link copied to clipboard

Gets an asset property's current value. For more information, see Querying current values in the IoT SiteWise User Guide.

Link copied to clipboard

Gets the history of an asset property's values. For more information, see Querying historical values in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard

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

Link copied to clipboard

Retrieves a paginated list of actions for a specific target resource.

Link copied to clipboard

Retrieves a paginated list of composite models associated with the asset model

Link copied to clipboard

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.

Link copied to clipboard

Retrieves a paginated list of summaries of all asset models.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard
inline suspend fun IotSiteWiseClient.listAssets(crossinline block: ListAssetsRequest.Builder.() -> Unit): ListAssetsResponse

Retrieves a paginated list of asset summaries.

Link copied to clipboard
Link copied to clipboard

Retrieves a paginated list of associated assets.

Link copied to clipboard

Retrieves a paginated list of bulk import job requests. For more information, see List bulk import jobs (CLI) in the IoT SiteWise User Guide.

Link copied to clipboard

Retrieves a paginated list of composition relationships for an asset model of type COMPONENT_MODEL.

Link copied to clipboard

Retrieves a paginated list of dashboards for an IoT SiteWise Monitor project.

Link copied to clipboard

Retrieves a paginated list of gateways.

Link copied to clipboard

Retrieves a paginated list of IoT SiteWise Monitor portals.

Link copied to clipboard
Link copied to clipboard

Retrieves a paginated list of assets associated with an IoT SiteWise Monitor project.

Link copied to clipboard

Retrieves a paginated list of projects for an IoT SiteWise Monitor portal.

Link copied to clipboard

Retrieves the list of tags for an IoT SiteWise resource.

Link copied to clipboard

Retrieves a paginated list of time series (data streams).

Link copied to clipboard

Sets the default encryption configuration for the Amazon Web Services account. For more information, see Key management in the IoT SiteWise User Guide.

Link copied to clipboard

Sets logging options for IoT SiteWise.

Link copied to clipboard

Configures storage settings for IoT SiteWise.

Link copied to clipboard

Adds tags to an IoT SiteWise resource. If a tag already exists for the resource, this operation updates the tag's value.

Link copied to clipboard

Removes a tag from an IoT SiteWise resource.

Link copied to clipboard

Updates an existing access policy that specifies an identity's access to an IoT SiteWise Monitor portal or project resource.

Link copied to clipboard

Updates an asset's name. For more information, see Updating assets and models in the IoT SiteWise User Guide.

Link copied to clipboard

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.

Link copied to clipboard

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.

Link copied to clipboard

Updates an asset property's alias and notification state.

Link copied to clipboard

Updates an IoT SiteWise Monitor dashboard.

Link copied to clipboard

Updates a gateway's name.

Link copied to clipboard

Updates a gateway capability configuration or defines a new capability configuration. Each gateway capability defines data sources for a gateway. A capability configuration can contain multiple data source configurations. If you define OPC-UA sources for a gateway in the IoT SiteWise console, all of your OPC-UA sources are stored in one capability configuration. To list all capability configurations for a gateway, use DescribeGateway.

Link copied to clipboard

Updates an IoT SiteWise Monitor portal.

Link copied to clipboard

Updates an IoT SiteWise Monitor project.

Link copied to clipboard

Create a copy of the client with one or more configuration values overridden. This method allows the caller to perform scoped config overrides for one or more client operations.