aws-sdk-iotsitewise 1.90.0 → 1.91.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -96,7 +96,8 @@ module Aws::IoTSiteWise
96
96
  include Aws::Structure
97
97
  end
98
98
 
99
- # Contains the summary of the actions.
99
+ # Contains the summary of the actions, including information about where
100
+ # the action resolves to.
100
101
  #
101
102
  # @!attribute [rw] action_id
102
103
  # The ID of the action.
@@ -936,7 +937,9 @@ module Aws::IoTSiteWise
936
937
  include Aws::Structure
937
938
  end
938
939
 
939
- # Contains a summary of a property associated with a model.
940
+ # Contains a summary of a property associated with a model. This
941
+ # includes information about which interfaces the property belongs to,
942
+ # if any.
940
943
  #
941
944
  # @!attribute [rw] id
942
945
  # The ID of the property.
@@ -983,6 +986,12 @@ module Aws::IoTSiteWise
983
986
  # model.
984
987
  # @return [Array<Types::AssetModelPropertyPathSegment>]
985
988
  #
989
+ # @!attribute [rw] interface_summaries
990
+ # A list of interface summaries that describe which interfaces this
991
+ # property belongs to, including the interface asset model ID and the
992
+ # corresponding property ID in the interface.
993
+ # @return [Array<Types::InterfaceSummary>]
994
+ #
986
995
  class AssetModelPropertySummary < Struct.new(
987
996
  :id,
988
997
  :external_id,
@@ -992,7 +1001,8 @@ module Aws::IoTSiteWise
992
1001
  :unit,
993
1002
  :type,
994
1003
  :asset_model_composite_model_id,
995
- :path)
1004
+ :path,
1005
+ :interface_summaries)
996
1006
  SENSITIVE = []
997
1007
  include Aws::Structure
998
1008
  end
@@ -4243,6 +4253,65 @@ module Aws::IoTSiteWise
4243
4253
  include Aws::Structure
4244
4254
  end
4245
4255
 
4256
+ # @!attribute [rw] asset_model_id
4257
+ # The ID of the asset model. This can be either the actual ID in UUID
4258
+ # format, or else externalId: followed by the external ID.
4259
+ # @return [String]
4260
+ #
4261
+ # @!attribute [rw] interface_asset_model_id
4262
+ # The ID of the interface asset model. This can be either the actual
4263
+ # ID in UUID format, or else externalId: followed by the external ID.
4264
+ # @return [String]
4265
+ #
4266
+ # @!attribute [rw] client_token
4267
+ # A unique case-sensitive identifier that you can provide to ensure
4268
+ # the idempotency of the request. Don't reuse this client token if a
4269
+ # new idempotent request is required.
4270
+ #
4271
+ # **A suitable default value is auto-generated.** You should normally
4272
+ # not need to pass this option.
4273
+ # @return [String]
4274
+ #
4275
+ class DeleteAssetModelInterfaceRelationshipRequest < Struct.new(
4276
+ :asset_model_id,
4277
+ :interface_asset_model_id,
4278
+ :client_token)
4279
+ SENSITIVE = []
4280
+ include Aws::Structure
4281
+ end
4282
+
4283
+ # @!attribute [rw] asset_model_id
4284
+ # The ID of the asset model.
4285
+ # @return [String]
4286
+ #
4287
+ # @!attribute [rw] interface_asset_model_id
4288
+ # The ID of the interface asset model.
4289
+ # @return [String]
4290
+ #
4291
+ # @!attribute [rw] asset_model_arn
4292
+ # The ARN of the asset model, which has the following format.
4293
+ # `arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}`
4294
+ # @return [String]
4295
+ #
4296
+ # @!attribute [rw] asset_model_status
4297
+ # Contains current status information for an asset model. For more
4298
+ # information, see [Asset and model states][1] in the *IoT SiteWise
4299
+ # User Guide*.
4300
+ #
4301
+ #
4302
+ #
4303
+ # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-and-model-states.html
4304
+ # @return [Types::AssetModelStatus]
4305
+ #
4306
+ class DeleteAssetModelInterfaceRelationshipResponse < Struct.new(
4307
+ :asset_model_id,
4308
+ :interface_asset_model_id,
4309
+ :asset_model_arn,
4310
+ :asset_model_status)
4311
+ SENSITIVE = []
4312
+ include Aws::Structure
4313
+ end
4314
+
4246
4315
  # @!attribute [rw] asset_model_id
