Устранение неполадок с кодами ошибок Центра Интернета вещей Azure

В этой статье описываются причины и решения распространенных кодов ошибок, которые могут возникнуть при использовании Центра Интернета вещей.

Ошибки 400xxx Неверный запрос

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 400. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
400000 GenericBadRequest Универсальная ошибка неверного запроса. Проверьте формат запроса и параметры.
400001 НедопустимаяВерсияПротокола Версия протокола, указанная в запросе, не поддерживается. Обновите запрос, чтобы использовать поддерживаемую версию протокола.
400002 НедопустимоеКоличествоРезультатовУстройства Число результатов, возвращаемых устройством, недопустимо. Убедитесь, что устройство возвращает правильное количество результатов.
400003 НевернаяОперация Запрошенная операция недопустима. Убедитесь, что операция поддерживается для устройства.
400004 ArgumentInvalid Один или несколько аргументов в запросе недопустимы. Проверьте аргументы запроса на правильность.
400005 ArgumentNull Один или несколько обязательных аргументов имеют значение NULL. Убедитесь, что указаны все обязательные аргументы.
400006 IotHubFormatError Недопустимый формат запроса. Проверьте формат запроса на правильность.
400007 DeviceStorageEntitySerializationError Сущность хранилища устройств не может быть сериализована или десериализирована. Проверьте формат сериализации и данные.
400008 BlobContainerValidationError Указанный BLOB-контейнер не является допустимым. Проверьте имя и права контейнера BLOB.
400009 ImportWarningExistsError Существует предупреждение о импорте. Просмотрите предупреждения об импорте и устраните их.
400010 НевернаяВерсияСхемы Указанная версия схемы не является допустимой. Обновите версию схемы до поддерживаемой версии.
400011 DeviceDefinedMultipleTimes Устройство определяется несколько раз. Убедитесь, что устройство определено только один раз.
400012 DeserializationError Произошла ошибка десериализации запроса. Проверьте формат запроса и данные для правильности.
Ошибка массовой операции с реестром 400013 Сбой операции пакетного реестра. Проверьте сведения о массовой операции и повторите попытку.
400014 Точка подключения по умолчанию не настроена (DefaultStorageEndpointNotConfigured) Конечная точка хранилища по умолчанию не настроена. Настройте конечную точку хранилища по умолчанию.
400015 InvalidFileUploadCorrelationId Идентификатор корреляции загрузки файла недействителен. Проверьте идентификатор корреляции отправки файла для правильности.
400016 ПросроченныйИдентификаторЗагрузкиФайла Срок действия идентификатора корреляции отправки файла истек. Получите новый идентификатор корреляции отправки файла.
400017 НедопустимаяТочкаХранения Указанная конечная точка хранилища не является допустимой. Проверьте конечную точку хранилища для правильности.
400018 НедопустимаяКонечнаяТочкаСообщений Указанная конечная точка обмена сообщениями не является допустимой. Проверьте конечную точку обмена сообщениями на наличие правильности.
400019 НедопустимыйСтатусЗавершенияЗагрузкиФайла Статус завершения загрузки файла не является допустимым. Проверьте состояние завершения отправки файла для правильности.
400020 Ошибка: InvalidStorageEndpointOrBlob При попытке создать блоб во время загрузки файла, хранилище блобов отвечает либо Forbidden, Unauthorized, NotFound, либо BadRequest. Проверьте разрешения и существование BLOB-хранилища.
400021 ЗапросОтменен Запрос был отменен. Повторите запрос.
400022 InvalidStorageEndpointProperty Указанное свойство конечной точки хранилища недопустимо. Проверьте свойства конечной точки хранилища для правильности.
400023 EtagDoesNotMatch ETag, указанный в запросе, не соответствует текущему ETag ресурса. Обновите ETag в запросе, чтобы он соответствовал текущему ETag.
400024 Время запроса истекло Запрос превысил время ожидания. Повторите запрос.
400025 ОперацияНеПоддерживаетсяНаРеплике Операция не поддерживается в указанной реплике. Просмотрите детали операции и реплики.
400026 ПустоеСообщение Сообщение имеет нулевое значение. Убедитесь, что сообщение не является пустым.
400027 СоединениеПринудительноЗакрытоПриНовомСоединении Устройство отключается и передает отчет о Communication_Error как ConnectionStatusChangeReason с использованием типа транспорта .NET SDK и MQTT. Операция двойника устройства в облако (например, чтение или исправление сообщаемых свойств) или вызов прямого метода завершается сбоем с кодом 400027ошибки. Эта ошибка возникает, когда другой клиент создает новое подключение к Центру Интернета вещей с помощью того же удостоверения, поэтому Центр Интернета вещей закрывает предыдущее подключение. Центр Интернета вещей не допускает подключения нескольких клиентов с использованием одного и того же удостоверения. Убедитесь, что каждый клиент подключается к Центру Интернета вещей с помощью собственного удостоверения.
400028 InvalidDeviceScope Указанная область устройства не является допустимой. Проверьте область применения устройства на корректность.
400029 Соединение насильственно закрыто при инжекции неисправностей Существующие подключения будут закрыты из-за этой ошибки во время обновления службы и платформы. Предполагается, что повторные попытки будут успешны немедленно. Повторите операцию.
400030 ПодключениеОтклоненоПриИнъекцииСбоев Новые подключения и немедленные попытки повторных попыток будут отклонены с этой ошибкой во время обновления службы и платформы. Повторите операцию.
400031 Недопустимый тип аутентификации конечной точки Указанный тип проверки подлинности конечной точки не является допустимым. Проверьте тип проверки подлинности конечной точки на корректность.
400032 ManagedIdentityNotEnabled Управляемое удостоверение не включено. Включите управляемое удостоверение.
400035 InvalidPolicyKey Указанный ключ политики недействителен. Проверьте ключ политики для правильности.
400036 Ошибка операции массовой регенерации ключа устройства Сбой операции массового повторного повторного восстановления ключа устройства. Просмотрите сведения об операции.

