Hochladen von Dateien von Ihren Geräten in die Cloud

2025-06-06

Mit IoT Central können Sie Medien und andere Dateien von verbundenen Geräten in den Cloudspeicher hochladen. Sie konfigurieren die Dateiuploadfunktion in Ihrer IoT Central Anwendung und implementieren dann Dateiuploads in Ihrem Gerätecode.

Sie können dateien auch verwalten und in der Vorschau anzeigen, die von Ihren Geräten in Ihrer IoT Central-Anwendung hochgeladen wurden.

Informationen zum Konfigurieren von Dateiuploads mithilfe der IoT Central-REST-API finden Sie unter Hinzufügen einer Speicherkontokonfiguration für den Dateiupload.

Voraussetzungen

Sie müssen ein Administrator in Ihrer IoT Central-Anwendung sein, um Dateiuploads zu konfigurieren.

Sie benötigen ein Azure Storage-Konto und einen Container zum Speichern der hochgeladenen Dateien. Wenn Sie nicht über ein Speicherkonto und einen Container verfügen, erstellen Sie ein Speicherkonto im Azure-Portal.

Konfigurieren von Gerätedateiuploads

So konfigurieren Sie Uploads von Gerätedateien

Wechseln Sie zum Abschnitt "Anwendung" in Ihrer Anwendung.
Wählen Sie Gerätedateispeicher aus.
Wählen Sie das Speicherkonto und den Container aus, die Sie verwenden möchten. Wenn sich das Speicherkonto in einem anderen Azure-Abonnement befindet als Ihre Anwendung, geben Sie eine Speicherkontoverbindungszeichenfolge ein.
Passen Sie bei Bedarf das Uploadtimeout an, das festlegt, für wie lange eine Anforderung gültig ist. Sie können es von 1 bis 24 Stunden festlegen.
Um Benutzern das Anzeigen und Verwalten hochgeladener Dateien in IoT Central zu ermöglichen, schalten Sie Enable access auf On.
Wählen Sie Speichern. Wenn der Status "Konfiguriert" angezeigt wird, können Geräte Dateien hochladen.

Deaktivieren von Gerätedateiuploads

So deaktivieren Sie Gerätedateiuploads in Ihrer IoT Central-Anwendung:

Navigieren Sie in Ihrer Anwendung zum Abschnitt Anwendung.
Wählen Sie Gerätedateispeicher aus.
Klicken Sie auf Löschen.

Steuern des Zugriffs auf hochgeladene Dateien

Mithilfe von Rollen und Berechtigungen können Sie steuern, wer hochgeladene Dateien anzeigen und löschen kann. Weitere Informationen finden Sie unter „Verwalten von Benutzern und Rollen in Ihrer IoT Central-Anwendung“ > „Verwalten von Geräten“.

Hochladen einer Datei von einem Gerät

IoT Central verwendet ioT Hubs Dateiupload-Feature, um Geräten das Hochladen von Dateien zu ermöglichen. Beispielcode zum Hochladen von Dateien von einem Gerät finden Sie im IoT Central-Dateiuploadgerätbeispiel.

Anzeigen und Verwalten von hochgeladenen Dateien

Wenn Sie den Zugriff auf Dateien in der Dateiuploadkonfiguration aktivieren, können Benutzer mit den richtigen Berechtigungen hochgeladene Dateien anzeigen und löschen.

Wichtig

Alle Dateien im Blob-Containerordner, der einem Gerät zugeordnet ist, werden in der Ansicht "Dateien" für dieses Gerät angezeigt, einschließlich aller Dateien, die das Gerät nicht hochgeladen hat.

Um hochgeladene Dateien anzuzeigen und zu löschen, wechseln Sie zur Ansicht "Dateien " für ein Gerät. Auf dieser Seite können Sie Miniaturansichten der hochgeladenen Dateien anzeigen und zwischen einem Katalog und einer Listenansicht wechseln. Bei jeder Datei gibt es Optionen zum Herunterladen oder Löschen:

Tipp

Der mime-Typ, der der Datei beim Hochladen in blob Storage zugewiesen wurde, bestimmt den Dateityp. Der Standardtyp ist binary/octet-stream.

Passen Sie die Listenansicht an, indem Sie nach Dateinamen filtern und die anzuzeigenden Spalten auswählen.

Um eine Vorschau des Dateiinhalts anzuzeigen und weitere Informationen darüber zu erhalten, wählen Sie sie aus. IoT Central unterstützt Vorschauen allgemeiner Dateitypen wie Text und Bilder:

Testen des Dateiuploads

Nachdem Sie Dateiuploads in Ihrer IoT Central-Anwendung konfiguriert haben, testen Sie sie mit dem Beispielcode. Verwenden Sie die folgenden Befehle, um das Beispiel-Repository an einen geeigneten Speicherort auf Ihrem lokalen Computer zu klonen und die Abhängigkeiten zu installieren:

