IoT Platform:Crear varios dispositivos a la vez

Requisitos previos

Ya se creó un producto. Para más información, consulte Create a product.

Procedimiento

1. Inicie sesión en la consola de IoT Platform.

2. En la página Overview, busque la instancia que desea gestionar y haga clic en su ID o nombre.

3. En el panel de navegación izquierdo, elija Devices > Devices.

4. En la página Devices, haga clic en Batch Add.

5. Seleccione un producto. Los nuevos dispositivos heredan las características de este producto.

   Importante

   Si el producto está asociado con otras plataformas, compruebe que su cuenta tenga una cuota suficiente de códigos de activación para crear los dispositivos.

   Establezca Add Method en Auto Generate, defina Device Quantity como 100 y luego haga clic en OK.

6. Elija un método para especificar los DeviceName.

   • Auto Generate: introduzca la cantidad de dispositivos. IoT Platform genera un DeviceName aleatorio, compuesto por letras y dígitos, para cada dispositivo.

   • Batch Upload: especifique un nombre para cada dispositivo. Haga clic en Download .csv Template, introduzca el DeviceName y el Nickname de cada dispositivo en la plantilla y, después, cargue el archivo en la consola de IoT Platform.

     Importante

     • No modifique la primera fila. Comience a introducir los datos desde la celda A2.

     • Un DeviceName debe tener entre 4 y 32 caracteres, y puede contener letras, dígitos, guiones (-), guiones bajos (_), arrobas (@), puntos (.) y dos puntos (:). El DeviceName debe ser único dentro de un producto.

     • Nickname es un alias opcional del dispositivo. El alias debe tener entre 4 y 64 caracteres, y puede contener caracteres chinos, japoneses, letras, dígitos y guiones bajos (_). Cada carácter chino o japonés cuenta como dos caracteres.

     • Un archivo puede contener hasta 10 000 registros y no debe superar los 2 MB.

7. Haga clic en OK.

   Si la lista cargada contiene nombres de dispositivo no válidos, aparece un mensaje de error. Haga clic en Download Invalid Device Name List para consultar los nombres no válidos, corríjalos y vuelva a cargar el archivo.

8. Una vez creados los dispositivos, haga clic en Download Device Certificate para descargar sus certificados. Posteriormente, grabe estos certificados en los dispositivos.

   Un certificado de dispositivo consta de un ProductKey, un DeviceName y un DeviceSecret. El dispositivo necesita esta credencial para comunicarse con IoT Platform. Guarde el certificado de forma segura.

   Parámetro	Descripción
   ProductKey	Es el ProductKey del producto al que pertenece el dispositivo. Se trata del GUID que IoT Platform emite para el producto.
   DeviceName	Es el DeviceName del dispositivo, que lo identifica de manera única dentro del producto. La combinación del DeviceName y el ProductKey funciona como identificador del dispositivo. IoT Platform usa este identificador para autenticar el dispositivo y comunicarse con él.
   DeviceSecret	Es el DeviceSecret del dispositivo, emitido por IoT Platform para la autenticación y el cifrado. Debe usarse junto con el DeviceName.

Resultado

Una vez creados los dispositivos, vaya a la pestaña Batch Management de la página Devices. Busque el producto correspondiente y haga clic en una de las siguientes opciones:

• Details: consulte el valor de Number of Added Devices y la lista de dispositivos del lote. Esta lista incluye información como los certificados y el estado de los dispositivos.

  Si algunos dispositivos se crearon con errores, los códigos y las causas se muestran en la lista de dispositivos. En la siguiente tabla se describen los códigos de error.

  Código de error	Mensaje	Descripción
  460	duplicated deviceName	El nombre del dispositivo está duplicado.
  	invalid deviceName	El nombre del dispositivo no es válido.
  6251	device exist	El dispositivo ya existe.
  6760	insufficient activation code	No tiene suficientes códigos de activación.
  64003	device creation failed	El dispositivo no se creó debido a operaciones simultáneas.
  6293	device has been distributed	El dispositivo ya se distribuyó.

• DownloadCSV: descargue los certificados de los dispositivos de este lote.

Pasos siguientes

Puede consultar la información de los dispositivos. Para más información, consulte View device information.

Para más información sobre cómo conectar un dispositivo a IoT Platform, consulte los siguientes temas:

• Connect a device to IoT Platform by using MQTT.fx

• Connect Android Things hardware to IoT Platform

Operaciones de API relacionadas

BatchRegisterDevice: registra varios dispositivos a la vez.