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.

Wiederentdeckung von Fähigkeiten

In diesem Abschnitt werden die Schritte zum erneuten Erlernen von Informationen zur Gerätefunktion für Geräte mit Hub-Verbindung mithilfe von Capability Rediscovery beschrieben.

Voraussetzungen

Gehen Sie wie folgt vor, bevor Sie versuchen, Funktionen wiederzufinden:

Wann sollte Capability Rediscovery verwendet werden

Verwenden Sie Capability Rediscovery in den folgenden Szenarien:

Starten Sie die Wiederherstellung der Funktionsfähigkeit

Starten Sie die Wiederherstellung der Funktionen für Ihren Hub, um die Gerätefunktionen zu aktualisieren.

Informationen darüber, ob die Gerätefunktionen aktualisiert wurden, finden Sie unter Funktionen für verwaltete Dinge abrufen.

Fehlerbehebung

Verwenden Sie die folgenden Anleitungen, um häufig auftretende Probleme bei der Wiederherstellung von Funktionen zu beheben. Wenn Funktionen wiederentdeckt werden, sendet Managed Integrations Benachrichtigungen über Kinesis oder EventBridge als JSON-Nachrichten.

Benachrichtigungen über Erfolge

Pro verarbeitetem Gerät:

{
    "messageType": "DEVICE_DISCOVERY_STATUS",
    // Capability rediscovery with controller and end device
    "resources": ["arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/abc123def456", "arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/xyz789uvw012"],
    "payload": {
        "deviceDiscoveryId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "status": "RUNNING",
        "deviceCount": 1
    }
}

Abschluss:

{
    "messageType": "DEVICE_DISCOVERY_STATUS",
    // Capability rediscovery with controller only
    "resources": ["arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/abc123def456"],
    "payload": {
        "deviceDiscoveryId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "status": "SUCCEEDED",
        "deviceCount": 0
    }
}

Benachrichtigungen über Fehler

Geräteausfall:

{
    "messageType": "DEVICE_DISCOVERY_STATUS",
    // Capability rediscovery with controller and end device
    "resources": ["arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/abc123def456", "arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/ghi345jkl678"],
    "payload": {
        "deviceDiscoveryId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "status": "RUNNING",
        "deviceCount": 1,
        "error": {
            "code": "500",
            "message": "Device unreachable",
            "managedThingId": "ghi345jkl678"
        }
    }
}

Vollständiger Ausfall:

{
    "messageType": "DEVICE_DISCOVERY_STATUS",
    // Capability rediscovery with controller only
    "resources": ["arn:aws:iotmanagedintegrations:us-east-1:123456789012:managed-thing/abc123def456"],
    "payload": {
        "deviceDiscoveryId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
        "status": "FAILED",
        "deviceCount": 0,
        "error": {
            "code": "404",
            "message": "Specified controller does not exist"
        }
    }
}

Keine Benachrichtigungen erhalten

Wenn Sie keine Benachrichtigungen über den Erkennungsstatus erhalten, stellen Sie sicher, dass Sie DEVICE_DISCOVERY_STATUS Ereignisbenachrichtigungen abonniert haben. Weitere Informationen zur Einrichtung von Benachrichtigungen finden Sie unter Richten Sie Benachrichtigungen für verwaltete Integrationen ein.

Einige Geräte wurden nicht aktualisiert

Wenn einige Geräte während der Wiederherstellung der Funktionsfähigkeit nicht aktualisiert werden können, überprüfen Sie die Fehlermeldungen in den DEVICE_DISCOVERY_STATUS Benachrichtigungen. Zu den häufigsten Fehlermeldungen gehören:

Um diese Probleme zu beheben, stellen Sie sicher, dass die betroffenen Geräte eingeschaltet und erreichbar sind, und versuchen Sie dann erneut, die Funktionsfähigkeit der ausgefallenen Geräte einzeln anhand des --end-device-identifier Parameters neu zu ermitteln.

Die Erkennung wird nie abgeschlossen

Wenn der Prozess zur Wiederherstellung der Fähigkeit nicht abgeschlossen wird, überprüfen Sie den Discovery-Status anhand der Discovery-Job-ID, die vom start-device-discovery folgenden Befehl zurückgegeben wurde:

aws iot-managed-integrations get-device-discovery \
  --identifier DISCOVERY_JOB_ID

Wenn die Erkennung feststeckt: