Azure IoT Geräte- und Dienst-SDKs

In dieser Referenz werden die Azure SDKs aufgeführt, die Sie zum Erstellen von IoT-Lösungen verwenden können, einschließlich Geräte-, Dienst- und Verwaltungs-SDKs für IoT Hub und Device Provisioning Service (DPS), Vorschau-SDKs für die Zertifikatverwaltung und Links zu Azure Digital Twins Steuerebenen- und Datenebenen-APIs.

Geräte-SDKs

Die Microsoft Azure IoT Geräte-SDKs enthalten Code, der das Erstellen von Anwendungen erleichtert, die eine Verbindung herstellen und von Azure IoT Hub Diensten verwaltet werden. Diese SDKs können auf einem allgemeinen MPU-basierten Computergerät wie einem PC, Tablet, Smartphone oder Raspberry Pi ausgeführt werden. Die SDKs unterstützen die Entwicklung in C und in modernen verwalteten Sprachen, einschließlich C#, Node.js, Python und Java.

Die SDKs sind in mehreren Sprachen verfügbar, sodass Sie sich flexibel für das SDK entscheiden können, das für Ihr Team und Ihr Szenario am besten geeignet ist.

Das Java Geräte-SDK enthält samples für Android.

Das C-Geräte-SDK enthält samples für iOS, die CocoaPods verwenden.

Verwenden Sie die Geräte-SDKs, um Code für die Ausführung auf IoT-Geräten zu entwickeln, die eine Verbindung mit IoT Hub oder IoT Central herstellen.

SDKs für eingebettete Geräte

Diese SDKs wurden für die Ausführung auf Geräten mit begrenzten Compute- und Arbeitsspeicherressourcen entwickelt und erstellt und werden mit der Programmiersprache C implementiert.

Die SDKs für eingebettete Geräte sind bei mehreren Betriebssystemen verfügbar, sodass Sie sich flexibel für das SDK entscheiden können, das für Ihr Szenario am besten geeignet ist.

Verwenden Sie die eingebetteten Geräte-SDKs, um Code für die Ausführung auf IoT-Geräten zu entwickeln, die eine Verbindung mit IoT Hub oder IoT Central herstellen.

Weitere Informationen zur Verwendung der eingebetteten Geräte-SDKs finden Sie in den Nutzungsszenarien für das C SDK und Embedded C SDK.

Lebenszyklus und Support für Geräte-SDKs

In diesem Abschnitt wird die Azure IoT Device SDK-Lebenszyklus- und Supportrichtlinie zusammengefasst. Weitere Informationen finden Sie unter Azure SDK Lifecycle- und Supportrichtlinie.

Paketlebenszyklus

Pakete werden in den folgenden Kategorien veröffentlicht. Jede Kategorie verfügt über eine definierte Unterstützungsstruktur.

1. Beta – Auch bekannt als Vorschau oder Release Candidate. Ist für den frühzeitigen Zugriff und Feedback verfügbar, und wird nicht für die Verwendung in der Produktion empfohlen. Die Unterstützung der Vorschauversion ist auf GitHub Probleme beschränkt. Vorschauversionen sind in der Regel weniger als sechs Monate live, danach sind sie entweder veraltet oder werden als aktiv veröffentlicht.

2. Aktiv – Allgemein verfügbar und vollständig unterstützt, erhält neue Featureupdates sowie Fehlerkorrekturen und Sicherheits-Patches. Verwenden Sie die neueste Version , da diese Version Korrekturen und Updates empfängt.

3. Veraltet – Ersetzt durch eine neuere Version. Die Unterstützung wird eingestellt, wenn die neue Version aktiv wird. Veraltete Versionen behandeln die kritischsten Fehlerkorrekturen und Sicherheits-Patches für weitere 12 Monate.

Unterstützung erhalten

Wenn bei der Verwendung der Azure IoT SDKs Probleme auftreten, suchen Sie unterstützung über die folgenden Optionen:

• Bericht von Fehlern – Alle Kunden können Fehler auf der Problemseite für das GitHub Repository melden, das dem entsprechenden SDK zugeordnet ist.

• Microsoft Customer Support Team – Benutzer, die über einen Support-Plan verfügen können das Microsoft Kundensupportteam einbeziehen, indem Sie direkt über das Azure Portal ein Supportticket erstellen.

IoT Hub-Dienst-SDKs

Die Azure IoT Dienst-SDKs enthalten Code, um das Erstellen von Anwendungen zu erleichtern, die direkt mit IoT Hub interagieren, um Geräte und Sicherheit zu verwalten.

Weitere Informationen zur Verwendung der Dienst-SDKs für die Interaktion mit Geräten über einen IoT-Hub finden Sie im Leitfaden für IoT Plug & Play Serviceentwickler.

IoT Hub-Verwaltungs-SDKs

Die IoT Hub-Verwaltungs-SDKs helfen Ihnen beim Erstellen von Back-End-Anwendungen, die die IoT-Hubs in Ihrem Azure-Abonnement verwalten.

Zu den Verwaltungs-SDKs gehören die Azure CLI, PowerShell und REST-API.

DPS-Geräte-SDKs

