aws-sdk-iotsitewise 1.6.0 → 1.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: add6490ae42c4a4806dde49082511cecaf4e92efd57bfe4fc0608e32d2728a8d
-  data.tar.gz: '0738ee6ed9ae08bbe450341cf3c6e4916051904b7bf3177115be2ca256955df9'
+  metadata.gz: 58db42ef833feb7565fd341eabbf2880f9793ce9c698dd698bd0059e9a3e1477
+  data.tar.gz: 128c16cc63ed3a0f1ebfd08ae1d9d9b2377f2d10cd1e809fcdbd41b100b3198c
 SHA512:
-  metadata.gz: 0e211d306f47d2187907dd29dcd898cdfbe91f10ecca7598f5c0b77533b4b888a8b40105f9ed6b3c67fe858312bb0671664025bf2ccc1cbab6fb14f94ad99db1
-  data.tar.gz: 2ac9c139e3e70f57b0f5778bcce07e6e89cf0b0bf2c4d6da467d25bf88a4ad8d63a1fb30c616819000b94b1989780d65eaa0105ec89aba3582faad5eb32a367e
+  metadata.gz: 1f76a3be9a0c186966535526f0b6ddf6f50905af145d6e49cd7dde99be6d8efea0d37ebe61c368f214d521513180a7685485abd9e76f300f07918419dad0948b
+  data.tar.gz: 73e9b21dcde1c9f681b073fc662c153d21b8b42b53eadc3ee60f5c61bf263d263e9c3e30f96095b73d73f830c96092f2219cdbb08149ca6202e7cb447cc52982

data/lib/aws-sdk-iotsitewise.rb

@@ -7,6 +7,7 @@
 #
 # WARNING ABOUT GENERATED CODE
 
+
 require 'aws-sdk-core'
 require 'aws-sigv4'
 
@@ -45,9 +46,9 @@ require_relative 'aws-sdk-iotsitewise/customizations'
 #
 # See {Errors} for more information.
 #
-# @service
+# @!group service
 module Aws::IoTSiteWise
 
-  GEM_VERSION = '1.6.0'
+  GEM_VERSION = '1.12.0'
 
 end

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

@@ -85,13 +85,28 @@ module Aws::IoTSiteWise
     #     * `Aws::Credentials` - Used for configuring static, non-refreshing
     #       credentials.
     #
+    #     * `Aws::SharedCredentials` - Used for loading static credentials from a
+    #       shared file, such as `~/.aws/config`.
+    #
+    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #
+    #     * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
+    #       assume a role after providing credentials via the web.
+    #
+    #     * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
+    #       access token generated from `aws login`.
+    #
+    #     * `Aws::ProcessCredentials` - Used for loading credentials from a
+    #       process that outputs to stdout.
+    #
     #     * `Aws::InstanceProfileCredentials` - Used for loading credentials
     #       from an EC2 IMDS on an EC2 instance.
     #
-    #     * `Aws::SharedCredentials` - Used for loading credentials from a
-    #       shared file, such as `~/.aws/config`.
+    #     * `Aws::ECSCredentials` - Used for loading credentials from
+    #       instances running in ECS.
     #
-    #     * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
+    #     * `Aws::CognitoIdentityCredentials` - Used for loading credentials
+    #       from the Cognito Identity service.
     #
     #     When `:credentials` are not configured directly, the following
     #     locations will be searched for credentials:
@@ -101,10 +116,10 @@ module Aws::IoTSiteWise
     #     * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
     #     * `~/.aws/credentials`
     #     * `~/.aws/config`
-    #     * EC2 IMDS instance profile - When used by default, the timeouts are
-    #       very aggressive. Construct and pass an instance of
-    #       `Aws::InstanceProfileCredentails` to enable retries and extended
-    #       timeouts.
+    #     * 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.
     #
     #   @option options [required, String] :region
     #     The AWS region to connect to.  The configured `:region` is
@@ -314,7 +329,7 @@ module Aws::IoTSiteWise
 
     # 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][1] in the *AWS IoT SiteWise User Guide*.
+    # see [Associating assets][1] in the *AWS IoT SiteWise User Guide*.
     #
     #
     #
@@ -326,7 +341,7 @@ module Aws::IoTSiteWise
     # @option params [required, String] :hierarchy_id
     #   The ID of a hierarchy in the parent asset's model. Hierarchies allow
     #   different groupings of assets to be formed that all come from the same
-    #   asset model. For more information, see [Asset Hierarchies][1] in the
+    #   asset model. For more information, see [Asset hierarchies][1] in the
     #   *AWS IoT SiteWise User Guide*.
     #
     #
@@ -450,7 +465,7 @@ module Aws::IoTSiteWise
 
     # Sends a list of asset property values to AWS IoT SiteWise. Each value
     # is a timestamp-quality-value (TQV) data point. For more information,
