Solución de problemas de códigos de error de Azure IoT Hub

En este artículo se describen las causas y soluciones de los códigos de error comunes que puede encontrar al usar IoT Hub.

400xxx Errores de solicitud incorrecta

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 400. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de enrutamiento 4001xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4001. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de módulos 4003xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4003. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de configuraciones 4004xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4004. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de interfaz de gemelo digital 4005xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4005. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores no autorizados 401xxx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 401. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Error 401003 IotHubUnauthorized

En los registros, es posible que vea un patrón donde los dispositivos se desconectan con 401003 IoTHubUnauthorized, seguido de 404104 DeviceConnectionClosedRemotely, y después se conectan correctamente poco después.

O bien, se produce un error en las solicitudes a IoT Hub con uno de los siguientes mensajes de error:

• Falta el encabezado de autorización
• IotHub '*' no contiene el dispositivo especificado '*'
• La regla de autorización '*' no permite el acceso a '*'
• Error de autenticación para este dispositivo, renovación del token o certificado y reconexión
• La huella digital no coincide con la configuración: Huella digital: SHA1Hash=*, SHA2Hash=*; Configuración: PrimaryThumbprint=*, SecondaryThumbprint=*
• La entidad de seguridad user@example.com no está autorizada para la operación GET en /exampleOperation debido a que no tiene permisos asignados

Este error se produce porque, para MQTT, algunos SDK dependen de IoT Hub para emitir la desconexión cuando expira el token de SAS para saber cuándo actualizarlo. Por tanto:

1. El token de SAS expira
2. IoT Hub observa la expiración y desconecta el dispositivo con 401003 IoTHubUnauthorized
3. El dispositivo completa la desconexión con 404104 DeviceConnectionClosedRemotely
4. El SDK de IoT genera un nuevo token de SAS.
5. El dispositivo se vuelve a conectar correctamente con IoT Hub

O bien, IoT Hub no pudo autenticar el encabezado de autenticación, la regla o la clave. Este resultado podría deberse a cualquiera de los motivos citados en los síntomas.

Para resolver este error, no es necesario realizar ninguna acción si se usa el SDK de IoT para la conexión mediante la cadena de conexión del dispositivo. El SDK de IoT vuelve a generar el nuevo token para volver a conectarse a la expiración del token de SAS.

La duración predeterminada del token es de 60 minutos en los SDK; sin embargo, para algunos SDK, se puede configurar la duración del token y el umbral de renovación de tokens. Además, los errores generados cuando un dispositivo se desconecta y vuelve a conectarse en la renovación de tokens difiere para cada SDK. Para más información, y para más información sobre cómo determinar qué SDK usa el dispositivo en los registros, consulte la sección Comportamiento de desconexión de dispositivos MQTT con los SDK de Azure IoT de Supervisión, diagnóstico y solución de problemas de conectividad de dispositivos de Azure IoT Hub.

Para los desarrolladores de dispositivos, si el volumen de errores es un problema, cambie al SDK de C, que renueva el token de SAS antes de la expiración. Para AMQP, el token de SAS puede actualizarse sin desconexión.

En general, el mensaje de error presentado debe explicar cómo corregir el error. Si por alguna razón no tiene acceso al detalle del mensaje de error, asegúrese de:

• El SAS o cualquier otro token de seguridad que utilice no ha expirado.
• Para la autenticación de certificados X.509, el certificado de dispositivo o el certificado de entidad de certificación asociado al dispositivo no han expirado. Para obtener información sobre cómo registrar certificados de entidad de certificación X.509 con IoT Hub, consulte Tutorial: Creación y carga de certificados para pruebas.
• Para la autenticación de huella digital del certificado X.509, la huella digital del certificado de dispositivo se registra con IoT Hub.
• La credencial de autorización está bien formada para el protocolo que use. Para más información, consulte Control del acceso a IoT Hub mediante el identificador de Microsoft Entra.
• La regla de autorización empleada tiene permiso para la operación solicitada.
• Para los últimos mensajes de error que comienzan por "principal...", este error se puede resolver asignando el nivel correcto del permiso RBAC de Azure al usuario. Por ejemplo, un propietario de IoT Hub puede asignar el rol "Propietario de datos de IoT Hub", que concede todos los permisos. Pruebe este rol para resolver el problema de falta de permisos.

403xxx Errores prohibidos

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 403. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Error 403002 IotHubQuotaExceeded

Es posible que vea que las solicitudes a IoT Hub producen un error 403002 IotHubQuotaExceeded. Y en Azure Portal, la lista de dispositivos de IoT Hub no se carga.

Este error se produce normalmente cuando se supera la cuota diaria de mensajes del centro de IoT. Para resolver este error:

