Distribución de dispositivos - IoT Platform - Centro de documentación de Alibaba Cloud

Escenarios

Puede distribuir dispositivos en los siguientes escenarios:

Grabación en el dispositivo antes de la conexión: Antes de despachar los dispositivos desde la fábrica, no es necesario codificar distintos endpoints según las instancias o regiones de IoT Platform donde residan. En cada dispositivo se graba un endpoint globalmente único que no contiene información de la región. Después de salir de fábrica, puede distribuir los dispositivos a diferentes regiones desde la consola de IoT Platform. De este modo, los dispositivos pueden conectarse a IoT Platform desde distintas regiones alrededor del mundo.
Migración de negocios: Si migra su negocio, es posible que deba cambiar la región o instancia a la que está conectado un dispositivo. En este caso, puede distribuir los dispositivos entre regiones, instancias o cuentas.

Las siguientes directivas de distribución aplican a los distintos escenarios:

Región especificada: Los dispositivos se distribuyen a la región e instancia indicadas. Si puede confirmar la región y la instancia de destino hacia donde deben distribuirse los dispositivos, se recomienda utilizar esta directiva. Esto permite distribuir los dispositivos de manera eficiente.
Acceso más cercano: Los dispositivos podrían utilizarse en diferentes regiones del mundo. Al distribuirlos, puede seleccionar una o más regiones y elegir una instancia de cada una. Posteriormente, los dispositivos se conectarán a la región más cercana según sus direcciones IP. Así, un dispositivo se conecta a la región más próxima sin importar su ubicación física.

Notas de uso

Elemento	Descripción
Alcance de la distribución	Puede distribuir dispositivos en todas las regiones donde esté desplegado IoT Platform. Un dispositivo puede distribuirse varias veces.
Distribución entre cuentas	Si existen varias instancias públicas de la versión anterior en la misma región, no es posible distribuir dispositivos entre dichas instancias. Para obtener más información, consulte Manage instance endpoints. La directiva de acceso más cercano no es compatible.
Distribución a una región específica	Si distribuye un producto, se distribuyen los datos del producto, pero no los datos de los dispositivos pertenecientes a dicho producto. Si distribuye un dispositivo, se distribuyen tanto los datos del dispositivo especificado en la directiva de distribución como los datos del producto al que pertenece. Para obtener más información sobre los elementos que pueden distribuirse, consulte Distributable items.
Distribución a la región más cercana	No es posible distribuir únicamente productos. Si distribuye un dispositivo, también se distribuyen los datos del producto al que pertenece. Los datos del dispositivo se distribuyen según la dirección IP del endpoint al que se conectan los dispositivos.

Elementos distribuibles

Puede distribuir dispositivos entre instancias, regiones o cuentas.

Una vez distribuido un dispositivo, también se distribuyen ciertos datos del dispositivo y del producto. La siguiente tabla describe los elementos distribuibles.

Elemento distribuible	Límites
Número máximo de dispositivos	Puede distribuir hasta 10,000 dispositivos simultáneamente.
Datos del dispositivo	El certificado del dispositivo se distribuye y se utiliza para autenticar la conexión entre el dispositivo y la nueva instancia. El certificado incluye ProductKey, DeviceName y DeviceSecret. Los siguientes datos del dispositivo no se distribuyen: Datos de tiempo de ejecución. Estos datos se generan mientras el dispositivo está en funcionamiento e incluyen el estado del dispositivo, datos de Thing Specification Language (TSL), sombras de dispositivo, archivos y registros. Cuando se distribuye un dispositivo, este pasa a estar inactivo. Al reconectarse a IoT Platform, el dispositivo se activa y puede conectarse o desconectarse. Los datos de tiempo de ejecución permanecen en la región, instancia y cuenta de origen. Si el dispositivo se redistribuye a la región de origen, dichos datos aún pueden utilizarse. Datos de relaciones topológicas, etiquetas y grupos. Si se distribuye un dispositivo, estos datos se eliminan.
Datos del producto	Se distribuyen la información del producto, las categorías de temas, las funciones TSL y los scripts de análisis de datos. Los destinatarios solo pueden consultar los datos de los productos distribuidos. No pueden editar ni eliminar datos en las pestañas Product Information, Topic Categories, Define Feature o Data Parsing de la página Product Details. Tampoco pueden crear dispositivos para los productos distribuidos desde la consola de IoT Platform. Importante Si se distribuye un dispositivo, tenga en cuenta lo siguiente: Si crea un dispositivo en el producto original de la instancia de origen, el DeviceName del nuevo dispositivo debe ser diferente al del dispositivo distribuido. No puede eliminar el dispositivo distribuido desde la instancia de destino. Para eliminarlo, distribuya el dispositivo desde la instancia de destino hacia la instancia de origen. Luego podrá eliminarlo desde la instancia de origen.

