定義靜態資料 (屬性) - AWS IoT SiteWise

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

定義靜態資料 (屬性)

資產屬性代表一般靜態的資訊,例如裝置製造商或地理位置。您從資產模型建立的每個資產,皆會包含該模型的屬性。

定義屬性 (主控台)

當您在 AWS IoT SiteWise 主控台中定義資產模型的屬性時,您可以指定下列參數:

  • 名稱 – 屬性的名稱。

  • 預設值 – (選用) 此屬性的預設值。從模型建立的資產具有此屬性值。對於從模型建立的資產,如需如何覆寫預設值的詳細資訊,請參閱 更新屬性值

  • 資料類型 – 屬性的資料類型,其為下列其中一項:

    • 字串 – 最多 1024 個位元組的字串。

    • 整數 – 範圍為 【-2,147,483,648,2,147,483,647】 的帶正負號 32 位元整數。

    • Double – 具有範圍 【-10^100、10^100】 和 IEEE 754 雙精度的浮點數。

    • 布林值truefalse

  • 外部 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】 和 IEEE 754 雙精度的浮點數。

    • BOOLEANtruefalse

  • externalId – (選用) 這是使用者定義的 ID。如需詳細資訊,請參閱《AWS IoT SiteWise 使用者指南》中的 具有外部 IDs參考物件

範例屬性定義

下列範例示範會將資產的模型編號以預設值呈現的屬性。此物件是包含 屬性AssetModelProperty 範例。您可以指定此物件做為 CreateAssetModel 請求承載的一部分,以建立屬性屬性。如需詳細資訊,請參閱建立資產模型 (AWS CLI)

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