aws-sdk-iotsitewise 1.68.0 → 1.69.0

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

@@ -1154,6 +1154,33 @@ module Aws::IoTSiteWise
     # @option params [required, String] :asset_model_name
     #   A unique name for the asset model.
     #
+    # @option params [String] :asset_model_type
+    #   The type of asset model.
+    #
+    #   * **ASSET\_MODEL** – (default) An asset model that you can use to
+    #     create assets. Can't be included as a component in another asset
+    #     model.
+    #
+    #   * **COMPONENT\_MODEL** – A reusable component that you can include in
+    #     the composite models of other asset models. You can't create assets
+    #     directly from this type of asset model.
+    #
+    # @option params [String] :asset_model_id
+    #   The ID to assign to the asset model, if desired. IoT SiteWise
+    #   automatically generates a unique ID for you, so this parameter is
+    #   never required. However, if you prefer to supply your own ID instead,
+    #   you can specify it here in UUID format. If you specify your own ID, it
+    #   must be globally unique.
+    #
+    # @option params [String] :asset_model_external_id
+    #   An external ID to assign to the asset model. The external ID must be
+    #   unique within your Amazon Web Services account. For more information,
+    #   see [Using external IDs][1] in the *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/object-ids.html#external-ids
+    #
     # @option params [String] :asset_model_description
     #   A description for the asset model.
     #
@@ -1220,33 +1247,6 @@ module Aws::IoTSiteWise
     #
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/tag-resources.html
     #
-    # @option params [String] :asset_model_id
-    #   The ID to assign to the asset model, if desired. IoT SiteWise
-    #   automatically generates a unique ID for you, so this parameter is
-    #   never required. However, if you prefer to supply your own ID instead,
-    #   you can specify it here in UUID format. If you specify your own ID, it
-    #   must be globally unique.
-    #
-    # @option params [String] :asset_model_external_id
-    #   An external ID to assign to the asset model. The external ID must be
-    #   unique within your Amazon Web Services account. For more information,
-    #   see [Using external IDs][1] in the *IoT SiteWise User Guide*.
-    #
-    #
-    #
-    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/object-ids.html#external-ids
-    #
-    # @option params [String] :asset_model_type
-    #   The type of asset model.
-    #
-    #   * **ASSET\_MODEL** – (default) An asset model that you can use to
-    #     create assets. Can't be included as a component in another asset
-    #     model.
-    #
-    #   * **COMPONENT\_MODEL** – A reusable component that you can include in
-    #     the composite models of other asset models. You can't create assets
-    #     directly from this type of asset model.
-    #
     # @return [Types::CreateAssetModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateAssetModelResponse#asset_model_id #asset_model_id} => String
@@ -1257,9 +1257,14 @@ module Aws::IoTSiteWise
     #
     #   resp = client.create_asset_model({
     #     asset_model_name: "Name", # required
+    #     asset_model_type: "ASSET_MODEL", # accepts ASSET_MODEL, COMPONENT_MODEL
+    #     asset_model_id: "ID",
+    #     asset_model_external_id: "ExternalId",
     #     asset_model_description: "Description",
     #     asset_model_properties: [
     #       {
+    #         id: "ID",
+    #         external_id: "ExternalId",
     #         name: "Name", # required
     #         data_type: "STRING", # required, accepts STRING, INTEGER, DOUBLE, BOOLEAN, STRUCT
     #         data_type_spec: "Name",
@@ -1327,25 +1332,27 @@ module Aws::IoTSiteWise
     #             },
     #           },
     #         },
-    #         id: "ID",
-    #         external_id: "ExternalId",
     #       },
     #     ],
     #     asset_model_hierarchies: [
     #       {
-    #         name: "Name", # required
-    #         child_asset_model_id: "CustomID", # required
     #         id: "ID",
     #         external_id: "ExternalId",
+    #         name: "Name", # required
+    #         child_asset_model_id: "CustomID", # required
     #       },
     #     ],
     #     asset_model_composite_models: [
     #       {
+    #         id: "ID",
+    #         external_id: "ExternalId",
     #         name: "Name", # required
     #         description: "Description",
     #         type: "Name", # required
     #         properties: [
     #           {
+    #             id: "ID",
+    #             external_id: "ExternalId",
     #             name: "Name", # required
     #             data_type: "STRING", # required, accepts STRING, INTEGER, DOUBLE, BOOLEAN, STRUCT
     #             data_type_spec: "Name",
@@ -1413,21 +1420,14 @@ module Aws::IoTSiteWise
     #                 },
     #               },
     #             },