Ошибки маршрутизации 4001xxx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4001. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
400100 Некорректный ввод маршрута (InvalidRouteTestInput) Указанные входные данные теста маршрута некорректны. Проверьте входные данные теста маршрута для правильности.
400101 НедействительныйИсточникНаМаршруте Источник, указанный в маршруте, недействителен. Проверьте источник на маршруте для корректности.
400102 RoutingNotEnabled Маршрутизация не включена. Включите маршрутизацию.
400103 Ошибка в кодировке или типе содержимого Кодировка содержимого или указанный тип не является допустимым. Проверьте кодировку содержимого или его тип на корректность.

Ошибки модулей 4003xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4003. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
400301 CannotRegisterModuleToModule Обмен данными между модулями не поддерживается. Вместо этого используйте обмен данными между устройствами и облаком.
400302 TenantHubRoutingNotEnabled Маршрутизация хаба арендатора не активирована. Включите маршрутизацию концентратора клиентов.

Ошибки конфигураций 4004xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4004. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
400401 Неверное состояние целевой конфигурации Целевое условие, указанное в конфигурации, недопустимо. Проверьте правильность целевого условия.
400402 InvalidConfigurationContent Содержимое, указанное в конфигурации, недопустимо. Проверьте содержимое конфигурации для правильности.
400403 Невозможно изменить неизменяемое содержание конфигурации Содержимое конфигурации неизменяемо и не может быть изменено. Создайте новую конфигурацию.
400404 ОшибкаКонфигурацииПользовательскихМетрик Указанный в конфигурации запрос настраиваемых метрик не является действительным. Проверьте запрос пользовательских метрик на корректность.

Ошибки интерфейсов цифрового двойника 4005xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4005. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
400501 InvalidPnPInterfaceDefinition Указанное определение интерфейса недопустимо. Проверьте определение интерфейса для правильности.
400502 НедействительныеЖелаемыеСвойстваPnP Указанные требуемые свойства недопустимы. Проверьте требуемые свойства для правильности.
400503 InvalidPnPReportedProperties (Некорректные переданные свойства PnP) Указанные свойства недопустимы. Проверьте сообщаемые свойства для правильности.
400504 Недействительные PnPWritableОбъявленныеСвойства Указанные заявленные свойства для записи недействительны. Проверьте доступные для записи сообщённые свойства на правильность.
400505 InvalidDigitalTwinJsonPatch - Недействительный JSON-патч для цифрового двойника Патч JSON, указанный для цифрового двойника, недействителен. Проверьте JSON патч на корректность.
400506 InvalidDigitalTwinPayload Полезная нагрузка, указанная для цифрового двойника, недействительна. Проверьте полезную нагрузку цифрового двойника на правильность.
400507 InvalidDigitalTwinPatch Указанный патч для цифрового двойника недопустим. Проверьте патч цифрового двойника на правильность.
400508 InvalidDigitalTwinPatchPath Путь исправления, указанный для цифрового двойника, не является допустимым. Проверьте путь патча цифрового двойника на корректность.

401x Несанкционированные ошибки

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 401. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
401000 ОбщийНеавторизованный Запрос не авторизован. Проверьте учетные данные авторизации.
401001 IotHubNotFound Указанный Центр Интернета вещей не найден. Проверьте имя и регион Центра Интернета вещей.
401002 IotHubUnauthorizedAccess Запрос не авторизован для доступа к Центру Интернета вещей. Проверьте политики доступа и разрешения Центра Интернета вещей.
401003 IotHubUnauthorized Запрос не авторизован для доступа к Центру Интернета вещей. Дополнительные сведения см. в ошибке 401003 IotHubUnauthorized.
401004 ElasticPoolNotFound Указанный эластичный пул не найден. Проверьте имя эластичного пула и регион.
401100 Несанкционированное изменение системного модуля доступа Системный модуль не авторизован для изменения ресурса. Проверьте разрешения системного модуля.

Ошибка 401003: IotHubUnauthorized (неавторизованный доступ к IoT-хабу)

В журналах может появиться шаблон отключения устройств, 401003 IoTHubUnauthorizedза которым следует 404104 DeviceConnectionClosedRemotely, а затем успешное подключение вскоре после этого.

Кроме того, запросы к Центру Интернета вещей завершаются сбоем с одним из следующих сообщений об ошибках:

  • Отсутствует заголовок авторизации
  • IotHub '*' не содержит указанное устройство "*"
  • Правило авторизации "*" не разрешает доступ для "*"
  • Ошибка аутентификации для этого устройства, обновите токен или сертификат и подключитесь снова.
  • Отпечаток не соответствует конфигурации: Отпечаток: SHA1Hash=*, SHA2Hash=*; Конфигурация: PrimaryThumbprint=*, SecondaryThumbprint=*
  • Субъект user@example.com не авторизован для GET on /exampleOperation из-за отсутствия назначенных разрешений

