Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Redécouverte des capacités

Cette section décrit les étapes à suivre pour réapprendre les informations de capacité des appareils connectés au hub à l'aide de la redécouverte des capacités.

Conditions préalables

Effectuez les étapes suivantes avant de tenter de redécouvrir les fonctionnalités :

Quand utiliser la redécouverte des capacités

Utilisez la redécouverte des capacités dans les scénarios suivants :

Lancer la redécouverte des capacités

Lancez la redécouverte des fonctionnalités de votre hub afin de mettre à jour les fonctionnalités de l'appareil.

Pour vérifier que les fonctionnalités de l'appareil ont été mises à jour, voir Fonctionnalités relatives à la gestion des objets.

Résolution des problèmes

Suivez les instructions suivantes pour résoudre les problèmes courants liés à la redécouverte des capacités. Lorsque la redécouverte des capacités est en cours, Managed Integrations envoie des notifications via Kinesis ou EventBridge sous forme de messages JSON.

Notifications de réussite

Par appareil en cours de traitement :

{
    "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
    }
}

Achèvement :

{
    "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
    }
}

Notifications d'échec

Défaillance de l'appareil :

{
    "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"
        }
    }
}

Défaillance complète :

{
    "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"
        }
    }
}

Aucune notification reçue

Si vous ne recevez aucune notification concernant l'état de la découverte, vérifiez que vous êtes abonné aux notifications d'DEVICE_DISCOVERY_STATUSévénements. Pour plus d'informations sur la configuration des notifications, consultez Configurer les notifications d'intégrations gérées.

Certains appareils ne sont pas mis à jour

Si certains appareils ne parviennent pas à se mettre à jour lors de la redécouverte des fonctionnalités, vérifiez les messages d'erreur contenus dans les DEVICE_DISCOVERY_STATUS notifications. Les messages d'erreur courants sont les suivants :

Pour résoudre ces problèmes, assurez-vous que les appareils concernés sont sous tension et accessibles, puis réessayez de redécouvrir les capacités des périphériques défaillants individuellement à l'aide du --end-device-identifier paramètre.

La découverte ne s'achève jamais

Si le processus de redécouverte des capacités ne s'achève pas, vérifiez l'état de la découverte à l'aide de l'ID de tâche de découverte renvoyé par la start-device-discovery commande :

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

Si la découverte est bloquée :