Package software.amazon.awscdk.services.iotsitewise

Class CfnAssetModel

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.CfnElement

software.amazon.awscdk.CfnRefElement

software.amazon.awscdk.CfnResource

software.amazon.awscdk.services.iotsitewise.CfnAssetModel

All Implemented Interfaces:

IEnvironmentAware, IInspectable, ITaggable, IAssetModelRef, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.118.0 (build 02eec31)",
           date="2025-11-04T09:27:43.534Z")
@Stability(Stable)
public class CfnAssetModel
extends CfnResource
implements IInspectable, IAssetModelRef, ITaggable

Creates an asset model from specified property and hierarchy definitions.

You create assets from asset models. With asset models, 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 in the AWS IoT SiteWise User Guide .

You can create three types of asset models, ASSET_MODEL , COMPONENT_MODEL , or an INTERFACE .

• 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.
• INTERFACE – An interface is a type of model that defines a standard structure that can be applied to different asset models.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.iotsitewise.*;
 CfnAssetModel cfnAssetModel = CfnAssetModel.Builder.create(this, "MyCfnAssetModel")
         .assetModelName("assetModelName")
         // the properties below are optional
         .assetModelCompositeModels(List.of(AssetModelCompositeModelProperty.builder()
                 .name("name")
                 .type("type")
                 // the properties below are optional
                 .composedAssetModelId("composedAssetModelId")
                 .compositeModelProperties(List.of(AssetModelPropertyProperty.builder()
                         .dataType("dataType")
                         .name("name")
                         .type(PropertyTypeProperty.builder()
                                 .typeName("typeName")
                                 // the properties below are optional
                                 .attribute(AttributeProperty.builder()
                                         .defaultValue("defaultValue")
                                         .build())
                                 .metric(MetricProperty.builder()
                                         .expression("expression")
                                         .variables(List.of(ExpressionVariableProperty.builder()
                                                 .name("name")
                                                 .value(VariableValueProperty.builder()
                                                         .hierarchyExternalId("hierarchyExternalId")
                                                         .hierarchyId("hierarchyId")
                                                         .hierarchyLogicalId("hierarchyLogicalId")
                                                         .propertyExternalId("propertyExternalId")
                                                         .propertyId("propertyId")
                                                         .propertyLogicalId("propertyLogicalId")
                                                         .propertyPath(List.of(PropertyPathDefinitionProperty.builder()
                                                                 .name("name")
                                                                 .build()))
                                                         .build())
                                                 .build()))
                                         .window(MetricWindowProperty.builder()
                                                 .tumbling(TumblingWindowProperty.builder()
                                                         .interval("interval")
                                                         // the properties below are optional
                                                         .offset("offset")
                                                         .build())
                                                 .build())
                                         .build())
                                 .transform(TransformProperty.builder()
                                         .expression("expression")
                                         .variables(List.of(ExpressionVariableProperty.builder()
                                                 .name("name")
                                                 .value(VariableValueProperty.builder()
                                                         .hierarchyExternalId("hierarchyExternalId")
                                                         .hierarchyId("hierarchyId")
                                                         .hierarchyLogicalId("hierarchyLogicalId")
                                                         .propertyExternalId("propertyExternalId")
                                                         .propertyId("propertyId")
                                                         .propertyLogicalId("propertyLogicalId")
                                                         .propertyPath(List.of(PropertyPathDefinitionProperty.builder()
                                                                 .name("name")
                                                                 .build()))
                                                         .build())
                                                 .build()))
                                         .build())
                                 .build())
                         // the properties below are optional
                         .dataTypeSpec("dataTypeSpec")
                         .externalId("externalId")
                         .id("id")
                         .logicalId("logicalId")
                         .unit("unit")
                         .build()))
                 .description("description")
                 .externalId("externalId")
                 .id("id")
                 .parentAssetModelCompositeModelExternalId("parentAssetModelCompositeModelExternalId")
                 .path(List.of("path"))
                 .build()))
         .assetModelDescription("assetModelDescription")
         .assetModelExternalId("assetModelExternalId")
         .assetModelHierarchies(List.of(AssetModelHierarchyProperty.builder()
                 .childAssetModelId("childAssetModelId")
                 .name("name")
                 // the properties below are optional
                 .externalId("externalId")
                 .id("id")
                 .logicalId("logicalId")
                 .build()))
         .assetModelProperties(List.of(AssetModelPropertyProperty.builder()
                 .dataType("dataType")
                 .name("name")
                 .type(PropertyTypeProperty.builder()
                         .typeName("typeName")
                         // the properties below are optional
                         .attribute(AttributeProperty.builder()
                                 .defaultValue("defaultValue")
                                 .build())
                         .metric(MetricProperty.builder()
                                 .expression("expression")
                                 .variables(List.of(ExpressionVariableProperty.builder()
                                         .name("name")
                                         .value(VariableValueProperty.builder()
                                                 .hierarchyExternalId("hierarchyExternalId")
                                                 .hierarchyId("hierarchyId")
                                                 .hierarchyLogicalId("hierarchyLogicalId")
                                                 .propertyExternalId("propertyExternalId")
                                                 .propertyId("propertyId")
                                                 .propertyLogicalId("propertyLogicalId")
                                                 .propertyPath(List.of(PropertyPathDefinitionProperty.builder()
                                                         .name("name")
                                                         .build()))
                                                 .build())
                                         .build()))
                                 .window(MetricWindowProperty.builder()
                                         .tumbling(TumblingWindowProperty.builder()
                                                 .interval("interval")
                                                 // the properties below are optional
                                                 .offset("offset")
                                                 .build())
                                         .build())
                                 .build())
                         .transform(TransformProperty.builder()
                                 .expression("expression")
                                 .variables(List.of(ExpressionVariableProperty.builder()
                                         .name("name")
                                         .value(VariableValueProperty.builder()
                                                 .hierarchyExternalId("hierarchyExternalId")
                                                 .hierarchyId("hierarchyId")
                                                 .hierarchyLogicalId("hierarchyLogicalId")
                                                 .propertyExternalId("propertyExternalId")
                                                 .propertyId("propertyId")
                                                 .propertyLogicalId("propertyLogicalId")
                                                 .propertyPath(List.of(PropertyPathDefinitionProperty.builder()
                                                         .name("name")
                                                         .build()))
                                                 .build())
                                         .build()))
                                 .build())
                         .build())
                 // the properties below are optional
                 .dataTypeSpec("dataTypeSpec")
                 .externalId("externalId")
                 .id("id")
                 .logicalId("logicalId")
                 .unit("unit")
                 .build()))
         .assetModelType("assetModelType")
         .enforcedAssetModelInterfaceRelationships(List.of(EnforcedAssetModelInterfaceRelationshipProperty.builder()
                 .interfaceAssetModelId("interfaceAssetModelId")
                 .propertyMappings(List.of(EnforcedAssetModelInterfacePropertyMappingProperty.builder()
                         .interfaceAssetModelPropertyExternalId("interfaceAssetModelPropertyExternalId")
                         // the properties below are optional
                         .assetModelPropertyExternalId("assetModelPropertyExternalId")
                         .assetModelPropertyLogicalId("assetModelPropertyLogicalId")
                         .build()))
                 .build()))
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();
 