-    # see [Ingesting Data Using the API][1] in the *AWS IoT SiteWise User
+    # see [Ingesting data using the API][1] in the *AWS IoT SiteWise User
     # Guide*.
     #
     # To identify an asset property, you must specify one of the following:
@@ -472,10 +487,16 @@ module Aws::IoTSiteWise
     # example, if you store a TQV `\{T1, GOOD, V1\}`, then storing `\{T1,
     # GOOD, V2\}` replaces the existing TQV.
     #
+    # AWS IoT SiteWise authorizes access to each
+    # `BatchPutAssetPropertyValue` entry individually. For more information,
+    # see [BatchPutAssetPropertyValue authorization][3] in the *AWS IoT
+    # SiteWise User Guide*.
+    #
     #
     #
     # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/ingest-api.html
     # [2]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html
+    # [3]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/security_iam_service-with-iam.html#security_iam_service-with-iam-id-based-policies-batchputassetpropertyvalue-action
     #
     # @option params [required, Array<Types::PutAssetPropertyValueEntry>] :entries
     #   The list of asset property value entries for the batch put request.
@@ -531,17 +552,17 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Creates an access policy that grants the specified AWS Single Sign-On
-    # user or group access to the specified AWS IoT SiteWise Monitor portal
-    # or project resource.
+    # Creates an access policy that grants the specified identity (AWS SSO
+    # user, AWS SSO group, or IAM user) access to the specified AWS IoT
+    # SiteWise Monitor portal or project resource.
     #
     # @option params [required, Types::Identity] :access_policy_identity
-    #   The identity for this access policy. Choose either a `user` or a
-    #   `group` but not both.
+    #   The identity for this access policy. Choose an AWS SSO user, an AWS
+    #   SSO group, or an IAM user.
     #
     # @option params [required, Types::Resource] :access_policy_resource
     #   The AWS IoT SiteWise Monitor resource for this access policy. Choose
-    #   either `portal` or `project` but not both.
+    #   either a portal or a project.
     #
     # @option params [required, String] :access_policy_permission
     #   The permission level for this access policy. Note that a project
@@ -579,6 +600,9 @@ module Aws::IoTSiteWise
     #       group: {
     #         id: "IdentityId", # required
     #       },
+    #       iam_user: {
+    #         arn: "ARN", # required
+    #       },
     #     },
     #     access_policy_resource: { # required
     #       portal: {
@@ -608,7 +632,7 @@ module Aws::IoTSiteWise
     end
 
     # Creates an asset from an existing asset model. For more information,
-    # see [Creating Assets][1] in the *AWS IoT SiteWise User Guide*.
+    # see [Creating assets][1] in the *AWS IoT SiteWise User Guide*.
     #
     #
     #
@@ -674,7 +698,7 @@ module Aws::IoTSiteWise
     # 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][1] in the *AWS IoT SiteWise User Guide*.
+    # [Defining asset models][1] in the *AWS IoT SiteWise User Guide*.
     #
     #
     #
@@ -688,7 +712,7 @@ module Aws::IoTSiteWise
     #
     # @option params [Array<Types::AssetModelPropertyDefinition>] :asset_model_properties
     #   The property definitions of the asset model. For more information, see
-    #   [Asset Properties][1] in the *AWS IoT SiteWise User Guide*.
+    #   [Asset properties][1] in the *AWS IoT SiteWise User Guide*.
     #
     #   You can specify up to 200 properties per asset model. For more
     #   information, see [Quotas][2] in the *AWS IoT SiteWise User Guide*.
@@ -702,7 +726,7 @@ module Aws::IoTSiteWise
     #   The hierarchy definitions of the asset model. Each hierarchy specifies
     #   an asset model whose assets can be children of any other assets
     #   created from this asset model. For more information, see [Asset
-    #   Hierarchies][1] in the *AWS IoT SiteWise User Guide*.
+    #   hierarchies][1] in the *AWS IoT SiteWise User Guide*.
     #
     #   You can specify up to 10 hierarchies per asset model. For more
     #   information, see [Quotas][2] in the *AWS IoT SiteWise User Guide*.
@@ -823,7 +847,7 @@ module Aws::IoTSiteWise
     #
     # @option params [required, String] :dashboard_definition
     #   The dashboard definition specified in a JSON literal. For detailed
-    #   information, see [Creating Dashboards (CLI)][1] in the *AWS IoT
+    #   information, see [Creating dashboards (CLI)][1] in the *AWS IoT
     #   SiteWise User Guide*.
     #
     #
@@ -933,23 +957,19 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Creates a portal, which can contain projects and dashboards. Before
-    # you can create a portal, you must configure AWS Single Sign-On in the
-    # current Region. AWS IoT SiteWise Monitor uses AWS SSO to manage user
-    # permissions. For more information, see [Enabling AWS SSO][1] in the
-    # *AWS IoT SiteWise User Guide*.
+    # Creates a portal, which can contain projects and dashboards. AWS IoT
+    # SiteWise Monitor uses AWS SSO or IAM to authenticate portal users and
+    # manage user permissions.
     #
-    # <note markdown="1"> Before you can sign in to a new portal, you must add at least one AWS
-    # SSO user or group to that portal. For more information, see [Adding or
-    # Removing Portal Administrators][2] in the *AWS IoT SiteWise User
-    # Guide*.
+    # <note markdown="1"> Before you can sign in to a new portal, you must add at least one
+    # identity to that portal. For more information, see [Adding or removing
+    # portal administrators][1] in the *AWS IoT SiteWise User Guide*.
     #
     #  </note>
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-get-started.html#mon-gs-sso
-    # [2]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/administer-portals.html#portal-change-admins
     #
     # @option params [required, String] :portal_name
     #   A friendly name for the portal.
@@ -992,6 +1012,30 @@ module Aws::IoTSiteWise
     #
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html
     #
+    # @option params [String] :portal_auth_mode
+    #   The service to use to authenticate users to the portal. Choose from
+    #   the following options:
+    #
+    #   * `SSO` – The portal uses AWS Single Sign-On to authenticate users and
+    #     manage user permissions. Before you can create a portal that uses
+    #     AWS SSO, you must enable AWS SSO. For more information, see
+    #     [Enabling AWS SSO][1] in the *AWS IoT SiteWise User Guide*. This
+    #     option is only available in AWS Regions other than the China
+    #     Regions.
+    #
+    #   * `IAM` – The portal uses AWS Identity and Access Management (IAM) to
+    #     authenticate users and manage user permissions. IAM users must have
+    #     the `iotsitewise:CreatePresignedPortalUrl` permission to sign in to
+    #     the portal. This option is only available in the China Regions.
+    #
+    #   You can't change this value after you create a portal.
+    #
+    #   Default: `SSO`
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/monitor-get-started.html#mon-gs-sso
+    #
     # @return [Types::CreatePortalResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreatePortalResponse#portal_id #portal_id} => String
@@ -1015,6 +1059,7 @@ module Aws::IoTSiteWise
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
+    #     portal_auth_mode: "IAM", # accepts IAM, SSO
     #   })
     #
     # @example Response structure
@@ -1023,7 +1068,7 @@ module Aws::IoTSiteWise
     #   resp.portal_arn #=> String
     #   resp.portal_start_url #=> String
     #   resp.portal_status.state #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE", "FAILED"
-    #   resp.portal_status.error.code #=> String, one of "INTERNAL_FAILURE"
+    #   resp.portal_status.error.code #=> String, one of "INTERNAL_FAILURE", "VALIDATION_ERROR", "LIMIT_EXCEEDED"
     #   resp.portal_status.error.message #=> String
     #   resp.sso_application_id #=> String
     #
@@ -1034,6 +1079,42 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
+    # Creates a pre-signed URL to a portal. Use this operation to create
+    # URLs to portals that use AWS Identity and Access Management (IAM) to
+    # authenticate users. An IAM user with access to a portal can call this
+    # API to get a URL to that portal. The URL contains a session token that
+    # lets the IAM user access the portal.
+    #
+    # @option params [required, String] :portal_id
+    #   The ID of the portal to access.
+    #
+    # @option params [Integer] :session_duration_seconds
+    #   The duration (in seconds) for which the session at the URL is valid.
+    #
+    #   Default: 900 seconds (15 minutes)
+    #
+    # @return [Types::CreatePresignedPortalUrlResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
+    #
+    #   * {Types::CreatePresignedPortalUrlResponse#presigned_portal_url #presigned_portal_url} => String
+    #
+    # @example Request syntax with placeholder values
+    #
+    #   resp = client.create_presigned_portal_url({
+    #     portal_id: "ID", # required
+    #     session_duration_seconds: 1,
+    #   })
+    #
+    # @example Response structure
+    #
+    #   resp.presigned_portal_url #=> String
+    #
+    # @overload create_presigned_portal_url(params = {})
+    # @param [Hash] params ({})
+    def create_presigned_portal_url(params = {}, options = {})
+      req = build_request(:create_presigned_portal_url, params)
+      req.send_request(options)
+    end
+
     # Creates a project in the specified portal.
     #
     # @option params [required, String] :portal_id
@@ -1091,10 +1172,9 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Deletes an access policy that grants the specified AWS Single Sign-On
-    # identity access to the specified AWS IoT SiteWise Monitor resource.
-    # You can use this operation to revoke access to an AWS IoT SiteWise
-    # Monitor resource.
+    # Deletes an access policy that grants the specified identity access to
+    # the specified AWS IoT SiteWise Monitor resource. You can use this
+    # operation to revoke access to an AWS IoT SiteWise Monitor resource.
     #
     # @option params [required, String] :access_policy_id
     #   The ID of the access policy to be deleted.