Precauciones

Elemento afectado por la distribución del dispositivo	Descripción
Facturación	Los dispositivos pueden distribuirse independientemente de si existen pagos pendientes en la instancia de origen o de destino. Después de distribuir un dispositivo, la instancia de destino cobra el uso del dispositivo según las reglas de facturación de IoT Platform.
Tarea de distribución de dispositivos	Una tarea de distribución de dispositivos iniciada no puede cancelarse. Si un dispositivo está en línea al momento de distribuirlo, se fuerza su desconexión.
Mensajería	Si desea utilizar las funciones de suscripción del lado del servidor mediante Advanced Message Queuing Protocol (AMQP) y reenvío de datos en un dispositivo distribuido, debe volver a configurarlas en la instancia de destino.
Actualización OTA	Si desea configurar una actualización over-the-air (OTA) para el dispositivo distribuido, considere lo siguiente: Antes de configurar una actualización OTA para un dispositivo distribuido entre regiones o instancias, debe cambiar a la región o instancia de destino en la consola de IoT Platform. Si el dispositivo se distribuyó entre cuentas, debe usar la cuenta de destino para configurar la actualización OTA. Puede obtener el paquete de actualización del propietario de la cuenta de origen. Para obtener más información sobre la función de actualización OTA, consulte Overview of OTA updates.
Actualización de datos del producto	Después de distribuir un producto, las operaciones realizadas sobre él en la instancia de origen, como crear temas personalizados, definir modelos TSL o editar scripts de análisis de datos, no afectan al producto distribuido en la instancia de destino.

Procedimiento

Cree un producto y un dispositivo dentro de ese producto, y luego obtenga el certificado del dispositivo en la consola de IoT Platform. El certificado incluye ProductKey, DeviceName y DeviceSecret. Para obtener más información, consulte Create a product, Create a device y Create multiple devices at a time.

Utilice Link SDK for C V4.x para configurar el dispositivo físico, o bien configúrelo según un protocolo de comunicación para implementar la siguiente función.

Nota

Para configurar el dispositivo, se recomienda utilizar Link SDK for C. Para obtener más información, consulte Overview of device distribution.

Después de distribuir el dispositivo en la consola de IoT Platform, puede conectarlo a la plataforma mediante los siguientes pasos:

Utilice uno de los siguientes métodos para iniciar una solicitud Bootstrap según el método de desarrollo del dispositivo:

Conectar el dispositivo mediante Link SDK for C

El dispositivo invoca el método Bootstrap encapsulado en el SDK y envía una solicitud al endpoint globalmente único https://iot-auth-global.aliyuncs.com con los parámetros ProductKey y DeviceName.

Para obtener información sobre cómo desarrollar la función Bootstrap, consulte Overview of device distribution.

Conectar el dispositivo sin utilizar el SDK

Envíe una solicitud a https://iot-auth-global.aliyuncs.com/auth/bootstrap según el protocolo que utilice. La siguiente tabla describe los parámetros de la solicitud.

Tabla 1 Parámetros de la solicitud
Parámetro	Obligatorio	Descripción
productKey	Obligatorio	El ProductKey del producto al que pertenece el dispositivo. Puede consultar el ProductKey en la consola de IoT Platform. Para obtener información sobre cómo conseguir el ProductKey, consulte Create a device.
deviceName	Obligatorio	El DeviceName del dispositivo. Puede consultar el DeviceName en la consola de IoT Platform.
clientId	Opcional	El ID del cliente. Debe tener entre 1 y 64 caracteres.
version	Opcional	El número de versión del servicio de verificación.
timestamp	Opcional	La marca de tiempo. No se verifica mediante el algoritmo de ventana deslizante.
resources	Opcional	Los nombres de los recursos que desea obtener. Ejemplo: MQTT. Separe varios nombres de recursos con comas (,).

Tabla 2 Parámetros de respuesta
Parámetro	Tipo	Descripción
resources	Struct	La información del recurso, como el endpoint del broker de Message Queuing Telemetry Transport (MQTT).

Ejemplo de solicitud

POST /auth/bootstrap HTTP/1.1
Host: iot-auth-global.aliyuncs.com
Content-Type: application/x-www-form-urlencoded
Content-Length: 123
productKey=123&timestamp=123&version=default&clientId=123&resources=mqtt&deviceName=test

Ejemplo de respuesta