See Also:

• http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-iotsitewise-assetmodel.html

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static interface	CfnAssetModel.AssetModelCompositeModelProperty	Contains information about a composite model in an asset model.
static interface	CfnAssetModel.AssetModelHierarchyProperty	Describes an asset hierarchy that contains a hierarchy's name, ID, and child asset model ID that specifies the type of asset that can be in this hierarchy.
static interface	CfnAssetModel.AssetModelPropertyProperty	Contains information about an asset model property.
static interface	CfnAssetModel.AttributeProperty	Contains an asset attribute property.
static final class	CfnAssetModel.Builder	A fluent builder for CfnAssetModel.
static interface	CfnAssetModel.EnforcedAssetModelInterfacePropertyMappingProperty	Contains information about applied interface property and asset model property.
static interface	CfnAssetModel.EnforcedAssetModelInterfaceRelationshipProperty	Contains information about applied interface hierarchy and asset model hierarchy.
static interface	CfnAssetModel.ExpressionVariableProperty	Contains expression variable information.
static interface	CfnAssetModel.MetricProperty	Contains an asset metric property.
static interface	CfnAssetModel.MetricWindowProperty	Contains a time interval window used for data aggregate computations (for example, average, sum, count, and so on).
static interface	CfnAssetModel.PropertyPathDefinitionProperty	Represents one level between a composite model and the root of the asset model.
static interface	CfnAssetModel.PropertyTypeProperty	Contains a property type, which can be one of attribute , measurement , metric , or transform .
static interface	CfnAssetModel.TransformProperty	Contains an asset transform property.
static interface	CfnAssetModel.TumblingWindowProperty	Contains a tumbling window, which is a repeating fixed-sized, non-overlapping, and contiguous time window.
static interface	CfnAssetModel.VariableValueProperty	Identifies a property value used in an expression.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.iotsitewise.IAssetModelRef