• Actualice o aumente el número de unidades en el centro de IoT o espere al siguiente día UTC para que se actualice la cuota diaria.
• Para comprender cómo se cuentan las operaciones hacia la cuota, como consultas gemelas y métodos directos, consulte la sección Cargos por operación de la Información de facturación de Azure IoT Hub.
• Para configurar la supervisión para el uso diario de la cuota, configure una alerta con la métrica Número total de mensajes usados. Para obtener instrucciones paso a paso, consulte la sección Configuración de métricas de Tutorial: Configuración y uso de métricas y registros con un centro de IoT.

Un trabajo de importación masiva también puede devolver este error cuando el número de dispositivos registrados en IoT Hub se aproxima o supera el límite de cuota de un centro de IoT. Para obtener más información, consulte la sección Solución de problemas en los trabajos de importación de Importar y exportar identidades de dispositivos IoT Hub de forma masiva.

Error 403004 DeviceMaximumQueueDepthExceeded

Al intentar enviar un mensaje de nube a dispositivo, es posible que vea que se produce un error 403004 en la solicitud o DeviceMaximumQueueDepthExceeded.

La causa subyacente de este error es que el número de mensajes puestos en cola para el dispositivo supera el límite de la cola.

La razón más probable de que te encuentres con este límite es porque usas HTTPS para recibir el mensaje, lo que conduce al sondeo continuo mediante ReceiveAsync, lo que da lugar a que IoT Hub limite la solicitud.

El patrón admitido para los mensajes de nube a dispositivo con HTTPS es dispositivos conectados intermitentemente que comprueban si hay mensajes con poca frecuencia (menos de cada 25 minutos). Para reducir la probabilidad de encontrarse con el límite de colas, cambie a AMQP o MQTT para mensajes de nube a dispositivo.

Como alternativa, mejore la lógica del lado del dispositivo para completar, rechazar o abandonar rápidamente los mensajes en cola, acortar el tiempo de vida o considerar la posibilidad de enviar menos mensajes. Para más información, consulte la sección Expiración de mensajes (período de vida) de Descripción de la mensajería de nube a dispositivo desde un centro de IoT.

Por último, considere la posibilidad de usar purge Queue API para limpiar periódicamente los mensajes pendientes antes de alcanzar el límite.

403006 error LímiteMáximoDeCargaDeArchivosActivosDelDispositivoExcedido

Es posible que vea que se produce un error en la solicitud de carga de archivos con el código 403006 de error o DeviceMaximumActiveFileUploadLimitExceeded un mensaje "Número de solicitudes de carga de archivos activas no puede superar los 10".

Este error se produce porque cada cliente de dispositivo está limitado para cargas simultáneas de archivos. Puede superar fácilmente el límite si el dispositivo no notifica a IoT Hub cuando se completan las cargas de archivos. Normalmente, una red del lado del dispositivo no confiable provoca este problema.

Para resolver este error, asegúrese de que el dispositivo pueda notificar rápidamente la finalización de la carga de archivos de IoT Hub. A continuación, intente reducir el TTL del token de SAS para la configuración de carga de archivos.

Errores prohibidos del modelo de dispositivo 4031xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4031. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de NotFound 404xxx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 404. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Error 404001 DeviceNotFound

Durante una comunicación de la nube al dispositivo (C2D), como el mensaje C2D, la actualización gemela o el método directo, puede que vea que la operación produce un error 404001 DeviceNotFound.

Error en la operación porque IoT Hub no encuentra el dispositivo. El dispositivo no está registrado o está deshabilitado.

Para resolver este error, registre el identificador de dispositivo que usó y vuelva a intentarlo.

Errores del modelo de dispositivo 4041xx NotFound

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4041. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

error de 404103 DeviceNotOnline

Podría ver que un método directo a un dispositivo falla con el error 404103 DeviceNotOnline incluso si el dispositivo está en línea.

Si sabe que el dispositivo está en línea y sigue recibiendo el error, es probable que se produzca el error porque la devolución de llamada del método directo no está registrada en el dispositivo.

Para obtener más información sobre la configuración correcta del dispositivo para las devoluciones de llamada de métodos directos, consulte la sección Controlar un método directo en un dispositivo de Controlar un método directo en un dispositivo.

error 404104 ConexiónDelDispositivoCerradaRemotamente

Es posible que vea que los dispositivos se desconectan a intervalos regulares (cada 65 minutos, por ejemplo) y verá 404104 DeviceConnectionClosedRemotely en los registros de recursos de IoT Hub. A veces también aparece 401003 IoTHubUnauthorized y un evento de conexión correcta de dispositivo menos de un minuto después.

O los dispositivos se desconectan aleatoriamente y se ve 404104 DeviceConnectionClosedRemotely en los registros de recursos de IoT Hub.

O bien, muchos dispositivos se desconectan a la vez, se ve una interrupción en la métrica de dispositivos conectados (connectedDeviceCount) y hay más errores 404104 DeviceConnectionClosedRemotely y errores internos 500xxx en los registros de Azure Monitor de lo habitual.

Este error puede producirse porque el token de SAS usado para conectarse a IoT Hub expiró, lo que hace que IoT Hub desconecte el dispositivo. La conexión se vuelve a establecer cuando el dispositivo actualiza el token. Por ejemplo, el token de SAS expira cada hora de forma predeterminada para el SDK de C, lo que puede provocar desconexiones normales. Para más información, consulte 401003 IoTHubUnauthorized error.

Entre otras posibilidades se incluyen:

• El dispositivo perdió la conectividad de red subyacente durante más tiempo que el tiempo de espera de MQTT, lo que da lugar a un tiempo de espera de inactividad remoto. La configuración de mantenimiento de MQTT puede ser diferente por dispositivo.
• El dispositivo envió un restablecimiento a nivel TCP/IP, pero no envió uno a nivel de aplicación MQTT DISCONNECT. Básicamente, el dispositivo cerró abruptamente la conexión de socket subyacente. A veces, los errores en versiones anteriores del SDK de Azure IoT podrían provocar este problema.
• La aplicación del dispositivo se ha bloqueado.

O bien, IoT Hub podría estar experimentando un problema transitorio. Para obtener más información, vea Errores internos 500xxx.

Para resolver este error:

• Consulte las instrucciones para el error 401003 IoTHubUnauthorized.
• Asegúrese de que el dispositivo tiene una buena conectividad con IoT Hub mediante la prueba de la conexión. Si la red no es confiable o intermitente, no se recomienda aumentar el valor keep-alive porque podría provocar la detección (a través de alertas de Azure Monitor, por ejemplo) tardando más tiempo.
• Use las versiones más recientes de los SDK de Azure IoT Hub.
• Consulte las instrucciones para ver los errores internos 500xxx.

Errores de configuración 4043xx NotFound

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4043. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de PnP 4044xx NotFound

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4044. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

405xxx errores de método no permitido

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 405. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de MethodNotAllowed del modelo de dispositivo 4051xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4051. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de conflicto 409xxx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 409. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Error 409001 DispositivoYaExiste

Al intentar registrar un dispositivo en IoT Hub, es posible que vea que se produce un error 409001 DeviceAlreadyExistsen la solicitud.

Este error se produce porque ya hay un dispositivo con el mismo identificador de dispositivo en ioT Hub.

Para resolver este error, use otro identificador de dispositivo e inténtelo de nuevo.

error 409002: ConflictoDeCreaciónDeEnlace

Es posible que vea el error 409002 LinkCreationConflict en los registros junto con la desconexión del dispositivo o un error de mensaje de nube a dispositivo.

Por lo general, este error se produce cuando IoT Hub detecta que un cliente tiene más de una conexión. De hecho, cuando llega una nueva solicitud de conexión para un dispositivo con una conexión existente, IoT Hub cierra la conexión existente con este error.

En el caso más común, un problema independiente (como 404104 error DeviceConnectionClosedRemotely) hace que el dispositivo se desconecte. El dispositivo intenta restablecer la conexión inmediatamente, pero IoT Hub sigue teniendo en cuenta el dispositivo conectado. IoT Hub cierra la conexión anterior y registra este error.

O bien, la lógica errónea del lado del dispositivo hace que el dispositivo establezca la conexión cuando una ya esté abierta.

Para resolver este error, busque otros errores en los registros que puede solucionar porque este error suele aparecer como un efecto secundario de un problema transitorio diferente. De lo contrario, asegúrese de emitir una nueva solicitud de conexión solo si la conexión se interrumpe.

Errores de conflicto en el modelo de dispositivo 4091xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4091. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de conflicto en módulos 4093xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4093. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de conflicto de configuración 4094xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4094. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de conflicto de gemelos digitales 4095xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 4095. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores 412xxx PreconditionFailed

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 412. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Error 412002 DeviceMessageLockLost

Al intentar enviar un mensaje de nube a dispositivo, es posible que vea que se produce un error en la solicitud con el error 412002 DeviceMessageLockLost.

Este error se produce porque cuando un dispositivo recibe un mensaje de nube a dispositivo de la cola (por ejemplo, mediante ReceiveAsync()), IoT Hub bloquea el mensaje durante un tiempo de espera de bloqueo de un minuto. Si el dispositivo intenta completar el mensaje después de que expire el tiempo de espera de bloqueo, IoT Hub lanza esta excepción.

Si IoT Hub no recibe la notificación dentro del plazo de un minuto de espera de bloqueo, restablece el mensaje al estado Enqueued. El dispositivo puede intentar recibir el mensaje de nuevo. Para evitar que el error se produzca en el futuro, implemente la lógica del lado del dispositivo para completar el mensaje en un minuto después de recibir el mensaje. Este tiempo de espera de un minuto no se puede cambiar.

Errores 413xxx Entidad de solicitud demasiado grande

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 413. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores 415xxx de tipo de medio no admitido

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 415. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores 429xxx de excepción limitación

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 429. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Estos errores se producen cuando se superan los límites de limitación de la operación solicitada.

Solo puede supervisar el error 429001 ThrottlingException a través de Azure Monitor en la métrica Número de errores de limitación. Actualmente, los demás errores de limitación no tienen una métrica asociada, pero se capturan en los registros.

Para resolver estos errores, compruebe si alcanza el límite de limitación comparando la métrica Intentos de envío de mensajes de telemetría con los límites especificados anteriormente. También puede comprobar la métrica Número de errores de limitación. Para obtener información sobre estas métricas, consulte Métricas de telemetría del dispositivo. Para obtener información sobre cómo usar métricas para ayudarle a supervisar el centro de IoT, consulte Supervisión de Azure IoT Hub.

IoT Hub solo devuelve 429001 ThrottlingException después de que se infringe el límite durante demasiado tiempo. Este retraso se realiza para que los mensajes no se pierdan si el hub de IoT recibe tráfico de ráfaga. Mientras tanto, IoT Hub procesa los mensajes en la velocidad limitada de la operación, que podría ser lenta si hay mucho tráfico en el trabajo pendiente. Para más información, consulte la sección Gestión del tráfico de cuotas y limitaciones de IoT Hub.

Considere la posibilidad de escalar verticalmente el IoT Hub si alcanza los límites de cuota u otras limitaciones.

Errores 499xxx de solicitud cerrada por el cliente

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 499. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores de servidor interno 500xxx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 500 o menciona un error de servidor. Algunas posibilidades son:

Puede haber muchas causas de una 500xxx respuesta de error. En todos los casos, es más probable que el problema sea transitorio. Aunque el equipo de IoT Hub trabaja duro para mantener el Acuerdo de Nivel de Servicio, algunos subconjuntos pequeños de nodos de IoT Hub pueden experimentar ocasionalmente errores transitorios. Cuando el dispositivo intenta conectarse a un nodo que tiene problemas, recibe este error.

Para mitigar los errores 5000xx, realice un reintento desde el dispositivo. Para administrar automáticamente los reintentos, asegúrese de usar la versión más reciente de los SDK de Azure IoT Hub. Para obtener más información sobre los procedimientos recomendados para el control de errores transitorios y los reintentos, consulte Control de errores transitorios.

Si el problema persiste, compruebe Resource Health y Estado de Azure para ver si IoT Hub tiene un problema conocido. También puede usar la función de conmutación por error manual.

Si no hay problemas conocidos y el problema continúa, póngase en contacto con el soporte técnico para una investigación más detallada.

Errores relacionados con la resolución 5003xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 5003. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores relacionados con MSI 5004xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 5004. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores relacionados con PnP 5005xx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 5005. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores relacionados con la puerta de enlace 502xxx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 502. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores 503xxx relacionados con el servicio no disponible

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 503. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores 5031xx de modelo de dispositivo no disponible

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 5031. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores 5032xx de configuración no disponible

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 5032. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores 5033xx relacionados con la no disponibilidad de PnP

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 5033. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Errores relacionados con el tiempo de espera del gateway 504xxx

Es posible que vea que las solicitudes a IoT Hub producen un error que comienza con 504. En la tabla siguiente se enumeran los códigos de error, sus descripciones y posibles soluciones.

Error 504101 GatewayTimeout

Al intentar invocar un método directo de IoT Hub a un dispositivo, es posible que vea que se produce un error en la solicitud con el error 504101 GatewayTimeout.

Este error se produce porque IoT Hub encontró un error y no pudo confirmar si el método directo se completó antes de que se agote el tiempo de espera. O bien, al usar una versión anterior del SDK de C# de Azure IoT (<1.19.0), el vínculo de AMQP entre el dispositivo e IoT Hub se puede quitar silenciosamente debido a un error.

Para resolver este error, emita un reintento o una actualización a la versión más reciente del SDK de C# de Azure IOT.

Contenido relacionado

• Solución de problemas del servicio Azure IoT Hub Device Provisioning
• Supervisión, diagnóstico y solución de problemas de conectividad de dispositivos
• Cuotas y límites de IoT Hub
• Supervisión de Azure IoT Hub