Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
L’interface de ligne de commande (CLI) Azure permet de créer et gérer des ressources Azure à partir de la ligne de commande ou dans les scripts. Ce guide de démarrage rapide détaille l’utilisation d’Azure CLI pour créer un hub IoT et une instance de service IoT Hub Device Provisioning et lier les deux services.
Si vous ne disposez pas d’un compte Azure, créez-en un gratuitement avant de commencer.
Important
Le hub IoT et le service d’approvisionnement que vous créez dans ce guide de démarrage rapide seront publiquement détectables en tant que points de terminaison DNS. Veillez à éviter les informations sensibles si vous décidez de modifier les noms utilisés pour ces ressources.
Conditions préalables
Utilisez l’environnement Bash dans Azure Cloud Shell. Pour obtenir plus d’informations, consultez Démarrage d’Azure Cloud Shell.
Si vous préférez exécuter des commandes de référence CLI localement, installez 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 terminer le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour obtenir d’autres options de connexion, consultez S’authentifier auprès d’Azure à l’aide d’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 et gérer 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.
Créer un groupe de ressources
Créez un groupe de ressources avec la commande az group create. Un groupe de ressources Azure est un conteneur logique dans lequel les ressources Azure sont déployées et gérées.
L’exemple suivant crée un groupe de ressources nommé my-sample-resource-group à l’emplacement westus .
az group create --name my-sample-resource-group --location westus
Conseil / Astuce
L’exemple crée le groupe de ressources dans l’emplacement USA Ouest. Vous pouvez afficher la liste des emplacements disponibles en exécutant la commande az account list-locations -o table.
Créer un hub IoT
Créez un hub IoT avec la commande az iot hub create .
L’exemple suivant crée un hub IoT nommé my-sample-hub à l’emplacement westus . Un nom IoT Hub doit être globalement unique dans Azure. Vous devez donc ajouter un préfixe ou un suffixe unique au nom d’exemple ou choisir un nouveau nom. Assurez-vous que votre nom suit les conventions d’affectation de noms appropriées pour un hub IoT : il doit s’agir de 3 à 50 caractères de longueur et ne peut contenir que des caractères alphanumériques en majuscules ou minuscules ou des traits d’union ('-').
az iot hub create --name my-sample-hub --resource-group my-sample-resource-group --location westus
Créer une instance du service de provisionnement de dispositifs
Créez une instance de service Device Provisioning avec la commande az iot dps create .
L’exemple suivant crée une instance de service Device Provisioning nommée my-sample-dps à l’emplacement westus . Vous devez également choisir un nom global unique pour votre propre instance. Assurez-vous qu’il suit les conventions d’affectation de noms appropriées pour un service IoT Hub Device Provisioning : il doit s’agir de 3 à 64 caractères de longueur et ne peut contenir que des caractères alphanumériques en majuscules ou minuscules ou des traits d’union ('-').
az iot dps create --name my-sample-dps --resource-group my-sample-resource-group --location westus
Conseil / Astuce
L’exemple crée le service d’approvisionnement dans l’emplacement USA Ouest. Vous pouvez afficher la liste des emplacements disponibles en exécutant la commande az provider show --namespace Microsoft.Devices --query "resourceTypes[?resourceType=='ProvisioningServices'].locations | [0]" --out table ou en accédant à la page État Azure et en recherchant « Service Device Provisioning ». Dans les commandes, les emplacements peuvent être spécifiés dans un format d’un mot ou de plusieurs mots. Par exemple : westus, West US, WEST US, etc. La valeur ne respecte pas la casse. Si vous utilisez le format multi word pour spécifier l’emplacement, placez la valeur entre guillemets ; par exemple, --location "West US".
Pour la résilience et la fiabilité, nous vous recommandons de déployer sur l’une des régions qui prennent en charge les Zones de disponibilité.
Obtenir la chaîne de connexion pour le hub IoT
Vous avez besoin de la chaîne de connexion de votre hub IoT pour la lier au service Device Provisioning. Utilisez la commande az iot hub connection-string show pour obtenir la chaîne de connexion et utiliser sa sortie pour définir une variable utilisée ultérieurement lorsque vous liez les deux ressources.
L’exemple suivant définit la variable hubConnectionString sur la valeur de la chaîne de connexion pour la clé primaire de la stratégie iothubowner du hub (le --policy-name paramètre peut être utilisé pour spécifier une autre stratégie). Échangez my-sample-hub pour le nom unique du hub IoT que vous avez choisi précédemment. La commande utilise les options de requête et de sortie Azure CLI pour extraire la chaîne de connexion de la sortie de commande.
hubConnectionString=$(az iot hub connection-string show --name my-sample-hub --key primary --query connectionString -o tsv)
Vous pouvez utiliser la echo commande pour afficher la chaîne de connexion.
echo $hubConnectionString
Remarque
Ces deux commandes sont valides pour un hôte s’exécutant sous Bash.
Si vous utilisez un interpréteur de commandes Windows/CMD local ou un hôte PowerShell, modifiez les commandes pour utiliser la syntaxe correcte pour cet environnement.
Si vous utilisez Azure Cloud Shell, vérifiez que la liste déroulante de l’environnement sur le côté gauche de la fenêtre de l’interpréteur de commandes indique Bash.
Lier le hub IoT et le service d’approvisionnement
Liez le hub IoT et votre service d’approvisionnement avec la commande az iot dps linked-hub create .
L’exemple suivant lie un hub IoT nommé my-sample-hub à l’emplacement westus et un service Device Provisioning nommé my-sample-dps. Échangez ces noms pour les noms uniques du hub IoT et du service Device Provisioning que vous avez choisis précédemment. La commande utilise la chaîne de connexion pour votre hub IoT qui a été stocké dans la variable hubConnectionString à l’étape précédente.
az iot dps linked-hub create --dps-name my-sample-dps --resource-group my-sample-resource-group --connection-string $hubConnectionString --location westus
La commande peut prendre quelques minutes.
Vérifier le service d’approvisionnement
Obtenez les détails de votre service d’approvisionnement avec la commande az iot dps show .
L’exemple suivant obtient les détails d’un service d’approvisionnement nommé my-sample-dps. Remplacez ce nom par celui de votre propre service d'approvisionnement en appareils.
az iot dps show --name my-sample-dps
Le hub IoT lié est affiché dans la collection properties.iotHubs .
Nettoyer les ressources
Les autres guides de démarrage rapide de cette collection reposent sur ce guide de démarrage rapide. Si vous souhaitez continuer à utiliser d’autres démarrages rapides ou les didacticiels, ne nettoyez pas les ressources créées lors de ce démarrage rapide. Si vous n’envisagez pas de continuer, vous pouvez utiliser les commandes suivantes pour supprimer le service d’approvisionnement, le hub IoT ou le groupe de ressources et toutes ses ressources. Remplacez les noms des ressources incluses dans les commandes suivantes par les noms de vos propres ressources.
Pour supprimer le service d’approvisionnement, exécutez la commande az iot dps delete :
az iot dps delete --name my-sample-dps --resource-group my-sample-resource-group
Pour supprimer le hub IoT, exécutez la commande az iot hub delete :
az iot hub delete --name my-sample-hub --resource-group my-sample-resource-group
Pour supprimer un groupe de ressources et toutes ses ressources, exécutez la commande az group delete :
az group delete --name my-sample-resource-group
Étapes suivantes
Dans ce guide de démarrage rapide, vous avez déployé un hub IoT et une instance du service Device Provisioning, puis vous avez lié ces deux ressources. Pour savoir comment utiliser cette configuration pour provisionner un appareil, passez au démarrage rapide traitant de la création d’un appareil.