静的データ (属性) を定義する

アセット属性は、デバイスの製造元や地理的位置など、一般的に静的な情報を表します。アセットモデルから作成する各アセットには、このモデルの属性が含まれています。

属性の定義 (コンソール）

AWS IoT SiteWise コンソールでアセットモデルの属性を定義するときは、次のパラメータを指定します。

• [Name] (名前) - プロパティの名前。

• [Default value] (デフォルト値) –(オプション) この属性のデフォルト値。モデルから作成されたアセットは、属性に対してこの値を持ちます。モデルから作成されたアセットのデフォルト値を上書きする方法の詳細については、「属性値を更新する」を参照してください。

• [Data type] (データ型) - プロパティのデータ型で、次のいずれかになります。

  • [String] (文字列) – 最大 1024 バイトの文字列。

  • [Integer] (整数) - [-2,147,483,648, 2,147,483,647] の範囲を持つ 32 ビットの符合付き整数。

  • Double – [-10^100, 10^100] および 754 IEEE 倍精度の範囲の浮動小数点数。

  • [Boolean] (ブール値) - true または false。

• 外部 ID – (オプション) これはユーザー定義 ID です。詳細については、AWS IoT SiteWise  ユーザーガイドの 外部でオブジェクトを参照する IDsを参照してください。

詳細については、「アセットモデルを作成する (コンソール）」を参照してください。

属性の定義 (AWS CLI）

を使用してアセットモデルの属性を定義する場合は AWS IoT SiteWise API、次のパラメータを指定します。

• name - プロパティの名前。

• defaultValue -(オプション) この属性のデフォルト値。モデルから作成されたアセットは、属性に対してこの値を持ちます。モデルから作成されたアセットのデフォルト値を上書きする方法の詳細については、「属性値を更新する」を参照してください。

• dataType - プロパティのデータ型。次のいずれかです。

  • STRING - 最大 1024 バイトの文字列。

  • INTEGER - [-2,147,483,648, 2,147,483,647] の範囲を持つ 32 ビットの符合付き整数。

  • DOUBLE – [-10^100, 10^100] および 754 IEEE 倍精度の範囲の浮動小数点数。

  • BOOLEAN – true または false

• externalId – (オプション) これはユーザー定義 ID です。詳細については、AWS IoT SiteWise  ユーザーガイドの 外部でオブジェクトを参照する IDsを参照してください。

例 属性定義の例

次の例では、デフォルト値でアセットのモデル番号を表す属性を示します。このオブジェクトは、属性 AssetModelPropertyを含む の例です。このオブジェクトをCreateAssetModelリクエストペイロードの一部として指定して、属性プロパティを作成できます。詳細については、「アセットモデルを作成する (AWS CLI）」を参照してください。

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