Datenmodell für verwaltete Integrationen - Verwaltete Integrationen für AWS IoT Device Management

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Datenmodell für verwaltete Integrationen

Das Datenmodell für verwaltete Integrationen verwaltet die gesamte Kommunikation zwischen dem Endbenutzer und verwalteten Integrationen.

Gerätehierarchie

Die capability Datenelemente endpoint und werden verwendet, um ein Gerät im Datenmodell für verwaltete Integrationen zu beschreiben.

endpoint

Das endpoint steht für die logischen Schnittstellen oder Dienste, die von der Funktion angeboten werden.

{
    "endpointId": { "type":"string" },
    "capabilities": Capability[]
}

Capability

Das capability steht für die Funktionen des Geräts.

{
    "$id": "string",                // Schema identifier (e.g. /schema-versions/capability/matter.OnOff@1.4)
    "name": "string",               // Human readable name
    "version": "string",            // e.g. 1.0  
    "properties": Property[],
    "actions": Action[],
    "events": Event[]
}

Für das capability Datenelement gibt es drei Elemente, aus denen dieses Element besteht: propertyaction, undevent. Sie können verwendet werden, um mit dem Gerät zu interagieren und es zu überwachen.

  • Eigenschaft: Status, die vom Gerät gespeichert werden, z. B. die aktuelle Helligkeitsstufe einer dimmbaren Leuchte.

    • {
    "name":                      // Property Name is outside of Property Entity
    "value": Value,              // value represented in any type e.g. 4, "A", []
    "lastChangedAt": Timestamp   // ISO 8601 Timestamp upto milliseconds yyyy-MM-ddTHH:mm:ss.ssssssZ
    "mutable": boolean,
    "retrievable": boolean,
    "reportable": boolean
    
}

  • Aktion: Aufgaben, die ausgeführt werden können, z. B. das Verriegeln einer Tür an einem Türschloss. Aktionen können zu Reaktionen und Ergebnissen führen.

    • { 
    "name": { "$ref": "/schema-versions/definition/aws.name@1.0" }, //required 
    "parameters": Map<String name, JSONNode value>, 
    "responseCode": HTTPResponseCode,
    "errors": { 
        "code": "string",
        "message": "string"
    }
}

  • Ereignis: Im Wesentlichen eine Aufzeichnung vergangener Zustandsübergänge. Ereignisse property stellen zwar die aktuellen Zustände dar, sind aber ein Journal der Vergangenheit und beinhalten einen monoton ansteigenden Zähler, einen Zeitstempel und eine Priorität. Sie ermöglichen die Erfassung von Zustandsübergängen sowie die Datenmodellierung, die mit dieser Methode nicht ohne weiteres erreicht werden kann. property

    • {
    "name": { "$ref": "/schema-versions/definition/aws.name@1.0" },        //required
    "parameters": Map<String name, JSONNode value> 
}