-    #             id: "ID",
-    #             external_id: "ExternalId",
     #           },
     #         ],
-    #         id: "ID",
-    #         external_id: "ExternalId",
     #       },
     #     ],
     #     client_token: "ClientToken",
     #     tags: {
     #       "TagKey" => "TagValue",
     #     },
-    #     asset_model_id: "ID",
-    #     asset_model_external_id: "ExternalId",
-    #     asset_model_type: "ASSET_MODEL", # accepts ASSET_MODEL, COMPONENT_MODEL
     #   })
     #
     # @example Response structure
@@ -1481,9 +1481,6 @@ module Aws::IoTSiteWise
     # @option params [required, String] :asset_model_id
     #   The ID of the asset model this composite model is a part of.
     #
-    # @option params [String] :parent_asset_model_composite_model_id
-    #   The ID of the parent composite model in this asset model relationship.
-    #
     # @option params [String] :asset_model_composite_model_external_id
     #   An external ID to assign to the composite model.
     #
@@ -1492,6 +1489,9 @@ module Aws::IoTSiteWise
     #   `UpdateAssetModelCompositeModel` and specifying the derived ID of the
     #   model or property from the created model it's a part of.
     #
+    # @option params [String] :parent_asset_model_composite_model_id
+    #   The ID of the parent composite model in this asset model relationship.
+    #
     # @option params [String] :asset_model_composite_model_id
     #   The ID of the composite model. IoT SiteWise automatically generates a
     #   unique ID for you, so this parameter is never required. However, if
@@ -1533,6 +1533,27 @@ module Aws::IoTSiteWise
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/custom-composite-models.html#inline-composite-models
     #   [2]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
     #
+    # @option params [String] :if_match
+    #   The expected current entity tag (ETag) for the asset model’s latest or
+    #   active version (specified using `matchForVersionType`). The create
+    #   request is rejected if the tag does not match the latest or active
+    #   version's current entity tag. See [Optimistic locking for asset model
+    #   writes][1] in the *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/opt-locking-for-model.html
+    #
+    # @option params [String] :if_none_match
+    #   Accepts ***** to reject the create request if an active version
+    #   (specified using `matchForVersionType` as `ACTIVE`) already exists for
+    #   the asset model.
+    #
+    # @option params [String] :match_for_version_type
+    #   Specifies the asset model version type (`LATEST` or `ACTIVE`) used in
+    #   conjunction with `If-Match` or `If-None-Match` headers to determine
+    #   the target ETag for the create operation.
+    #
     # @return [Types::CreateAssetModelCompositeModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateAssetModelCompositeModelResponse#asset_model_composite_model_id #asset_model_composite_model_id} => String
@@ -1543,8 +1564,8 @@ module Aws::IoTSiteWise
     #
     #   resp = client.create_asset_model_composite_model({
     #     asset_model_id: "CustomID", # required
-    #     parent_asset_model_composite_model_id: "CustomID",
     #     asset_model_composite_model_external_id: "ExternalId",
+    #     parent_asset_model_composite_model_id: "CustomID",
     #     asset_model_composite_model_id: "ID",
     #     asset_model_composite_model_description: "Description",
     #     asset_model_composite_model_name: "Name", # required
@@ -1553,6 +1574,8 @@ module Aws::IoTSiteWise
     #     composed_asset_model_id: "CustomID",
     #     asset_model_composite_model_properties: [
     #       {
+    #         id: "ID",
+    #         external_id: "ExternalId",
     #         name: "Name", # required
     #         data_type: "STRING", # required, accepts STRING, INTEGER, DOUBLE, BOOLEAN, STRUCT
     #         data_type_spec: "Name",
@@ -1620,10 +1643,11 @@ module Aws::IoTSiteWise
     #             },
     #           },
     #         },
-    #         id: "ID",
-    #         external_id: "ExternalId",
     #       },
     #     ],
+    #     if_match: "ETag",
+    #     if_none_match: "SelectAll",
+    #     match_for_version_type: "LATEST", # accepts LATEST, ACTIVE
     #   })
     #
     # @example Response structure
