Azure-Geräteupdate für IoT Hub-Clientbibliothek für .NET– Version 1.0.0

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 (Genehmigen von Updates für Gruppen von Geräten, die in IoT Hub verwaltet und bereitgestellt werden).

Quellcode | Paket | Produktdokumentation

Erste Schritte

Das vollständige Microsoft Azure SDK kann von der Microsoft Azure-Downloadseite heruntergeladen werden und bietet Unterstützung für die Erstellung von Bereitstellungspaketen, die Integration in Tools, umfangreiche Befehlszeilentools und vieles mehr.

Für eine optimale Entwicklungserfahrung sollten Entwickler die offiziellen Microsoft NuGet-Pakete für Bibliotheken verwenden. NuGet-Pakete werden regelmäßig mit neuen Funktionen und Hotfixes aktualisiert.

Voraussetzungen

• Microsoft Azure-Abonnement: Um Microsoft Azure-Dienste aufzurufen, müssen Sie ein Azure-Abonnement erstellen.
• Geräteupdate für IoT Hub instance
• Azure IoT Hub instance

Installieren des Pakets

Installieren Sie das Geräteupdate für IoT Hub Clientbibliothek für .NET mit NuGet:

dotnet add package Azure.IoT.DeviceUpdate

Authentifizieren des Clients

Um mit dem Device Update für IoT Hub-Dienst zu interagieren, müssen Sie eine instance einer TokenCredential-Klasse erstellen und an den Konstruktor Ihrer DeviceUpdateClient- und DeviceManagementClient-Klasse übergeben.

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 drei Standard Komponenten:

• DeviceManagementClient: Geräte-, Gruppen- und Bereitstellungsverwaltung (Enumerate, create, retrieve, delete device, group, deployment usw.)
• DeviceUpdateClient: Updateverwaltung (Importieren, Aufzählen, Löschen usw.)

Weitere Informationen zu Device Update für IoT Hub finden Sie unter Device Update 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 bei Einem Fehler eine RequestFailedException mit hilfreichen ErrorCodes aus.

Wenn Sie z. B. den GetUpdateAsync 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 update = await _updatesClient.GetUpdateAsync(
      "provider", "name", "1.0.0.0");
}
catch (RequestFailedException ex) when (ex.Status == (int)HttpStatusCode.NotFound)
{
    // Update does not exist.
}

Nächste Schritte

Erste Schritte mit unserem Geräteupdate für IoT Hub Beispiele

Mitwirken

Beiträge und Vorschläge für dieses Projekt sind willkommen. Most contributions require you to agree to a Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us the rights to use your contribution. Weitere Informationen finden Sie unter Lizenzvertrag für Mitwirkende.

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.