Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Riscoperta delle capacità

Questa sezione descrive i passaggi per apprendere nuovamente le informazioni sulle funzionalità dei dispositivi connessi all'hub utilizzando Capability Rediscovery.

Prerequisiti

Completa questi passaggi prima di tentare la riscoperta delle funzionalità:

Quando utilizzare Capability Rediscovery

Utilizza la riscoperta delle capacità nei seguenti scenari:

Avvia la riscoperta delle funzionalità

Avvia la riscoperta delle funzionalità del tuo hub per aggiornare le funzionalità del dispositivo.

Per verificare che le funzionalità del dispositivo siano state aggiornate, consulta Get managed thing capabilities.

Risoluzione dei problemi

Utilizza le seguenti indicazioni per risolvere i problemi più comuni relativi alla riscoperta delle funzionalità. Quando è in corso la riscoperta delle funzionalità, Managed Integrations invia notifiche tramite Kinesis o EventBridge come messaggi JSON.

Notifiche di successo

Per dispositivo in fase di elaborazione:

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

Completamento:

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

Notifiche di errore

Guasto del dispositivo:

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

Fallimento completo:

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

Nessuna notifica ricevuta

Se non ricevi notifiche sullo stato del rilevamento, verifica di aver sottoscritto la sottoscrizione alle notifiche DEVICE_DISCOVERY_STATUS degli eventi. Per ulteriori informazioni su come impostare le notifiche, consulta Imposta le notifiche relative alle integrazioni gestite.

Alcuni dispositivi non sono aggiornati

Se alcuni dispositivi non riescono ad aggiornarsi durante la riscoperta della funzionalità, controlla i messaggi di errore nelle DEVICE_DISCOVERY_STATUS notifiche. I messaggi di errore più comuni includono:

Per risolvere questi problemi, assicurati che i dispositivi interessati siano accesi e raggiungibili, quindi riprova la funzionalità per i dispositivi guasti singolarmente utilizzando il parametro. --end-device-identifier

La scoperta non viene mai completata

Se il processo di riscoperta delle funzionalità non viene completato, controlla lo stato di rilevamento utilizzando l'ID del processo di rilevamento restituito dal start-device-discovery comando:

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

Se il rilevamento è bloccato: