Azure Device Update pour IoT Hub bibliothèque de client pour Java - version 1.0.12

Article
10/21/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 dans 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 Documentation produit

Prise en main

Le KIT de développement logiciel (SDK) Microsoft Azure complet peut être téléchargé à partir de la page Téléchargements Microsoft Azure et est fourni avec la prise en charge de la création de packages de déploiement, de l’intégration à 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

Un Kit de développement Java (JDK), version 8 ou ultérieure.
Abonnement Azure
Device Update pour IoT Hub instance
Azure IoT Hub instance

Inclure le package

<dependency>
  <groupId>com.azure</groupId>
  <artifactId>azure-iot-deviceupdate</artifactId>
  <version>1.0.12</version>
</dependency>

Authentifier le client

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

Pour plus d’informations sur la configuration de l’authentification, reportez-vous au document Prise en main du Kit de développement logiciel (SDK) Java .

Concepts clés

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

DeviceUpdate : gestion des mises à jour (importation, énumération, suppression, etc.)
DeviceManagement : gestion des appareils (énumérer les appareils et récupérer les propriétés des appareils), gestion du déploiement (démarrer et surveiller les déploiements de mises à jour sur un ensemble d’appareils)

Vous pouvez en savoir plus sur Device Update pour IoT Hub en consultant Device Update 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 IoT Hub opérations de service lèveront une exception ErrorResponseException en cas d’échec avec des codes d’erreur utiles.

Par exemple, si vous utilisez l’opération getUpdateWithResponse 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<BinaryData> response = client.getUpdateWithResponse("foo", "bar", "0.0.0.1",
            null);
} catch (HttpResponseException e) {
    if (e.getResponse().getStatusCode() == 404) {
        // update does not exist
        System.out.println("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) spécifiant que vous avez le droit de nous accorder les droits d’utiliser votre contribution, et que vous nous les accordez.

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.

Impressions

Partager via