

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.

# Geräteereignisse mit der API senden SendConnectorEvent
<a name="send-connector-events"></a>

## Übersicht über vom Gerät ausgelöste Ereignisse
<a name="device-initiated-events-overview"></a>

Die `SendConnectorEvent` API wird zwar verwendet, um asynchron auf `AWS.DiscoverDevices` Vorgänge zu `AWS.SendCommand` reagieren, sie wird aber auch verwendet, um verwaltete Integrationen über alle vom Gerät ausgelösten Ereignisse zu benachrichtigen. Geräteinitiierte Ereignisse können als jedes Ereignis definiert werden, das von einem Gerät ohne einen vom Benutzer initiierten Befehl generiert wird. Zu diesen Geräteereignissen können unter anderem Änderungen des Gerätestatus, Bewegungserkennung, Akkuladestand und mehr gehören. Sie können diese Ereignisse mithilfe der `SendConnectorEvent` API mit der Operation **DEVICE\$1EVENT** an verwaltete Integrationen zurücksenden.

Im folgenden Abschnitt wird anhand einer Smart-Kamera, die zu Hause installiert ist, als Beispiel verwendet, um den Ablauf dieser Ereignisse näher zu erläutern:

![\[Arbeitsablauf bei Geräteereignissen\]](http://docs.aws.amazon.com/de_de/iot-mi/latest/devguide/images/device-events-workflow.png)


**Arbeitsablauf bei Geräteereignissen**

1. Ihre Kamera erkennt Bewegungen und generiert daraufhin ein Ereignis, das an Ihren Ressourcenserver gesendet wird.

1. Ihr Ressourcenserver verarbeitet das Ereignis und sendet es an Ihren C2C-Anschluss.

1. Ihr Connector übersetzt dieses Ereignis in die verwaltete Integrationsschnittstelle für AWS IoT Device Management`DEVICE_EVENT`.

1. Ihr C2C-Connector sendet dieses Geräteereignis mithilfe der `SendConnectorEvent` API an verwaltete Integrationen, wobei der Vorgang auf „DEVICE\$1EVENT“ eingestellt ist.

1. Managed Integrations identifiziert den relevanten Kunden und leitet dieses Ereignis an den Kunden weiter.

1. Der Kunde erhält dieses Ereignis und zeigt es dem Benutzer anhand einer Benutzerkennung an.

Weitere Informationen zum `SendConnectorEvent` API-Betrieb finden Sie `SendConnectorEvent` im Referenzhandbuch für verwaltete Integrationen für AWS IoT Device Management API.

## Anforderungen für vom Gerät ausgelöste Ereignisse
<a name="device-events-requirements"></a>

Im Folgenden sind einige Anforderungen für vom Gerät ausgelöste Ereignisse aufgeführt.
+ Ihre C2C-Connector-Ressource sollte in der Lage sein, asynchrone Geräteereignisse von Ihrem Ressourcenserver zu empfangen
+ Ihre C2C-Connector-Ressource sollte in der Lage sein, verwaltete Integrationen für AWS IoT Device Management Service-APIs über Sigv4 aufzurufen, wobei die AWS Anmeldeinformationen der für die Registrierung des C2C-Connectors AWS-Konto verwendeten Personen verwendet werden.

Das folgende Beispiel zeigt einen Connector, der ein vom Gerät ausgelöstes Ereignis über die API sendet: SendConnectorEvent 

```
AWS-API: /SendConnectorEvent
URI: POST /connector-event/{Your-Connector-Id}

{
   "UserId": "Your-End-User-ID",
   "Operation": "DEVICE_EVENT",
   "OperationVersion": "1.0",
   "StatusCode": 200,
   "Message": None,
   "ConnectorDeviceId": "Your_Device_Id",
   "MatterEndpoint": {
        "id": "1",    
        "clusters": [{
            "id": "0x0202",
            "attributes": [
                {
                    "0x0000": "3"
                }
            ]
        }]
    }]
}
```

Aus dem folgenden Beispiel geht Folgendes hervor:
+ Dies kommt vom Geräteendpunkt mit der ID gleich 1.
+ Die Gerätefunktion, auf die sich dieses Ereignis bezieht, hat eine Cluster-ID von **0x0202** und bezieht sich auf den Themencluster Fan Control.
+ Das Attribut, das geändert wurde, hat die ID **0x000** und bezieht sich auf das Fan Mode Enum innerhalb des Clusters. **Es wurde auf den Wert **3** aktualisiert, was dem Wert High entspricht.**
+  Da `connectorId` es sich um einen Parameter handelt, der vom Cloud-Dienst bei der Erstellung zurückgegeben wird, müssen Connectors Abfragen verwenden GetCloudConnector und danach filtern`lambdaARN`. Der eigene Lambda `ARN` wird mithilfe der API abgefragt. `Lambda.get_function_url_config` Dadurch kann im `CloudConnectorId` Lambda dynamisch auf die zugegriffen und nicht wie zuvor statisch konfiguriert werden. 