定義靜態數據(屬性) - AWS IoT SiteWise

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

定義靜態數據(屬性)

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

定義屬性 (主控台)

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

  • 名稱 — 屬性的名稱。

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

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

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

    • 整數 — 有符號的 32 位元整數,範圍為 [-2,147,483,648,2,147,483,647]。

    • 雙倍 — 一個浮點數,範圍為 [-10 ^ 100,10 ^ 100] 和 IEEE 754 倍精度。

    • 布爾-truefalse

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

如需詳細資訊,請參閱 建立資產模型 (主控台)

定義屬性 (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 使用者指南》中的 使用外部 ID 參考物件

範例屬性定義

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

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