Эта ошибка возникает потому, что для протокола MQTT некоторые средства разработки зависят от Центра Интернета вещей, который отправляет сигнал об отключении, когда истекает срок действия маркера SAS, чтобы было понятно, когда его нужно обновить. Так:

  1. Срок действия маркера SAS истекает
  2. Центр Интернета вещей уведомляет об истечении срока действия и отключает устройство с помощью 401003 IoTHubUnauthorized
  3. Устройство завершает отключение с помощью 404104 DeviceConnectionClosedRemotely
  4. Пакет SDK для Интернета вещей создает новый маркер SAS
  5. Устройство повторно подключается к Центру Интернета вещей

Или Центр Интернета вещей не мог пройти проверку подлинности заголовка аутентификации, правила или ключа. Этот результат может быть вызван любой из причин, приведенных в симптомах.

Чтобы устранить эту ошибку, при использовании пакета SDK Интернета вещей для подключения с помощью строки подключения устройства не требуется никаких действий. Пакет SDK Интернета вещей повторно создает новый маркер для повторного подключения к истечении срока действия маркера SAS.

Срок действия маркера по умолчанию составляет 60 минут по пакетам SDK; Однако для некоторых пакетов SDK срок действия маркера и порог обновления маркера можно настроить. Кроме того, ошибки, возникающие при отключении и повторном подключении устройства в процессе обновления токенов, отличаются для каждого пакета SDK. Чтобы узнать больше и получить информацию о том, как определить, какой пакет SDK используется на вашем устройстве в журналах, см. раздел Поведение отключения устройств MQTT с Azure IoT SDK в разделе Мониторинг, диагностика и устранение неполадок подключений устройств Azure IoT Hub.

Для разработчиков устройств, если объем ошибок является проблемой, переключитесь на пакет SDK C, который продлевает маркер SAS до истечения срока действия. Для AMQP маркер SAS может обновляться без отключения.

Как правило, представленное сообщение об ошибке должно объяснить, как исправить ошибку. Если по какой-то причине у вас нет доступа к подробным сведениям об сообщении об ошибке, убедитесь, что:

  • Срок действия используемого маркера безопасности SAS или другого маркера безопасности не истек.
  • Для аутентификации с использованием сертификата X.509 сертификат устройства или сертификат ЦС, ассоциированный с устройством, не должен быть истекшим. Сведения о регистрации сертификатов ЦС X.509 в Центре Интернета вещей см. в руководстве по созданию и отправке сертификатов для тестирования.
  • Для проверки подлинности отпечатка сертификата X.509 отпечаток сертификата устройства регистрируется в Центре Интернета вещей.
  • Учетные данные авторизации хорошо сформированы для используемого протокола. Дополнительные сведения см. в разделе "Управление доступом к Центру Интернета вещей" с помощью идентификатора Microsoft Entra.
  • Правило авторизации, используемое, имеет разрешение для запрошенной операции.
  • Для последних сообщений об ошибках, начиная с "principal...", эта ошибка может быть устранена, назначив правильный уровень разрешения Azure RBAC пользователю. Например, владелец Центра Интернета вещей может назначить роль "Владелец данных Центра Интернета вещей", которая предоставляет все разрешения. Попробуйте использовать эту роль для устранения проблемы с отсутствием разрешений.

Примечание.

Некоторые устройства могут столкнуться с проблемой смещения времени, если время устройства отличается от времени сервера, превышающего пять минут. Эта ошибка может возникать, когда устройство подключается к Центру Интернета вещей без проблем в течение нескольких недель или даже месяцев, но затем начинает постоянно отклонить подключение. Ошибка также может быть связана с подмножеством устройств, подключенных к хабу Интернета вещей, так как смещение времени может произойти с разной скоростью в зависимости от того, когда устройство впервые подключено или включено.

Часто синхронизация времени с помощью NTP или перезагрузки устройства (которая может автоматически выполнять синхронизацию времени во время загрузки) исправляет проблему и позволяет устройству снова подключиться. Чтобы избежать этой ошибки, настройте устройство для периодической синхронизации времени с помощью NTP. Вы можете запланировать синхронизацию на ежедневно, еженедельно или ежемесячно, в зависимости от величины отклонения устройства. Если на устройстве не удается настроить периодическую синхронизацию NTP, запланируйте периодическую перезагрузку.

