aws-sdk-iotsitewise 1.39.0 → 1.42.0

data/lib/aws-sdk-iotsitewise/types.rb

@@ -982,6 +982,10 @@ module Aws::IoTSiteWise
     #   hierarchy specifies allowed parent/child asset relationships.
     #   @return [Array<Types::AssetHierarchy>]
     #
+    # @!attribute [rw] description
+    #   A description for the asset.
+    #   @return [String]
+    #
     class AssetSummary < Struct.new(
       :id,
       :arn,
@@ -990,7 +994,8 @@ module Aws::IoTSiteWise
       :creation_date,
       :last_update_date,
       :status,
-      :hierarchies)
+      :hierarchies,
+      :description)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1017,241 +1022,1011 @@ module Aws::IoTSiteWise
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-hierarchies.html
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-hierarchies.html
+    #   @return [String]
+    #
+    # @!attribute [rw] child_asset_id
+    #   The ID of the child asset to be associated.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_token
+    #   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.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    class AssociateAssetsRequest < Struct.new(
+      :asset_id,
+      :hierarchy_id,
+      :child_asset_id,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass AssociateTimeSeriesToAssetPropertyRequest
+    #   data as a hash:
+    #
+    #       {
+    #         alias: "PropertyAlias", # required
+    #         asset_id: "ID", # required
+    #         property_id: "ID", # required
+    #         client_token: "ClientToken",
+    #       }
+    #
+    # @!attribute [rw] alias
+    #   The alias that identifies the time series.
+    #   @return [String]
+    #
+    # @!attribute [rw] asset_id
+    #   The ID of the asset in which the asset property was created.
+    #   @return [String]
+    #
+    # @!attribute [rw] property_id
+    #   The ID of the asset property.
+    #   @return [String]
+    #
+    # @!attribute [rw] client_token
+    #   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.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    class AssociateTimeSeriesToAssetPropertyRequest < Struct.new(
+      :alias,
+      :asset_id,
+      :property_id,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains a summary of an associated asset.
+    #
+    # @!attribute [rw] id
+    #   The ID of the asset.
+    #   @return [String]
+    #
+    # @!attribute [rw] arn
+    #   The [ARN][1] of the asset, which has the following format.
+    #
+    #   `arn:$\{Partition\}:iotsitewise:$\{Region\}:$\{Account\}:asset/$\{AssetId\}`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
+    #   @return [String]
+    #
+    # @!attribute [rw] name
+    #   The name of the asset.
+    #   @return [String]
+    #
+    # @!attribute [rw] asset_model_id
+    #   The ID of the asset model used to create the asset.
+    #   @return [String]
+    #
+    # @!attribute [rw] creation_date
+    #   The date the asset was created, in Unix epoch time.
+    #   @return [Time]
+    #
+    # @!attribute [rw] last_update_date
+    #   The date the asset was last updated, in Unix epoch time.
+    #   @return [Time]
+    #
+    # @!attribute [rw] status
+    #   The current status of the asset.
+    #   @return [Types::AssetStatus]
+    #
+    # @!attribute [rw] hierarchies
+    #   A list of asset hierarchies that each contain a `hierarchyId`. A
+    #   hierarchy specifies allowed parent/child asset relationships.
+    #   @return [Array<Types::AssetHierarchy>]
+    #
+    # @!attribute [rw] description
+    #   A description for the asset.
+    #   @return [String]
+    #
+    class AssociatedAssetsSummary < Struct.new(
+      :id,
+      :arn,
+      :name,
+      :asset_model_id,
+      :creation_date,
+      :last_update_date,
+      :status,
+      :hierarchies,
+      :description)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains an asset attribute property. For more information, see
+    # [Attributes][1] in the *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-properties.html#attributes
+    #
+    # @note When making an API call, you may pass Attribute
+    #   data as a hash:
+    #
+    #       {
+    #         default_value: "DefaultValue",
+    #       }
+    #
+    # @!attribute [rw] default_value
+    #   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][1] in the *IoT
+    #   SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-attribute-values.html
+    #   @return [String]
+    #
+    class Attribute < Struct.new(
+      :default_value)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass BatchAssociateProjectAssetsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         project_id: "ID", # required
+    #         asset_ids: ["ID"], # required
+    #         client_token: "ClientToken",
+    #       }
+    #
+    # @!attribute [rw] project_id
+    #   The ID of the project to which to associate the assets.
+    #   @return [String]
+    #
+    # @!attribute [rw] asset_ids
+    #   The IDs of the assets to be associated to the project.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] client_token
+    #   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.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    class BatchAssociateProjectAssetsRequest < Struct.new(
+      :project_id,
+      :asset_ids,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] errors
+    #   A list of associated error information, if any.
+    #   @return [Array<Types::AssetErrorDetails>]
+    #
+    class BatchAssociateProjectAssetsResponse < Struct.new(
+      :errors)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass BatchDisassociateProjectAssetsRequest
+    #   data as a hash:
+    #
+    #       {
+    #         project_id: "ID", # required
+    #         asset_ids: ["ID"], # required
+    #         client_token: "ClientToken",
+    #       }
+    #
+    # @!attribute [rw] project_id
+    #   The ID of the project from which to disassociate the assets.
+    #   @return [String]
+    #
+    # @!attribute [rw] asset_ids
+    #   The IDs of the assets to be disassociated from the project.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] client_token
+    #   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.
+    #
+    #   **A suitable default value is auto-generated.** You should normally
+    #   not need to pass this option.
+    #   @return [String]
+    #
+    class BatchDisassociateProjectAssetsRequest < Struct.new(
+      :project_id,
+      :asset_ids,
+      :client_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] errors
+    #   A list of associated error information, if any.
+    #   @return [Array<Types::AssetErrorDetails>]
+    #
+    class BatchDisassociateProjectAssetsResponse < Struct.new(
+      :errors)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains information for an asset property aggregate entry that is
+    # associated with the [BatchGetAssetPropertyAggregates][1] API.
+    #
+    # To identify an asset property, you must specify one of the following:
+    #
+    # * The `assetId` and `propertyId` of an asset property.
+    #
+    # * A `propertyAlias`, which is a data stream alias (for example,
+    #   `/company/windfarm/3/turbine/7/temperature`). To define an asset
+    #   property's alias, see [UpdateAssetProperty][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyAggregates.html
+    # [2]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html
+    #
+    # @note When making an API call, you may pass BatchGetAssetPropertyAggregatesEntry
+    #   data as a hash:
+    #
+    #       {
+    #         entry_id: "EntryId", # required
+    #         asset_id: "ID",
+    #         property_id: "ID",
+    #         property_alias: "AssetPropertyAlias",
+    #         aggregate_types: ["AVERAGE"], # required, accepts AVERAGE, COUNT, MAXIMUM, MINIMUM, SUM, STANDARD_DEVIATION
+    #         resolution: "Resolution", # required
+    #         start_date: Time.now, # required
+    #         end_date: Time.now, # required
+    #         qualities: ["GOOD"], # accepts GOOD, BAD, UNCERTAIN
+    #         time_ordering: "ASCENDING", # accepts ASCENDING, DESCENDING
+    #       }
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
+    #   @return [String]
+    #
+    # @!attribute [rw] asset_id
+    #   The ID of the asset in which the asset property was created.
+    #   @return [String]
+    #
+    # @!attribute [rw] property_id
+    #   The ID of the asset property.
+    #   @return [String]
+    #
+    # @!attribute [rw] property_alias
+    #   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][1] in the
+    #   *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html
+    #   @return [String]
+    #
+    # @!attribute [rw] aggregate_types
+    #   The data aggregating function.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] resolution
+    #   The time interval over which to aggregate data.
+    #   @return [String]
+    #
+    # @!attribute [rw] start_date
+    #   The exclusive start of the range from which to query historical
+    #   data, expressed in seconds in Unix epoch time.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_date
+    #   The inclusive end of the range from which to query historical data,
+    #   expressed in seconds in Unix epoch time.
+    #   @return [Time]
+    #
+    # @!attribute [rw] qualities
+    #   The quality by which to filter asset data.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] time_ordering
+    #   The chronological sorting order of the requested information.
+    #
+    #   Default: `ASCENDING`
+    #   @return [String]
+    #
+    class BatchGetAssetPropertyAggregatesEntry < Struct.new(
+      :entry_id,
+      :asset_id,
+      :property_id,
+      :property_alias,
+      :aggregate_types,
+      :resolution,
+      :start_date,
+      :end_date,
+      :qualities,
+      :time_ordering)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains error information for an asset property aggregate entry that
+    # is associated with the [BatchGetAssetPropertyAggregates][1] API.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyAggregates.html
+    #
+    # @!attribute [rw] error_code
+    #   The error code.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_message
+    #   The associated error message.
+    #   @return [String]
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
+    #   @return [String]
+    #
+    class BatchGetAssetPropertyAggregatesErrorEntry < Struct.new(
+      :error_code,
+      :error_message,
+      :entry_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains the error code and the timestamp for an asset property
+    # aggregate entry that is associated with the
+    # [BatchGetAssetPropertyAggregates][1] API.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyAggregates.html
+    #
+    # @!attribute [rw] error_code
+    #   The error code.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_timestamp
+    #   The date the error occurred, in Unix epoch time.
+    #   @return [Time]
+    #
+    class BatchGetAssetPropertyAggregatesErrorInfo < Struct.new(
+      :error_code,
+      :error_timestamp)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @note When making an API call, you may pass BatchGetAssetPropertyAggregatesRequest
+    #   data as a hash:
+    #
+    #       {
+    #         entries: [ # required
+    #           {
+    #             entry_id: "EntryId", # required
+    #             asset_id: "ID",
+    #             property_id: "ID",
+    #             property_alias: "AssetPropertyAlias",
+    #             aggregate_types: ["AVERAGE"], # required, accepts AVERAGE, COUNT, MAXIMUM, MINIMUM, SUM, STANDARD_DEVIATION
+    #             resolution: "Resolution", # required
+    #             start_date: Time.now, # required
+    #             end_date: Time.now, # required
+    #             qualities: ["GOOD"], # accepts GOOD, BAD, UNCERTAIN
+    #             time_ordering: "ASCENDING", # accepts ASCENDING, DESCENDING
+    #           },
+    #         ],
+    #         next_token: "NextToken",
+    #         max_results: 1,
+    #       }
+    #
+    # @!attribute [rw] entries
+    #   The list of asset property aggregate entries for the batch get
+    #   request. You can specify up to 16 entries per request.
+    #   @return [Array<Types::BatchGetAssetPropertyAggregatesEntry>]
+    #
+    # @!attribute [rw] next_token
+    #   The token to be used for the next set of paginated results.
+    #   @return [String]
+    #
+    # @!attribute [rw] max_results
+    #   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.
+    #   @return [Integer]
+    #
+    class BatchGetAssetPropertyAggregatesRequest < Struct.new(
+      :entries,
+      :next_token,
+      :max_results)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # @!attribute [rw] error_entries
+    #   A list of the errors (if any) associated with the batch request.
+    #   Each error entry contains the `entryId` of the entry that failed.
+    #   @return [Array<Types::BatchGetAssetPropertyAggregatesErrorEntry>]
+    #
+    # @!attribute [rw] success_entries
+    #   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.
+    #   @return [Array<Types::BatchGetAssetPropertyAggregatesSuccessEntry>]
+    #
+    # @!attribute [rw] skipped_entries
+    #   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.
+    #   @return [Array<Types::BatchGetAssetPropertyAggregatesSkippedEntry>]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of results, or null if there are no
+    #   additional results.
+    #   @return [String]
+    #
+    class BatchGetAssetPropertyAggregatesResponse < Struct.new(
+      :error_entries,
+      :success_entries,
+      :skipped_entries,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains information for an entry that has been processed by the
+    # previous [BatchGetAssetPropertyAggregates][1] request.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyAggregates.html
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
+    #   @return [String]
+    #
+    # @!attribute [rw] completion_status
+    #   The completion status of each entry that is associated with the
+    #   [BatchGetAssetPropertyAggregates][1] API.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyAggregates.html
+    #   @return [String]
+    #
+    # @!attribute [rw] error_info
+    #   The error information, such as the error code and the timestamp.
+    #   @return [Types::BatchGetAssetPropertyAggregatesErrorInfo]
+    #
+    class BatchGetAssetPropertyAggregatesSkippedEntry < Struct.new(
+      :entry_id,
+      :completion_status,
+      :error_info)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains success information for an entry that is associated with the
+    # [BatchGetAssetPropertyAggregates][1] API.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyAggregates.html
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
+    #   @return [String]
+    #
+    # @!attribute [rw] aggregated_values
+    #   The requested aggregated asset property values (for example,
+    #   average, minimum, and maximum).
+    #   @return [Array<Types::AggregatedValue>]
+    #
+    class BatchGetAssetPropertyAggregatesSuccessEntry < Struct.new(
+      :entry_id,
+      :aggregated_values)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains information for an asset property value entry that is
+    # associated with the [BatchGetAssetPropertyValue][1] API.
+    #
+    # To identify an asset property, you must specify one of the following:
+    #
+    # * The `assetId` and `propertyId` of an asset property.
+    #
+    # * A `propertyAlias`, which is a data stream alias (for example,
+    #   `/company/windfarm/3/turbine/7/temperature`). To define an asset
+    #   property's alias, see [UpdateAssetProperty][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValue.html
+    # [2]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html
+    #
+    # @note When making an API call, you may pass BatchGetAssetPropertyValueEntry
+    #   data as a hash:
+    #
+    #       {
+    #         entry_id: "EntryId", # required
+    #         asset_id: "ID",
+    #         property_id: "ID",
+    #         property_alias: "AssetPropertyAlias",
+    #       }
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
+    #   @return [String]
+    #
+    # @!attribute [rw] asset_id
+    #   The ID of the asset in which the asset property was created.
+    #   @return [String]
+    #
+    # @!attribute [rw] property_id
+    #   The ID of the asset property.
+    #   @return [String]
+    #
+    # @!attribute [rw] property_alias
+    #   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][1] in the
+    #   *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html
+    #   @return [String]
+    #
+    class BatchGetAssetPropertyValueEntry < Struct.new(
+      :entry_id,
+      :asset_id,
+      :property_id,
+      :property_alias)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains error information for an asset property value entry that is
+    # associated with the [BatchGetAssetPropertyValue][1] API.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValue.html
+    #
+    # @!attribute [rw] error_code
+    #   The error code.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_message
+    #   The associated error message.
+    #   @return [String]
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
+    #   @return [String]
+    #
+    class BatchGetAssetPropertyValueErrorEntry < Struct.new(
+      :error_code,
+      :error_message,
+      :entry_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The error information, such as the error code and the timestamp.
+    #
+    # @!attribute [rw] error_code
+    #   The error code.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_timestamp
+    #   The date the error occurred, in Unix epoch time.
+    #   @return [Time]
+    #
+    class BatchGetAssetPropertyValueErrorInfo < Struct.new(
+      :error_code,
+      :error_timestamp)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains information for an asset property historical value entry that
+    # is associated with the [BatchGetAssetPropertyValueHistory][1] API.
+    #
+    # To identify an asset property, you must specify one of the following:
+    #
+    # * The `assetId` and `propertyId` of an asset property.
+    #
+    # * A `propertyAlias`, which is a data stream alias (for example,
+    #   `/company/windfarm/3/turbine/7/temperature`). To define an asset
+    #   property's alias, see [UpdateAssetProperty][2].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValue.html
+    # [2]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html
+    #
+    # @note When making an API call, you may pass BatchGetAssetPropertyValueHistoryEntry
+    #   data as a hash:
+    #
+    #       {
+    #         entry_id: "EntryId", # required
+    #         asset_id: "ID",
+    #         property_id: "ID",
+    #         property_alias: "AssetPropertyAlias",
+    #         start_date: Time.now,
+    #         end_date: Time.now,
+    #         qualities: ["GOOD"], # accepts GOOD, BAD, UNCERTAIN
+    #         time_ordering: "ASCENDING", # accepts ASCENDING, DESCENDING
+    #       }
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
+    #   @return [String]
+    #
+    # @!attribute [rw] asset_id
+    #   The ID of the asset in which the asset property was created.
+    #   @return [String]
+    #
+    # @!attribute [rw] property_id
+    #   The ID of the asset property.
+    #   @return [String]
+    #
+    # @!attribute [rw] property_alias
+    #   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][1] in the
+    #   *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html
+    #   @return [String]
+    #
+    # @!attribute [rw] start_date
+    #   The exclusive start of the range from which to query historical
+    #   data, expressed in seconds in Unix epoch time.
+    #   @return [Time]
+    #
+    # @!attribute [rw] end_date
+    #   The inclusive end of the range from which to query historical data,
+    #   expressed in seconds in Unix epoch time.
+    #   @return [Time]
+    #
+    # @!attribute [rw] qualities
+    #   The quality by which to filter asset data.
+    #   @return [Array<String>]
+    #
+    # @!attribute [rw] time_ordering
+    #   The chronological sorting order of the requested information.
+    #
+    #   Default: `ASCENDING`
+    #   @return [String]
+    #
+    class BatchGetAssetPropertyValueHistoryEntry < Struct.new(
+      :entry_id,
+      :asset_id,
+      :property_id,
+      :property_alias,
+      :start_date,
+      :end_date,
+      :qualities,
+      :time_ordering)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # A list of the errors (if any) associated with the batch request. Each
+    # error entry contains the `entryId` of the entry that failed.
+    #
+    # @!attribute [rw] error_code
+    #   The error code.
+    #   @return [String]
+    #
+    # @!attribute [rw] error_message
+    #   The associated error message.
     #   @return [String]
     #
-    # @!attribute [rw] child_asset_id
-    #   The ID of the child asset to be associated.
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
     #   @return [String]
     #
-    # @!attribute [rw] client_token
-    #   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.
+    class BatchGetAssetPropertyValueHistoryErrorEntry < Struct.new(
+      :error_code,
+      :error_message,
+      :entry_id)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # The error information, such as the error code and the timestamp.
     #
-    #   **A suitable default value is auto-generated.** You should normally
-    #   not need to pass this option.
+    # @!attribute [rw] error_code
+    #   The error code.
     #   @return [String]
     #
-    class AssociateAssetsRequest < Struct.new(
-      :asset_id,
-      :hierarchy_id,
-      :child_asset_id,
-      :client_token)
+    # @!attribute [rw] error_timestamp
+    #   The date the error occurred, in Unix epoch time.
+    #   @return [Time]
+    #
+    class BatchGetAssetPropertyValueHistoryErrorInfo < Struct.new(
+      :error_code,
+      :error_timestamp)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass AssociateTimeSeriesToAssetPropertyRequest
+    # @note When making an API call, you may pass BatchGetAssetPropertyValueHistoryRequest
     #   data as a hash:
     #
     #       {
-    #         alias: "PropertyAlias", # required
-    #         asset_id: "ID", # required
-    #         property_id: "ID", # required
-    #         client_token: "ClientToken",
+    #         entries: [ # required
+    #           {
+    #             entry_id: "EntryId", # required
+    #             asset_id: "ID",
+    #             property_id: "ID",
+    #             property_alias: "AssetPropertyAlias",
+    #             start_date: Time.now,
+    #             end_date: Time.now,
+    #             qualities: ["GOOD"], # accepts GOOD, BAD, UNCERTAIN
+    #             time_ordering: "ASCENDING", # accepts ASCENDING, DESCENDING
+    #           },
+    #         ],
+    #         next_token: "NextToken",
+    #         max_results: 1,
     #       }
     #
-    # @!attribute [rw] alias
-    #   The alias that identifies the time series.
-    #   @return [String]
+    # @!attribute [rw] entries
+    #   The list of asset property historical value entries for the batch
+    #   get request. You can specify up to 16 entries per request.
+    #   @return [Array<Types::BatchGetAssetPropertyValueHistoryEntry>]
     #
-    # @!attribute [rw] asset_id
-    #   The ID of the asset in which the asset property was created.
+    # @!attribute [rw] next_token
+    #   The token to be used for the next set of paginated results.
     #   @return [String]
     #
-    # @!attribute [rw] property_id
-    #   The ID of the asset property.
-    #   @return [String]
+    # @!attribute [rw] max_results
+    #   The maximum number of results to return for each paginated request.
+    #   A result set is returned in the two cases, whichever occurs first.
     #
-    # @!attribute [rw] client_token
-    #   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.
+    #   * The size of the result set is less than 1 MB.
     #
-    #   **A suitable default value is auto-generated.** You should normally
-    #   not need to pass this option.
-    #   @return [String]
+    #   * The number of data points in the result set is less than the value
+    #     of `maxResults`. The maximum value of `maxResults` is 4000.
+    #   @return [Integer]
     #
-    class AssociateTimeSeriesToAssetPropertyRequest < Struct.new(
-      :alias,
-      :asset_id,
-      :property_id,
-      :client_token)
+    class BatchGetAssetPropertyValueHistoryRequest < Struct.new(
+      :entries,
+      :next_token,
+      :max_results)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Contains a summary of an associated asset.
+    # @!attribute [rw] error_entries
+    #   A list of the errors (if any) associated with the batch request.
+    #   Each error entry contains the `entryId` of the entry that failed.
+    #   @return [Array<Types::BatchGetAssetPropertyValueHistoryErrorEntry>]
     #
-    # @!attribute [rw] id
-    #   The ID of the asset.
-    #   @return [String]
+    # @!attribute [rw] success_entries
+    #   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.
+    #   @return [Array<Types::BatchGetAssetPropertyValueHistorySuccessEntry>]
     #
-    # @!attribute [rw] arn
-    #   The [ARN][1] of the asset, which has the following format.
+    # @!attribute [rw] skipped_entries
+    #   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.
+    #   @return [Array<Types::BatchGetAssetPropertyValueHistorySkippedEntry>]
     #
-    #   `arn:$\{Partition\}:iotsitewise:$\{Region\}:$\{Account\}:asset/$\{AssetId\}`
+    # @!attribute [rw] next_token
+    #   The token for the next set of results, or null if there are no
+    #   additional results.
+    #   @return [String]
     #
+    class BatchGetAssetPropertyValueHistoryResponse < Struct.new(
+      :error_entries,
+      :success_entries,
+      :skipped_entries,
+      :next_token)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains information for an entry that has been processed by the
+    # previous [BatchGetAssetPropertyValueHistory][1] request.
     #
     #
-    #   [1]: https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html
-    #   @return [String]
     #
-    # @!attribute [rw] name
-    #   The name of the asset.
-    #   @return [String]
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValue.html
     #
-    # @!attribute [rw] asset_model_id
-    #   The ID of the asset model used to create the asset.
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
     #   @return [String]
     #
-    # @!attribute [rw] creation_date
-    #   The date the asset was created, in Unix epoch time.
-    #   @return [Time]
+    # @!attribute [rw] completion_status
+    #   The completion status of each entry that is associated with the
+    #   [BatchGetAssetPropertyValueHistory][1] API.
     #
-    # @!attribute [rw] last_update_date
-    #   The date the asset was last updated, in Unix epoch time.
-    #   @return [Time]
     #
-    # @!attribute [rw] status
-    #   The current status of the asset.
-    #   @return [Types::AssetStatus]
     #
-    # @!attribute [rw] hierarchies
-    #   A list of asset hierarchies that each contain a `hierarchyId`. A
-    #   hierarchy specifies allowed parent/child asset relationships.
-    #   @return [Array<Types::AssetHierarchy>]
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValueHistory.html
+    #   @return [String]
     #
-    class AssociatedAssetsSummary < Struct.new(
-      :id,
-      :arn,
-      :name,
-      :asset_model_id,
-      :creation_date,
-      :last_update_date,
-      :status,
-      :hierarchies)
+    # @!attribute [rw] error_info
+    #   The error information, such as the error code and the timestamp.
+    #   @return [Types::BatchGetAssetPropertyValueHistoryErrorInfo]
+    #
+    class BatchGetAssetPropertyValueHistorySkippedEntry < Struct.new(
+      :entry_id,
+      :completion_status,
+      :error_info)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # Contains an asset attribute property. For more information, see
-    # [Attributes][1] in the *IoT SiteWise User Guide*.
+    # Contains success information for an entry that is associated with the
+    # [BatchGetAssetPropertyValueHistory][1] API.
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-properties.html#attributes
-    #
-    # @note When making an API call, you may pass Attribute
-    #   data as a hash:
-    #
-    #       {
-    #         default_value: "DefaultValue",
-    #       }
-    #
-    # @!attribute [rw] default_value
-    #   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][1] in the *IoT
-    #   SiteWise User Guide*.
-    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValue.html
     #
-    #
-    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/update-attribute-values.html
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
     #   @return [String]
     #
-    class Attribute < Struct.new(
-      :default_value)
+    # @!attribute [rw] asset_property_value_history
+    #   The requested historical values for the specified asset property.
+    #   @return [Array<Types::AssetPropertyValue>]
+    #
+    class BatchGetAssetPropertyValueHistorySuccessEntry < Struct.new(
+      :entry_id,
+      :asset_property_value_history)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass BatchAssociateProjectAssetsRequest
+    # @note When making an API call, you may pass BatchGetAssetPropertyValueRequest
     #   data as a hash:
     #
     #       {
-    #         project_id: "ID", # required
-    #         asset_ids: ["ID"], # required
-    #         client_token: "ClientToken",
+    #         entries: [ # required
+    #           {
+    #             entry_id: "EntryId", # required
+    #             asset_id: "ID",
+    #             property_id: "ID",
+    #             property_alias: "AssetPropertyAlias",
+    #           },
+    #         ],
+    #         next_token: "NextToken",
     #       }
     #
-    # @!attribute [rw] project_id
-    #   The ID of the project to which to associate the assets.
-    #   @return [String]
-    #
-    # @!attribute [rw] asset_ids
-    #   The IDs of the assets to be associated to the project.
-    #   @return [Array<String>]
-    #
-    # @!attribute [rw] client_token
-    #   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.
+    # @!attribute [rw] entries
+    #   The list of asset property value entries for the batch get request.
+    #   You can specify up to 16 entries per request.
+    #   @return [Array<Types::BatchGetAssetPropertyValueEntry>]
     #
-    #   **A suitable default value is auto-generated.** You should normally
-    #   not need to pass this option.
+    # @!attribute [rw] next_token
+    #   The token to be used for the next set of paginated results.
     #   @return [String]
     #
-    class BatchAssociateProjectAssetsRequest < Struct.new(
-      :project_id,
-      :asset_ids,
-      :client_token)
+    class BatchGetAssetPropertyValueRequest < Struct.new(
+      :entries,
+      :next_token)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # @!attribute [rw] errors
-    #   A list of associated error information, if any.
-    #   @return [Array<Types::AssetErrorDetails>]
+    # @!attribute [rw] error_entries
+    #   A list of the errors (if any) associated with the batch request.
+    #   Each error entry contains the `entryId` of the entry that failed.
+    #   @return [Array<Types::BatchGetAssetPropertyValueErrorEntry>]
     #
-    class BatchAssociateProjectAssetsResponse < Struct.new(
-      :errors)
+    # @!attribute [rw] success_entries
+    #   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.
+    #   @return [Array<Types::BatchGetAssetPropertyValueSuccessEntry>]
+    #
+    # @!attribute [rw] skipped_entries
+    #   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.
+    #   @return [Array<Types::BatchGetAssetPropertyValueSkippedEntry>]
+    #
+    # @!attribute [rw] next_token
+    #   The token for the next set of results, or null if there are no
+    #   additional results.
+    #   @return [String]
+    #
+    class BatchGetAssetPropertyValueResponse < Struct.new(
+      :error_entries,
+      :success_entries,
+      :skipped_entries,
+      :next_token)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # @note When making an API call, you may pass BatchDisassociateProjectAssetsRequest
-    #   data as a hash:
+    # Contains information for an entry that has been processed by the
+    # previous [BatchGetAssetPropertyValue][1] request.
     #
-    #       {
-    #         project_id: "ID", # required
-    #         asset_ids: ["ID"], # required
-    #         client_token: "ClientToken",
-    #       }
     #
-    # @!attribute [rw] project_id
-    #   The ID of the project from which to disassociate the assets.
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValue.html
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
     #   @return [String]
     #
-    # @!attribute [rw] asset_ids
-    #   The IDs of the assets to be disassociated from the project.
-    #   @return [Array<String>]
+    # @!attribute [rw] completion_status
+    #   The completion status of each entry that is associated with the
+    #   [BatchGetAssetPropertyValue][1] request.
     #
-    # @!attribute [rw] client_token
-    #   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.
     #
-    #   **A suitable default value is auto-generated.** You should normally
-    #   not need to pass this option.
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValue.html
     #   @return [String]
     #
-    class BatchDisassociateProjectAssetsRequest < Struct.new(
-      :project_id,
-      :asset_ids,
-      :client_token)
+    # @!attribute [rw] error_info
+    #   The error information, such as the error code and the timestamp.
+    #   @return [Types::BatchGetAssetPropertyValueErrorInfo]
+    #
+    class BatchGetAssetPropertyValueSkippedEntry < Struct.new(
+      :entry_id,
+      :completion_status,
+      :error_info)
       SENSITIVE = []
       include Aws::Structure
     end
 
-    # @!attribute [rw] errors
-    #   A list of associated error information, if any.
-    #   @return [Array<Types::AssetErrorDetails>]
+    # Contains success information for an entry that is associated with the
+    # [BatchGetAssetPropertyValue][1] API.
     #
-    class BatchDisassociateProjectAssetsResponse < Struct.new(
-      :errors)
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_BatchGetAssetPropertyValue.html
+    #
+    # @!attribute [rw] entry_id
+    #   The ID of the entry.
+    #   @return [String]
+    #
+    # @!attribute [rw] asset_property_value
+    #   Contains asset property value information.
+    #   @return [Types::AssetPropertyValue]
+    #
+    class BatchGetAssetPropertyValueSuccessEntry < Struct.new(
+      :entry_id,
+      :asset_property_value)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -1785,6 +2560,7 @@ module Aws::IoTSiteWise
     #         tags: {
     #           "TagKey" => "TagValue",
     #         },
+    #         asset_description: "Description",
     #       }
     #
     # @!attribute [rw] asset_name
@@ -1814,11 +2590,16 @@ module Aws::IoTSiteWise
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html
     #   @return [Hash<String,String>]
     #
+    # @!attribute [rw] asset_description
+    #   A description for the asset.
+    #   @return [String]
+    #
     class CreateAssetRequest < Struct.new(
       :asset_name,
       :asset_model_id,
       :client_token,
-      :tags)
+      :tags,
+      :asset_description)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -2869,6 +3650,10 @@ module Aws::IoTSiteWise
     #   error message.
     #   @return [Types::AssetStatus]
     #
+    # @!attribute [rw] asset_description
+    #   A description for the asset.
+    #   @return [String]
+    #
     class DescribeAssetResponse < Struct.new(
       :asset_id,
       :asset_arn,
@@ -2879,7 +3664,8 @@ module Aws::IoTSiteWise
       :asset_composite_models,
       :asset_creation_date,
       :asset_last_update_date,
-      :asset_status)
+      :asset_status,
+      :asset_description)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -3328,7 +4114,7 @@ module Aws::IoTSiteWise
     #     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 cold tier. The cold tier is a customer-managed
+    #     cold tier and the hot tier. The cold tier is a customer-managed
     #     Amazon S3 bucket.
     #   @return [String]
     #
@@ -5884,7 +6670,7 @@ module Aws::IoTSiteWise
     #     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 cold tier. The cold tier is a customer-managed
+    #     cold tier and the hot tier. The cold tier is a customer-managed
     #     Amazon S3 bucket.
     #   @return [String]
     #
@@ -5938,7 +6724,7 @@ module Aws::IoTSiteWise
     #     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 cold tier. The cold tier is a customer-managed
+    #     cold tier and the hot tier. The cold tier is a customer-managed
     #     Amazon S3 bucket.
     #   @return [String]
     #
@@ -6863,6 +7649,7 @@ module Aws::IoTSiteWise
     #         asset_id: "ID", # required
     #         asset_name: "Name", # required
     #         client_token: "ClientToken",
+    #         asset_description: "Description",
     #       }
     #
     # @!attribute [rw] asset_id
@@ -6882,10 +7669,15 @@ module Aws::IoTSiteWise
     #   not need to pass this option.
     #   @return [String]
     #
+    # @!attribute [rw] asset_description
+    #   A description for the asset.
+    #   @return [String]
+    #
     class UpdateAssetRequest < Struct.new(
       :asset_id,
       :asset_name,
-      :client_token)
+      :client_token,
+      :asset_description)
       SENSITIVE = []
       include Aws::Structure
     end