View a markdown version of this page

Redescubrimiento de capacidades - Integraciones gestionadas para AWS IoT Device Management
Requisitos previosCuándo utilizar el redescubrimiento de capacidadesInicie el redescubrimiento de la capacidadResolución de problemas

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Redescubrimiento de capacidades

En esta sección se describen los pasos para volver a aprender la información de capacidad de los dispositivos conectados a un hub mediante la redetección de capacidades.

Requisitos previos

Complete estos pasos antes de intentar redescubrir la capacidad:

Cuándo utilizar el redescubrimiento de capacidades

Utilice el redescubrimiento de capacidades en los siguientes escenarios:

  • Tras una actualización del firmware de un dispositivo final que añada o modifique las capacidades del dispositivo

  • Tras una actualización del software del hub que permita la compatibilidad con las nuevas funciones del dispositivo

  • Cuando las capacidades del dispositivo no se reflejan con precisión en las integraciones gestionadas

  • Para actualizar la información de capacidad de un solo dispositivo o de todos los dispositivos conectados a un hub

Inicie el redescubrimiento de la capacidad

Inicie el redescubrimiento de las capacidades de su hub para actualizar las capacidades del dispositivo.

Para iniciar el redescubrimiento de capacidades

  • Utilice el comando start-device-discovery con el tipo de descubrimiento. CONTROLLER_CAPABILITY_REDISCOVERY

    Ejemplo de start-device-discovery

    # 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

    Respuesta:

    {
    "Id": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "StartedAt": "2026-01-12T23:07:49.275Z"
}
    nota

    El --protocol parámetro aceptaZIGBEE, o. ZWAVE CUSTOM

    Si no se proporciona el --end-device-identifier parámetro opcional, se vuelven a detectar todos los dispositivos asociados al hub para el protocolo seleccionado.

    Para obtener más información, consulte el comando start-device-discovery en la Referencia de comandos de integraciones gestionadas. AWS CLI

Para comprobar que las capacidades del dispositivo se han actualizado, consulte Obtener las capacidades de los dispositivos gestionados.

Resolución de problemas

Utilice la siguiente guía para solucionar problemas comunes relacionados con la redetección de capacidades. Cuando se está redescubriendo la capacidad, Managed Integrations envía las notificaciones a través de Kinesis o EventBridge como mensajes JSON.

Notificaciones de éxito

Por dispositivo que se está procesando:

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

Finalización:

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

Notificaciones de error

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

Fallo total:

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

No se ha recibido ninguna notificación

Si no recibe notificaciones sobre el estado del descubrimiento, compruebe que se ha suscrito a las notificaciones de DEVICE_DISCOVERY_STATUS eventos. Para obtener más información sobre la configuración de notificaciones, consulte Configure las notificaciones de integraciones gestionadas.

Algunos dispositivos no están actualizados

Si algunos dispositivos no se actualizan durante la redetección de la capacidad, comprueba los mensajes de error de las DEVICE_DISCOVERY_STATUS notificaciones. Entre los mensajes de error comunes se incluyen los siguientes:

  • Device unreachable- El dispositivo está desconectado o no responde

  • Timeout querying device- El dispositivo no responde en el plazo previsto

  • Invalid capability report- Es posible que el firmware del dispositivo tenga un problema

Para resolver estos problemas, asegúrese de que los dispositivos afectados estén encendidos y accesibles y, a continuación, vuelva a intentar descubrir la capacidad de los dispositivos defectuosos de forma individual utilizando el parámetro. --end-device-identifier

El descubrimiento nunca se completa

Si el proceso de redescubrimiento de capacidades no se completa, compruebe el estado del descubrimiento mediante el ID del trabajo de descubrimiento devuelto por el start-device-discovery comando:

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

Si el descubrimiento se bloquea:

  • Compruebe que el hub esté en línea y conectado a Managed Integrations

  • Espere hasta 15 minutos para que se agote automáticamente el tiempo de espera de la detección

  • Vuelva a intentar el redescubrimiento de la capacidad después de confirmar que el hub y los dispositivos están operativos