@@ -1124,7 +1204,7 @@ module Aws::IoTSiteWise
     end
 
     # Deletes an asset. This action can't be undone. For more information,
-    # see [Deleting Assets and Models][1] in the *AWS IoT SiteWise User
+    # see [Deleting assets and models][1] in the *AWS IoT SiteWise User
     # Guide*.
     #
     # <note markdown="1"> You can't delete an asset that's associated to another asset. For
@@ -1177,7 +1257,7 @@ module Aws::IoTSiteWise
     # 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][1] in the *AWS IoT SiteWise User Guide*.
+    # [Deleting assets and models][1] in the *AWS IoT SiteWise User Guide*.
     #
     #
     #
@@ -1249,12 +1329,6 @@ module Aws::IoTSiteWise
 
     # Deletes a gateway from AWS IoT SiteWise. When you delete a gateway,
     # some of the gateway's files remain in your gateway's file system.
-    # For more information, see [Data retention][1] in the *AWS IoT SiteWise
-    # User Guide*.
-    #
-    #
-    #
-    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/data-retention.html
     #
     # @option params [required, String] :gateway_id
     #   The ID of the gateway to delete.
@@ -1301,7 +1375,7 @@ module Aws::IoTSiteWise
     # @example Response structure
     #
     #   resp.portal_status.state #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE", "FAILED"
-    #   resp.portal_status.error.code #=> String, one of "INTERNAL_FAILURE"
+    #   resp.portal_status.error.code #=> String, one of "INTERNAL_FAILURE", "VALIDATION_ERROR", "LIMIT_EXCEEDED"
     #   resp.portal_status.error.message #=> String
     #
     # @overload delete_portal(params = {})
@@ -1340,8 +1414,8 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Describes an access policy, which specifies an AWS SSO user or
-    # group's access to an AWS IoT SiteWise Monitor portal or project.
+    # Describes an access policy, which specifies an identity's access to
+    # an AWS IoT SiteWise Monitor portal or project.
     #
     # @option params [required, String] :access_policy_id
     #   The ID of the access policy.
@@ -1368,6 +1442,7 @@ module Aws::IoTSiteWise
     #   resp.access_policy_arn #=> String
     #   resp.access_policy_identity.user.id #=> String
     #   resp.access_policy_identity.group.id #=> String
+    #   resp.access_policy_identity.iam_user.arn #=> String
     #   resp.access_policy_resource.portal.id #=> String
     #   resp.access_policy_resource.project.id #=> String
     #   resp.access_policy_permission #=> String, one of "ADMINISTRATOR", "VIEWER"
@@ -1509,7 +1584,21 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Retrieves information about an asset's property.
+    # Retrieves information about an asset property.
+    #
+    # <note markdown="1"> When you call this operation for an attribute property, this response
+    # includes the default attribute value that you define in the asset
+    # model. If you update the default value in the model, this operation's
+    # response includes the new default value.
+    #
+    #  </note>
+    #
+    # This operation doesn't return the value of the asset property. To get
+    # the value of an asset property, use [GetAssetPropertyValue][1].
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_GetAssetPropertyValue.html
     #
     # @option params [required, String] :asset_id
     #   The ID of the asset.
@@ -1729,6 +1818,7 @@ module Aws::IoTSiteWise
     #   * {Types::DescribePortalResponse#portal_last_update_date #portal_last_update_date} => Time
     #   * {Types::DescribePortalResponse#portal_logo_image_location #portal_logo_image_location} => Types::ImageLocation
     #   * {Types::DescribePortalResponse#role_arn #role_arn} => String
+    #   * {Types::DescribePortalResponse#portal_auth_mode #portal_auth_mode} => String
     #
     # @example Request syntax with placeholder values
     #
@@ -1746,13 +1836,14 @@ module Aws::IoTSiteWise
     #   resp.portal_start_url #=> String
     #   resp.portal_contact_email #=> String
     #   resp.portal_status.state #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE", "FAILED"
-    #   resp.portal_status.error.code #=> String, one of "INTERNAL_FAILURE"
+    #   resp.portal_status.error.code #=> String, one of "INTERNAL_FAILURE", "VALIDATION_ERROR", "LIMIT_EXCEEDED"
     #   resp.portal_status.error.message #=> String
     #   resp.portal_creation_date #=> Time
     #   resp.portal_last_update_date #=> Time
     #   resp.portal_logo_image_location.id #=> String
     #   resp.portal_logo_image_location.url #=> String
     #   resp.role_arn #=> String
