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:
+ Integrieren Sie ein Hub-Gerät in den Managed Integrations Hub.
+ Integrieren Sie ein oder mehrere Endgeräte in den Hub.
+ Installieren Sie die neueste Version von AWS CLI aus der [Managed Integrations AWS CLI Command Reference](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)
+ (Optional) Abonnieren Sie [DEVICE\_DISCOVERY\_STATUS-Ereignisbenachrichtigungen](managedintegrations-notifications.md#managedintegrations-notification-setup).
## Wann sollte Capability Rediscovery verwendet werden
Verwenden Sie Capability Rediscovery in den folgenden Szenarien:
+ Nach einem Firmware-Update für ein Endgerät, das Gerätefunktionen hinzufügt oder ändert
+ Nach einem Hub-Softwareupdate, das die Unterstützung neuer Gerätefunktionen ermöglicht
+ Wenn die Gerätefunktionen in Managed Integrations nicht korrekt wiedergegeben werden
+ Um die Funktionsinformationen für ein einzelnes Gerät oder für alle mit einem Hub verbundenen Geräte zu aktualisieren
## Starten Sie die Wiederherstellung der Funktionsfähigkeit
Starten Sie die Wiederherstellung der Funktionen für Ihren Hub, um die Gerätefunktionen zu aktualisieren.
**Um die Wiederherstellung der Funktionsfähigkeit zu starten**
+ Verwenden Sie den Befehl [start-device-discovery mit dem Discovery-Typ](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html). `CONTROLLER_CAPABILITY_REDISCOVERY`
**start-device-discovery-Beispiel**
```
# For a single device
aws iot-managed-integrations start-device-discovery \
--discovery-type CONTROLLER_CAPABILITY_REDISCOVERY \
--controller-identifier {{HUB_MANAGED_THING_ID}} \
--protocol {{PROTOCOL}} \
--end-device-identifier {{DEVICE_MANAGED_THING_ID}}
# For all devices on a protocol
aws iot-managed-integrations start-device-discovery \
--discovery-type CONTROLLER_CAPABILITY_REDISCOVERY \
--controller-identifier {{HUB_MANAGED_THING_ID}} \
--protocol {{PROTOCOL}}
```
**Antwort:**
```
{
"Id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
"StartedAt": "2026-01-12T23:07:49.275Z"
}
```
**Anmerkung**
Der `--protocol` Parameter akzeptiert`ZIGBEE`,, oder. `ZWAVE` `CUSTOM`
Wenn der optionale `--end-device-identifier` Parameter nicht angegeben wird, werden alle Geräte, die dem Hub für das ausgewählte Protokoll zugeordnet sind, erneut erkannt.
*Weitere Informationen finden Sie unter dem Befehl [start-device-discovery](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html) in der Befehlsreferenz für verwaltete Integrationen. AWS CLI *
[Informationen darüber, ob die Gerätefunktionen aktualisiert wurden, finden Sie unter Funktionen für verwaltete Dinge abrufen.](managedintegrations-sdk-v2-cookbook-ugs.md#managedintegrations-sdk-v2-cookbook-check-device-capabilties)
## 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](managedintegrations-notifications.md#managedintegrations-notification-setup).
### 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:
+ `Device unreachable`- Das Gerät ist offline oder reagiert nicht
+ `Timeout querying device`- Das Gerät reagiert nicht innerhalb des erwarteten Zeitrahmens
+ `Invalid capability report`- Möglicherweise liegt ein Problem mit der Gerätefirmware vor
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:
+ Stellen Sie sicher, dass der Hub online und mit Managed Integrations verbunden ist
+ Warten Sie bis zu 15 Minuten, bis die Erkennung automatisch abgelaufen ist
+ Versuchen Sie erneut, die Funktion erneut zu ermitteln, nachdem Sie sich vergewissert haben, dass der Hub und die Geräte betriebsbereit sind