IAssetModelRef.Jsii$Default, IAssetModelRef.Jsii$Proxy

Nested classes/interfaces inherited from interface software.constructs.IConstruct

software.constructs.IConstruct.Jsii$Default

Nested classes/interfaces inherited from interface software.amazon.awscdk.IInspectable

IInspectable.Jsii$Default, IInspectable.Jsii$Proxy

Nested classes/interfaces inherited from interface software.amazon.awscdk.ITaggable

ITaggable.Jsii$Default, ITaggable.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field	Description
static final String	CFN_RESOURCE_TYPE_NAME	The CloudFormation resource type name for this resource class.

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	CfnAssetModel(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	CfnAssetModel(software.amazon.jsii.JsiiObjectRef objRef)
	CfnAssetModel(software.constructs.Construct scope, String id, CfnAssetModelProps props)

Method Summary

Modifier and Type	Method	Description
static IAssetModelRef	fromAssetModelArn(software.constructs.Construct scope, String id, String arn)	Creates a new IAssetModelRef from an ARN.
static IAssetModelRef	fromAssetModelId(software.constructs.Construct scope, String id, String assetModelId)	Creates a new IAssetModelRef from a assetModelId.
Object	getAssetModelCompositeModels()	The composite models that are part of this asset model.
String	getAssetModelDescription()	A description for the asset model.
String	getAssetModelExternalId()	The external ID of the asset model.
Object	getAssetModelHierarchies()	The hierarchy definitions of the asset model.
String	getAssetModelName()	A unique name for the asset model.
Object	getAssetModelProperties()	The property definitions of the asset model.
AssetModelReference	getAssetModelRef()	A reference to a AssetModel resource.
String	getAssetModelType()	The type of asset model.
String	getAttrAssetModelArn()	The ARN of the asset model, which has the following format.
String	getAttrAssetModelId()	The ID of the asset model.
protected Map<String,Object>	getCfnProperties()
Object	getEnforcedAssetModelInterfaceRelationships()	a list of asset model and interface relationships.
TagManager	getTags()	Tag Manager which manages the tags for this resource.
List<CfnTag>	getTagsRaw()	A list of key-value pairs that contain metadata for the asset.
void	inspect(TreeInspector inspector)	Examines the CloudFormation resource and discloses attributes.
protected Map<String,Object>	renderProperties(Map<String,Object> props)
void	setAssetModelCompositeModels(List<Object> value)	The composite models that are part of this asset model.
void	setAssetModelCompositeModels(IResolvable value)	The composite models that are part of this asset model.
void	setAssetModelDescription(String value)	A description for the asset model.
void	setAssetModelExternalId(String value)	The external ID of the asset model.
void	setAssetModelHierarchies(List<Object> value)	The hierarchy definitions of the asset model.
void	setAssetModelHierarchies(IResolvable value)	The hierarchy definitions of the asset model.
void	setAssetModelName(String value)	A unique name for the asset model.
void	setAssetModelProperties(List<Object> value)	The property definitions of the asset model.
void	setAssetModelProperties(IResolvable value)	The property definitions of the asset model.
void	setAssetModelType(String value)	The type of asset model.
void	setEnforcedAssetModelInterfaceRelationships(List<Object> value)	a list of asset model and interface relationships.
void	setEnforcedAssetModelInterfaceRelationships(IResolvable value)	a list of asset model and interface relationships.
void	setTagsRaw(List<CfnTag> value)	A list of key-value pairs that contain metadata for the asset.

Methods inherited from class software.amazon.awscdk.CfnResource

addDeletionOverride, addDependency, addDependsOn, addMetadata, addOverride, addPropertyDeletionOverride, addPropertyOverride, applyRemovalPolicy, applyRemovalPolicy, applyRemovalPolicy, getAtt, getAtt, getCfnOptions, getCfnResourceType, getEnv, getMetadata, getUpdatedProperites, getUpdatedProperties, isCfnResource, obtainDependencies, obtainResourceDependencies, removeDependency, replaceDependency, shouldSynthesize, toString, validateProperties

Methods inherited from class software.amazon.awscdk.CfnRefElement

getRef

Methods inherited from class software.amazon.awscdk.CfnElement

getCreationStack, getLogicalId, getStack, isCfnElement, overrideLogicalId

Methods inherited from class software.constructs.Construct

getNode, isConstruct

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.awscdk.IEnvironmentAware

getEnv

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Details

CFN_RESOURCE_TYPE_NAME

@Stability(Stable)
public static final String CFN_RESOURCE_TYPE_NAME

The CloudFormation resource type name for this resource class.

Constructor Details

CfnAssetModel

protected CfnAssetModel(software.amazon.jsii.JsiiObjectRef objRef)

CfnAssetModel

protected CfnAssetModel(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

CfnAssetModel

@Stability(Stable)
public CfnAssetModel(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 CfnAssetModelProps props)

Parameters:

scope - Scope in which this resource is defined. This parameter is required.

id - Construct identifier for this resource (unique in its scope). This parameter is required.

props - Resource properties. This parameter is required.

Method Details

fromAssetModelArn

@Stability(Stable)
@NotNull
public static IAssetModelRef fromAssetModelArn(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 String arn)

Creates a new IAssetModelRef from an ARN.

Parameters:

scope - This parameter is required.

id - This parameter is required.

arn - This parameter is required.

fromAssetModelId

@Stability(Stable)
@NotNull
public static IAssetModelRef fromAssetModelId(@NotNull
 software.constructs.Construct scope,
 @NotNull
 String id,
 @NotNull
 String assetModelId)

Creates a new IAssetModelRef from a assetModelId.

Parameters:

scope - This parameter is required.

id - This parameter is required.

assetModelId - This parameter is required.

inspect

@Stability(Stable)
public void inspect(@NotNull
 TreeInspector inspector)

Examines the CloudFormation resource and discloses attributes.

Specified by:

inspect in interface IInspectable

Parameters:

inspector - tree inspector to collect and process attributes. This parameter is required.

renderProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> renderProperties(@NotNull
 Map<String,Object> props)

Overrides:

renderProperties in class CfnResource

Parameters:

props - This parameter is required.

getAssetModelRef

@Stability(Stable)
@NotNull
public AssetModelReference getAssetModelRef()

A reference to a AssetModel resource.

Specified by:

getAssetModelRef in interface IAssetModelRef

getAttrAssetModelArn

@Stability(Stable)
@NotNull
public String getAttrAssetModelArn()

The ARN of the asset model, which has the following format.

getAttrAssetModelId

@Stability(Stable)
@NotNull
public String getAttrAssetModelId()

The ID of the asset model.

getCfnProperties

@Stability(Stable)
@NotNull
protected Map<String,Object> getCfnProperties()

Overrides:

getCfnProperties in class CfnResource

getTags

@Stability(Stable)
@NotNull
public TagManager getTags()

Tag Manager which manages the tags for this resource.

Specified by:

getTags in interface ITaggable

getAssetModelName

@Stability(Stable)
@NotNull
public String getAssetModelName()

A unique name for the asset model.

setAssetModelName

@Stability(Stable)
public void setAssetModelName(@NotNull
 String value)

A unique name for the asset model.

getAssetModelCompositeModels

@Stability(Stable)
@Nullable
public Object getAssetModelCompositeModels()

The composite models that are part of this asset model.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnAssetModel.AssetModelCompositeModelProperty>

setAssetModelCompositeModels

@Stability(Stable)
public void setAssetModelCompositeModels(@Nullable
 IResolvable value)

The composite models that are part of this asset model.

setAssetModelCompositeModels

@Stability(Stable)
public void setAssetModelCompositeModels(@Nullable
 List<Object> value)

The composite models that are part of this asset model.

getAssetModelDescription

@Stability(Stable)
@Nullable
public String getAssetModelDescription()

A description for the asset model.

setAssetModelDescription

@Stability(Stable)
public void setAssetModelDescription(@Nullable
 String value)

A description for the asset model.

getAssetModelExternalId

@Stability(Stable)
@Nullable
public String getAssetModelExternalId()

The external ID of the asset model.

setAssetModelExternalId

@Stability(Stable)
public void setAssetModelExternalId(@Nullable
 String value)

The external ID of the asset model.

getAssetModelHierarchies

@Stability(Stable)
@Nullable
public Object getAssetModelHierarchies()

The hierarchy definitions of the asset model.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnAssetModel.AssetModelHierarchyProperty>

setAssetModelHierarchies

@Stability(Stable)
public void setAssetModelHierarchies(@Nullable
 IResolvable value)

The hierarchy definitions of the asset model.

setAssetModelHierarchies

@Stability(Stable)
public void setAssetModelHierarchies(@Nullable
 List<Object> value)

The hierarchy definitions of the asset model.

getAssetModelProperties

@Stability(Stable)
@Nullable
public Object getAssetModelProperties()

The property definitions of the asset model.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnAssetModel.AssetModelPropertyProperty>

setAssetModelProperties

@Stability(Stable)
public void setAssetModelProperties(@Nullable
 IResolvable value)

The property definitions of the asset model.

setAssetModelProperties

@Stability(Stable)
public void setAssetModelProperties(@Nullable
 List<Object> value)

The property definitions of the asset model.

getAssetModelType

@Stability(Stable)
@Nullable
public String getAssetModelType()

The type of asset model.

setAssetModelType

@Stability(Stable)
public void setAssetModelType(@Nullable
 String value)

The type of asset model.

getEnforcedAssetModelInterfaceRelationships

@Stability(Stable)
@Nullable
public Object getEnforcedAssetModelInterfaceRelationships()

a list of asset model and interface relationships.

Returns union: either IResolvable or Listinvalid input: '<'either IResolvable or CfnAssetModel.EnforcedAssetModelInterfaceRelationshipProperty>

setEnforcedAssetModelInterfaceRelationships

@Stability(Stable)
public void setEnforcedAssetModelInterfaceRelationships(@Nullable
 IResolvable value)

a list of asset model and interface relationships.

setEnforcedAssetModelInterfaceRelationships

@Stability(Stable)
public void setEnforcedAssetModelInterfaceRelationships(@Nullable
 List<Object> value)

a list of asset model and interface relationships.

getTagsRaw

@Stability(Stable)
@Nullable
public List<CfnTag> getTagsRaw()

A list of key-value pairs that contain metadata for the asset.

setTagsRaw

@Stability(Stable)
public void setTagsRaw(@Nullable
 List<CfnTag> value)

A list of key-value pairs that contain metadata for the asset.