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.

# Einfache Einrichtung für das Onboarding und den Betrieb von Geräten
<a name="managedintegrations-sdk-v2-cookbook-ss"></a>

Richten Sie Ihre Geräte so ein, dass sie in Ihren Hub für verwaltete Integrationen integriert werden, indem Sie ein verwaltetes Objekt erstellen und es mit Ihrem Hub verbinden. In diesem Abschnitt werden die Schritte beschrieben, um den Onboarding-Prozess für Geräte mithilfe einer einfachen Einrichtung abzuschließen.

## Voraussetzungen
<a name="managedintegrations-sdk-v2-cookbook-ss-prereq"></a>

Gehen Sie wie folgt vor, bevor Sie versuchen, ein Gerät an Bord zu nehmen:
+ Integrieren Sie ein Hub-Gerät in den Managed Integrations Hub.
+ Installieren Sie die neueste Version von AWS CLI aus der [Managed Integrations AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/) Command Reference
+ Abonnieren Sie [DEVICE\_LIFE\_CYCLE-Ereignisbenachrichtigungen](managedintegrations-notifications.md#managedintegrations-notification-setup).

**Topics**
+ [Voraussetzungen](#managedintegrations-sdk-v2-cookbook-ss-prereq)
+ [Schritt 1: Erstellen Sie einen Anmeldeinformationsspeicher](#managedintegrations-sdk-v2-cookbook-credential-locker)
+ [Schritt 2: Fügen Sie Ihrem Hub den Credential Locker hinzu](#managedintegrations-sdk-v2-cookbook-add-to-hub)
+ [Schritt 3: Erstellen Sie ein verwaltetes Ding mit Anmeldeinformationen.](#managedintegrations-sdk-v2-cookbook-ss-create-managed-thing)
+ [Schritt 4: Schließen Sie das Gerät an und überprüfen Sie seinen Status.](#managedintegrations-sdk-v2-cookbook-ss-check-device-status)
+ [Schritt 5: Holen Sie sich die Gerätefunktionen](#managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities)
+ [Schritt 6: Senden Sie einen Befehl an das verwaltete Ding](#managedintegrations-sdk-v2-cookbook-ss-control-device)
+ [Schritt 7: Entfernen Sie das verwaltete Ding von Ihrem Hub](#managedintegrations-sdk-v2-cookbook-clean-up)

## Schritt 1: Erstellen Sie einen Anmeldeinformationsspeicher
<a name="managedintegrations-sdk-v2-cookbook-credential-locker"></a>

Erstellen Sie einen Anmeldeinformationsspeicher für Ihr Gerät. 

**Um einen Anmeldeinformationsspeicher zu erstellen**
+ Verwenden Sie den Befehl `create-credential-locker`. Die Ausführung dieses Befehls löst die Erstellung aller Fertigungsressourcen aus, einschließlich des Wi-Fi-Setup-Schlüsselpaars und des Gerätezertifikats.

  **create-credential-locker-Beispiel**

  ```
  aws iot-managed-integrations create-credential-locker \
    --name {{"DEVICE_NAME"}}
  ```

  **Antwort:**

  ```
  {    
    "Id": {{"LOCKER_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:credential-locker/{{LOCKER_ID}}
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  Weitere Informationen finden Sie in der [create-credential-locker](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-credential-locker.html)*Befehlsreferenz für verwaltete Integrationen zu diesem AWS CLI Befehl.*

## Schritt 2: Fügen Sie Ihrem Hub den Credential Locker hinzu
<a name="managedintegrations-sdk-v2-cookbook-add-to-hub"></a>

Fügen Sie das Credential Locker zu Ihrem Hub hinzu.

**Um Ihrem Hub ein Schließfach für Anmeldeinformationen hinzuzufügen**
+ Verwenden Sie den folgenden Befehl, um Ihrem Hub einen Anmeldeinformationsspeicher hinzuzufügen.

  ```
  aws iotmi --region {{AWS_REGION}} --endpoint {{AWS_ENDPOINT}} update-managed-thing \
  --identifier {{"HUB_MANAGED_THING_ID"}} --credential-locker-id {{"LOCKER_ID"}}
  ```

## Schritt 3: Erstellen Sie ein verwaltetes Ding mit Anmeldeinformationen.
<a name="managedintegrations-sdk-v2-cookbook-ss-create-managed-thing"></a>

Erstellen Sie ein verwaltetes Ding mit Anmeldeinformationen für Ihr Gerät. Jedes Gerät benötigt sein eigenes verwaltetes Ding.

**Um ein verwaltetes Ding zu erstellen**
+ Verwenden Sie den `create-managed-thing` Befehl, um ein verwaltetes Ding für Ihr Gerät zu erstellen.

  **create-managed-thing-Beispiel**

  ```
  #ZWAVE: 
  aws iot-managed-integrations create-managed-thing --role DEVICE \
  --authentication-material '900137947003133...' \ #auth material from zwave qr code
  --authentication-material-type ZWAVE_QR_BAR_CODE \
  --credential-locker-id ${locker_id}
  
  #ZIGBEE:
  aws iot-managed-integrations create-managed-thing --role DEVICE \
  --authentication-material 'Z:286...$I:A4DC00.' \ #auth material from zigbee qr code
  --authentication-material-type ZIGBEE_QR_BAR_CODE \
  --credential-locker-id ${locker_id}
  ```
**Anmerkung**  
Es gibt separate Befehle für Z-Wave- und ZigBee-Geräte.

  **Antwort:**

  ```
  {    
    "Id": {{"DEVICE_MANAGED_THING_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:managed-thing/{{DEVICE_MANAGED_THING_ID}}"
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  *Weitere Informationen finden Sie in der [create-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/create-managed-thing.html)Befehlsreferenz für verwaltete Integrationen AWS CLI zu diesem Befehl.*

## Schritt 4: Schließen Sie das Gerät an und überprüfen Sie seinen Status.
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-status"></a>

**Schließen Sie das Gerät an und überprüfen Sie seinen Status.**
+ Verwenden Sie den `get-managed-thing` Befehl, um den Status Ihres Geräts zu überprüfen. Das ProvisioningStatus Ihres verwalteten Objekts muss AKTIVIERT sein. Weitere Informationen finden Sie ProvisioningStatus unter [Gerätebereitstellung](https://docs.aws.amazon.com/iot-mi/latest/devguide/device-provisioning.html).

  **get-managed-thing-Beispiel**

  ```
  #KINESIS NOTIFICATION:
  {
      "version": "1.0.0",
      "messageId": "4ac684bb7f4c41adbb2eecc1e7991xxx",
      "messageType": "DEVICE_LIFE_CYCLE",
      "source": "aws.iotmanagedintegrations",
      "customerAccountId": "12345678901",
      "timestamp": "2025-06-10T05:30:59.852659650Z",
      "region": "us-east-1",
      "resources": ["XXX"],
      "payload": {
          "deviceDetails": {
              "id": "1e84f61fa79a41219534b6fd57052XXX",
              "arn": "XXX",
              "createdAt": "2025-06-09T06:24:34.336120179Z",
              "updatedAt": "2025-06-10T05:30:59.784157019Z"
          },
          "status": "ACTIVATED"
      }
  }
  aws iot-managed-integrations get-managed-thing \
  --identifier {{:"DEVICE_MANAGED_THING_ID"}}
  ```

  **Antwort:**

  ```
  {    
    "Id": {{"DEVICE_MANAGED_THING_ID"}}
    "Arn": "arn:aws:iotmanagedintegrations:{{AWS_REGION}}:{{AWS_ACCOUNT_ID}}:managed-thing/{{MANAGED_THING_ID}}"
    "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
  }
  ```

  *Weitere Informationen finden Sie unter dem [get-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing.html)Befehl in der Befehlsreferenz für verwaltete Integrationen AWS CLI .*

## Schritt 5: Holen Sie sich die Gerätefunktionen
<a name="managedintegrations-sdk-v2-cookbook-ss-check-device-capabilities"></a>

Verwenden Sie den `get-managed-thing-capabilities` Befehl, um Ihre Endpunkt-ID abzurufen und eine Liste möglicher Aktionen für Ihr Gerät anzuzeigen.

**Um die Funktionen eines Geräts abzurufen**
+ Verwenden Sie den `get-managed-thing-capabilities` Befehl und notieren Sie sich die Endpunkt-ID.

  **get-managed-thing-capabilties-Beispiel**

  ```
  aws iotmi get-managed-thing-capabilities \
  --identifier {{"DEVICE_MANAGED_THING_ID"}}
  ```

  **Antwort:**

  ```
  {    
      "ManagedThingId": "1e84f61fa79a41219534b6fd57052cbc",
      "CapabilityReport": {
          "version": "1.0.0",
          "nodeId": "zw.FCB10009+06",
          "endpoints": [
              {
                  "id": {{"ENDPOINT_ID"}}
                  "deviceTypes": [
                      "On/Off Switch"
                  ],
                  "capabilities": [
                      {
                          "id": "matter.OnOff@1.4",
                          "name": "On/Off",
                          "version": "6",
                          "properties": [
                              "OnOff"
                          ],
                          "actions": [
                              "Off",
                              "On"
                          ],
                          "events": []
                      }
                      ...
  }
  ```

  Weitere Informationen finden Sie unter dem [get-managed-thing-capabilities](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/get-managed-thing-capabilities.html)Befehl in der AWS CLI *Befehlsreferenz* für verwaltete Integrationen.

## Schritt 6: Senden Sie einen Befehl an das verwaltete Ding
<a name="managedintegrations-sdk-v2-cookbook-ss-control-device"></a>

Verwenden Sie den `send-managed-thing-command` Befehl, um einen Befehl zum Umschalten einer Aktion an Ihr verwaltetes Ding zu senden.

**Um einen Befehl an Ihr verwaltetes Ding zu senden**
+ Verwenden Sie den `send-managed-thing-command` Befehl, um einen Befehl an Ihr verwaltetes Ding zu senden.

  **send-managed-thing-command-Beispiel**

  ```
  json=$(jq -cr '.|@json') <<EOF
  [
    {
      "endpointId": "1",
      "capabilities": [
        {
          "id": "matter.OnOff@1.4",
          "name": "On/Off",
          "version": "1",
          "actions": [
            {
              "name": "Toggle",
              "parameters": {}
            }
          ]
        }
      ]
    }
  ]
  EOF
  aws iot-managed-integrations send-managed-thing-command \
  --managed-thing-id {{"DEVICE_MANAGED_THING_ID"}} --endpoints {{"ENDPOINT_ID"}}
  ```
**Anmerkung**  
In diesem Beispiel wird jq cli verwendet, aber Sie können auch die gesamte `endpointId` Zeichenfolge übergeben

  **Antwort:**

  ```
  {    
  "TraceId": {{"TRACE_ID"}}
  }
  ```

  *Weitere Informationen finden Sie unter dem [send-managed-thing-command](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/send-managed-thing-command.html)Befehl in der Befehlsreferenz für verwaltete Integrationen AWS CLI .*

## Schritt 7: Entfernen Sie das verwaltete Ding von Ihrem Hub
<a name="managedintegrations-sdk-v2-cookbook-clean-up"></a>

Bereinigen Sie Ihren Hub, indem Sie das verwaltete Ding entfernen.

**Um ein verwaltetes Ding zu löschen**
+ Verwenden Sie den `delete-managed-thing` Befehl, um ein verwaltetes Ding von Ihrem Gerätehub zu entfernen.

  **delete-managed-thing-Beispiel**

  ```
  aws iot-managed-integrations delete-managed-thing \
  --identifier {{"DEVICE_MANAGED_THING_ID"}}
  ```

  Weitere Informationen finden Sie in der [delete-managed-thing](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/delete-managed-thing.html)*Befehlsreferenz für verwaltete Integrationen zu diesem AWS CLI Befehl.*
**Anmerkung**  
Wenn das Gerät in einem bestimmten `DELETE_IN_PROGRESS` Zustand feststeckt, hängen Sie das `--force` Kennzeichen an. `delete-managed-thing command`
**Anmerkung**  
Bei Z-Wave-Geräten müssen Sie das Gerät nach der Ausführung des Befehls in den Pairing-Modus versetzen.