+    #   resp.portal_auth_mode #=> String, one of "IAM", "SSO"
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -1816,7 +1907,7 @@ module Aws::IoTSiteWise
     #   different groupings of assets to be formed that all come from the same
     #   asset model. You can use the hierarchy ID to identify the correct
     #   asset to disassociate. For more information, see [Asset
-    #   Hierarchies][1] in the *AWS IoT SiteWise User Guide*.
+    #   hierarchies][1] in the *AWS IoT SiteWise User Guide*.
     #
     #
     #
@@ -1852,8 +1943,7 @@ module Aws::IoTSiteWise
     end
 
     # Gets aggregated values for an asset property. For more information,
-    # see [Querying Aggregated Property Values][1] in the *AWS IoT SiteWise
-    # User Guide*.
+    # see [Querying aggregates][1] in the *AWS IoT SiteWise User Guide*.
     #
     # To identify an asset property, you must specify one of the following:
     #
@@ -1878,7 +1968,7 @@ module Aws::IoTSiteWise
     #   The property 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
+    #   see [Mapping industrial data streams to asset properties][1] in the
     #   *AWS IoT SiteWise User Guide*.
     #
     #
@@ -1905,12 +1995,16 @@ module Aws::IoTSiteWise
     # @option params [String] :time_ordering
     #   The chronological sorting order of the requested information.
     #
+    #   Default: `ASCENDING`
+    #
     # @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 be returned per paginated request.
     #
+    #   Default: 100
+    #
     # @return [Types::GetAssetPropertyAggregatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetAssetPropertyAggregatesResponse#aggregated_values #aggregated_values} => Array&lt;Types::AggregatedValue&gt;
@@ -1955,8 +2049,7 @@ module Aws::IoTSiteWise
     end
 
     # Gets an asset property's current value. For more information, see
-    # [Querying Current Property Values][1] in the *AWS IoT SiteWise User
-    # Guide*.
+    # [Querying current values][1] in the *AWS IoT SiteWise User Guide*.
     #
     # To identify an asset property, you must specify one of the following:
     #
@@ -1981,7 +2074,7 @@ module Aws::IoTSiteWise
     #   The property 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
+    #   see [Mapping industrial data streams to asset properties][1] in the
     #   *AWS IoT SiteWise User Guide*.
     #
     #
@@ -2018,8 +2111,8 @@ module Aws::IoTSiteWise
     end
 
     # Gets the history of an asset property's values. For more information,
-    # see [Querying Historical Property Values][1] in the *AWS IoT SiteWise
-    # User Guide*.
+    # see [Querying historical values][1] in the *AWS IoT SiteWise User
+    # Guide*.
     #
     # To identify an asset property, you must specify one of the following:
     #
@@ -2044,18 +2137,18 @@ module Aws::IoTSiteWise
     #   The property 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
+    #   see [Mapping industrial data streams to asset properties][1] in the
     #   *AWS IoT SiteWise User Guide*.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/connect-data-streams.html
     #
-    # @option params [required, Time,DateTime,Date,Integer,String] :start_date
+    # @option params [Time,DateTime,Date,Integer,String] :start_date
     #   The exclusive start of the range from which to query historical data,
     #   expressed in seconds in Unix epoch time.
     #
-    # @option params [required, Time,DateTime,Date,Integer,String] :end_date
+    # @option params [Time,DateTime,Date,Integer,String] :end_date
     #   The inclusive end of the range from which to query historical data,
     #   expressed in seconds in Unix epoch time.
     #
@@ -2065,12 +2158,16 @@ module Aws::IoTSiteWise
     # @option params [String] :time_ordering
     #   The chronological sorting order of the requested information.
     #
+    #   Default: `ASCENDING`
+    #
     # @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 be returned per paginated request.
     #
+    #   Default: 100
+    #
     # @return [Types::GetAssetPropertyValueHistoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetAssetPropertyValueHistoryResponse#asset_property_value_history #asset_property_value_history} => Array&lt;Types::AssetPropertyValue&gt;
@@ -2084,8 +2181,8 @@ module Aws::IoTSiteWise
     #     asset_id: "ID",
     #     property_id: "ID",
     #     property_alias: "AssetPropertyAlias",
-    #     start_date: Time.now, # required
-    #     end_date: Time.now, # required
+    #     start_date: Time.now,
+    #     end_date: Time.now,
     #     qualities: ["GOOD"], # accepts GOOD, BAD, UNCERTAIN
     #     time_ordering: "ASCENDING", # accepts ASCENDING, DESCENDING
     #     next_token: "NextToken",
@@ -2111,17 +2208,17 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Retrieves a paginated list of access policies for an AWS SSO identity
-    # (a user or group) or an AWS IoT SiteWise Monitor resource (a portal or
-    # project).
+    # Retrieves a paginated list of access policies for an identity (an AWS
+    # SSO user, an AWS SSO group, or an IAM user) or an AWS IoT SiteWise
+    # Monitor resource (a portal or project).
     #
     # @option params [String] :identity_type