403xx Запрещенные ошибки

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 403. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
403000 GenericForbidden Запрос запрещен. Проверьте разрешения запроса.
403001 IotHubSuspended Центр Интернета вещей приостановлен. Проверьте состояние Центра Интернета вещей.
403002 IotHubQuotaExceeded Превышена квота Центра Интернета вещей. Дополнительные сведения см. в ошибке IotHubQuotaExceeded 403002.
Ошибка 403003: превышение квоты задач (JobQuotaExceeded) Превышена квота задания. Проверьте квоты и ограничения задания.
403004 Превышен максимальный размер очереди устройства (DeviceMaximumQueueDepthExceeded) Превышена максимальная глубина очереди устройства. Дополнительные сведения см. в статье об ошибке 403004 DeviceMaximumQueueDepthExceeded.
403005 IotHubMaxCbsTokenExceeded Превышен максимальный предел токена CBS узла IoT. Проверьте ограничения токена CBS в IoT Hub (Центре Интернета вещей).
403006 Превышен предел максимального количества активных загрузок файлов на устройстве (DeviceMaximumActiveFileUploadLimitExceeded) Превышено максимальное ограничение на отправку файлов на устройство. Дополнительные сведения см. в статье 403006 об ошибке DeviceMaximumActiveFileUploadLimitExceed .
403007 Превышен максимальный размер очереди устройства Превышен максимальный размер очереди устройства. Проверьте размер очереди устройства.
403008 RoutingEndpointResponseForbidden Ответ конечной точки маршрутизации запрещен. Проверьте разрешения конечной точки маршрутизации.
403009 InvalidMessageExpiryTime Неверное время истечения сообщения. Проверьте параметры времени истечения срока действия сообщения.
403010 ОперацияНедоступнаВТекущемУровне Операция недоступна на текущем уровне. Проверьте уровень и возможности Центра Интернета вещей.
403011 КлючШифрованияКлючОтозван Ключ шифрования ключей был отозван. Проверьте состояние ключа для шифрования ключей.
403012 УстройствоОтключено Устройство отключено. Проверьте состояние устройства.
403800 DeviceMaximumInflightMethodExceeded Превышено максимальное ограничение метода в полете. Проверьте ограничения метода во время полета устройства.

Ошибка 403002 IotHubQuotaExceeded

Возможно, запросы к Центру Интернета вещей завершаются ошибкой 403002 IotHubQuotaExceeded. На портале Azure список устройств Центра Интернета вещей не загружается.

Эта ошибка обычно возникает, когда превышена квота ежедневного сообщения для Центра Интернета вещей. Чтобы устранить эту ошибку, выполните приведенные ниже действия.

Задание массового импорта также может возвращать эту ошибку, если число устройств, зарегистрированных в центре Интернета вещей, приближается или превышает ограничение квоты для Центра Интернета вещей. Дополнительные сведения см. в разделе «Устранение неполадок с заданиями импорта» в документе «Импорт и экспорт удостоверений устройств в Центре Интернета Вещей в больших объемах».

403004 ошибка DeviceMaximumQueueDepthExceeded

При попытке отправить сообщение об облаке на устройство может появиться сообщение об ошибке 403004 или DeviceMaximumQueueDepthExceededсбое запроса.

Основная причина этой ошибки заключается в том, что число сообщений, заведенных для устройства, превышает ограничение очереди.

Наиболее вероятной причиной возникновения этого ограничения является то, что вы используете HTTPS для получения сообщения, что приводит к постоянному опросу с помощью ReceiveAsync и, следовательно, к ограничению запроса в IoT-хабе.

Поддерживаемый шаблон для сообщений от облака к устройствам с использованием HTTPS предназначен для устройств, которые периодически подключаются и редко проверяют сообщения (реже чем каждые 25 минут). Чтобы снизить вероятность достижения лимита очереди, переключитесь на AMQP или MQTT для сообщений из облака на устройство.

Кроме того, улучшайте логику на стороне устройства, чтобы завершить, отклонить или отказаться от очередных сообщений быстро, сократить время жизни или рассмотреть возможность отправки меньшего количества сообщений. Дополнительные сведения см. в разделе «Срок действия сообщения (время жизни)» документа «Общие сведения об обмене сообщениями от облака к устройствам из IoT-хаба».

Наконец, рассмотрите возможность использования API очистки очереди для периодической очистки ожидающих сообщений до достижения ограничения.

403006 deviceMaximumActiveFileUploadLimitExceeded превышен предел максимального количества активных загрузок файлов ошибка

Возможно, запрос на отправку файла завершается сбоем с кодом 403006 ошибки или DeviceMaximumActiveFileUploadLimitExceeded сообщением "Число активных запросов на отправку файлов не может превышать 10".

Эта ошибка возникает, так как у каждого клиента устройства есть ограничение на одновременную загрузку файлов. Вы можете легко превысить ограничение, если устройство не уведомляет Центр Интернета вещей о завершении отправки файлов. Ненадежная сеть на стороне устройства обычно вызывает эту проблему.

Чтобы устранить эту ошибку, убедитесь, что устройство может быстро уведомить о завершении отправки файлов Центра Интернета вещей. Затем попробуйте уменьшить срок жизни маркера SAS для конфигурации отправки файлов.

Запрещенные ошибки модели устройства 4031xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4031. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
403100 ПревышеноМаксимальноеКоличествоСвойствМоделиУстройства Превышено максимальное ограничение свойств модели устройства. Проверьте свойства модели устройства.
403101 МаксимальноеКоличествоИндексируемыхСвойствВМоделиУстройстваПревышено Превышено максимальное ограничение индексируемых свойств модели устройства. Проверьте индексируемые свойства модели устройства.