HTTP/1.1 200 OK
Server: Tengine
Date: Wed, 29 Mar 2017 13:08:36 GMT
Content-Type: application/json;charset=utf-8
Connection: close
{
  "code" : 200,
  "data" : {
    "resources" : {
      "mqtt" : {
        "host" : "xxx.iot-as-mqtt.cn-shanghai.aliyuncs.com",
        "port" : 1883
      }
    }
  },
  "message" : "success"
}

IoT Platform devuelve un endpoint según la región y la instancia de destino. Si estableció el parámetro Distribution Policy en Nearest Access, IoT Platform determina la región y la instancia de destino basándose en la dirección IP del dispositivo.
El dispositivo se conecta a IoT Platform mediante MQTT utilizando el certificado del dispositivo y la información del endpoint de la instancia a la que puede conectarse. El certificado incluye ProductKey, DeviceName y DeviceSecret. La información del endpoint la devuelve el servicio de distribución.
- Conectar el dispositivo mediante Link SDK for C
  
  Para conectar el dispositivo, se recomienda utilizar el SDK V4.x. Para obtener más información sobre cómo conectar el dispositivo a IoT Platform, consulte Overview of device connection over MQTT.
- Conectar el dispositivo sin utilizar el SDK
  
  Utilice el proyecto de código abierto Paho MQTT para C embebido a fin de conectar el dispositivo a IoT Platform. Para obtener más información, consulte Paho MQTT C (embedded) integration example.
Opcional. Si distribuye el dispositivo desde la consola de IoT Platform, este recibe un mensaje MQTT que indica que se realizó una operación de distribución. A continuación, se fuerza la desconexión del dispositivo.

Los siguientes temas se utilizan cuando IoT Platform envía solicitudes MQTT descendentes y el dispositivo responde a IoT Platform:

Tema de solicitud: /sys/${productKey}/${deviceName}/thing/bootstrap/notify

Ejemplo de solicitud en formato Alink JSON:
```
{
    "id": "****",
    "version": "1.0", 
    "method": "thing.bootstrap.notify", 
    "params": {
      "cmd": 0
    }
}
```
Tema de respuesta: /sys/${productKey}/${deviceName}/thing/bootstrap/notify_reply

Ejemplo de respuesta en formato Alink JSON:
```
{
    "id": "****",
    "code":200,
    "data" : {}
}
```

Importante

Cada vez que conecte el dispositivo a IoT Platform, se recomienda completar las primeras tres etapas del proceso anterior. Esto garantiza que el endpoint almacenado en el dispositivo coincida con el enviado por IoT Platform. De lo contrario, el dispositivo podría fallar al conectarse.

La información del endpoint puede almacenarse en el dispositivo. Si se pierde la información de conexión o falla un intento de conexión, el dispositivo puede iniciar una solicitud Bootstrap para obtener nuevamente la información del endpoint.

Después de configurar un dispositivo, realice una de las siguientes operaciones según corresponda:
- Antes de distribuir un dispositivo existente que tenga deshabilitada la función de distribución de dispositivos, debe realizar una actualización OTA para actualizarlo a la versión desarrollada en el paso anterior. Para obtener información sobre cómo actualizar el dispositivo, consulte Overview of OTA updates.
  
  Importante
  Si la función de distribución de dispositivos está deshabilitada en un dispositivo existente, debe realizar una actualización OTA para habilitarla antes de distribuirlo. De lo contrario, el dispositivo no podrá conectarse a IoT Platform después de la distribución.
- Después de crear un dispositivo, debe grabar el certificado del dispositivo en él. Para obtener información sobre cómo grabar el certificado, consulte Overview of obtaining device certificates.

Distribuya el dispositivo a una región, instancia y cuenta específicas en la consola de IoT Platform según sus necesidades comerciales.

Inicie sesión en la consola de IoT Platform.
En la barra de navegación superior, seleccione China (Shanghai) en la lista desplegable.

Nota
Este paso se realiza para utilizar la función de distribución de dispositivos. No especifica la región de origen ni la de destino para la distribución.
En la página Overview, haga clic en All environment. En la pestaña All environment, localice la instancia que desea gestionar y haga clic en el ID o nombre de la instancia.
En el panel de navegación izquierdo, vaya a Resource Allocation > Device Distribution.
En la página Device Distribution, haga clic en Device Distribution.

Configure los parámetros.

La siguiente tabla describe los parámetros.