-    #   The type of identity (user or group). This parameter is required if
-    #   you specify `identityId`.
+    #   The type of identity (AWS SSO user, AWS SSO group, or IAM user). This
+    #   parameter is required if you specify `identityId`.
     #
     # @option params [String] :identity_id
     #   The ID of the identity. This parameter is required if you specify
-    #   `identityType`.
+    #   `USER` or `GROUP` for `identityType`.
     #
     # @option params [String] :resource_type
     #   The type of resource (portal or project). This parameter is required
@@ -2131,12 +2228,23 @@ module Aws::IoTSiteWise
     #   The ID of the resource. This parameter is required if you specify
     #   `resourceType`.
     #
+    # @option params [String] :iam_arn
+    #   The ARN of the IAM user. For more information, see [IAM ARNs][1] in
+    #   the *IAM User Guide*. This parameter is required if you specify `IAM`
+    #   for `identityType`.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_identifiers.html
+    #
     # @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 be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @return [Types::ListAccessPoliciesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListAccessPoliciesResponse#access_policy_summaries #access_policy_summaries} => Array&lt;Types::AccessPolicySummary&gt;
@@ -2147,10 +2255,11 @@ module Aws::IoTSiteWise
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_access_policies({
-    #     identity_type: "USER", # accepts USER, GROUP
+    #     identity_type: "USER", # accepts USER, GROUP, IAM
     #     identity_id: "IdentityId",
     #     resource_type: "PORTAL", # accepts PORTAL, PROJECT
     #     resource_id: "ID",
+    #     iam_arn: "ARN",
     #     next_token: "NextToken",
     #     max_results: 1,
     #   })
@@ -2161,6 +2270,7 @@ module Aws::IoTSiteWise
     #   resp.access_policy_summaries[0].id #=> String
     #   resp.access_policy_summaries[0].identity.user.id #=> String
     #   resp.access_policy_summaries[0].identity.group.id #=> String
+    #   resp.access_policy_summaries[0].identity.iam_user.arn #=> String
     #   resp.access_policy_summaries[0].resource.portal.id #=> String
     #   resp.access_policy_summaries[0].resource.project.id #=> String
     #   resp.access_policy_summaries[0].permission #=> String, one of "ADMINISTRATOR", "VIEWER"
@@ -2183,6 +2293,8 @@ module Aws::IoTSiteWise
     # @option params [Integer] :max_results
     #   The maximum number of results to be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @return [Types::ListAssetModelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListAssetModelsResponse#asset_model_summaries #asset_model_summaries} => Array&lt;Types::AssetModelSummary&gt;
@@ -2241,13 +2353,15 @@ module Aws::IoTSiteWise
     # @option params [Integer] :max_results
     #   The maximum number of results to be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @option params [String] :asset_model_id
     #   The ID of the asset model by which to filter the list of assets. This
     #   parameter is required if you choose `ALL` for `filter`.
     #
     # @option params [String] :filter
     #   The filter for the requested list of assets. Choose one of the
-    #   following options. Defaults to `ALL`.
+    #   following options:
     #
     #   * `ALL` – The list includes all assets for a given asset model ID. The
     #     `assetModelId` parameter is required if you filter by `ALL`.
@@ -2255,6 +2369,8 @@ module Aws::IoTSiteWise
     #   * `TOP_LEVEL` – The list includes only top-level assets in the asset
     #     hierarchy tree.
     #
+    #   Default: `ALL`
+    #
     # @return [Types::ListAssetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListAssetsResponse#asset_summaries #asset_summaries} => Array&lt;Types::AssetSummary&gt;
@@ -2295,18 +2411,25 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Retrieves a paginated list of the assets associated to a parent asset
-    # (`assetId`) by a given hierarchy (`hierarchyId`).
+    # Retrieves a paginated list of associated assets.
+    #
+    # You can use this operation to do the following:
+    #
+    # * List child assets associated to a parent asset by a hierarchy that
+    #   you specify.
+    #
+    # * List an asset's parent asset.
     #
     # @option params [required, String] :asset_id
-    #   The ID of the parent asset.
+    #   The ID of the asset to query.
     #
-    # @option params [required, String] :hierarchy_id
-    #   The hierarchy ID (of the parent asset model) whose associated assets
-    #   are returned. To find a hierarchy ID, use the [DescribeAsset][1] or
-    #   [DescribeAssetModel][2] actions.
+    # @option params [String] :hierarchy_id
+    #   The ID of the hierarchy by which child assets are associated to the
+    #   asset. To find a hierarchy ID, use the [DescribeAsset][1] or
+    #   [DescribeAssetModel][2] operations. This parameter is required if you
+    #   choose `CHILD` for `traversalDirection`.
     #
-    #   For more information, see [Asset Hierarchies][3] in the *AWS IoT
+    #   For more information, see [Asset hierarchies][3] in the *AWS IoT
     #   SiteWise User Guide*.
     #
     #
@@ -2315,12 +2438,26 @@ module Aws::IoTSiteWise
     #   [2]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html
     #   [3]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-hierarchies.html
     #
+    # @option params [String] :traversal_direction
+    #   The direction to list associated assets. Choose one of the following
+    #   options:
+    #
+    #   * `CHILD` – The list includes all child assets associated to the
+    #     asset. The `hierarchyId` parameter is required if you choose
+    #     `CHILD`.
+    #
+    #   * `PARENT` – The list includes the asset's parent asset.
+    #
+    #   Default: `CHILD`
+    #
     # @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 be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @return [Types::ListAssociatedAssetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListAssociatedAssetsResponse#asset_summaries #asset_summaries} => Array&lt;Types::AssociatedAssetsSummary&gt;
@@ -2332,7 +2469,8 @@ module Aws::IoTSiteWise
     #
     #   resp = client.list_associated_assets({
     #     asset_id: "ID", # required
-    #     hierarchy_id: "ID", # required
+    #     hierarchy_id: "ID",
+    #     traversal_direction: "PARENT", # accepts PARENT, CHILD
     #     next_token: "NextToken",
     #     max_results: 1,
     #   })
@@ -2373,6 +2511,8 @@ module Aws::IoTSiteWise
     # @option params [Integer] :max_results
     #   The maximum number of results to be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @return [Types::ListDashboardsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListDashboardsResponse#dashboard_summaries #dashboard_summaries} => Array&lt;Types::DashboardSummary&gt;
@@ -2413,6 +2553,8 @@ module Aws::IoTSiteWise
     # @option params [Integer] :max_results
     #   The maximum number of results to be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @return [Types::ListGatewaysResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListGatewaysResponse#gateway_summaries #gateway_summaries} => Array&lt;Types::GatewaySummary&gt;
@@ -2454,6 +2596,8 @@ module Aws::IoTSiteWise
     # @option params [Integer] :max_results
     #   The maximum number of results to be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @return [Types::ListPortalsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListPortalsResponse#portal_summaries #portal_summaries} => Array&lt;Types::PortalSummary&gt;
@@ -2478,6 +2622,9 @@ module Aws::IoTSiteWise
     #   resp.portal_summaries[0].creation_date #=> Time
     #   resp.portal_summaries[0].last_update_date #=> Time
     #   resp.portal_summaries[0].role_arn #=> String
+    #   resp.portal_summaries[0].status.state #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE", "FAILED"
+    #   resp.portal_summaries[0].status.error.code #=> String, one of "INTERNAL_FAILURE", "VALIDATION_ERROR", "LIMIT_EXCEEDED"
+    #   resp.portal_summaries[0].status.error.message #=> String
     #   resp.next_token #=> String
     #
     # @overload list_portals(params = {})
@@ -2499,6 +2646,8 @@ module Aws::IoTSiteWise
     # @option params [Integer] :max_results
     #   The maximum number of results to be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @return [Types::ListProjectAssetsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListProjectAssetsResponse#asset_ids #asset_ids} => Array&lt;String&gt;
@@ -2539,6 +2688,8 @@ module Aws::IoTSiteWise
     # @option params [Integer] :max_results
     #   The maximum number of results to be returned per paginated request.
     #
+    #   Default: 50
+    #
     # @return [Types::ListProjectsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListProjectsResponse#project_summaries #project_summaries} => Array&lt;Types::ProjectSummary&gt;
@@ -2689,20 +2840,19 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Updates an existing access policy that specifies an AWS SSO user or
-    # group's access to an AWS IoT SiteWise Monitor portal or project
-    # resource.
+    # Updates an existing access policy that specifies an identity's access
+    # to an AWS IoT SiteWise Monitor portal or project resource.
     #
     # @option params [required, String] :access_policy_id
     #   The ID of the access policy.
     #
     # @option params [required, Types::Identity] :access_policy_identity
-    #   The identity for this access policy. Choose either a `user` or a
-    #   `group` but not both.
+    #   The identity for this access policy. Choose an AWS SSO user, an AWS
+    #   SSO group, or an IAM user.
     #
     # @option params [required, Types::Resource] :access_policy_resource
     #   The AWS IoT SiteWise Monitor resource for this access policy. Choose
-    #   either `portal` or `project` but not both.
+    #   either a portal or a project.
     #
     # @option params [required, String] :access_policy_permission
     #   The permission level for this access policy. Note that a project
@@ -2729,6 +2879,9 @@ module Aws::IoTSiteWise
     #       group: {
     #         id: "IdentityId", # required
     #       },
+    #       iam_user: {
+    #         arn: "ARN", # required
+    #       },
     #     },
     #     access_policy_resource: { # required
     #       portal: {
@@ -2749,8 +2902,8 @@ module Aws::IoTSiteWise
       req.send_request(options)
     end
 
-    # Updates an asset's name. For more information, see [Updating Assets
-    # and Models][1] in the *AWS IoT SiteWise User Guide*.
+    # Updates an asset's name. For more information, see [Updating assets
+    # and models][1] in the *AWS IoT SiteWise User Guide*.
     #
     #
     #
@@ -2798,7 +2951,7 @@ module Aws::IoTSiteWise
     # 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][1] in the *AWS IoT
+    # information, see [Updating assets and models][1] in the *AWS IoT
     # SiteWise User Guide*.
     #
     # This operation overwrites the existing model with the provided model.
@@ -2806,12 +2959,12 @@ module Aws::IoTSiteWise
     # must include their IDs and definitions in the updated asset model
     # payload. For more information, see [DescribeAssetModel][2].
     #
-    #  If you remove a property from an asset model or update a property's
-    # formula expression, AWS IoT SiteWise deletes all previous data for
-    # that property. If you remove a hierarchy definition from an asset
-    # model, AWS IoT SiteWise disassociates every asset associated with that
-    # hierarchy. You can't change the type or data type of an existing
-    # property.
+    #  If you remove a property from an asset model, AWS IoT SiteWise
+    # deletes
+    # all previous data for that property. If you remove a hierarchy
+    # definition from an asset model, AWS IoT SiteWise disassociates every
+    # asset associated with that hierarchy. You can't change the type or
+    # data type of an existing property.
     #
     #
     #
@@ -2829,7 +2982,7 @@ module Aws::IoTSiteWise
     #
     # @option params [Array<Types::AssetModelProperty>] :asset_model_properties
     #   The updated property definitions of the asset model. For more
-    #   information, see [Asset Properties][1] in the *AWS IoT SiteWise User
+    #   information, see [Asset properties][1] in the *AWS IoT SiteWise User
     #   Guide*.
     #
     #   You can specify up to 200 properties per asset model. For more
@@ -2844,7 +2997,7 @@ module Aws::IoTSiteWise
     #   The updated hierarchy definitions of the asset model. Each hierarchy
     #   specifies an asset model whose assets can be children of any other
     #   assets created from this asset model. For more information, see [Asset
-    #   Hierarchies][1] in the *AWS IoT SiteWise User Guide*.
+    #   hierarchies][1] in the *AWS IoT SiteWise User Guide*.
     #
     #   You can specify up to 10 hierarchies per asset model. For more
     #   information, see [Quotas][2] in the *AWS IoT SiteWise User Guide*.
@@ -2961,7 +3114,7 @@ module Aws::IoTSiteWise
     #   The property 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
+    #   see [Mapping industrial data streams to asset properties][1] in the
     #   *AWS IoT SiteWise User Guide*.
     #
     #   If you omit this parameter, the alias is removed from the property.
@@ -2974,7 +3127,7 @@ module Aws::IoTSiteWise
     #   The MQTT notification state (enabled or disabled) for this asset
     #   property. When the notification state is enabled, AWS IoT SiteWise
     #   publishes property value updates to a unique MQTT topic. For more
-    #   information, see [Interacting with Other Services][1] in the *AWS IoT
+    #   information, see [Interacting with other services][1] in the *AWS IoT
     #   SiteWise User Guide*.
     #
     #   If you omit this parameter, the notification state is set to
@@ -3024,7 +3177,7 @@ module Aws::IoTSiteWise
     #
     # @option params [required, String] :dashboard_definition
     #   The new dashboard definition, as specified in a JSON literal. For
-    #   detailed information, see [Creating Dashboards (CLI)][1] in the *AWS
+    #   detailed information, see [Creating dashboards (CLI)][1] in the *AWS
     #   IoT SiteWise User Guide*.
     #
     #
@@ -3204,7 +3357,7 @@ module Aws::IoTSiteWise
     # @example Response structure
     #
     #   resp.portal_status.state #=> String, one of "CREATING", "UPDATING", "DELETING", "ACTIVE", "FAILED"
-    #   resp.portal_status.error.code #=> String, one of "INTERNAL_FAILURE"
+    #   resp.portal_status.error.code #=> String, one of "INTERNAL_FAILURE", "VALIDATION_ERROR", "LIMIT_EXCEEDED"
     #   resp.portal_status.error.message #=> String
     #
     # @overload update_portal(params = {})
@@ -3264,7 +3417,7 @@ module Aws::IoTSiteWise
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-iotsitewise'
-      context[:gem_version] = '1.6.0'
+      context[:gem_version] = '1.12.0'
       Seahorse::Client::Request.new(handlers, context)
     end