Ошибки 404xxxx NotFound

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 404. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
404000 GenericNotFound Запрошенный ресурс не найден. Проверьте идентификатор ресурса и повторите попытку.
404001 DeviceNotFound Указанное устройство не найдено. См. ошибку DeviceNotFound 404001 для получения дополнительной информации.
404002 JobNotFound Указанное задание не найдено. Проверьте идентификатор задания и повторите попытку.
404004 QuotaMetricNotFound Указанная метрика квоты не найдена. Проверьте идентификатор метрики квоты и повторите попытку.
404005 SystemPropertyNotFound Указанное системное свойство не найдено. Проверьте идентификатор системного свойства и повторите попытку.
404006 AmqpAddressNotFound (Адрес AMQP не найден) Указанный адрес AMQP не найден. Проверьте адрес AMQP и повторите попытку.
404007 Ответ на запрос конечной точки маршрутизации не найден (RoutingEndpointResponseNotFound) Не найден указанный ответ конечной точки маршрутизации. Проверьте конечную точку маршрутизации и повторите попытку.
404008 CertificateNotFound Указанный сертификат не найден. Проверьте идентификатор сертификата и повторите попытку.
404009 ElasticPoolTenantHubNotFound Указанный центр клиента эластичного пула не найден. Проверьте идентификатор узла арендатора эластичного пула и повторите попытку.
404010 ModuleNotFound Указанный модуль не найден. Проверьте идентификатор модуля и повторите попытку.
404011 AzureTableStoreNotFound Указанное хранилище таблиц Azure не найдено. Проверьте идентификатор хранилища таблиц Azure и повторите попытку.
404012 IotHubFailingOver Центр Интернета вещей переводится на резервный узел. Проверьте состояние Центра Интернета вещей и повторите попытку.
404013 ФункцияНеПоддерживается Запрошенная функция не поддерживается. Проверьте документацию по функциям и повторите попытку.
404014 DigitalTwinInterfaceNotFound Указанный интерфейс Digital Twin не найден. Проверьте идентификатор интерфейса Digital Twin и повторите попытку.

Ошибка DeviceNotFound 404001

Во время взаимодействия между облаком и устройством (C2D), например, C2D-сообщение, обновление двойника или вызов прямого метода, можно увидеть, что операция завершается ошибкой 404001 DeviceNotFound.

Сбой операции, так как Центр Интернета вещей не может найти устройство. Устройство не зарегистрировано или отключено.

Чтобы устранить эту ошибку, зарегистрируйте используемый идентификатор устройства, а затем повторите попытку.

Ошибки модели устройства 4041xx NotFound

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4041. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
404101 QueryStoreCluster не найден Указанный кластер хранилища запросов не найден. Проверьте идентификатор кластера хранилища запросов и повторите попытку.
404102 DeviceNotOnline Указанное устройство не подключено к сети. См. ошибку 404103 DeviceNotOnline для получения дополнительной информации.
404104 Подключение устройства закрыто удаленно Подключение к устройству было закрыто удаленно. Дополнительные сведения см. в статье 404104 об ошибке DeviceConnectionClosedRemotely .

ошибка DeviceNotOnline 404103

Возможно, вы увидите, что прямой метод к устройству завершается ошибкой 404103 DeviceNotOnline , даже если устройство подключено к сети.

Если вы знаете, что устройство находится в сети и по-прежнему получает ошибку, скорее всего, произошла ошибка, так как обратный вызов прямого метода не зарегистрирован на устройстве.

Для получения более подробной информации о правильной настройке вашего устройства для обратных вызовов прямых методов см. раздел "Обработка прямого метода на устройстве" в подразделе "Обработка прямого метода на устройстве".

ошибка 404104 закрытие соединения устройства удаленно

Вы можете заметить, что устройства отключаются через регулярные интервалы (например, каждые 65 минут) и отображаются 404104 DeviceConnectionClosedRemotely в журналах ресурсов Центра управления Интернетом вещей. Иногда вы также видите 401003 IoTHubUnauthorized и успешное событие подключения к устройству менее чем за минуту.

Кроме того, устройства отключаются случайным образом, и в журналах ресурсов IoT Hub виден 404104 DeviceConnectionClosedRemotely.

Или множество устройств отключается одновременно, вы видите падение в метрике подключенных устройств (connectedDeviceCount), и в журналах Azure Monitor больше обычного 404104 DeviceConnectionClosedRemotely и 500xxx внутренних ошибок.

Эта ошибка может возникать из-за истечения срока действия маркера SAS, используемого для подключения к Центру Интернета вещей , что приводит к отключению устройства в Центре Интернета вещей. Соединение восстанавливается, когда устройство обновляет маркер. Например, срок действия маркера SAS истекает каждый час по умолчанию для пакета SDK для C, что может привести к регулярному отключению. Чтобы узнать подробнее, см. описание ошибки IoTHubUnauthorized 401003.

К некоторым другим возможностям относятся:

  • Устройство потеряло базовое сетевое подключение дольше, чем MQTT в режиме поддержания активности, что привело к истечении времени ожидания удаленного простоя. Параметр MQTT keep-alive может отличаться на устройство.
  • Устройство отправило сброс на уровне TCP/IP, но не отправило сброс на уровне приложения MQTT DISCONNECT. По сути, устройство резко закрыло основное соединение с сокетом. Иногда ошибки в более ранних версиях пакета SDK Для Интернета вещей Azure могут вызвать эту проблему.
  • Сбой приложения на стороне устройства.

Кроме того, Центр Интернета вещей может столкнуться с временной проблемой. Дополнительные сведения см. в разделе 500xxx Internal errors.

Чтобы устранить эту ошибку, выполните приведенные ниже действия.

Примечание.

Для надежного управления подключениями рекомендуется использовать пакеты SDK для устройств Azure IoT. Дополнительные сведения см. в статье "Управление подключением устройств" для создания устойчивых приложений

Ошибки конфигурации 4043xxx NotFound

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4043. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
404301 ConfigurationNotFound (Конфигурация не найдена) Указанная конфигурация не найдена. Проверьте идентификатор конфигурации и повторите попытку.
404302 GroupNotFound Указанная группа не найдена. Проверьте идентификатор группы и повторите попытку.

