aws-sdk-iotsitewise 1.34.0 → 1.38.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: daa301ce76c3b74af511bb27dd527aff549dbcd843295a222f93b47b14560450
-  data.tar.gz: ccbf8a3a20f48054a892ad8e642befcd32d1f8520994acddf897b5ca957ad460
+  metadata.gz: 5cd91087e4b617d884ca980bddfc5d2b8a2da3ce38cfd7a5895cf88f658afb21
+  data.tar.gz: ad05e6f7ea9d0920c2ec79e45f447b32a700556ecfe7a979f4c52384f16b9954
 SHA512:
-  metadata.gz: 93129a2346d193565c282677ea9cfd88372489c24f2dffaa1e9841fdb7cc8f0456ad741fe73585ff447ef1a280d53d713a9c0dc96683f362a0dddbf2a1d032f7
-  data.tar.gz: 6d2f95add076c446d37e3f2ac229ee52e89009c78bb6179dd7944e49e492989c632ff4843e64df688f5b083be5b9a83aa36268a1f20525b0883ef8d62b9c3d28
+  metadata.gz: 4cc2b5c95f1f42918e18b8119b46b9eeed8f11fe7ab66a96848701c1d80a7dafe804f1d3581e7ce19d571e05766b0cc6954ba09332231d4a72c923f8d272e195
+  data.tar.gz: 2d816578fd257adfd4334f14397494032fc3db4c6094347bf0ffc893eec4dbad2bda68b944ef99f7b9cbfa8c4891c2c387f3e4603e068f66767099b6dfe74f3b

data/CHANGELOG.md

@@ -1,6 +1,26 @@
 Unreleased Changes
 ------------------
 
+1.38.0 (2021-12-21)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.37.0 (2021-11-30)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
+1.36.0 (2021-11-29)
+------------------
+
+* Feature - AWS IoT SiteWise now supports retention configuration for the hot tier storage.
+
+1.35.0 (2021-11-24)
+------------------
+
+* Feature - AWS IoT SiteWise now accepts data streams that aren't associated with any asset properties. You can organize data by updating data stream associations.
+
 1.34.0 (2021-11-04)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.34.0
+1.38.0

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

@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
 require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
 require 'aws-sdk-core/plugins/transfer_encoding.rb'
 require 'aws-sdk-core/plugins/http_checksum.rb'
+require 'aws-sdk-core/plugins/defaults_mode.rb'
 require 'aws-sdk-core/plugins/signature_v4.rb'
 require 'aws-sdk-core/plugins/protocols/rest_json.rb'
 
@@ -73,6 +74,7 @@ module Aws::IoTSiteWise
     add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
     add_plugin(Aws::Plugins::TransferEncoding)
     add_plugin(Aws::Plugins::HttpChecksum)
+    add_plugin(Aws::Plugins::DefaultsMode)
     add_plugin(Aws::Plugins::SignatureV4)
     add_plugin(Aws::Plugins::Protocols::RestJson)
 
@@ -119,7 +121,9 @@ module Aws::IoTSiteWise
     #     * EC2/ECS IMDS instance profile - When used by default, the timeouts
     #       are very aggressive. Construct and pass an instance of
     #       `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
-    #       enable retries and extended timeouts.
+    #       enable retries and extended timeouts. Instance profile credential
+    #       fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
+    #       to true.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -173,6 +177,10 @@ module Aws::IoTSiteWise
     #     Used only in `standard` and adaptive retry modes. Specifies whether to apply
     #     a clock skew correction and retry requests with skewed client clocks.
     #
+    #   @option options [String] :defaults_mode ("legacy")
+    #     See {Aws::DefaultsModeConfiguration} for a list of the
+    #     accepted modes and the configuration defaults that are included.
+    #
     #   @option options [Boolean] :disable_host_prefix_injection (false)
     #     Set to true to disable SDK automatically adding host prefix
     #     to default service endpoint when available.
@@ -295,7 +303,7 @@ module Aws::IoTSiteWise
     #     seconds to wait when opening a HTTP session before raising a
     #     `Timeout::Error`.
     #