@@ -2198,6 +2222,27 @@ module Aws::IoTSiteWise
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [String] :if_match
+    #   The expected current entity tag (ETag) for the asset model’s latest or
+    #   active version (specified using `matchForVersionType`). The delete
+    #   request is rejected if the tag does not match the latest or active
+    #   version's current entity tag. See [Optimistic locking for asset model
+    #   writes][1] in the *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/opt-locking-for-model.html
+    #
+    # @option params [String] :if_none_match
+    #   Accepts ***** to reject the delete request if an active version
+    #   (specified using `matchForVersionType` as `ACTIVE`) already exists for
+    #   the asset model.
+    #
+    # @option params [String] :match_for_version_type
+    #   Specifies the asset model version type (`LATEST` or `ACTIVE`) used in
+    #   conjunction with `If-Match` or `If-None-Match` headers to determine
+    #   the target ETag for the delete operation.
+    #
     # @return [Types::DeleteAssetModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteAssetModelResponse#asset_model_status #asset_model_status} => Types::AssetModelStatus
@@ -2207,6 +2252,9 @@ module Aws::IoTSiteWise
     #   resp = client.delete_asset_model({
     #     asset_model_id: "CustomID", # required
     #     client_token: "ClientToken",
+    #     if_match: "ETag",
+    #     if_none_match: "SelectAll",
+    #     match_for_version_type: "LATEST", # accepts LATEST, ACTIVE
     #   })
     #
     # @example Response structure
@@ -2250,6 +2298,27 @@ module Aws::IoTSiteWise
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
+    # @option params [String] :if_match
+    #   The expected current entity tag (ETag) for the asset model’s latest or
+    #   active version (specified using `matchForVersionType`). The delete
+    #   request is rejected if the tag does not match the latest or active
+    #   version's current entity tag. See [Optimistic locking for asset model
+    #   writes][1] in the *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/opt-locking-for-model.html
+    #
+    # @option params [String] :if_none_match
+    #   Accepts ***** to reject the delete request if an active version
+    #   (specified using `matchForVersionType` as `ACTIVE`) already exists for
+    #   the asset model.
+    #
+    # @option params [String] :match_for_version_type
+    #   Specifies the asset model version type (`LATEST` or `ACTIVE`) used in
+    #   conjunction with `If-Match` or `If-None-Match` headers to determine
+    #   the target ETag for the delete operation.
+    #
     # @return [Types::DeleteAssetModelCompositeModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DeleteAssetModelCompositeModelResponse#asset_model_status #asset_model_status} => Types::AssetModelStatus
@@ -2260,6 +2329,9 @@ module Aws::IoTSiteWise
     #     asset_model_id: "CustomID", # required
     #     asset_model_composite_model_id: "CustomID", # required
     #     client_token: "ClientToken",
+    #     if_match: "ETag",
+    #     if_none_match: "SelectAll",
+    #     match_for_version_type: "LATEST", # accepts LATEST, ACTIVE
     #   })
     #
     # @example Response structure
@@ -2760,37 +2832,53 @@ module Aws::IoTSiteWise
     # @option params [Boolean] :exclude_properties
     #   Whether or not to exclude asset model properties from the response.
     #
+    # @option params [String] :asset_model_version
+    #   The version alias that specifies the latest or active version of the
+    #   asset model. The details are returned in the response. The default
+    #   value is `LATEST`. See [ Asset model versions][1] in the *IoT SiteWise
+    #   User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/model-active-version.html
+    #
     # @return [Types::DescribeAssetModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeAssetModelResponse#asset_model_id #asset_model_id} => String
+    #   * {Types::DescribeAssetModelResponse#asset_model_external_id #asset_model_external_id} => String
     #   * {Types::DescribeAssetModelResponse#asset_model_arn #asset_model_arn} => String
     #   * {Types::DescribeAssetModelResponse#asset_model_name #asset_model_name} => String
+    #   * {Types::DescribeAssetModelResponse#asset_model_type #asset_model_type} => String
     #   * {Types::DescribeAssetModelResponse#asset_model_description #asset_model_description} => String
     #   * {Types::DescribeAssetModelResponse#asset_model_properties #asset_model_properties} => Array<Types::AssetModelProperty>
     #   * {Types::DescribeAssetModelResponse#asset_model_hierarchies #asset_model_hierarchies} => Array<Types::AssetModelHierarchy>
     #   * {Types::DescribeAssetModelResponse#asset_model_composite_models #asset_model_composite_models} => Array<Types::AssetModelCompositeModel>
+    #   * {Types::DescribeAssetModelResponse#asset_model_composite_model_summaries #asset_model_composite_model_summaries} => Array<Types::AssetModelCompositeModelSummary>
     #   * {Types::DescribeAssetModelResponse#asset_model_creation_date #asset_model_creation_date} => Time
     #   * {Types::DescribeAssetModelResponse#asset_model_last_update_date #asset_model_last_update_date} => Time
     #   * {Types::DescribeAssetModelResponse#asset_model_status #asset_model_status} => Types::AssetModelStatus