4247
4316
  # The ID of the asset model to delete. This can be either the actual
4248
4317
  # ID in UUID format, or else `externalId:` followed by the external
@@ -4845,6 +4914,50 @@ module Aws::IoTSiteWise
4845
4914
  include Aws::Structure
4846
4915
  end
4847
4916
 
4917
+ # @!attribute [rw] asset_model_id
4918
+ # The ID of the asset model. This can be either the actual ID in UUID
4919
+ # format, or else externalId: followed by the external ID.
4920
+ # @return [String]
4921
+ #
4922
+ # @!attribute [rw] interface_asset_model_id
4923
+ # The ID of the interface asset model. This can be either the actual
4924
+ # ID in UUID format, or else externalId: followed by the external ID.
4925
+ # @return [String]
4926
+ #
4927
+ class DescribeAssetModelInterfaceRelationshipRequest < Struct.new(
4928
+ :asset_model_id,
4929
+ :interface_asset_model_id)
4930
+ SENSITIVE = []
4931
+ include Aws::Structure
4932
+ end
4933
+
4934
+ # @!attribute [rw] asset_model_id
4935
+ # The ID of the asset model.
4936
+ # @return [String]
4937
+ #
4938
+ # @!attribute [rw] interface_asset_model_id
4939
+ # The ID of the interface asset model.
4940
+ # @return [String]
4941
+ #
4942
+ # @!attribute [rw] property_mappings
4943
+ # A list of property mappings between the interface asset model and
4944
+ # the asset model where the interface is applied.
4945
+ # @return [Array<Types::PropertyMapping>]
4946
+ #
4947
+ # @!attribute [rw] hierarchy_mappings
4948
+ # A list of hierarchy mappings between the interface asset model and
4949
+ # the asset model where the interface is applied.
4950
+ # @return [Array<Types::HierarchyMapping>]
4951
+ #
4952
+ class DescribeAssetModelInterfaceRelationshipResponse < Struct.new(
4953
+ :asset_model_id,
4954
+ :interface_asset_model_id,
4955
+ :property_mappings,
4956
+ :hierarchy_mappings)
4957
+ SENSITIVE = []
4958
+ include Aws::Structure
4959
+ end
4960
+
4848
4961
  # @!attribute [rw] asset_model_id
4849
4962
  # The ID of the asset model. This can be either the actual ID in UUID
4850
4963
  # format, or else `externalId:` followed by the external ID, if it has
@@ -4964,6 +5077,12 @@ module Aws::IoTSiteWise
4964
5077
  # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/model-active-version.html
4965
5078
  # @return [String]
4966
5079
  #
5080
+ # @!attribute [rw] interface_details
5081
+ # A list of interface details that describe the interfaces implemented
5082
+ # by this asset model, including interface asset model IDs and
5083
+ # property mappings.
5084
+ # @return [Array<Types::InterfaceRelationship>]
5085
+ #
4967
5086
  # @!attribute [rw] e_tag
4968
5087
  # The entity tag (ETag) is a hash of the retrieved version of the
4969
5088
  # asset model. It's used to make concurrent updates safely to the
@@ -4993,6 +5112,7 @@ module Aws::IoTSiteWise
4993
5112
  :asset_model_last_update_date,
4994
5113
  :asset_model_status,
4995
5114
  :asset_model_version,
5115
+ :interface_details,
4996
5116
  :e_tag)
4997
5117
  SENSITIVE = []
4998
5118
  include Aws::Structure
@@ -5578,7 +5698,8 @@ module Aws::IoTSiteWise
5578
5698
  # @return [String]
5579
5699
  #
5580
5700
  # @!attribute [rw] target_resource
5581
- # The resource the action will be taken on.
5701
+ # The resource the action will be taken on. This can include
5702
+ # asset-based resources and computation model resources.
5582
5703
  # @return [Types::TargetResource]
5583
5704
  #
5584
5705
  # @!attribute [rw] target_resource_version
@@ -6452,7 +6573,8 @@ module Aws::IoTSiteWise
6452
6573
  # @return [String]
6453
6574
  #
6454
6575
  # @!attribute [rw] target_resource
6455
- # The resource the action will be taken on.
6576
+ # The resource the action will be taken on. This can include
6577
+ # asset-based resources and computation model resources.
6456
6578
  # @return [Types::TargetResource]
6457
6579
  #
6458
6580
  # @!attribute [rw] target_resource_version
@@ -7138,6 +7260,25 @@ module Aws::IoTSiteWise
7138
7260
  include Aws::Structure
7139
7261
  end
7140
7262
 
7263
+ # Maps a hierarchy from an interface asset model to a hierarchy in the
7264
+ # asset model where the interface is applied.
7265
+ #
7266
+ # @!attribute [rw] asset_model_hierarchy_id
7267
+ # The ID of the hierarchy in the asset model where the interface is
7268
+ # applied.
7269
+ # @return [String]
7270
+ #
7271
+ # @!attribute [rw] interface_asset_model_hierarchy_id
7272
+ # The ID of the hierarchy in the interface asset model.
7273
+ # @return [String]
7274
+ #
7275
+ class HierarchyMapping < Struct.new(
7276
+ :asset_model_hierarchy_id,
7277
+ :interface_asset_model_hierarchy_id)
7278
+ SENSITIVE = []
7279
+ include Aws::Structure
7280
+ end
7281
+
7141
7282
  # Contains information about an Identity and Access Management role. For
7142
7283
  # more information, see [IAM roles][1] in the *IAM User Guide*.
7143
7284
  #
@@ -7281,6 +7422,53 @@ module Aws::IoTSiteWise
7281
7422
  include Aws::Structure
7282
7423
  end
7283
7424
 
7425
+ # Contains information about the relationship between an asset model and
7426
+ # an interface asset model that is applied to it.
7427
+ #
7428
+ # @!attribute [rw] id
7429
+ # The ID of the asset model that has the interface applied to it.
7430
+ # @return [String]
7431
+ #
7432
+ class InterfaceRelationship < Struct.new(
7433
+ :id)
7434
+ SENSITIVE = []
7435
+ include Aws::Structure
7436
+ end
7437
+
7438
+ # Contains summary information about an interface relationship, which
7439
+ # defines how an interface is applied to an asset model. This summary
7440
+ # provides the essential identifiers needed to retrieve detailed
7441
+ # information about the relationship.
7442
+ #
7443
+ # @!attribute [rw] id
7444
+ # The ID of the asset model that has the interface applied to it.
7445
+ # @return [String]
7446
+ #
7447
+ class InterfaceRelationshipSummary < Struct.new(
7448
+ :id)
7449
+ SENSITIVE = []
7450
+ include Aws::Structure
7451
+ end
7452
+
7453
+ # Contains summary information about an interface that a property
7454
+ # belongs to.
7455
+ #
7456
+ # @!attribute [rw] interface_asset_model_id
7457
+ # The ID of the interface asset model that contains this property.
7458
+ # @return [String]
7459
+ #
7460
+ # @!attribute [rw] interface_asset_model_property_id
7461
+ # The ID of the property in the interface asset model that corresponds
7462
+ # to this property.
7463
+ # @return [String]
7464
+ #
7465
+ class InterfaceSummary < Struct.new(
7466
+ :interface_asset_model_id,
7467
+ :interface_asset_model_property_id)
7468
+ SENSITIVE = []
7469
+ include Aws::Structure
7470
+ end
7471
+
7284
7472
  # IoT SiteWise can't process your request right now. Try again later.
7285
7473
  #
7286
7474
  # @!attribute [rw] message
@@ -7739,6 +7927,9 @@ module Aws::IoTSiteWise
7739
7927
  # * **COMPONENT\_MODEL** – A reusable component that you can include
7740
7928
  # in the composite models of other asset models. You can't create
7741
7929
  # assets directly from this type of asset model.
7930
+ #
7931
+ # * **INTERFACE** – An interface is a type of model that defines a
7932
+ # standard structure that can be applied to different asset models.
7742
7933
  # @return [Array<String>]
