Clientbibliothek des Azure IoT Models-Repositorys für .NET – Version 1.0.0-preview.5

Artikel
04/24/2023

Diese Bibliothek bietet Funktionen für die Interaktion mit dem Azure IoT Models-Repository. Darüber hinaus soll eine konsistente Arbeit mit Repositorys für Digitale Zwillingsmodelle gemäß den Azure IoT-Konventionen bereitgestellt werden.

Quellcode | Paket (Nuget)

Erste Schritte

Das vollständige Microsoft Azure SDK kann von der Microsoft Azure-Downloadseite 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 Fehlerbehebungen aktualisiert.

Installieren des Pakets

Installieren Sie die Clientbibliothek des Azure IoT Models-Repositorys für .NET mit NuGet:

Install-Package Azure.IoT.ModelsRepository

Sehen Sie sich die Paketdetails unter nuget.org an.

Voraussetzungen

Ein Modellrepository nach Azure IoT-Konventionen
- Das Modellrepository kann sich im lokalen Dateisystem befinden oder auf einem Webserver gehostet werden.
- Azure IoT hostet das globale Azure IoT Models-Repository , auf das der Client standardmäßig verweist, wenn kein URI bereitgestellt wird.

Authentifizieren des Clients

Derzeit werden keine Authentifizierungsmechanismen im Client unterstützt. Der globale Endpunkt ist nicht an ein Azure-Abonnement gebunden und unterstützt keine Authentifizierung. Alle veröffentlichten Modelle sind für den anonymen öffentlichen Verbrauch bestimmt.

Wichtige Begriffe

Das Azure IoT Models-Repository ermöglicht Es Buildern, Modelle für digitale Zwillinge zu verwalten und gemeinsam zu nutzen. Bei den Modellen handelt es sich um JSON-LD-Dokumente , die mit der Digital Twins Definition Language (DTDL) definiert werden.

Das Repository definiert ein Muster zum Speichern von DTDL-Schnittstellen in einer Verzeichnisstruktur basierend auf dem Digital Twin Model Identifier (DTMI). Sie können eine Schnittstelle im Repository suchen, indem Sie den DTMI in einen relativen Pfad konvertieren. Der DTMI "dtmi:com:example:Thermostat;1" übersetzt z. B. in /dtmi/com/example/thermostat-1.json.

Threadsicherheit

Wir garantieren, dass alle Client-instance Methoden threadsicher und unabhängig voneinander sind. Siehe Threadsicherheitsrichtlinie. Dadurch wird sichergestellt, dass die Empfehlung, Clientinstanzen wiederzuverwenden, immer sicher ist, auch threadsübergreifend.

Zusätzliche Konzepte

Beispiele

Sie können sich mit dem Client vertraut machen, indem Sie Beispiele für das IoT-Modellrepository verwenden.

Problembehandlung

Alle Dienstvorgänge lösen RequestFailedException bei Einem Fehler mit hilfreichen Fehlercodes und anderen Informationen aus. Der Client erzeugt auch Diagnoseereignisse und Protokollierung, die mit einem EventListener überwacht werden können.

Nächste Schritte

Sehen Sie sich Implementierungsbeispiele mit unseren Codebeispielen an.

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. Einzelheiten dazu finden Sie unter https://cla.microsoft.com.

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.