IoT Platform:Créer plusieurs appareils simultanément

Prérequis

Vous avez créé un produit. Pour plus d'informations, consultez la rubrique Créer un produit.

Procédure

1. Connectez-vous à la console IoT Platform.

2. Sur la page Overview, repérez l'instance à gérer et cliquez sur son ID ou son nom.

3. Dans le volet de navigation de gauche, sélectionnez Devices > Devices.

4. Sur la page Devices, cliquez sur Batch Add.

5. Sélectionnez un produit. Les nouveaux appareils héritent des fonctionnalités de ce produit.

   Important

   Si le produit est associé à d'autres plateformes, vérifiez que votre compte dispose d'un quota suffisant de codes d'activation pour créer des appareils.

   Définissez Add Method sur Auto Generate, spécifiez Device Quantity à 100, puis cliquez sur OK.

6. Choisissez une méthode pour spécifier les DeviceNames.

   • Auto Generate : saisissez le nombre d'appareils. IoT Platform génère un DeviceName aléatoire composé de lettres et de chiffres pour chaque appareil.

   • Batch Upload : spécifiez un nom pour chaque appareil. Cliquez sur Download .csv Template, saisissez le DeviceName et le Nickname de chaque appareil dans le modèle, puis importez le fichier dans la console IoT Platform.

     Important

     • Ne modifiez pas la première ligne. Commencez la saisie des données à partir de la cellule A2.

     • Un DeviceName doit comporter entre 4 et 32 caractères et peut contenir des lettres, des chiffres, des traits d'union (-), des traits de soulignement (_), des signes at (@), des points (.) et des deux-points (:). Un DeviceName doit être unique au sein d'un produit.

     • Le Nickname est un alias facultatif pour l'appareil. Un alias doit comporter entre 4 et 64 caractères et peut contenir des caractères chinois, japonais, des lettres, des chiffres et des traits de soulignement (_). Un caractère chinois ou japonais compte pour deux caractères.

     • Un fichier peut contenir jusqu'à 10 000 enregistrements et ne doit pas dépasser 2 Mo.

7. Cliquez sur OK.

   Si la liste importée contient des noms d'appareils non valides, un message d'erreur s'affiche. Cliquez sur Download Invalid Device Name List pour afficher les noms invalides, corrigez-les, puis importez à nouveau le fichier.

8. Une fois les appareils créés, cliquez sur Download Device Certificate pour télécharger leurs certificats. Vous pouvez intégrer ces certificats directement sur les appareils.

   Un certificat d'appareil se compose d'un ProductKey, d'un DeviceName et d'un DeviceSecret. L'appareil a besoin de ces informations d'identification pour communiquer avec IoT Platform. Conservez le certificat en toute sécurité.

   Parameter	Description
   ProductKey	ProductKey du produit auquel appartient l'appareil. Le ProductKey est l'identifiant global unique (GUID) attribué par IoT Platform au produit.
   DeviceName	DeviceName de l'appareil, qui sert d'identifiant unique au sein du produit. La combinaison du DeviceName et du ProductKey constitue l'identifiant de l'appareil. IoT Platform utilise cet identifiant pour authentifier l'appareil et établir la communication avec celui-ci.
   DeviceSecret	DeviceSecret de l'appareil, attribué par IoT Platform pour l'authentification et le chiffrement. Le DeviceSecret doit être utilisé conjointement avec le DeviceName.

Résultat

Une fois les appareils créés, accédez à l'onglet Batch Management de la page Devices. Repérez le produit concerné et cliquez sur l'une des options suivantes :

• Details : consultez le Number of Added Devices et la liste des appareils du lot. La liste inclut des informations telles que les certificats d'appareil et leur statut.

  Si la création de certains appareils a échoué, les codes d'erreur et leurs causes s'affichent dans la liste des appareils. Le tableau suivant décrit ces codes d'erreur.

  Error code	Message	Description
  460	duplicated deviceName	The device name is duplicated.
  	invalid deviceName	The device name is invalid.
  6251	device exist	The device already exists.
  6760	insufficient activation code	You do not have enough activation codes.
  64003	device creation failed	The device was not created due to concurrent operations.
  6293	device has been distributed	The device has been distributed.

• DownloadCSV : téléchargez les certificats des appareils de ce lot.

Étapes suivantes

Consultez les informations relatives à l'appareil. Pour plus d'informations, voir Afficher les informations de l'appareil.

Pour en savoir plus sur la connexion d'un appareil à IoT Platform, consultez les rubriques suivantes :

• Connecter un appareil à IoT Platform à l'aide de MQTT.fx

• Connecter du matériel Android Things à IoT Platform

Opérations API associées

BatchRegisterDevice : enregistre plusieurs appareils simultanément.