Ошибки 4044xx PnP NotFound

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4044. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
404401 DigitalTwinModelNotFound Указанная модель цифрового двойника не найдена. Проверьте идентификатор модели цифрового двойника и повторите попытку.
404402 InterfaceNameModelNotFound Указанная модель имен интерфейса не найдена. Проверьте идентификатор модели имени интерфейса и повторите попытку.

Ошибки 405xxx MethodNotAllowed

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 405. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
405000 GenericMethodNotAllowed (метод не разрешен или недопустим) Указанный метод не разрешен. Проверьте метод и повторите попытку.

Ошибки модели устройства 4051xx "Метод не разрешен"

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4051. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
405102 ОперацияНеРазрешенаВТекущемСостоянии Операция не разрешена в текущем состоянии. Проверьте состояние устройства и повторите попытку.
405103 ImportDevicesNotSupported Импорт устройств не поддерживается. Проверьте параметры импорта и повторите попытку.
405104 BulkAddDevicesNotSupported Массовое добавление устройств не поддерживается. Проверьте параметры массового добавления и повторите попытку.

Ошибки конфликта 409xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 409. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
409000 Общий конфликт Произошел конфликт. Проверьте запрос и повторите попытку.
409001 УстройствоУжеСуществует Указанное устройство уже существует. Дополнительные сведения см. в статье 409001 об ошибке DeviceAlreadyExists .
409002 LinkCreationConflict Конфликт произошел при создании ссылки. Дополнительные сведения см. в ошибке 409002 LinkCreationConflict.
409003 CallbackSubscriptionConflict (конфликт подписки на обратный вызов) Произошел конфликт с подпиской на обратный вызов. Проверьте параметры подписки обратного вызова и повторите попытку.

ошибка «Устройство уже существует» 409001

При попытке зарегистрировать устройство в Центре Интернета вещей может появиться сообщение об ошибке 409001 DeviceAlreadyExistsзапроса.

Эта ошибка возникает, так как в Центре Интернета вещей уже есть устройство с тем же идентификатором устройства.

Чтобы устранить эту ошибку, используйте другой идентификатор устройства и повторите попытку.

ошибка LinkCreationConflict 409002

Может появиться ошибка 409002 LinkCreationConflict в журналах вместе с отключением устройства или сбоем сообщения из облака на устройство.

Как правило, эта ошибка возникает, когда Центр Интернета вещей обнаруживает, что клиент имеет несколько подключений. Фактически, когда новый запрос на подключение поступает для устройства с существующим подключением, Центр Интернета вещей закрывает существующее соединение с этой ошибкой.

В наиболее распространенном случае отключение устройства вызывает отдельная проблема (например, ошибка 404104 DeviceConnectionClosedRemotely). Устройство пытается немедленно восстановить подключение, но Центр Интернета вещей по-прежнему считает устройство подключенным. Центр Интернета вещей закрывает предыдущее подключение и регистрирует эту ошибку.

Или неисправная логика на стороне устройства приводит к тому, что устройство устанавливает подключение, когда оно уже открыто.

Чтобы устранить эту ошибку, найдите другие ошибки в журналах, которые можно устранить, так как эта ошибка обычно отображается как побочный эффект другой временной проблемы. В противном случае не забудьте отправить новый запрос на подключение, только если соединение прерывается.

Ошибки конфликтов конфигурации устройства модели 4091xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4091. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
409101 МодельУжеСуществует Указанная модель уже существует. Проверьте идентификатор модели и повторите попытку.
409102 DeviceLocked Указанное устройство заблокировано. Проверьте состояние устройства и повторите попытку.
409103 DeviceJobAlreadyExists Указанное задание устройства уже существует. Проверьте идентификатор задания устройства и повторите попытку.
409104 JobAlreadyExists Указанное задание уже существует. Проверьте идентификатор задания и повторите попытку.

Ошибки конфликтов модулей 4093xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4093. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
409301 МодульУжеСуществуетНаУстройстве Указанный модуль уже существует на устройстве. Проверьте идентификатор модуля и повторите попытку.

Ошибки конфликтов конфигурации 4094xxx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4094. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
409401 КонфигурацияУжеСуществует Указанная конфигурация уже существует. Проверьте идентификатор конфигурации и повторите попытку.
409402 Конфигурация уже применяется на устройстве Указанное приложение конфигурации уже выполняется на устройстве. Проверьте состояние устройства и повторите попытку.

Ошибки конфликтов цифровых двойников 4095xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 4095. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
409501 Модель цифрового двойника уже существует Указанная модель цифрового двойника уже существует. Проверьте идентификатор модели цифрового двойника и повторите попытку.
409502 МодельЦифровогоДвойникаСуществуетСДругимТипомМодели Указанная модель цифрового двойника существует с другим типом модели. Проверьте тип модели цифрового двойника и повторите попытку.
409503 Интерфейс с именем "InterfaceNameModel" уже существует Указанная модель имен интерфейса уже существует. Проверьте идентификатор модели имени интерфейса и повторите попытку.

Ошибки предварительных условий 412xxxx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 412. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
412000 GenericPreconditionFailed Не выполнено общее предварительное условие. Проверьте запрос и повторите попытку.
412001 Невыполнено предварительное условие Не удалось выполнить предварительные условия. Проверьте запрос и повторите попытку.
412002 DeviceMessageLockLost Блокировка сообщения устройства была потеряна. Дополнительные сведения см. в разделе ошибка 412002 DeviceMessageLockLost.
412003 JobRunPreconditionFailed Не удалось выполнить предварительное условие запуска задания. Проверьте состояние задания и повторите попытку.
412004 InflightMessagesInLink В ссылке есть сообщения о полете. Проверьте состояние ссылки и повторите попытку.

