Création d’un IoT Hub à l’aide de l’interface de ligne de commande Azure
Cet article explique comment créer un hub IoT à l’aide d’Azure CLI.
Prérequis
Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.
Lorsque vous créez un IoT Hub, vous devez le créer dans un groupe de ressources. Utilisez un groupe de ressources existant, ou exécutez la commande suivante pour en créer un groupe de ressources :
az group create --name {your resource group name} --location westus
Conseil
L’exemple précédent crée le groupe de ressources dans l’emplacement USA Ouest. Vous pouvez afficher une liste des emplacements disponibles en exécutant cette commande :
az account list-locations -o table
Créer un hub IoT
Utilisez l’interface de ligne de commande Azure pour créer un groupe de ressources, puis ajoutez un IoT Hub.
Exécutez la commande suivante pour créer un IoT Hub dans votre groupe de ressources en utilisant un nom globalement unique pour votre IoT Hub :
az iot hub create --name {your iot hub name} \
--resource-group {your resource group name} --sku S1
Important
Comme le hub IoT sera publiquement détectable en tant que point de terminaison DNS, veillez à éviter d’entrer des informations sensibles ou personnellement identifiables quand vous le nommez.
La commande précédente crée un hub IoT dans le niveau de tarification S1 pour lequel vous êtes facturé. Pour plus d’informations, voir la tarification d’Azure IoT Hub.
Pour plus d’informations sur les commandes Azure IoT Hub, consultez l’article de référence az iot hub
.
Mettre à jour le hub IoT
Vous pouvez modifier les paramètres d’un hub IoT existant après sa création. Voici des propriétés que vous pouvez définir pour un hub IoT :
Tarification et mise à l’échelle : migrer vers un autre niveau ou définir le nombre d’unités IoT Hub.
Filtre IP : Spécifiez une plage d’adresses IP qui seront acceptées ou rejetées par le hub IoT.
Propriétés : liste des propriétés que vous pouvez copier et utiliser ailleurs, comme l’ID de ressource, le groupe de ressources, l’emplacement, etc.
Pour obtenir la liste complète des options permettant de mettre à jour un hub IoT, consultez la page de référence des commandes az iot hub update.
Inscrire un nouvel appareil dans le hub IoT
Dans cette section, vous allez créer une identité d’appareil dans le registre des identités de votre hub IoT. Un appareil ne peut pas se connecter à un hub, à moins d’avoir une entrée dans le registre des identités. Pour plus d’informations, consultez Comprendre le registre des identités dans votre IoT Hub. Cette identité d’appareil est compatible IoT Edge.
Exécutez la commande suivante pour créer une identité d’appareil. Utilisez votre nom de hub IoT et créez un nom d’ID d’appareil à la place de {iothub_name}
et {device_id}
. Cette commande crée une identité d’appareil avec une autorisation par défaut (clé privée partagée).
az iot hub device-identity create -n {iothub_name} -d {device_id} --ee
Le résultat est une impression JSON incluant vos clés et d’autres informations.
Par ailleurs, vous disposez de plusieurs options pour inscrire un appareil à l’aide de différents types d’autorisations. Pour explorer les options, consultez Exemples dans la page de référence az iot hub device-identity.
Supprimer un hub IoT
Diverses commandes permettent de supprimer une ressource individuelle, telle qu’un hub IoT.
Pour supprimer un hub IoT, exécutez la commande suivante :
az iot hub delete --name {your iot hub name} -\
-resource-group {your resource group name}
Étapes suivantes
En savoir plus sur les commandes disponibles dans l’extension Microsoft Azure IoT pour Azure CLI :