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:
+ Incorpore un dispositivo hub al hub de integraciones gestionadas.
+ Incorpore uno o más dispositivos finales al hub.
+ Instale la última versión de AWS CLI desde la Referencia de [AWS CLI comandos de Managed Integrations](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/)
+ (Opcional) Suscríbase a las notificaciones de eventos de [DEVICE\_DISCOVERY\_STATUS](managedintegrations-notifications.md#managedintegrations-notification-setup).
## 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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html). `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 acepta`ZIGBEE`, 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](https://docs.aws.amazon.com/cli/latest/reference/iot-managed-integrations/start-device-discovery.html) 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.](managedintegrations-sdk-v2-cookbook-ugs.md#managedintegrations-sdk-v2-cookbook-check-device-capabilties)
## 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](managedintegrations-notifications.md#managedintegrations-notification-setup).
### 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