Azure Device Update for IoT Hub Clientbibliothek für Java – Version 1.0.12
Die Bibliothek bietet Zugriff auf das Geräteupdate für IoT Hub Dienst, mit dem Kunden Updates für ihre IoT-Geräte in der Cloud veröffentlichen und diese Updates dann auf ihren Geräten bereitstellen können (Updates für Gruppen von Geräten genehmigen, die in IoT Hub verwaltet und bereitgestellt werden).
Quellcode | Produktdokumentation
Erste Schritte
Das vollständige Microsoft Azure SDK kann von der Seite Microsoft Azure-Downloads heruntergeladen werden und wird mit Unterstützung für das Erstellen von Bereitstellungspaketen, die Integration in Tools, umfangreiche Befehlszeilentools und vieles mehr bereitgestellt.
Für eine optimale Entwicklungsumgebung sollten Entwickler die offiziellen Microsoft NuGet-Pakete für Bibliotheken verwenden. NuGet-Pakete werden regelmäßig mit neuen Funktionen und Hotfixes aktualisiert.
Voraussetzungen
- Java Development Kit (JDK), Version 8 oder höher.
- Azure-Abonnement
- Geräteupdate für IoT Hub instance
- Azure IoT Hub instance
Schließen Sie das Paket ein
<dependency>
<groupId>com.azure</groupId>
<artifactId>azure-iot-deviceupdate</artifactId>
<version>1.0.12</version>
</dependency>
Authentifizieren des Clients
Um mit dem Device Update for IoT Hub-Dienst zu interagieren, müssen Sie eine instance einer TokenCredential-Klasse erstellen und an den Konstruktor Ihrer DeviceUpdateClientBuilder
Klasse übergeben.
Weitere Authentifizierungskonfigurationen finden Sie im Dokument "Erste Schritte" des Java SDK .
Wichtige Begriffe
Device Update for IoT Hub ist ein verwalteter Dienst, mit dem Sie Over-the-Air-Updates für Ihre IoT-Geräte bereitstellen können. Die Clientbibliothek verfügt über zwei Standard Komponenten:
- DeviceUpdate: Updateverwaltung (Importieren, Auflisten, Löschen usw.)
- DeviceManagement: Geräteverwaltung (Auflisten von Geräten und Abrufen von Geräteeigenschaften), Bereitstellungsverwaltung (Starten und Überwachen von Updatebereitstellungen für eine Gruppe von Geräten)
Weitere Informationen zu Geräteupdates für IoT Hub finden Sie unter Geräteupdate für IoT Hub.
Beispiele
Mithilfe von Beispielen können Sie sich mit verschiedenen APIs vertraut machen.
Problembehandlung
Alle Geräteupdates für IoT Hub-Dienstvorgänge lösen eine ErrorResponseException bei Einem Fehler mit hilfreichen ErrorCodes aus.
Wenn Sie beispielsweise den getUpdateWithResponse
Vorgang verwenden und das gesuchte Modell nicht vorhanden ist, können Sie diesen spezifischen HttpStatusCode abfangen, um den in diesem Fall folgenden Vorgang zu bestimmen.
try {
Response<BinaryData> response = client.getUpdateWithResponse("foo", "bar", "0.0.0.1",
null);
} catch (HttpResponseException e) {
if (e.getResponse().getStatusCode() == 404) {
// update does not exist
System.out.println("update does not exist");
}
}
Nächste Schritte
Erste Schritte mit unseren Beispielen zum Geräteupdate für IoT Hub
Mitwirken
Beiträge und Vorschläge für dieses Projekt sind willkommen. Für die meisten Beiträge ist die Zustimmung zu einer Lizenzvereinbarung für Mitwirkende (Contributor License Agreement, CLA) erforderlich, in der Sie erklären, dass Sie dazu berechtigt sind, uns die Rechte für die Nutzung Ihres Beitrags zu erteilen, und dies auch tun.
Wenn Sie einen Pull Request (PR) übermitteln, überprüft ein CLA-Bot automatisch, ob Sie eine Lizenzvereinbarung bereitstellen und den PR entsprechend ergänzen müssen (z.B. mit einer Bezeichnung oder einem Kommentar). Führen Sie einfach die Anweisungen des Bots aus. Sie müssen dies nur einmal für alle Repositorys ausführen, die unsere CLA verwenden.
Für dieses Projekt gelten die Microsoft-Verhaltensregeln für Open Source (Microsoft Open Source Code of Conduct). Weitere Informationen finden Sie in den häufig gestellten Fragen zum Verhaltenskodex. Sie können sich auch an opencode@microsoft.com wenden, wenn Sie weitere Fragen oder Anmerkungen haben.