Bibliothèque de client azure IoT Models Repository pour .NET - version 1.0.0-preview.5

Article
04/24/2023

Cette bibliothèque fournit des fonctionnalités permettant d’interagir avec le référentiel de modèles Azure IoT. Il vise également à fournir une expérience cohérente de l’utilisation des référentiels de modèles de jumeau numérique en suivant les conventions Azure IoT.

| Code source Package (nuget)

Prise en main

Le KIT de développement logiciel (SDK) Microsoft Azure complet peut être téléchargé à partir de la page de téléchargements Microsoft Azure , et il est fourni avec la prise en charge de la création de packages de déploiement, de l’intégration avec des outils, des outils en ligne de commande riches, etc.

Pour une expérience de développement optimale, les développeurs doivent utiliser les packages Microsoft NuGet officiels pour les bibliothèques. Les packages NuGet sont régulièrement mis à jour avec de nouvelles fonctionnalités et des correctifs de bogues.

Installer le package

Installez la bibliothèque de client Azure IoT Models Repository pour .NET avec NuGet :

Install-Package Azure.IoT.ModelsRepository

Affichez les détails du package dans nuget.org.

Prérequis

Un référentiel de modèles suivant les conventions Azure IoT
- Le référentiel de modèles peut être situé sur le système de fichiers local ou hébergé sur un serveur web.
- Azure IoT héberge le référentiel de modèles Azure IoT global vers lequel le client pointe par défaut si aucun URI n’est fourni.

Authentifier le client

Actuellement, aucun mécanisme d’authentification n’est pris en charge dans le client. Le point de terminaison global n’est pas lié à un abonnement Azure et ne prend pas en charge l’authentification. Tous les modèles publiés sont destinés à la consommation publique anonyme.

Concepts clés

Le référentiel de modèles Azure IoT permet aux générateurs de gérer et de partager des modèles de jumeau numérique. Les modèles sont des documents JSON-LD définis à l’aide du langage DTDL (Digital Twins Definition Language).

Le référentiel définit un modèle pour stocker les interfaces DTDL dans une structure de répertoires basée sur l’identificateur de modèle de jumeau numérique (DTMI). Vous pouvez localiser une interface dans le référentiel en convertissant le DTMI en chemin d’accès relatif. Par exemple, le DTMI «dtmi:com:example:Thermostat;1 » se /dtmi/com/example/thermostat-1.jsontraduit par .

Sécurité des threads

Nous garantissons que toutes les méthodes de instance client sont thread-safe et indépendantes les unes des autres. Consultez les instructions de sécurité des threads. Cela garantit que la recommandation de réutilisation des instances clientes est toujours sécurisée, même entre les threads.

Concepts supplémentaires

Exemples

Vous pouvez vous familiariser avec le client à l’aide d’exemples pour le référentiel de modèles IoT.

Dépannage

Toutes les opérations de service lèvent RequestFailedException en cas d’échec, avec des codes d’erreur utiles et d’autres informations. Le client produit également des événements de diagnostic et une journalisation qui peuvent être écoutés avec un EventListener.

Étapes suivantes

Consultez des exemples d’implémentation avec nos exemples de code.

Contribution

Ce projet accepte les contributions et les suggestions. La plupart des contributions vous demandent d’accepter un contrat de licence de contribution (CLA) déclarant que vous avez le droit de nous accorder, et que vous nous accordez réellement, les droits d’utilisation de votre contribution. Pour plus d’informations, consultez https://cla.microsoft.com

Quand vous envoyez une demande de tirage (pull request), un bot CLA détermine automatiquement si vous devez fournir un contrat CLA et agrémenter la demande de tirage de façon appropriée (par exemple, avec une étiquette ou un commentaire). Suivez simplement les instructions fournies par le bot. Vous ne devez effectuer cette opération qu’une seule fois sur tous les dépôts utilisant notre contrat CLA.

Ce projet a adopté le Code de conduite Open Source de Microsoft. Pour plus d’informations, consultez les Questions fréquentes (FAQ) sur le code de conduite ou envoyez vos questions ou vos commentaires à opencode@microsoft.com.