Defining static data (attributes) - Amazon IoT SiteWise
Defining attributes (console)Defining attributes (Amazon CLI)
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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 Amazon 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.

    • Boolean – true or false.

  • External ID – (Optional) This is a user-defined ID. For more information, see Referencing objects with external IDs in the Amazon IoT SiteWise User Guide.

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

Defining attributes (Amazon CLI)

When you define an attribute for an asset model with the Amazon 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 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.

    • BOOLEAN – true or false.

  • externalId – (Optional) This is a user-defined ID. For more information, see Referencing objects with external IDs in the Amazon IoT SiteWise User Guide.

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 (Amazon CLI).

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