git clone https://github.com/azure-Samples/iot-central-file-upload-device
cd iotc-file-upload-device
npm i
npm build

Erstellen der Gerätevorlage und Importieren des Modells

Führen Sie zum Testen des Dateiuploads die Beispielgeräteanwendung aus. Erstellen Sie zunächst eine Gerätevorlage für das Beispielgerät:

Öffnen Sie Ihre Anwendung in der zentralen IoT-Benutzeroberfläche.
Wechseln Sie im linken Bereich zu "Gerätevorlagen ", und wählen Sie dann +Neu aus.
Wählen Sie das IoT-Gerät für den Vorlagentyp aus.
Geben Sie auf der Seite "Anpassen " einen Namen wie " Dateiuploadgerätebeispiel " für die Gerätevorlage ein.
Wählen Sie auf der Seite Überprüfen die Option Erstellen aus.
Wählen Sie "Modell importieren " aus, und laden Sie die FileUploadDeviceDcm.json Modelldatei aus dem iotc-file-upload-device\setup Ordner im zuvor heruntergeladenen Repository hoch.
Wählen Sie "Veröffentlichen " aus, um die Erstellung der Gerätevorlage abzuschließen.

Hinzufügen eines Geräts

So fügen Sie ein Gerät Ihrer Azure IoT Central-Anwendung hinzu:

Wechseln Sie im linken Bereich zu "Geräte ".
Wählen Sie die Gerätevorlage Gerätebeispiel für Dateiupload aus, die Sie zuvor erstellt haben.
Wählen Sie + Neu und dann "Erstellen" aus.
Wählen Sie das von Ihnen erstellte Gerät und dann "Verbinden" aus.

Kopieren Sie die Werte für ID scope, Device ID und Primary key. Sie verwenden diese Werte im Gerätebeispielcode.

Ausführen des Beispiels

Öffnen Sie das Git-Repository, das Sie in VS Code heruntergeladen haben. Erstellen Sie eine ENV-Datei im Stammverzeichnis Ihres Projekts, und fügen Sie die zuvor kopierten Werte hinzu. Die Datei sollte wie in diesem Beispiel mit Ihren Werten aussehen:

scopeId=<YOUR_SCOPE_ID>
deviceId=<YOUR_DEVICE_ID>
deviceKey=<YOUR_PRIMARY_KEY>
modelId=dtmi:IoTCentral:IotCentralFileUploadDevice;1

Öffnen Sie das Git-Repository, das Sie in VS Code heruntergeladen haben. Drücken Sie F5, um das Beispiel auszuführen oder zu debuggen. In Ihrem Terminalfenster sehen Sie das Geräteregister und stellen eine Verbindung mit IoT Central her:

Starting IoT Central device...
 > Machine: Windows_NT, 8 core, freemem=6674mb, totalmem=16157mb
Starting device registration...
DPS registration succeeded
Connecting the device...
IoT Central successfully connected device: 7z1xo26yd8
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}
Sending telemetry: {
    "TELEMETRY_SYSTEM_HEARTBEAT": 1
}

Das Beispielprojekt enthält eine Beispieldatei mit dem Namen datafile.json. Diese Datei wird hochgeladen, wenn Sie den Befehl "Datei hochladen " in Ihrer IoT Central-Anwendung verwenden.

Öffnen Sie Ihre Anwendung, und wählen Sie das erstellte Gerät aus, um den Upload zu testen. Wählen Sie die Registerkarte "Befehl " und dann die Schaltfläche "Ausführen " aus. Wenn Sie "Ausführen" auswählen, ruft die IoT Central-Anwendung eine direkte Methode auf Ihrem Gerät auf, um die Datei hochzuladen. Sie können diese direkte Methode im Beispielcode in der Datei „/device.ts“ sehen. Der Name dieser Methode lautet uploadFileCommand. Öffnen Sie Ihre Anwendung, und wählen Sie das erstellte Gerät aus, um den Upload zu testen. Wählen Sie die Registerkarte "Befehl " und dann die Schaltfläche " Ausführen " aus. Wenn Sie "Ausführen" auswählen, ruft IoT Central eine direkte Methode auf Ihrem Gerät auf, um die Datei hochzuladen. Sie können diese Methode im Beispielcode in der Datei "/device.ts " sehen. Der Name dieser Methode lautet uploadFileCommand.

Wählen Sie die Registerkarte " Rohdaten " aus, um den Dateiuploadstatus zu überprüfen.

Screenshot: Das U I zeigt, wie Sie einen Dateiupload überprüfen.

Sie können auch einen REST-API-Aufruf durchführen, um den Dateiuploadstatus im Speichercontainer zu überprüfen.

Freigeben über