7743
7934
  #
7744
7935
  # @!attribute [rw] next_token
@@ -8403,6 +8594,44 @@ module Aws::IoTSiteWise
8403
8594
  include Aws::Structure
8404
8595
  end
8405
8596
 
8597
+ # @!attribute [rw] interface_asset_model_id
8598
+ # The ID of the interface asset model. This can be either the actual
8599
+ # ID in UUID format, or else externalId: followed by the external ID.
8600
+ # @return [String]
8601
+ #
8602
+ # @!attribute [rw] next_token
8603
+ # The token to be used for the next set of paginated results.
8604
+ # @return [String]
8605
+ #
8606
+ # @!attribute [rw] max_results
8607
+ # The maximum number of results to return for each paginated request.
8608
+ # Default: 50
8609
+ # @return [Integer]
8610
+ #
8611
+ class ListInterfaceRelationshipsRequest < Struct.new(
8612
+ :interface_asset_model_id,
8613
+ :next_token,
8614
+ :max_results)
8615
+ SENSITIVE = []
8616
+ include Aws::Structure
8617
+ end
8618
+
8619
+ # @!attribute [rw] interface_relationship_summaries
8620
+ # A list that summarizes each interface relationship.
8621
+ # @return [Array<Types::InterfaceRelationshipSummary>]
8622
+ #
8623
+ # @!attribute [rw] next_token
8624
+ # The token for the next set of results, or null if there are no
8625
+ # additional results.
8626
+ # @return [String]
8627
+ #
8628
+ class ListInterfaceRelationshipsResponse < Struct.new(
8629
+ :interface_relationship_summaries,
8630
+ :next_token)
8631
+ SENSITIVE = []
8632
+ include Aws::Structure
8633
+ end
8634
+
8406
8635
  # @!attribute [rw] next_token
8407
8636
  # The token to be used for the next set of paginated results.
8408
8637
  # @return [String]
@@ -9042,6 +9271,53 @@ module Aws::IoTSiteWise
9042
9271
  include Aws::Structure
9043
9272
  end
9044
9273
 
9274
+ # Maps a property from an interface asset model to a property in the
9275
+ # asset model where the interface is applied.
9276
+ #
9277
+ # @!attribute [rw] asset_model_property_id
9278
+ # The ID of the property in the asset model where the interface is
9279
+ # applied.
9280
+ # @return [String]
9281
+ #
9282
+ # @!attribute [rw] interface_asset_model_property_id
9283
+ # The ID of the property in the interface asset model.
9284
+ # @return [String]
9285
+ #
9286
+ class PropertyMapping < Struct.new(
9287
+ :asset_model_property_id,
9288
+ :interface_asset_model_property_id)
9289
+ SENSITIVE = []
9290
+ include Aws::Structure
9291
+ end
9292
+
9293
+ # Contains configuration options for mapping properties from an
9294
+ # interface asset model to an asset model where the interface is
9295
+ # applied.
9296
+ #
9297
+ # @!attribute [rw] match_by_property_name
9298
+ # If true, properties are matched by name between the interface asset
9299
+ # model and the asset model where the interface is applied.
9300
+ # @return [Boolean]
9301
+ #
9302
+ # @!attribute [rw] create_missing_property
9303
+ # If true, missing properties from the interface asset model are
9304
+ # automatically created in the asset model where the interface is
9305
+ # applied.
9306
+ # @return [Boolean]
9307
+ #
9308
+ # @!attribute [rw] overrides
9309
+ # A list of specific property mappings that override the automatic
9310
+ # mapping by name when an interface is applied to an asset model.
9311
+ # @return [Array<Types::PropertyMapping>]
9312
+ #
9313
+ class PropertyMappingConfiguration < Struct.new(
9314
+ :match_by_property_name,
9315
+ :create_missing_property,
9316
+ :overrides)
9317
+ SENSITIVE = []
9318
+ include Aws::Structure
9319
+ end
9320
+
9045
9321
  # Contains asset property value notification information. When the
9046
9322
  # notification state is enabled, IoT SiteWise publishes property value
9047
9323
  # updates to a unique MQTT topic. For more information, see [Interacting