-    #   * {Types::DescribeAssetModelResponse#asset_model_type #asset_model_type} => String
-    #   * {Types::DescribeAssetModelResponse#asset_model_composite_model_summaries #asset_model_composite_model_summaries} => Array<Types::AssetModelCompositeModelSummary>
-    #   * {Types::DescribeAssetModelResponse#asset_model_external_id #asset_model_external_id} => String
+    #   * {Types::DescribeAssetModelResponse#asset_model_version #asset_model_version} => String
+    #   * {Types::DescribeAssetModelResponse#e_tag #e_tag} => String
     #
     # @example Request syntax with placeholder values
     #
     #   resp = client.describe_asset_model({
     #     asset_model_id: "CustomID", # required
     #     exclude_properties: false,
+    #     asset_model_version: "AssetModelVersionFilter",
     #   })
     #
     # @example Response structure
     #
     #   resp.asset_model_id #=> String
+    #   resp.asset_model_external_id #=> String
     #   resp.asset_model_arn #=> String
     #   resp.asset_model_name #=> String
+    #   resp.asset_model_type #=> String, one of "ASSET_MODEL", "COMPONENT_MODEL"
     #   resp.asset_model_description #=> String
     #   resp.asset_model_properties #=> Array
     #   resp.asset_model_properties[0].id #=> String
+    #   resp.asset_model_properties[0].external_id #=> String
     #   resp.asset_model_properties[0].name #=> String
     #   resp.asset_model_properties[0].data_type #=> String, one of "STRING", "INTEGER", "DOUBLE", "BOOLEAN", "STRUCT"
     #   resp.asset_model_properties[0].data_type_spec #=> String
@@ -2821,18 +2909,18 @@ module Aws::IoTSiteWise
     #   resp.asset_model_properties[0].path #=> Array
     #   resp.asset_model_properties[0].path[0].id #=> String
     #   resp.asset_model_properties[0].path[0].name #=> String
-    #   resp.asset_model_properties[0].external_id #=> String
     #   resp.asset_model_hierarchies #=> Array
     #   resp.asset_model_hierarchies[0].id #=> String
+    #   resp.asset_model_hierarchies[0].external_id #=> String
     #   resp.asset_model_hierarchies[0].name #=> String
     #   resp.asset_model_hierarchies[0].child_asset_model_id #=> String
-    #   resp.asset_model_hierarchies[0].external_id #=> String
     #   resp.asset_model_composite_models #=> Array
     #   resp.asset_model_composite_models[0].name #=> String
     #   resp.asset_model_composite_models[0].description #=> String
     #   resp.asset_model_composite_models[0].type #=> String
     #   resp.asset_model_composite_models[0].properties #=> Array
     #   resp.asset_model_composite_models[0].properties[0].id #=> String
+    #   resp.asset_model_composite_models[0].properties[0].external_id #=> String
     #   resp.asset_model_composite_models[0].properties[0].name #=> String
     #   resp.asset_model_composite_models[0].properties[0].data_type #=> String, one of "STRING", "INTEGER", "DOUBLE", "BOOLEAN", "STRUCT"
     #   resp.asset_model_composite_models[0].properties[0].data_type_spec #=> String
@@ -2863,18 +2951,8 @@ module Aws::IoTSiteWise
     #   resp.asset_model_composite_models[0].properties[0].path #=> Array
     #   resp.asset_model_composite_models[0].properties[0].path[0].id #=> String
     #   resp.asset_model_composite_models[0].properties[0].path[0].name #=> String
-    #   resp.asset_model_composite_models[0].properties[0].external_id #=> String
     #   resp.asset_model_composite_models[0].id #=> String
     #   resp.asset_model_composite_models[0].external_id #=> String
-    #   resp.asset_model_creation_date #=> Time
-    #   resp.asset_model_last_update_date #=> Time
-    #   resp.asset_model_status.state #=> String, one of "CREATING", "ACTIVE", "UPDATING", "PROPAGATING", "DELETING", "FAILED"
-    #   resp.asset_model_status.error.code #=> String, one of "VALIDATION_ERROR", "INTERNAL_FAILURE"
-    #   resp.asset_model_status.error.message #=> String
-    #   resp.asset_model_status.error.details #=> Array
-    #   resp.asset_model_status.error.details[0].code #=> String, one of "INCOMPATIBLE_COMPUTE_LOCATION", "INCOMPATIBLE_FORWARDING_CONFIGURATION"
-    #   resp.asset_model_status.error.details[0].message #=> String
-    #   resp.asset_model_type #=> String, one of "ASSET_MODEL", "COMPONENT_MODEL"
     #   resp.asset_model_composite_model_summaries #=> Array
     #   resp.asset_model_composite_model_summaries[0].id #=> String
     #   resp.asset_model_composite_model_summaries[0].external_id #=> String