-    #   @option options [Integer] :http_read_timeout (60) The default
+    #   @option options [Float] :http_read_timeout (60) The default
     #     number of seconds to wait for response data.  This value can
     #     safely be set per-request on the session.
     #
@@ -311,6 +319,9 @@ module Aws::IoTSiteWise
     #     disables this behaviour.  This value can safely be set per
     #     request on the session.
     #
+    #   @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
+    #     in seconds.
+    #
     #   @option options [Boolean] :http_wire_trace (false) When `true`,
     #     HTTP debug output will be sent to the `:logger`.
     #
@@ -386,6 +397,43 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
+    # Associates a time series (data stream) with an asset property.
+    #
+    # @option params [required, String] :alias
+    #   The alias that identifies the time series.
+    #
+    # @option params [required, String] :asset_id
+    #   The ID of the asset in which the asset property was created.
+    #
+    # @option params [required, String] :property_id
+    #   The ID of the asset property.
+    #
+    # @option params [String] :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 [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.associate_time_series_to_asset_property({
+    #     alias: "PropertyAlias", # required
+    #     asset_id: "ID", # required
+    #     property_id: "ID", # required
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @overload associate_time_series_to_asset_property(params = {})
+    # @param [Hash] params ({})
+    def associate_time_series_to_asset_property(params = {}, options = {})
+      req = build_request(:associate_time_series_to_asset_property, params)
+      req.send_request(options)
+    end
+
     # Associates a group (batch) of assets with an IoT SiteWise Monitor
     # project.
     #
@@ -1135,8 +1183,7 @@ module Aws::IoTSiteWise
     #     China Regions.
     #
     #   * `IAM` – The portal uses Identity and Access Management to
-    #     authenticate users and manage user permissions. This option is only
-    #     available in the China Regions.
+    #     authenticate users and manage user permissions.
     #
     #   You can't change this value after you create a portal.
     #
@@ -1218,6 +1265,11 @@ module Aws::IoTSiteWise
 
     # Creates a project in the specified portal.
     #
+    # <note markdown="1"> Make sure that the project name and description don't contain
+    # confidential information.
+    #
+    #  </note>
+    #
     # @option params [required, String] :portal_id
     #   The ID of the portal in which to create the project.
     #
@@ -1520,6 +1572,58 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
+    # 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.
+    #
+    # To identify a time series, do one of the following:
+    #
+    # * If the time series isn't associated with an asset property, specify
+    #   the `alias` of the time series.
+    #
+    # * If the time series is associated with an asset property, specify one
+    #   of the following:
+    #
+    #   * The `alias` of the time series.
+    #
+    #   * The `assetId` and `propertyId` that identifies the asset property.
+    #
+    # @option params [String] :alias
+    #   The alias that identifies the time series.
+    #
+    # @option params [String] :asset_id
+    #   The ID of the asset in which the asset property was created.
+    #
+    # @option params [String] :property_id
+    #   The ID of the asset property.
+    #
+    # @option params [String] :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 [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.delete_time_series({
+    #     alias: "PropertyAlias",
+    #     asset_id: "ID",
+    #     property_id: "ID",
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @overload delete_time_series(params = {})
+    # @param [Hash] params ({})
+    def delete_time_series(params = {}, options = {})
+      req = build_request(:delete_time_series, params)
+      req.send_request(options)
+    end
+
     # Describes an access policy, which specifies an identity's access to
     # an IoT SiteWise Monitor portal or project.
     #
@@ -2133,6 +2237,8 @@ module Aws::IoTSiteWise
     #
     #   * {Types::DescribeStorageConfigurationResponse#storage_type #storage_type} => String
     #   * {Types::DescribeStorageConfigurationResponse#multi_layer_storage #multi_layer_storage} => Types::MultiLayerStorage
+    #   * {Types::DescribeStorageConfigurationResponse#disassociated_data_storage #disassociated_data_storage} => String
+    #   * {Types::DescribeStorageConfigurationResponse#retention_period #retention_period} => Types::RetentionPeriod
     #   * {Types::DescribeStorageConfigurationResponse#configuration_status #configuration_status} => Types::ConfigurationStatus
     #   * {Types::DescribeStorageConfigurationResponse#last_update_date #last_update_date} => Time
     #