Parámetro	Descripción
Distribution Method	El método utilizado para distribuir dispositivos. Valores válidos: This Account: Distribuye los dispositivos a otra instancia o región de la cuenta actual. Cross-account: Distribuye los dispositivos a otra cuenta. Nota Si establece el parámetro Distribution Method en Cross-account, no puede establecer el parámetro Distribution Policy en Nearest Access.
Destination Account	La cuenta de destino hacia la cual se distribuyen los dispositivos. Si establece el parámetro Distribution Method en Cross-account, este parámetro es obligatorio. Puede especificar la cuenta de destino mediante el nombre o el ID de la cuenta. Destination Account Name: Introduzca el nombre de una cuenta de Alibaba Cloud. Destination Account ID: Introduzca el ID de una cuenta de Alibaba Cloud. Nota Para consultar el ID de la cuenta de Alibaba Cloud, siga estos pasos: Inicie sesión en la consola de IoT Platform y haga clic en la foto de perfil en la esquina superior derecha para ir a la página Security Settings.
Verification Code	Después de especificar la cuenta de destino, haga clic en Send Verification Code. IoT Platform envía un código de verificación al número de celular asociado con la cuenta. El código tiene una validez de 5 minutos. Contacte al propietario de la cuenta de destino para obtener el código.
Source Region	La región desde la cual se distribuyen los dispositivos.
Source Instance	La instancia desde la cual se distribuyen los dispositivos.
Distribution Policy	La directiva utilizada para distribuir los dispositivos. Valores válidos: Update Region: Distribuye los dispositivos a una región específica. Nearest Access: Distribuye los dispositivos a la región más cercana según la dirección IP de los dispositivos. Puede seleccionar una o más regiones.
Destination Region	Si establece el parámetro Distribution Policy en Update Region, este parámetro es obligatorio. Seleccione la región hacia la cual desea distribuir los dispositivos.
Destination Instance	Si establece el parámetro Distribution Policy en Update Region, este parámetro es obligatorio. La instancia hacia la cual desea distribuir los dispositivos. Si establece el parámetro Distribution Method en This Account, debe seleccionar una instancia de destino. Si establece el parámetro Distribution Method en Cross-account, debe especificar un ID de instancia. De lo contrario, se utilizará una instancia pública de la versión anterior. Importante Si la instancia de destino es una nueva instancia pública o una instancia Enterprise Edition, debe especificar un ID de instancia. Para obtener más información, consulte Manage instance endpoints.
Region	Si establece el parámetro Distribution Policy en Nearest Access, este parámetro es obligatorio. Puede seleccionar una o más regiones. Si desea distribuir los dispositivos a la región de origen, selecciónela. Si existen varias instancias en la región de destino, puede seleccionar una instancia de la lista desplegable.
Devices	Puede seleccionar los dispositivos mediante uno de los siguientes métodos: Select: Seleccione un producto de la lista de productos y luego uno o más dispositivos de la lista correspondiente. Los dispositivos permanecerán seleccionados incluso si cambia de página en la lista. Si establece el parámetro Distribution Method en Update Region y no especifica ningún dispositivo, IoT Platform distribuirá únicamente los productos. Choose File: Cargue un archivo que contenga una lista de dispositivos. El archivo debe estar en formato CSV y puede contener hasta 1,000 entradas. Haga clic en Download Template para obtener la plantilla del archivo.

Haga clic en OK.

IoT Platform ejecuta inmediatamente la tarea de distribución.

Si estableció el parámetro Distribution Policy en Update Region, los datos del producto y del dispositivo se distribuyen a la región especificada.
Si estableció el parámetro Distribution Policy en Nearest Access, los datos del producto se distribuyen a las regiones especificadas. Cuando un dispositivo se conecta a IoT Platform, la plataforma distribuye dinámicamente los datos del dispositivo a la región más cercana según la dirección IP del dispositivo.

La siguiente tabla describe los distintos estados de una tarea de distribución. El estado se muestra en la pestaña Batch List.

Estado	Descripción
Initializing	La tarea de distribución se está inicializando.
Distributing	La tarea de distribución se está ejecutando. Si una tarea permanece en este estado durante mucho tiempo, puede hacer clic en Retry en la columna Actions.
Distributed	La tarea de distribución ha finalizado. Este estado no indica que todos los dispositivos se hayan distribuido. Para comprobarlo, haga clic en Download Record en la columna Actions y revise el resultado. Si falta algún dispositivo específico, significa que no se pudo distribuir.
Failed	La tarea de distribución falló debido a inestabilidad en la red. Puede hacer clic en Retry en la columna Actions. Si el problema persiste, contacte al servicio de atención al cliente o envíe un ticket.

Una vez completada la tarea de distribución y cuando el dispositivo se conecte a IoT Platform, este se conectará a la región e instancia de destino siguiendo las operaciones del Paso 2.