@@ -2884,7 +2962,16 @@ module Aws::IoTSiteWise
     #   resp.asset_model_composite_model_summaries[0].path #=> Array
     #   resp.asset_model_composite_model_summaries[0].path[0].id #=> String
     #   resp.asset_model_composite_model_summaries[0].path[0].name #=> String
-    #   resp.asset_model_external_id #=> String
+    #   resp.asset_model_creation_date #=> Time
+    #   resp.asset_model_last_update_date #=> Time
+    #   resp.asset_model_status.state #=> String, one of "CREATING", "ACTIVE", "UPDATING", "PROPAGATING", "DELETING", "FAILED"
+    #   resp.asset_model_status.error.code #=> String, one of "VALIDATION_ERROR", "INTERNAL_FAILURE"
+    #   resp.asset_model_status.error.message #=> String
+    #   resp.asset_model_status.error.details #=> Array
+    #   resp.asset_model_status.error.details[0].code #=> String, one of "INCOMPATIBLE_COMPUTE_LOCATION", "INCOMPATIBLE_FORWARDING_CONFIGURATION"
+    #   resp.asset_model_status.error.details[0].message #=> String
+    #   resp.asset_model_version #=> String
+    #   resp.e_tag #=> String
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -2927,6 +3014,16 @@ module Aws::IoTSiteWise
     #
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/object-ids.html#external-id-references
     #
+    # @option params [String] :asset_model_version
+    #   The version alias that specifies the latest or active version of the
+    #   asset model. The details are returned in the response. The default
+    #   value is `LATEST`. See [ Asset model versions][1] in the *IoT SiteWise
+    #   User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/model-active-version.html
+    #
     # @return [Types::DescribeAssetModelCompositeModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::DescribeAssetModelCompositeModelResponse#asset_model_id #asset_model_id} => String
@@ -2946,6 +3043,7 @@ module Aws::IoTSiteWise
     #   resp = client.describe_asset_model_composite_model({
     #     asset_model_id: "CustomID", # required
     #     asset_model_composite_model_id: "CustomID", # required
+    #     asset_model_version: "AssetModelVersionFilter",
     #   })
     #
     # @example Response structure
@@ -2961,6 +3059,7 @@ module Aws::IoTSiteWise
     #   resp.asset_model_composite_model_type #=> String
     #   resp.asset_model_composite_model_properties #=> Array
     #   resp.asset_model_composite_model_properties[0].id #=> String
+    #   resp.asset_model_composite_model_properties[0].external_id #=> String
     #   resp.asset_model_composite_model_properties[0].name #=> String
     #   resp.asset_model_composite_model_properties[0].data_type #=> String, one of "STRING", "INTEGER", "DOUBLE", "BOOLEAN", "STRUCT"
     #   resp.asset_model_composite_model_properties[0].data_type_spec #=> String
@@ -2991,7 +3090,6 @@ module Aws::IoTSiteWise
     #   resp.asset_model_composite_model_properties[0].path #=> Array
     #   resp.asset_model_composite_model_properties[0].path[0].id #=> String
     #   resp.asset_model_composite_model_properties[0].path[0].name #=> String
-    #   resp.asset_model_composite_model_properties[0].external_id #=> String
     #   resp.composition_details.composition_relationship #=> Array
     #   resp.composition_details.composition_relationship[0].id #=> String
     #   resp.asset_model_composite_model_summaries #=> Array
@@ -4403,6 +4501,16 @@ module Aws::IoTSiteWise
     #
     #   Default: 50
     #
+    # @option params [String] :asset_model_version
+    #   The version alias that specifies the latest or active version of the
+    #   asset model. The details are returned in the response. The default
+    #   value is `LATEST`. See [ Asset model versions][1] in the *IoT SiteWise
+    #   User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/model-active-version.html
+    #
     # @return [Types::ListAssetModelCompositeModelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListAssetModelCompositeModelsResponse#asset_model_composite_model_summaries #asset_model_composite_model_summaries} => Array<Types::AssetModelCompositeModelSummary>
@@ -4416,6 +4524,7 @@ module Aws::IoTSiteWise
     #     asset_model_id: "CustomID", # required
     #     next_token: "NextToken",
     #     max_results: 1,
+    #     asset_model_version: "AssetModelVersionFilter",
     #   })
     #
     # @example Response structure