@@ -2141,6 +2247,9 @@ module Aws::IoTSiteWise
     #   resp.storage_type #=> String, one of "SITEWISE_DEFAULT_STORAGE", "MULTI_LAYER_STORAGE"
     #   resp.multi_layer_storage.customer_managed_s3_storage.s3_resource_arn #=> String
     #   resp.multi_layer_storage.customer_managed_s3_storage.role_arn #=> String
+    #   resp.disassociated_data_storage #=> String, one of "ENABLED", "DISABLED"
+    #   resp.retention_period.number_of_days #=> Integer
+    #   resp.retention_period.unlimited #=> Boolean
     #   resp.configuration_status.state #=> String, one of "ACTIVE", "UPDATE_IN_PROGRESS", "UPDATE_FAILED"
     #   resp.configuration_status.error.code #=> String, one of "VALIDATION_ERROR", "INTERNAL_FAILURE"
     #   resp.configuration_status.error.message #=> String
@@ -2153,6 +2262,66 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
+    # Retrieves information about a time series (data stream).
+    #
+    # To identify a time series, do one of the following:
+    #
+    # * If the time series isn't associated with an asset property, specify
+    #   the `alias` of the time series.
+    #
+    # * If the time series is associated with an asset property, specify one
+    #   of the following:
+    #
+    #   * The `alias` of the time series.
+    #
+    #   * The `assetId` and `propertyId` that identifies the asset property.
+    #
+    # @option params [String] :alias
+    #   The alias that identifies the time series.
+    #
+    # @option params [String] :asset_id
+    #   The ID of the asset in which the asset property was created.
+    #
+    # @option params [String] :property_id
+    #   The ID of the asset property.
+    #
+    # @return [Types::DescribeTimeSeriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::DescribeTimeSeriesResponse#asset_id #asset_id} => String
+    #   * {Types::DescribeTimeSeriesResponse#property_id #property_id} => String
+    #   * {Types::DescribeTimeSeriesResponse#alias #alias} => String
+    #   * {Types::DescribeTimeSeriesResponse#time_series_id #time_series_id} => String
+    #   * {Types::DescribeTimeSeriesResponse#data_type #data_type} => String
+    #   * {Types::DescribeTimeSeriesResponse#data_type_spec #data_type_spec} => String
+    #   * {Types::DescribeTimeSeriesResponse#time_series_creation_date #time_series_creation_date} => Time
+    #   * {Types::DescribeTimeSeriesResponse#time_series_last_update_date #time_series_last_update_date} => Time
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.describe_time_series({
+    #     alias: "PropertyAlias",
+    #     asset_id: "ID",
+    #     property_id: "ID",
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.asset_id #=> String
+    #   resp.property_id #=> String
+    #   resp.alias #=> String
+    #   resp.time_series_id #=> String
+    #   resp.data_type #=> String, one of "STRING", "INTEGER", "DOUBLE", "BOOLEAN", "STRUCT"
+    #   resp.data_type_spec #=> String
+    #   resp.time_series_creation_date #=> Time
+    #   resp.time_series_last_update_date #=> Time
+    #
+    # @overload describe_time_series(params = {})
+    # @param [Hash] params ({})
+    def describe_time_series(params = {}, options = {})
+      req = build_request(:describe_time_series, params)
+      req.send_request(options)
+    end
+
     # Disassociates a child asset from the given parent asset through a
     # hierarchy defined in the parent asset's model.
     #
@@ -2199,6 +2368,43 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
+    # Disassociates a time series (data stream) from an asset property.
+    #
+    # @option params [required, String] :alias
+    #   The alias that identifies the time series.
+    #
+    # @option params [required, String] :asset_id
+    #   The ID of the asset in which the asset property was created.
+    #
+    # @option params [required, String] :property_id
+    #   The ID of the asset property.
+    #
+    # @option params [String] :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 [Struct] Returns an empty {Seahorse::Client::Response response}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.disassociate_time_series_from_asset_property({
+    #     alias: "PropertyAlias", # required
+    #     asset_id: "ID", # required
+    #     property_id: "ID", # required
+    #     client_token: "ClientToken",
+    #   })
+    #
+    # @overload disassociate_time_series_from_asset_property(params = {})
+    # @param [Hash] params ({})
+    def disassociate_time_series_from_asset_property(params = {}, options = {})
+      req = build_request(:disassociate_time_series_from_asset_property, params)
+      req.send_request(options)
+    end
+
     # Gets aggregated values for an asset property. For more information,
     # see [Querying aggregates][1] in the *IoT SiteWise User Guide*.
     #
@@ -2542,7 +2748,7 @@ module Aws::IoTSiteWise
     #
     #     For example, you can use this operation to return the interpolated
     #     temperature values for a wind turbine every 24 hours over a duration
-    #     of 7 days. If the interpolation starts on July 1, 2021, at 9 AM, IoT
+    #     of 7 days. If the interpolation starts July 1, 2021, at 9 AM, IoT
     #     SiteWise returns the first interpolated value on July 2, 2021, at 9
     #     AM, the second interpolated value on July 3, 2021, at 9 AM, and so
     #     on.
@@ -2555,28 +2761,28 @@ module Aws::IoTSiteWise
     #     forward this interpolated value until a new data point is found.
     #
     #     For example, you can get the state of an on-off valve every 24 hours
-    #     over a duration of 7 days. If the interpolation starts on July 1,
-    #     2021, at 9 AM, IoT SiteWise returns the last observed data point
-    #     between July 1, 2021, at 9 AM and July 2, 2021, at 9 AM as the first
-    #     interpolated value. If no data point is found after 9 AM on July 2,
-    #     2021, IoT SiteWise uses the same interpolated value for the rest of
-    #     the days.
+    #     over a duration of 7 days. If the interpolation starts July 1, 2021,
+    #     at 9 AM, IoT SiteWise returns the last observed data point between
+    #     July 1, 2021, at 9 AM and July 2, 2021, at 9 AM as the first
+    #     interpolated value. If a data point isn't found after 9 AM on July
+    #     2, 2021, IoT SiteWise uses the same interpolated value for the rest
+    #     of the days.
     #
     #
     #
     #   [1]: https://en.wikipedia.org/wiki/Linear_interpolation
     #
     # @option params [Integer] :interval_window_in_seconds
-    #   The query interval for the window in seconds. IoT SiteWise computes
+    #   The query interval for the window, in seconds. IoT SiteWise computes
     #   each interpolated value by using data points from the timestamp of
-    #   each interval minus the window to the timestamp of each interval plus
-    #   the window. If not specified, the window is between the start time
+    #   each interval, minus the window to the timestamp of each interval plus
+    #   the window. If not specified, the window ranges between the start time
     #   minus the interval and the end time plus the interval.
     #
     #   <note markdown="1"> * If you specify a value for the `intervalWindowInSeconds` parameter,
-    #     the `type` parameter must be `LINEAR_INTERPOLATION`.
+    #     the value for the `type` parameter must be `LINEAR_INTERPOLATION`.
     #
-    #   * If no data point is found during the specified query window, IoT
+    #   * If a data point isn't found during the specified query window, IoT
     #     SiteWise won't return an interpolated value for the interval. This
     #     indicates that there's a gap in the ingested data points.
     #
@@ -2585,11 +2791,11 @@ module Aws::IoTSiteWise
     #   For example, you can get the interpolated temperature values for a
     #   wind turbine every 24 hours over a duration of 7 days. If the
     #   interpolation starts on July 1, 2021, at 9 AM with a window of 2
-    #   hours, IoT SiteWise uses the data points from 7 AM (9 AM - 2 hours) to
-    #   11 AM (9 AM + 2 hours) on July 2, 2021 to compute the first
-    #   interpolated value, uses the data points from 7 AM (9 AM - 2 hours) to
-    #   11 AM (9 AM + 2 hours) on July 3, 2021 to compute the second
-    #   interpolated value, and so on.
+    #   hours, IoT SiteWise uses the data points from 7 AM (9 AM minus 2
+    #   hours) to 11 AM (9 AM plus 2 hours) on July 2, 2021 to compute the
+    #   first interpolated value. Next, IoT SiteWise uses the data points from
+    #   7 AM (9 AM minus 2 hours) to 11 AM (9 AM plus 2 hours) on July 3, 2021
+    #   to compute the second interpolated value, and so on.
     #
     # @return [Types::GetInterpolatedAssetPropertyValuesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3247,6 +3453,66 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
+    # Retrieves a paginated list of time series (data streams).
+    #
+    # @option params [String] :next_token
+    #   The token to be used for the next set of paginated results.
+    #
+    # @option params [Integer] :max_results
+    #   The maximum number of results to return for each paginated request.
+    #
+    # @option params [String] :asset_id
+    #   The ID of the asset in which the asset property was created.
+    #
+    # @option params [String] :alias_prefix
+    #   The alias prefix of the time series.
+    #
+    # @option params [String] :time_series_type
+    #   The type of the time series. The time series type can be one of the
+    #   following values:
+    #
+    #   * `ASSOCIATED` – The time series is associated with an asset property.
+    #
+    #   * `DISASSOCIATED` – The time series isn't associated with any asset
+    #     property.
+    #
+    # @return [Types::ListTimeSeriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::ListTimeSeriesResponse#time_series_summaries #time_series_summaries} => Array&lt;Types::TimeSeriesSummary&gt;
+    #   * {Types::ListTimeSeriesResponse#next_token #next_token} => String
+    #
+    # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.list_time_series({
+    #     next_token: "NextToken",
+    #     max_results: 1,
+    #     asset_id: "ID",
+    #     alias_prefix: "PropertyAlias",
+    #     time_series_type: "ASSOCIATED", # accepts ASSOCIATED, DISASSOCIATED
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.time_series_summaries #=> Array
+    #   resp.time_series_summaries[0].asset_id #=> String
+    #   resp.time_series_summaries[0].property_id #=> String
+    #   resp.time_series_summaries[0].alias #=> String
+    #   resp.time_series_summaries[0].time_series_id #=> String
+    #   resp.time_series_summaries[0].data_type #=> String, one of "STRING", "INTEGER", "DOUBLE", "BOOLEAN", "STRUCT"
+    #   resp.time_series_summaries[0].data_type_spec #=> String
+    #   resp.time_series_summaries[0].time_series_creation_date #=> Time
+    #   resp.time_series_summaries[0].time_series_last_update_date #=> Time
+    #   resp.next_token #=> String
+    #
+    # @overload list_time_series(params = {})
+    # @param [Hash] params ({})
+    def list_time_series(params = {}, options = {})
+      req = build_request(:list_time_series, params)
+      req.send_request(options)
+    end
+
     # Sets the default encryption configuration for the Amazon Web Services
     # account. For more information, see [Key management][1] in the *IoT
     # SiteWise User Guide*.
@@ -3259,8 +3525,8 @@ module Aws::IoTSiteWise
     #   The type of encryption used for the encryption configuration.
     #
     # @option params [String] :kms_key_id
-    #   The Key ID of the customer managed customer master key (CMK) used for
-    #   KMS encryption. This is required if you use `KMS_BASED_ENCRYPTION`.
+    #   The Key ID of the customer managed key used for KMS encryption. This
+    #   is required if you use `KMS_BASED_ENCRYPTION`.
     #
     # @return [Types::PutDefaultEncryptionConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3315,25 +3581,52 @@ module Aws::IoTSiteWise
     # Configures storage settings for IoT SiteWise.
     #
     # @option params [required, String] :storage_type
-    #   The type of storage that you specified for your data. The storage type
-    #   can be one of the following values:
+    #   The storage tier that you specified for your data. The `storageType`
+    #   parameter can be one of the following values:
     #
-    #   * `SITEWISE_DEFAULT_STORAGE` – IoT SiteWise replicates your data into
-    #     a service managed database.
+    #   * `SITEWISE_DEFAULT_STORAGE` – IoT SiteWise saves your data into the
+    #     hot tier. The hot tier is a service-managed database.
     #
-    #   * `MULTI_LAYER_STORAGE` – IoT SiteWise replicates your data into a
-    #     service managed database and saves a copy of your raw data and
-    #     metadata in an Amazon S3 object that you specified.
+    #   * `MULTI_LAYER_STORAGE` – IoT SiteWise saves your data in both the
+    #     cold tier and the cold tier. The cold tier is a customer-managed
+    #     Amazon S3 bucket.
     #
     # @option params [Types::MultiLayerStorage] :multi_layer_storage
     #   Identifies a storage destination. If you specified
     #   `MULTI_LAYER_STORAGE` for the storage type, you must specify a
     #   `MultiLayerStorage` object.
     #
+    # @option params [String] :disassociated_data_storage
+    #   Contains the storage configuration for time series (data streams) that
+    #   aren't associated with asset properties. The
+    #   `disassociatedDataStorage` can be one of the following values:
+    #
+    #   * `ENABLED` – IoT SiteWise accepts time series that aren't associated
+    #     with asset properties.
+    #
+    #     After the `disassociatedDataStorage` is enabled, you can't disable
+    #     it.
+    #
+    #   * `DISABLED` – IoT SiteWise doesn't accept time series (data streams)
+    #     that aren't associated with asset properties.
+    #
+    #   For more information, see [Data streams][1] in the *IoT SiteWise User
+    #   Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/data-streams.html
+    #
+    # @option params [Types::RetentionPeriod] :retention_period
+    #   How many days your data is kept in the hot tier. By default, your data
+    #   is kept indefinitely in the hot tier.
+    #
     # @return [Types::PutStorageConfigurationResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::PutStorageConfigurationResponse#storage_type #storage_type} => String
     #   * {Types::PutStorageConfigurationResponse#multi_layer_storage #multi_layer_storage} => Types::MultiLayerStorage
+    #   * {Types::PutStorageConfigurationResponse#disassociated_data_storage #disassociated_data_storage} => String
+    #   * {Types::PutStorageConfigurationResponse#retention_period #retention_period} => Types::RetentionPeriod
     #   * {Types::PutStorageConfigurationResponse#configuration_status #configuration_status} => Types::ConfigurationStatus
     #
     # @example Request syntax with placeholder values
@@ -3346,6 +3639,11 @@ module Aws::IoTSiteWise
     #         role_arn: "ARN", # required
     #       },
     #     },
+    #     disassociated_data_storage: "ENABLED", # accepts ENABLED, DISABLED
+    #     retention_period: {
+    #       number_of_days: 1,
+    #       unlimited: false,
+    #     },
     #   })
     #
     # @example Response structure
@@ -3353,6 +3651,9 @@ module Aws::IoTSiteWise
     #   resp.storage_type #=> String, one of "SITEWISE_DEFAULT_STORAGE", "MULTI_LAYER_STORAGE"
     #   resp.multi_layer_storage.customer_managed_s3_storage.s3_resource_arn #=> String
     #   resp.multi_layer_storage.customer_managed_s3_storage.role_arn #=> String
+    #   resp.disassociated_data_storage #=> String, one of "ENABLED", "DISABLED"
+    #   resp.retention_period.number_of_days #=> Integer
+    #   resp.retention_period.unlimited #=> Boolean
     #   resp.configuration_status.state #=> String, one of "ACTIVE", "UPDATE_IN_PROGRESS", "UPDATE_FAILED"
     #   resp.configuration_status.error.code #=> String, one of "VALIDATION_ERROR", "INTERNAL_FAILURE"
     #   resp.configuration_status.error.message #=> String
@@ -4124,7 +4425,7 @@ module Aws::IoTSiteWise
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-iotsitewise'
-      context[:gem_version] = '1.34.0'
+      context[:gem_version] = '1.38.0'
       Seahorse::Client::Request.new(handlers, context)
     end