Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
In diesem Artikel werden Fehlercodes für Device Update für Azure IoT Hub aufgeführt. Fehlercodes können vom Geräteupdate-Agent, dem Übermittlungsoptimierungs-Agent oder dem Inhaltsdienst für Geräteaktualisierungen stammen.
Device Update-Agent
ResultCode und ExtendedResultCode
Die PNP-Schnittstelle von Device Update for IoT Hub Core meldet ResultCode und ExtendedResultCode, die zur Diagnose von Fehlern verwendet werden können. Weitere Informationen zur PNP-Schnittstelle von Device Update for IoT Hub Core finden Sie unter Device Update for IoT Hub und IoT Plug & Play. Weitere Informationen zu den Standardbedeutungen der Device Update-Agents „ResultCode“ und „ExtendedResultCodes“ finden Sie unter Device Update GitHub-Repository.
ResultCode ist ein allgemeiner Statuscode und ExtendedResultCode eine ganze Zahl mit codierten Fehlerinformationen.
ExtendedResultCode wird als ganze Zahl mit Vorzeichen in der PNP-Schnittstelle angezeigt. Konvertieren Sie die ganze Zahl mit Vorzeichen in ein Hexadezimalformat ohne Vorzeichen, um ExtendedResultCode zu decodieren. Nur die ersten 4 Bytes von ExtendedResultCode werden verwendet und weisen das Format FFFFFFFF auf, wobei der erste Teil den Einrichtungscode und die restlichen Bits den Fehlercode darstellen.
Einrichtungscodes
| Einrichtungscode | BESCHREIBUNG |
|---|---|
| D | Vom DO SDK ausgelöster Fehler |
| E | Fehlercode: errno |
Beispiel:
ExtendedResultCode ist gleich -536870781.
Die Hexadezimaldarstellung ohne Vorzeichen von -536870781 ist FFFFFFFF E0000083.
| Ignorieren | Einrichtungscode | Fehlercode |
|---|---|---|
| FFFFFFFF | E | 0000083 |
0x83 in Hexadezimaldarstellung ist 131 in Dezimaldarstellung: errno-Wert für ENOLCK.
Übermittlungsoptimierungs-Agent
In der folgenden Tabelle sind die Fehlercodes aufgeführt, die sich auf die Komponente zur Übermittlungsoptimierung (DO) des Device Update-Clients beziehen. Die DO-Komponente ist für das Herunterladen von Updateinhalten auf das IoT-Gerät verantwortlich.
Der DO-Fehlercode kann durch Untersuchen der Ausnahmen abgerufen werden, die als Reaktion auf einen API-Befehl ausgelöst werden. Alle Fehlercodes können durch das Präfix 0x80D0 identifiziert werden.
| Fehlercode | Zeichenfolgenfehler | type | BESCHREIBUNG |
|---|---|---|---|
| 0x80D01001L | DO_E_NO_SERVICE | – | Die Übermittlungsoptimierung konnte den Dienst nicht bereitstellen. |
| 0x80D02002L | DO_E_DOWNLOAD_NO_PROGRESS | Auftrag herunterladen | Beim Herunterladen einer Datei ist innerhalb des definierten Zeitraums kein Fortschritt aufgetreten. |
| 0x80D02011L | DO_E_UNKNOWN_PROPERTY_ID | Auftrag herunterladen | SetProperty() oder GetProperty() wurde mit einer unbekannten Eigenschaften-ID aufgerufen. |
| 0x80D02012L | DO_E_READ_ONLY_PROPERTY | Auftrag herunterladen | SetProperty() kann nicht für eine schreibgeschützte Eigenschaft aufgerufen werden. |
| 0x80D02013L | DO_E_INVALID_STATE | Auftrag herunterladen | Die angeforderte Aktion ist im aktuellen Auftragszustand nicht zulässig. Der Auftrag wurde möglicherweise abgebrochen, oder die Übertragung wurde abgeschlossen. Er befindet sich jetzt in einem schreibgeschützten Zustand. |
| 0x80D02018L | DO_E_FILE_DOWNLOADSINK_UNSPECIFIED | Auftrag herunterladen | Ein Download kann nicht gestartet werden, da keine Downloadsenke (lokale Datei oder Streamschnittstelle) angegeben wurde. |
| 0x80D02200L | DO_E_DOWNLOAD_NO_URI | IDODownload-Schnittstelle | Der Download wurde ohne Angabe eines URI gestartet. |
| 0x80D03805L | DO_E_BLOCKED_BY_NO_NETWORK | Vorübergehende Schwierigkeiten | Der Download wurde aufgrund des Verlusts der Netzwerkkonnektivität angehalten. |
0 00 00000 Total 4 bytes (32 bits)
- -- -----
| | |
| | |
| | +--------- Error code (20 bits)
| |
| +------------- Component/Area code (8 bits)
|
+--------------- Facility code (4 bits)
Weitere Informationen zum Analysieren von Codes finden Sie unter Ergebniscodes und erweiterte Ergebniscodes des Device Update-Agents und Implementieren eines benutzerdefinierten Inhaltshandlers.
Device Update-Inhaltsdienst
In der folgenden Tabelle werden Fehlercodes aufgeführt, die sich auf die Inhaltsdienstkomponente des Device Update-Diensts beziehen. Die Inhaltsdienstkomponente ist für das Importieren von Update-Inhalten zuständig. Weitere Informationen zur Problembehandlung sind auch für den Import von Proxyupdates verfügbar.
| Fehlercode | Zeichenfolgenfehler | Nächste Schritte |
|---|---|---|
| UpdateAlreadyExists | Ein Update mit der gleichen Identität ist bereits vorhanden. | Stellen Sie sicher, dass Sie ein Update importieren, das noch nicht in diese Instanz des Geräteupdates für IoT Hub importiert wurde. |
| DuplicateContentImport | Identischer Inhalt wurde gleichzeitig mehrmals importiert. | Stellen Sie sicher, dass Sie ein Update importieren, das noch nicht in diese Instanz des Geräteupdates für IoT Hub importiert wurde. |
| CannotProcessImportManifest | Fehler beim Verarbeiten des Importmanifests. | Informationen zur ordnungsgemäßen Formatierung des Importmanifests finden Sie unter Importkonzepte und in der Dokumentation zum Importieren des Updates. |
| CannotDownload | Das Importmanifest kann nicht heruntergeladen werden. | Stellen Sie sicher, dass die URL für die Importmanifestdatei noch gültig ist. |
| CannotParse | Das Importmanifest kann nicht analysiert werden. | Überprüfen Sie das Importmanifest anhand des Schemas auf Genauigkeit, das in der Dokumentation zum Importieren des Updates definiert ist. |
| UnsupportedVersion | Die Schemaversion des Importmanifests wird nicht unterstützt. | Stellen Sie sicher, dass das Importmanifest das neueste Schema verwendet, das in der Dokumentation zum Importieren des Updates definiert ist. |
| Fehler beim Importieren des Updates aufgrund eines überschrittenen Grenzwerts. | Der zusätzliche Updateanbieter kann nicht importiert werden. | Sie haben einen Grenzwert für die Anzahl der verschiedenen Anbieter erreicht, die in Ihrer Instanz des Geräteupdates für IoT Hub zulässig sind. Löschen Sie einige Updates aus der Instanz, und versuchen Sie es noch mal. |
| Fehler beim Importieren des Updates aufgrund eines überschrittenen Grenzwerts. | Der zusätzliche Updatename für den angegebenen Anbieter kann nicht importiert werden. | Sie haben einen Grenzwert für die Anzahl der unterschiedlichen Namen erreicht, die unter einem Anbieter in Ihrer Instanz von Device Update for IoT Hub zulässig sind. Löschen Sie einige Updates aus der Instanz, und versuchen Sie es noch mal. |
| Fehler beim Importieren des Updates aufgrund eines überschrittenen Grenzwerts. | Zusätzliche Updateversion für den angegebenen Anbieter und Namen kann nicht importiert werden. | Sie haben einen Grenzwert für die Anzahl der unterschiedlichen Versionen erreicht, die unter einem Anbieter und Namen in Ihrer Instanz von Device Update for IoT Hub zulässig sind. Löschen Sie einige Updates mit diesem Namen aus Ihrer Instanz, und versuchen Sie es noch mal. |
| Fehler beim Importieren des Updates aufgrund eines überschrittenen Grenzwerts. | Der zusätzliche Updateanbieter kann nicht mit der angegebenen Kompatibilität importiert werden. or Ein zusätzlicher Updatename kann nicht mit der angegebenen Kompatibilität importiert werden. or Kann zusätzliche Update-Version mit der angegebenen Kompatibilität nicht importieren. |
Beachten Sie beim Definieren von Kompatibilitätseigenschaften in einem Importmanifest, dass Device Update for IoT Hub eine einzige Kombination aus Anbieter und Name für einen bestimmten Satz an Kompatibilitätseigenschaften unterstützt. Wenn Sie versuchen, die gleichen Kompatibilitätseigenschaften mit mehr als einer Kombination aus Anbieter und Name zu verwenden, werden diese Fehler angezeigt. Um dieses Problem zu beheben, stellen Sie sicher, dass alle Updates für ein bestimmtes Gerät (wie durch Kompatibilitätseigenschaften definiert) denselben Anbieter und Namen verwenden. |
| CannotProcessUpdateFile | Fehler beim Verarbeiten der Quelldatei. | |
| ContentFileCannotDownload | Quelldatei kann nicht heruntergeladen werden. | Stellen Sie sicher, dass die URL für die Updatedatei(en) noch gültig ist. |
| SourceFileMalwareDetected | In einer zu importierenden Datei wurde eine bekannte Schadsoftwaresignatur erkannt. | Device Update for IoT Hub überprüft importierte Inhalte auf Schadsoftware mithilfe verschiedener Mechanismen. Wenn eine bekannte Schadsoftwaresignatur erkannt wird, führt der Import zu Fehlern, und eine eindeutige Fehlermeldung wird zurückgegeben. Die Fehlermeldung enthält die Beschreibung der Schadsoftwaresignatur und einen Dateihash für jede Datei, in der die Signatur erkannt wurde. Sie können den Dateihash verwenden, um die markierte Datei zu finden, und die Beschreibung der Schadsoftwaresignatur, um diese Datei auf Schadsoftware zu überprüfen. Sobald Sie die Schadsoftware aus allen importierten Dateien entfernen, können Sie den Importvorgang erneut starten. |
| SourceFilePendingMalwareAnalysis | In einer importierten Datei wurde eine Signatur erkannt, die möglicherweise auf vorhandene Schadsoftware hindeutet. | Device Update for IoT Hub überprüft importierte Inhalte auf Schadsoftware mithilfe verschiedener Mechanismen. Der Import schlägt fehl, wenn eine Überprüfungssignatur Merkmale von Schadsoftware aufweist, selbst wenn es keine genaue Übereinstimmung mit bekannter Schadsoftware gibt. In diesem Fall wird eine eindeutige Fehlermeldung zurückgegeben. Die Fehlermeldung enthält die Beschreibung der mutmaßlichen Schadsoftwaresignatur und einen Dateihash für jede Datei, in der die Signatur erkannt wurde. Sie können den Dateihash verwenden, um die markierte Datei zu finden, und die Beschreibung der Schadsoftwaresignatur, um diese Datei auf Schadsoftware zu überprüfen. Sobald Sie die Schadsoftware aus allen importierten Dateien entfernen, können Sie den Importvorgang erneut starten. Wenn Sie sicher sind, dass Ihre Dateien frei von Schadsoftware sind, und dieser Fehler weiterhin angezeigt wird, kontaktieren Sie den Microsoft-Support. |