@@ -4471,6 +4580,16 @@ module Aws::IoTSiteWise
     #
     #   Default: `BASE`
     #
+    # @option params [String] :asset_model_version
+    #   The version alias that specifies the latest or active version of the
+    #   asset model. The details are returned in the response. The default
+    #   value is `LATEST`. See [ Asset model versions][1] in the *IoT SiteWise
+    #   User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/model-active-version.html
+    #
     # @return [Types::ListAssetModelPropertiesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListAssetModelPropertiesResponse#asset_model_property_summaries #asset_model_property_summaries} => Array<Types::AssetModelPropertySummary>
@@ -4485,12 +4604,14 @@ module Aws::IoTSiteWise
     #     next_token: "NextToken",
     #     max_results: 1,
     #     filter: "ALL", # accepts ALL, BASE
+    #     asset_model_version: "AssetModelVersionFilter",
     #   })
     #
     # @example Response structure
     #
     #   resp.asset_model_property_summaries #=> Array
     #   resp.asset_model_property_summaries[0].id #=> String
+    #   resp.asset_model_property_summaries[0].external_id #=> String
     #   resp.asset_model_property_summaries[0].name #=> String
     #   resp.asset_model_property_summaries[0].data_type #=> String, one of "STRING", "INTEGER", "DOUBLE", "BOOLEAN", "STRUCT"
     #   resp.asset_model_property_summaries[0].data_type_spec #=> String
@@ -4522,7 +4643,6 @@ module Aws::IoTSiteWise
     #   resp.asset_model_property_summaries[0].path #=> Array
     #   resp.asset_model_property_summaries[0].path[0].id #=> String
     #   resp.asset_model_property_summaries[0].path[0].name #=> String
-    #   resp.asset_model_property_summaries[0].external_id #=> String
     #   resp.next_token #=> String
     #
     # @overload list_asset_model_properties(params = {})
@@ -4534,6 +4654,17 @@ module Aws::IoTSiteWise
 
     # Retrieves a paginated list of summaries of all asset models.
     #
+    # @option params [Array<String>] :asset_model_types
+    #   The type of asset model. If you don't provide an `assetModelTypes`,
+    #   all types of asset models are returned.
+    #
+    #   * **ASSET\_MODEL** – An asset model that you can use to create assets.
+    #     Can't be included as a component in another asset model.
+    #
+    #   * **COMPONENT\_MODEL** – A reusable component that you can include in
+    #     the composite models of other asset models. You can't create assets
+    #     directly from this type of asset model.
+    #
     # @option params [String] :next_token
     #   The token to be used for the next set of paginated results.
     #
@@ -4542,16 +4673,15 @@ module Aws::IoTSiteWise
     #
     #   Default: 50
     #
-    # @option params [Array<String>] :asset_model_types
-    #   The type of asset model.
+    # @option params [String] :asset_model_version
+    #   The version alias that specifies the latest or active version of the
+    #   asset model. The details are returned in the response. The default
+    #   value is `LATEST`. See [ Asset model versions][1] in the *IoT SiteWise
+    #   User Guide*.
     #
-    #   * **ASSET\_MODEL** – (default) An asset model that you can use to
-    #     create assets. Can't be included as a component in another asset
-    #     model.
     #
-    #   * **COMPONENT\_MODEL** – A reusable component that you can include in
-    #     the composite models of other asset models. You can't create assets
-    #     directly from this type of asset model.
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/model-active-version.html
     #
     # @return [Types::ListAssetModelsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4563,17 +4693,20 @@ module Aws::IoTSiteWise
     # @example Request syntax with placeholder values
     #
     #   resp = client.list_asset_models({
+    #     asset_model_types: ["ASSET_MODEL"], # accepts ASSET_MODEL, COMPONENT_MODEL
     #     next_token: "NextToken",
     #     max_results: 1,
-    #     asset_model_types: ["ASSET_MODEL"], # accepts ASSET_MODEL, COMPONENT_MODEL
+    #     asset_model_version: "AssetModelVersionFilter",
     #   })
     #
     # @example Response structure
     #
     #   resp.asset_model_summaries #=> Array
     #   resp.asset_model_summaries[0].id #=> String
+    #   resp.asset_model_summaries[0].external_id #=> String
     #   resp.asset_model_summaries[0].arn #=> String
     #   resp.asset_model_summaries[0].name #=> String
+    #   resp.asset_model_summaries[0].asset_model_type #=> String, one of "ASSET_MODEL", "COMPONENT_MODEL"
     #   resp.asset_model_summaries[0].description #=> String
     #   resp.asset_model_summaries[0].creation_date #=> Time
     #   resp.asset_model_summaries[0].last_update_date #=> Time
@@ -4583,8 +4716,7 @@ module Aws::IoTSiteWise
     #   resp.asset_model_summaries[0].status.error.details #=> Array
     #   resp.asset_model_summaries[0].status.error.details[0].code #=> String, one of "INCOMPATIBLE_COMPUTE_LOCATION", "INCOMPATIBLE_FORWARDING_CONFIGURATION"
     #   resp.asset_model_summaries[0].status.error.details[0].message #=> String
-    #   resp.asset_model_summaries[0].asset_model_type #=> String, one of "ASSET_MODEL", "COMPONENT_MODEL"
-    #   resp.asset_model_summaries[0].external_id #=> String
+    #   resp.asset_model_summaries[0].version #=> String
     #   resp.next_token #=> String
     #
     # @overload list_asset_models(params = {})
@@ -4825,10 +4957,9 @@ module Aws::IoTSiteWise
     #
     # You can use this operation to do the following:
     #
-    # * List child assets associated to a parent asset by a hierarchy that
-    #   you specify.
+    # * `CHILD` - List all child assets associated to the asset.
     #
-    # * List an asset's parent asset.
+    # * `PARENT` - List the asset's parent asset.
     #
     # @option params [required, String] :asset_id
     #   The ID of the asset to query. This can be either the actual ID in UUID
@@ -4841,31 +4972,29 @@ module Aws::IoTSiteWise
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/object-ids.html#external-id-references
     #
     # @option params [String] :hierarchy_id
+    #   (Optional) If you don't provide a `hierarchyId`, all the immediate
+    #   assets in the `traversalDirection` will be returned.
+    #
     #   The ID of the hierarchy by which child assets are associated to the
     #   asset. (This can be either the actual ID in UUID format, or else
     #   `externalId:` followed by the external ID, if it has one. For more
     #   information, see [Referencing objects with external IDs][1] in the
-    #   *IoT SiteWise User Guide*.) To find a hierarchy ID, use the
-    #   [DescribeAsset][2] or [DescribeAssetModel][3] operations. This
-    #   parameter is required if you choose `CHILD` for `traversalDirection`.
+    #   *IoT SiteWise User Guide*.)
     #
-    #   For more information, see [Asset hierarchies][4] in the *IoT SiteWise
+    #   For more information, see [Asset hierarchies][2] in the *IoT SiteWise
     #   User Guide*.
     #
     #
     #
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/object-ids.html#external-id-references
-    #   [2]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html
-    #   [3]: https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAssetModel.html
-    #   [4]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-hierarchies.html
+    #   [2]: 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`.
+    #     asset.
     #
     #   * `PARENT` – The list includes the asset's parent asset.
     #
@@ -5758,6 +5887,16 @@ module Aws::IoTSiteWise
     #
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/object-ids.html#external-id-references
     #
+    # @option params [String] :asset_model_external_id
+    #   An external ID to assign to the asset model. The asset model must not
+    #   already have an external ID. The external ID must be unique within
+    #   your Amazon Web Services account. For more information, see [Using
+    #   external IDs][1] in the *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/object-ids.html#external-ids
+    #
     # @option params [required, String] :asset_model_name
     #   A unique name for the asset model.
     #
@@ -5819,15 +5958,26 @@ module Aws::IoTSiteWise
     #   **A suitable default value is auto-generated.** You should normally
     #   not need to pass this option.**
     #
-    # @option params [String] :asset_model_external_id
-    #   An external ID to assign to the asset model. The asset model must not
-    #   already have an external ID. The external ID must be unique within
-    #   your Amazon Web Services account. For more information, see [Using
-    #   external IDs][1] in the *IoT SiteWise User Guide*.
+    # @option params [String] :if_match
+    #   The expected current entity tag (ETag) for the asset model’s latest or
+    #   active version (specified using `matchForVersionType`). The update
+    #   request is rejected if the tag does not match the latest or active
+    #   version's current entity tag. See [Optimistic locking for asset model
+    #   writes][1] in the *IoT SiteWise User Guide*.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/object-ids.html#external-ids
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/opt-locking-for-model.html
+    #
+    # @option params [String] :if_none_match
+    #   Accepts ***** to reject the update request if an active version
+    #   (specified using `matchForVersionType` as `ACTIVE`) already exists for
+    #   the asset model.
+    #
+    # @option params [String] :match_for_version_type
+    #   Specifies the asset model version type (`LATEST` or `ACTIVE`) used in
+    #   conjunction with `If-Match` or `If-None-Match` headers to determine
+    #   the target ETag for the update operation.
     #
     # @return [Types::UpdateAssetModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -5837,11 +5987,13 @@ module Aws::IoTSiteWise
     #
     #   resp = client.update_asset_model({
     #     asset_model_id: "CustomID", # required