@@ -9122,6 +9398,73 @@ module Aws::IoTSiteWise
9122
9398
  include Aws::Structure
9123
9399
  end
9124
9400
 
9401
+ # @!attribute [rw] asset_model_id
9402
+ # The ID of the asset model. This can be either the actual ID in UUID
9403
+ # format, or else externalId: followed by the external ID.
9404
+ # @return [String]
9405
+ #
9406
+ # @!attribute [rw] interface_asset_model_id
9407
+ # The ID of the interface asset model. This can be either the actual
9408
+ # ID in UUID format, or else externalId: followed by the external ID.
9409
+ # @return [String]
9410
+ #
9411
+ # @!attribute [rw] property_mapping_configuration
9412
+ # The configuration for mapping properties from the interface asset
9413
+ # model to the asset model where the interface is applied. This
9414
+ # configuration controls how properties are matched and created during
9415
+ # the interface application process.
9416
+ # @return [Types::PropertyMappingConfiguration]
9417
+ #
9418
+ # @!attribute [rw] client_token
9419
+ # A unique case-sensitive identifier that you can provide to ensure
9420
+ # the idempotency of the request. Don't reuse this client token if a
9421
+ # new idempotent request is required.
9422
+ #
9423
+ # **A suitable default value is auto-generated.** You should normally
9424
+ # not need to pass this option.
9425
+ # @return [String]
9426
+ #
9427
+ class PutAssetModelInterfaceRelationshipRequest < Struct.new(
9428
+ :asset_model_id,
9429
+ :interface_asset_model_id,
9430
+ :property_mapping_configuration,
9431
+ :client_token)
9432
+ SENSITIVE = []
9433
+ include Aws::Structure
9434
+ end
9435
+
9436
+ # @!attribute [rw] asset_model_id
9437
+ # The ID of the asset model.
9438
+ # @return [String]
9439
+ #
9440
+ # @!attribute [rw] interface_asset_model_id
9441
+ # The ID of the interface asset model.
9442
+ # @return [String]
9443
+ #
9444
+ # @!attribute [rw] asset_model_arn
9445
+ # The ARN of the asset model, which has the following format.
9446
+ # `arn:${Partition}:iotsitewise:${Region}:${Account}:asset-model/${AssetModelId}`
9447
+ # @return [String]
9448
+ #
9449
+ # @!attribute [rw] asset_model_status
9450
+ # Contains current status information for an asset model. For more
9451
+ # information, see [Asset and model states][1] in the *IoT SiteWise
9452
+ # User Guide*.
9453
+ #
9454
+ #
9455
+ #
9456
+ # [1]: https://docs.aws.amazon.com/iot-sitewise/latest/userguide/asset-and-model-states.html
9457
+ # @return [Types::AssetModelStatus]
9458
+ #
9459
+ class PutAssetModelInterfaceRelationshipResponse < Struct.new(
9460
+ :asset_model_id,
9461
+ :interface_asset_model_id,
9462
+ :asset_model_arn,
9463
+ :asset_model_status)
9464
+ SENSITIVE = []
9465
+ include Aws::Structure
9466
+ end
9467
+
9125
9468
  # Contains a list of value updates for an asset property in the list of
9126
9469
  # asset entries consumed by the [BatchPutAssetPropertyValue][1] API
9127
9470
  # operation.
@@ -9583,7 +9926,8 @@ module Aws::IoTSiteWise
9583
9926
 
9584
9927
  class TagResourceResponse < Aws::EmptyStructure; end
9585
9928
 
9586
- # The resource the action will be taken on.
9929
+ # The resource the action will be taken on. This can include asset-based
9930
+ # resources and computation model resources.
9587
9931
  #
9588
9932
  # @!attribute [rw] asset_id
9589
9933
  # The ID of the asset, in UUID format.
@@ -56,7 +56,7 @@ module Aws::IoTSiteWise
56
56
  autoload :Endpoints, 'aws-sdk-iotsitewise/endpoints'
57
57
  autoload :EventStreams, 'aws-sdk-iotsitewise/event_streams'
58
58
 
59
- GEM_VERSION = '1.90.0'
59
+ GEM_VERSION = '1.91.0'
60
60
 
61
61
  end
62
62