Defining static data (attributes) - AWS IoT SiteWise

Defining static data (attributes)

Asset attributes represent information that is generally static, such as device manufacturer or geographic location. Each asset that you create from an asset model contains the attributes of that model.

Defining attributes (console)

When you define an attribute for an asset model in the AWS IoT SiteWise console, you specify the following parameters:

  • Name – The property's name.

  • Default value – (Optional) The default value for this attribute. Assets created from the model have this value for the attribute. For more information about how to override the default value in an asset created from a model, see Updating attribute values.

  • Data type – The property's data type, which is one of the following:

    • String – A string with up to 1024 bytes.

    • Integer – A signed 32-bit integer with range [-2,147,483,648, 2,147,483,647].

    • Double – A floating point number with range [-10^100, 10^100] and IEEE 754 double precision.

    • Booleantrue or false.

For more information, see Creating an asset model (console).

Example attribute definition

The following example demonstrates an attribute that represents an asset's model number with a default value.


                AWS IoT SiteWise "Create model" page screenshot with an example attribute's parameters
                  highlighted.

Defining attributes (CLI)

When you define an attribute for an asset model with the AWS IoT SiteWise API, you specify the following parameters:

  • name – The property's name.

  • defaultValue – (Optional) The default value for this attribute. Assets created from the model have this value for the attribute. For more information about how to override the default value in an asset created from a model, see Updating attribute values.

  • dataType – The property's data type, which is one of the following:

    • STRING – A string with up to 1024 bytes.

    • INTEGER – A floating point number with range [-10^100, 10^100] and IEEE 754 double precision.

    • DOUBLE – A signed 32-bit integer with range [-2,147,483,648, 2,147,483,647].

    • BOOLEANtrue or false.

Example attribute definition

The following example demonstrates an attribute that represents an asset's model number with a default value. This object is an example of an AssetModelProperty that contains an Attribute. You can specify this object as a part of the CreateAssetModel request payload to create an attribute property. For more information, see Creating an asset model (CLI).

{ ... "assetModelProperties": [ { "name": "Model number", "dataType": "STRING", "type": { "attribute": { "defaultValue": "BLT123" } } } ], ... }