Die DPS-Geräte-SDKs stellen Implementierungen der Register-API und anderer bereit, die Geräte zur Bereitstellung über DPS aufrufen. Die Geräte-SDKs können auf allgemeinen MPU-basierten Computergeräten wie PCs, Tablets, Smartphones oder Raspberry Pi ausgeführt werden. Die SDKs unterstützen die Entwicklung in C und in modernen verwalteten Sprachen, einschließlich C#, Node.js, Python und Java.

In der folgenden Tabelle sind die Geräte-SDKs aufgeführt, die für jede unterstützte Sprache verfügbar sind.

SDKs für eingebettete DPS-Geräte

Diese SDKs wurden für die Ausführung auf Geräten mit begrenzten Compute- und Arbeitsspeicherressourcen entwickelt und erstellt und werden mit der Programmiersprache C implementiert.

Erfahren Sie mehr über die Geräte- und eingebetteten Geräte-SDKs in IoT-SDKs.

DPS-Dienst-SDKs

Die DPS-Dienst-SDKs helfen Ihnen beim Erstellen von Back-End-Anwendungen zum Verwalten von Registrierungen und Registrierungs-Datensätzen in DPS-Instanzen.

DPS-Verwaltungs-SDKs

Die DPS-Verwaltungs-SDKs helfen Ihnen beim Erstellen von Back-End-Anwendungen, die die DPS-Instanzen und deren Metadaten in Ihrem Azure-Abonnement verwalten.

Zertifikatverwaltungs-SDKs (Vorschau)

Verwenden Sie für SDKs, die die Microsoft-gesicherte X.509-Zertifikatverwaltung in der Vorschau unterstützen, die folgenden Anweisungen und Beispiele. Um Zertifikatverwaltungs-SDKs in der Vorschau zu verwenden, müssen Sie Azure IoT Hub mit einer verknüpften DPS-Instanz verwenden, und Geräte müssen über DPS bereitgestellt werden.

Zertifikatverwaltungsgeräte-SDKs (Vorschau)

In der folgenden Tabelle sind die Plattform-SDKs aufgeführt, die derzeit Microsoft gesicherte X.509-Zertifikatverwaltung in der Vorschau unterstützen.

Eingebettete Geräte-SDKs für die Zertifikatverwaltung (Vorschau)

In der folgenden Tabelle sind die eingebetteten SDKs aufgeführt, die derzeit Microsoft gesicherte X.509-Zertifikatverwaltung in der Vorschau unterstützen.

Azure Digital Twins Steuerebenen-APIs

Die Steuerelementebenen-APIs sind ARM-APIs, die zum Verwalten Ihrer Azure Digital Twins Instanz als Ganzes verwendet werden, sodass vorgänge wie das Erstellen oder Löschen der gesamten Instanz behandelt werden. Sie werden diese APIs auch zum Erstellen und Löschen von Endpunkten verwenden.

Um die APIs direkt aufzurufen, verweisen Sie im Control-Flugzeug-Swagger-Repo auf den neuesten Ordner "Swagger". Dieser Ordner enthält auch einen Ordner mit Beispielen, die die Verwendung veranschaulichen.

Hier sind die sdKs, die derzeit für die Azure Digital Twins Steuerebenen-APIs verfügbar sind.

Azure Digital Twins Datenebenen-APIs

Die Datenebenen-APIs sind die Azure Digital Twins-APIs, die zum Verwalten der Elemente in Ihrer Azure Digital Twins Instanz verwendet werden. Dazu gehören Vorgänge wie das Erstellen von Routen, das Hochladen von Modellen, das Erstellen von Beziehungen und das Verwalten von Zwillingen. Sie können ganz allgemein in die folgenden Kategorien unterteilt werden:

• DigitalTwinModels - Die Kategorie "DigitalTwinModels" enthält APIs zum Verwalten der models in einer Azure Digital Twins Instanz. Zu den Verwaltungsaktivitäten gehören das Hochladen, Überprüfen, Abrufen und Löschen von Modellen, die in DTDL erstellt wurden.
• DigitalTwins - Die Kategorie "DigitalTwins" enthält die APIs, mit denen Entwickler digital twins und ihre Beziehungen in einer Azure Digital Twins Instanz erstellen, ändern und löschen können.
• Query: Die Kategorie „Query“ ermöglicht es Entwicklern, Gruppen von digitalen Zwillingen im Zwillingsgraphen beziehungsübergreifend zu finden.
• Event Routes: Die Kategorie „Event Routes“ enthält APIs zur Weiterleitung von Daten, durch das System und zu Downstreamdiensten.
• Import Jobs – Mit der Import Jobs-API können Sie eine zeitintensive, asynchrone Aktion zum Bulk-Importieren von Modellen, Zwillingen und Beziehungen verwalten.
• Delete Jobs – Mit der Delete Jobs-API können Sie eine zeitintensive, asynchrone Aktion zum Löschen aller Modelle, Zwillinge und Beziehungen in einer Instanz verwalten.

Um die APIs direkt aufzurufen, verweisen Sie auf den neuesten Swagger-Ordner im datenebenen-Repository Swagger. Dieser Ordner enthält auch einen Ordner mit Beispielen, die die Verwendung veranschaulichen. Sie können auch die Referenzdokumentation zur Datenebenen-API anzeigen.

Hier sind die sdKs, die derzeit für die Azure Digital Twins Datenebenen-APIs verfügbar sind.

Nächste Schritte

Beispiele für empfohlene nächste Schritte:

• Leitfaden für Geräteentwickler
• Leitfaden für Dienstentwickler