Ошибка 412002 DeviceMessageLockLost

При попытке отправить сообщение об облаке на устройство может появиться сообщение об ошибке 412002 DeviceMessageLockLostзапроса.

Эта ошибка происходит, потому что, когда устройство получает облачное сообщение от устройства из очереди (например, с помощью ReceiveAsync()), Центр Интернета вещей блокирует это сообщение на время блокировки, которое составляет одну минуту. Если устройство пытается завершить сообщение после истечения времени блокировки, Центр Интернета вещей выбрасывает это исключение.

Если Центр Интернета вещей не получает уведомление в течение одной минуты времени ожидания блокировки, оно возвращает сообщение в состояние enqueued . Устройство может попытаться снова получить сообщение. Чтобы предотвратить возникновение ошибки в будущем, реализуйте логику на стороне устройства, чтобы завершить сообщение в течение одной минуты после получения сообщения. Это одноминутное время ожидания не может быть изменено.

Ошибки 413xxx: Сущность запроса слишком велика

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 413. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
413000 GenericRequestEntityTooLarge Сущность запроса слишком велика. Уменьшите размер сущности запроса и повторите попытку.
413001 MessageTooLarge Сообщение слишком большое. Уменьшите размер сообщения и повторите попытку.
413002 TooManyDevices Регистрируются слишком много устройств. Уменьшите количество устройств и повторите попытку.
413003 Слишком много модулей на устройстве На устройстве регистрируется слишком много модулей. Уменьшите количество модулей и повторите попытку.
413101 ConfigurationCountLimitExceeded Превышено ограничение количества конфигураций. Уменьшите количество конфигураций и повторите попытку.
413201 Лимит количества моделей Digital Twin превышен Превышено ограничение количества моделей цифровых двойников. Уменьшите количество моделей цифровых двойников и повторите попытку.
413202 InterfaceNameCompressionModelCountLimitExceeded Превышено ограничение количества моделей сжатия имен интерфейса. Уменьшите количество моделей сжатия имен интерфейса и повторите попытку.

Ошибки неподдерживаемого типа носителя 415xxx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 415. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
415000 GenericUnsupportedMediaType Тип носителя не поддерживается. Проверьте тип носителя и повторите попытку.
415101 НесовместимыйТипДанных Тип данных несовместим. Проверьте тип данных и повторите попытку.

Ошибки сбоев регулирования частоты 429xxx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 429. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
429000 GenericСлишкомМногоЗапросов Было сделано слишком много запросов. Уменьшите количество запросов и повторите попытку.
429001 РегулированиеException Произошло исключение регулирования. Дополнительные сведения см. в документации по ограничениям регулирования .
429002 Предел очереди ожидания превышен Количество запросов, которые находятся в очереди из-за ограничения скорости, превысило лимит ожидающих обработки. Уменьшите количество запросов и повторите попытку. Перед отправкой ответа с ограничением скорости изучите документацию по формированию трафика, чтобы лучше понять, как это работает.
429003 РегулированиеBacklogTimeout Запросы, которые были отложены из-за ограничения, истекло время ожидания в очереди ожидания. Уменьшите количество запросов и повторите попытку.
429004 ДросселированиеMaxActiveJobCountExceeded Превышено максимальное число активных заданий. Уменьшите количество активных заданий и повторите попытку.
429005 Превышено ограничение устройства по ограничениям Превышено ограничение регулирования устройства. Уменьшите количество запросов с устройства и повторите попытку.

Эти ошибки возникают при превышении ограничений регулирования для запрошенной операции.

Вы можете отслеживать 429001 ThrottlingException ошибки только с помощью Azure Monitor в разделе " Число ошибок регулирования" метрик. В настоящее время другие ошибки регулирования не имеют связанной метрики, но фиксируются в журналах.

Чтобы устранить эти ошибки, проверьте, не достигнули ли вы ограничения регулирования, сравнивая метрику попыток отправки сообщений телеметрии с ранее указанными пределами. Можно также проверить количество ошибок регулирования . Сведения об этих метриках см. в разделе "Метрики телеметрии устройства". Сведения об использовании метрик для мониторинга Центра Интернета вещей см. в статье "Мониторинг Центра Интернета вещей Azure".

Центр Интернета вещей отправляет 429001 ThrottlingException только после превышения лимита в течение слишком длительного времени. Эта задержка выполняется для того, чтобы ваши сообщения не терялись, если на ваш центр Интернета вещей происходит скачок трафика. В то же время IoT Hub обрабатывает сообщения с ограниченной скоростью операций, которая может замедлиться при большом объеме трафика в очереди. Для получения дополнительной информации см. раздел «Управление трафиком» в квотах и ограничениях по скорости узлов сети IoT.

Мы рекомендуем выполнить масштабирование Центра Интернета вещей, если вы превысили квоту или ограничения регулирования.

Ошибки закрытого запроса клиента 499xxx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 499. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
499000 ClientClosedRequest Клиент закрыл запрос. Повторите попытку позже.

Ошибки внутреннего сервера 500xxx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, которая начинается с 500 или упоминает ошибку сервера. Ниже приведены некоторые возможности.

Код ошибки Description
500001 ServerError Произошла ошибка на стороне сервера.
500008 GenericTimeout Центр Интернета вещей не мог завершить запрос подключения до истечения времени ожидания.
ServiceUnavailable (без кода ошибки) Центр Интернета вещей столкнулся с внутренней ошибкой.
InternalServerError (без кода ошибки) Центр Интернета вещей столкнулся с внутренней ошибкой.

Существует множество причин для ответа на ошибку 500xxx . Во всех случаях проблема, скорее всего, является временной. Хотя команда IoT Hub упорно работает над поддержанием SLA, небольшие подмножества узлов IoT Hub могут иногда испытывать временные сбои. Когда устройство пытается подключиться к узлу с проблемами, вы получите эту ошибку.

Чтобы устранить 5000xx ошибки, выполните повторную попытку с устройства. Чтобы автоматически управлять повторными попытками, убедитесь, что вы используете последнюю версию пакетов SDK Центра Интернета вещей Azure. Дополнительные сведения о рекомендациях по обработке временных сбоев и повторных попыток см. в разделе "Обработка временных сбоев".

Если проблема сохраняется, проверьте работоспособность ресурсов и состояние Azure , чтобы узнать, есть ли у Центра Интернета вещей известная проблема. Вы также можете использовать функцию аварийного переключения вручную.

Если нет известных проблем и проблема продолжается, обратитесь в службу поддержки для дальнейшего расследования.

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 5003. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
500301 ModelRepoEndpointError Конечная точка репозитория моделей неверна. Проверьте конечную точку репозитория моделей и повторите попытку.
500302 ResolutionError Произошла ошибка разрешения. Повторите попытку позже.

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 5004. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
500401 UnableToFetchCredentials (Не удалось получить учетные данные) Не удается получить учетные данные. Проверьте учетные данные и повторите попытку.
500402 Не удалось получить информацию о съемщике Не удается получить сведения о клиенте. Проверьте сведения о клиенте и повторите попытку.
500403 UnableToShareIdentity Невозможно поделиться личностью. Проверьте параметры общего доступа к удостоверениям и повторите попытку.

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 5005. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
500501 UnableToExpandDiscoveryInfo Не удалось расширить информацию об обнаружении. Проверьте сведения об обнаружении и повторите попытку.
500502 Не удается расширить сведения о компоненте Не удалось отобразить сведения о компоненте. Проверьте сведения о компоненте и повторите попытку.
500503 Невозможно сжать информацию о компоненте (UnableToCompressComponentInfo) Не удается сжать сведения о компонентах. Проверьте сведения о компоненте и повторите попытку.
500504 Невозможно сжать информацию о поиске Не удается сжать сведения об обнаружении. Проверьте сведения об обнаружении и повторите попытку.
500505 OrphanDiscoveryDocument Найденный документ обнаружения сирот. Проверьте документ обнаружения и повторите попытку.

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 502. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
502000 GenericBadGateway Произошла универсальная ошибка плохого шлюза. Повторите попытку позже.

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 503. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
503000 GenericServiceUnavailable Произошла ошибка "Служба недоступна". Повторите попытку позже.
503001 ServiceUnavailable Служба недоступна. Повторите попытку позже.
503004 Ошибка активации IoT Hub Сбой активации Центра Интернета вещей. Проверьте состояние Центра Интернета вещей и повторите попытку.
503005 ServerBusy Сервер занят. Повторите попытку позже.
503006 IotHubRestoring Центр Интернета вещей восстанавливается. Повторите попытку позже.
503008 ReceiveLinkOpensThrottled Открытия принимающих ссылок ограничены. Повторите попытку позже.

Ошибки недоступных моделей устройства 5031xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 5031. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
503101 ConnectionUnavailable Подключение недоступно. Проверьте подключение и повторите попытку.
503102 УстройствоНедоступно Устройство недоступно. Проверьте состояние устройства и повторите попытку.

Ошибки недоступности конфигурации 5032xx

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 5032. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
503201 ConfigurationNotAvailable Конфигурация недоступна. Проверьте конфигурацию и повторите попытку.
503202 GroupNotAvailable Группа недоступна. Проверьте группу и повторите попытку.

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 5033. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
503301 HostingServiceNotAvailable Служба размещения недоступна. Повторите попытку позже.

Возможно, запросы к Центру Интернета вещей завершаются ошибкой, начинающейся с 504. В следующей таблице перечислены коды ошибок, их описания и возможные решения.

Код ошибки Description Solution
504000 GenericGatewayTimeout Произошла ошибка времени ожидания универсального шлюза. Повторите попытку позже.
504101 GatewayTimeout Время ожидания шлюза истекло. Дополнительные сведения см. в статье об ошибке GatewayTimeout 504101 .

Ошибка 504101: тайм-аут шлюза

При попытке вызвать прямой метод из Центра Интернета вещей на устройство может появиться сообщение об ошибке 504101 GatewayTimeoutзапроса.

Эта ошибка возникает, так как Центр Интернета вещей столкнулся с ошибкой и не смог подтвердить, завершился ли прямой метод до истечения времени ожидания. Кроме того, при использовании более ранней версии пакета SDK для Интернета вещей Azure (<1.19.0) связь AMQP между устройством и Центром Интернета вещей может быть удалена автоматически из-за ошибки.

Чтобы устранить эту ошибку, выполните повторную попытку или обновление до последней версии пакета SDK для Azure IOT C#.

Связанный контент

  • Last updated on