+    #     asset_model_external_id: "ExternalId",
     #     asset_model_name: "Name", # required
     #     asset_model_description: "Description",
     #     asset_model_properties: [
     #       {
     #         id: "CustomID",
+    #         external_id: "ExternalId",
     #         name: "Name", # required
     #         data_type: "STRING", # required, accepts STRING, INTEGER, DOUBLE, BOOLEAN, STRUCT
     #         data_type_spec: "Name",
@@ -5915,15 +6067,14 @@ module Aws::IoTSiteWise
     #             name: "Name",
     #           },
     #         ],
-    #         external_id: "ExternalId",
     #       },
     #     ],
     #     asset_model_hierarchies: [
     #       {
     #         id: "CustomID",
+    #         external_id: "ExternalId",
     #         name: "Name", # required
     #         child_asset_model_id: "CustomID", # required
-    #         external_id: "ExternalId",
     #       },
     #     ],
     #     asset_model_composite_models: [
@@ -5934,6 +6085,7 @@ module Aws::IoTSiteWise
     #         properties: [
     #           {
     #             id: "CustomID",
+    #             external_id: "ExternalId",
     #             name: "Name", # required
     #             data_type: "STRING", # required, accepts STRING, INTEGER, DOUBLE, BOOLEAN, STRUCT
     #             data_type_spec: "Name",
@@ -6007,7 +6159,6 @@ module Aws::IoTSiteWise
     #                 name: "Name",
     #               },
     #             ],
-    #             external_id: "ExternalId",
     #           },
     #         ],
     #         id: "CustomID",
@@ -6015,7 +6166,9 @@ module Aws::IoTSiteWise
     #       },
     #     ],
     #     client_token: "ClientToken",
-    #     asset_model_external_id: "ExternalId",
+    #     if_match: "ETag",
+    #     if_none_match: "SelectAll",
+    #     match_for_version_type: "LATEST", # accepts LATEST, ACTIVE
     #   })
     #
     # @example Response structure
@@ -6098,6 +6251,27 @@ module Aws::IoTSiteWise
     #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/custom-composite-models.html#inline-composite-models
     #   [2]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/quotas.html
     #
+    # @option params [String] :if_match
+    #   The expected current entity tag (ETag) for the asset model’s latest or
+    #   active version (specified using `matchForVersionType`). The update
+    #   request is rejected if the tag does not match the latest or active
+    #   version's current entity tag. See [Optimistic locking for asset model
+    #   writes][1] in the *IoT SiteWise User Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/opt-locking-for-model.html
+    #
+    # @option params [String] :if_none_match
+    #   Accepts ***** to reject the update request if an active version
+    #   (specified using `matchForVersionType` as `ACTIVE`) already exists for
+    #   the asset model.
+    #
+    # @option params [String] :match_for_version_type
+    #   Specifies the asset model version type (`LATEST` or `ACTIVE`) used in
+    #   conjunction with `If-Match` or `If-None-Match` headers to determine
+    #   the target ETag for the update operation.
+    #
     # @return [Types::UpdateAssetModelCompositeModelResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::UpdateAssetModelCompositeModelResponse#asset_model_composite_model_path #asset_model_composite_model_path} => Array&lt;Types::AssetModelCompositeModelPathSegment&gt;
@@ -6115,6 +6289,7 @@ module Aws::IoTSiteWise
     #     asset_model_composite_model_properties: [
     #       {
     #         id: "CustomID",
+    #         external_id: "ExternalId",
     #         name: "Name", # required
     #         data_type: "STRING", # required, accepts STRING, INTEGER, DOUBLE, BOOLEAN, STRUCT
     #         data_type_spec: "Name",
@@ -6188,9 +6363,11 @@ module Aws::IoTSiteWise
     #             name: "Name",
     #           },
     #         ],
-    #         external_id: "ExternalId",
     #       },
     #     ],
+    #     if_match: "ETag",
+    #     if_none_match: "SelectAll",
+    #     match_for_version_type: "LATEST", # accepts LATEST, ACTIVE
     #   })
     #
     # @example Response structure
@@ -6576,7 +6753,7 @@ module Aws::IoTSiteWise
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-iotsitewise'
-      context[:gem_version] = '1.68.0'
+      context[:gem_version] = '1.69.0'
       Seahorse::Client::Request.new(handlers, context)
     end