AWS 實作事項資料模型

事項資料模型的 AWS 實作會管理受管整合和第三方雲端提供者之間的所有通訊。

如需詳細資訊，請參閱事項資料模型：開發人員資源。

裝置階層

有兩種資料元素可用來描述裝置： endpoint和 cluster。

endpoint

endpoint 代表 功能提供的邏輯界面或服務。

{
    "id": { "type":"string"},
    "clusters": Cluster[]
}

cluster

cluster 代表裝置功能。

{
    "id": "hexadecimalString",
   "revision": "string"        // optional
    "attributes": AttributeMap<String attributeId, JSONNode>,
   "commands": CommandMap<String commandId, JSONNode>,
   "events": EventMap<String eventId, JsonNode>
}

對於cluster資料元素，有三個項目構成該項目：attribute、 command和 event。它們可用來與裝置互動和監控裝置。

• 屬性：裝置保留的狀態，例如可調光光源的目前亮度屬性。

  • {
        "id" (hexadecimalString): (JsonNode) value
    }

• 命令：可執行的任務，例如鎖定門鎖上的門。命令可能會產生回應和結果。

  • "id": {
        "fieldId": "fieldValue",
        ...
        "responseCode": HTTPResponseCode,
        "errors": { 
            "code": "string",
            "message": "string"
        }
    }

• 事件：基本上是過去狀態轉換的記錄。雖然 attributes代表目前狀態，但事件是過去的日誌，並包含單調增加的計數器、時間戳記和優先順序。它們可以擷取狀態轉換，以及使用 無法立即實現的資料建模attributes。

  • "id": {
        "fieldId": "fieldValue",
        ...
    }