View a markdown version of this page

Einfache Einrichtung für das Onboarding und den Betrieb von Geräten - Verwaltete Integrationen für AWS IoT Device Management
VoraussetzungenSchritt 1: Erstellen Sie einen AnmeldeinformationsspeicherSchritt 2: Fügen Sie Ihrem Hub den Credential Locker hinzuSchritt 3: Erstellen Sie ein verwaltetes Ding mit Anmeldeinformationen.Schritt 4: Schließen Sie das Gerät an und überprüfen Sie seinen Status.Schritt 5: Holen Sie sich die GerätefunktionenSchritt 6: Senden Sie einen Befehl an das verwaltete DingSchritt 7: Entfernen Sie das verwaltete Ding von Ihrem Hub

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

Richten Sie Ihre Geräte so ein, dass sie in Ihren Managed Integrations Hub 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

Gehen Sie wie folgt vor, bevor Sie versuchen, ein Gerät an Bord zu nehmen:

Schritt 1: Erstellen Sie einen Anmeldeinformationsspeicher

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 unter dem Befehl create-credentials locker in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

Schritt 2: Fügen Sie Ihrem Hub den Credential Locker hinzu

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.

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 unter dem Befehl create-managed-thing in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

Schritt 4: Schließen Sie das Gerät an und überprüfen Sie seinen Status.

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 dazu finden Sie ProvisioningStatus unter Gerätebereitstellung.

    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 Befehl get-managed-thing in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

Schritt 5: Holen Sie sich die Gerätefunktionen

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 Befehl get-managed-thing-capabilities in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

Schritt 6: Senden Sie einen Befehl an das verwaltete Ding

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 Befehl send-managed-thing-command in der Managed Integrations Command Reference. AWS CLI

Schritt 7: Entfernen Sie das verwaltete Ding von Ihrem Hub

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 unter dem Befehl delete-managed-thing in der Befehlsreferenz für verwaltete Integrationen. AWS CLI

    Anmerkung

    Wenn das Gerät in einem bestimmten DELETE_IN_PROGRESS Zustand feststeckt, hängen Sie das Kennzeichen an. --force 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.