Azure Device Update pour IoT Hub bibliothèque cliente pour .NET - version 1.0.0

Article
04/18/2023

La bibliothèque fournit l’accès au service Device Update pour IoT Hub qui permet aux clients de publier des mises à jour pour leurs appareils IoT sur le cloud, puis de déployer ces mises à jour sur leurs appareils (approuver les mises à jour sur des groupes d’appareils gérés et provisionnés dans IoT Hub).

| Code source Paquet | Documentation produit

Prise en main

L’intégralité du Kit de développement logiciel (SDK) Microsoft Azure peut être téléchargée à partir de la page Téléchargements Microsoft Azure et fournie avec la prise en charge de la création de packages de déploiement, l’intégration avec des outils, des outils en ligne de commande enrichis, 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 correctifs logiciels.

Prérequis

Abonnement Microsoft Azure : pour appeler les services Microsoft Azure, vous devez créer un abonnement Azure
Mise à jour de l’appareil pour IoT Hub instance
Azure IoT Hub instance

Installer le package

Installez la bibliothèque de client Device Update pour IoT Hub pour .NET avec NuGet :

dotnet add package Azure.IoT.DeviceUpdate

Authentifier le client

Pour interagir avec Device Update pour IoT Hub service, vous devez créer un instance d’une classe TokenCredential et le transmettre au constructeur de votre classe DeviceUpdateClient et DeviceManagementClient.

Concepts clés

Device Update pour IoT Hub est un service managé qui vous permet de déployer des mises à jour en direct pour vos appareils IoT. La bibliothèque cliente comporte trois composants main :

DeviceManagementClient : appareil, groupe, gestion du déploiement (énumérer, créer, récupérer, supprimer un appareil, groupe, déploiement, etc.)
DeviceUpdateClient : gestion des mises à jour (importation, énumération, suppression, etc.)

Pour en savoir plus sur Device Update pour IoT Hub, consultez Mise à jour de l’appareil pour IoT Hub.

Exemples

Vous pouvez vous familiariser avec différentes API à l’aide d’exemples.

Dépannage

Toutes les mises à jour d’appareil pour les opérations de service IoT Hub déclenchent une exception RequestFailedException en cas d’échec avec des codes d’erreur utiles.

Par exemple, si vous utilisez l’opération GetUpdateAsync et que le modèle que vous recherchez n’existe pas, vous pouvez intercepter ce HttpStatusCode spécifique pour décider de l’opération qui suit dans ce cas.

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.
}

Étapes suivantes

Prise en main de nos exemples Device Update pour IoT Hub

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 Contrat de licence contributeur.

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.

Partager via