Aprovisionamiento de los dispositivos de Sidewalk por lotes - AWS IoT Wireless
Aprovisionamiento de los dispositivos de Sidewalk por lotes (consola)Aprovisionamiento de los dispositivos de Sidewalk por lotes (CLI)Actualización o eliminación de las tareas de importación

Aprovisionamiento de los dispositivos de Sidewalk por lotes

En esta sección, se muestra cómo puede aprovisionar dispositivos Sidewalk de forma masiva a AWS IoT Core para Amazon Sidewalk mediante la consola de AWS IoT y la AWS CLI.

Aprovisionamiento de los dispositivos de Sidewalk por lotes (consola)

Para añadir el dispositivo de Sidewalk mediante la consola de AWS IoT, vaya a la pestaña Sidewalk del Centro de dispositivos, seleccione Aprovisionar dispositivos por lotes y, a continuación, lleve a cabo los siguientes pasos.

  1. Elección del método de importación

    Especifique cómo quiere importar los dispositivos que se van a incorporar de forma masiva a AWS IoT Core para Amazon Sidewalk.

    • Para aprovisionar dispositivos individuales mediante su SMSN, elija Aprovisionar un dispositivo individual con soporte técnico de fábrica.

    • Para aprovisionar dispositivos por lotes mediante un archivo CSV que contenga una lista de dispositivos y sus SMSN, elija Usar un bucket de S3.

  2. Especificación de los dispositivos que se van a incorporar

    En función del método que haya elegido para incorporar los dispositivos, añada la información de los dispositivos y sus números de serie.

    1. Si eligió Aprovisionar un dispositivo individual con soporte técnico de fábrica, especifique la siguiente información:

      1. Un Nombre para cada dispositivo que se va a incorporar. El nombre debe ser único en su Cuenta de AWS y Región de AWS.

      2. Su número de serie de fabricación de Sidewalk (SMSN) en el campo Escriba SMSN.

      3. Un Destino que describa la regla de IoT para enrutar los mensajes del dispositivo a otros Servicios de AWS.

    2. Si eligió Usar un bucket de S3:

      1. Proporcione la información de Destino del bucket de S3, que consiste en la información de la URL de S3. Para proporcionar su archivo CSV, elija Examinar S3 y, a continuación, elija el archivo CSV que desee usar.

        AWS IoT Core para Amazon Sidewalk rellena automáticamente la URL de S3, que es la ruta al archivo CSV en el bucket de S3. El formato de la ruta es s3://bucket_name/file_name. Para ver el archivo en la consola de Amazon Simple Storage Service, seleccione Ver.

      2. Proporcione el Rol de aprovisionamiento de S3, con el que AWS IoT Core para Amazon Sidewalk podrá acceder al archivo CSV del bucket de S3 en su nombre. Puede crear un nuevo rol de servicio o elegir uno existente.

        Para crear un nuevo rol, puede proporcionar un Nombre de rol o dejarlo en blanco para que se genere automáticamente un nombre aleatorio.

      3. Proporcione un Destino que describa la regla de IoT para enrutar los mensajes del dispositivo a otros Servicios de AWS.

  3. Inicio de la tarea de importación

    Proporcione las etiquetas opcionales como pares de nombre-valor y pulse Enviar para iniciar la tarea de importación de dispositivos inalámbricos.

Aprovisionamiento de los dispositivos de Sidewalk por lotes (CLI)

A fin de incorporar los dispositivos Sidewalk a su cuenta para AWS IoT Core para Amazon Sidewalk, utilice cualquiera de las siguientes operaciones API, en función de si desea añadir los dispositivos de forma individual o proporcionando el archivo CSV contenido en un bucket de S3.

  • Carga de dispositivos por lotes mediante un archivo CSV de S3

    Para cargar dispositivos por lotes proporcionando el archivo CSV en un bucket de S3, utilice la operación StartWirelessDeviceImportTask de la API o el comando start-wireless-device-import-task de la AWS CLI. Al crear la tarea, especifique la ruta al archivo CSV en el bucket de Amazon S3 y el rol de IAM que concede a AWS IoT Core para Amazon Sidewalk los permisos necesarios para acceder al archivo CSV.

    Cuando la tarea comience a ejecutarse, AWS IoT Core para Amazon Sidewalk empezará a leer el archivo CSV y comparará los números de serie (SMSN) del archivo con la información correspondiente del registro de control recibido de Amazon Sidewalk. Si los números de serie coinciden, empezará a crear registros de dispositivos inalámbricos correspondientes a dichos números de serie.

    El comando siguiente muestra un ejemplo de creación de una tarea de importación:

    aws iotwireless start-wireless-device-import-task \ 
    --cli-input-json "file://task.json"

    A continuación se muestra el contenido del archivo task.json.

    Contenido de task.json

    {
    "DestinationName": "Sidewalk_Destination",
    "Sidewalk": {
        "DeviceCreationFile": "s3://import_task_bucket/import_file1", 
        "Role": "arn:aws:iam::123456789012:role/service-role/ACF1zBEI"     
    }
}

    La ejecución de este comando devuelve un ID y un ARN para la tarea de importación.

    {    
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
    "Id": "a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
}
  • Aprovisionamiento de los dispositivos de forma individual mediante su SMSN

    Para aprovisionar los dispositivos de forma individual mediante su SMSN, utilice la operación StartSingleWirelessDeviceImportTask de la API o el comando start-single-wireless-device-import-task de la AWS CLI. Al crear la tarea, especifique el destino de Sidewalk y el número de serie del dispositivo que desea incorporar.

    Cuando el número de serie coincida con la información correspondiente del registro de control recibido de Amazon Sidewalk, la tarea se ejecutará y se creará el registro del dispositivo inalámbrico.

    El comando siguiente muestra un ejemplo de creación de una tarea de importación:

    aws iotwireless start-single-wireless-device-import-task \ 
    --destination-name sidewalk_destination \    
    --sidewalk '{"SidewalkManufacturingSn": "82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A"}'

    La ejecución de este comando devuelve un ID y un ARN para la tarea de importación.

    {
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"    
    "Id": "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
}

Actualización o eliminación de las tareas de importación

Si desea añadir dispositivos adicionales a una tarea de importación, puede actualizarla. También puede eliminar una tarea si ya no la necesita o si ha producido un error. Para obtener información sobre cuándo actualizar o eliminar una tarea, consulte Cómo utilizar el aprovisionamiento por lotes de Sidewalk.

aviso

Las acciones de eliminación son permanentes y no se pueden deshacer. Al eliminar una tarea de importación que ya se ha completado correctamente, no se eliminarán los dispositivos finales que ya se han incorporado mediante la misma.

Para actualizar o eliminar las tareas de importación:

  • Mediante la consola de AWS IoT

    En los pasos siguientes se explica cómo actualizar o eliminar las tareas de importación mediante la consola de AWS IoT.

    Para actualizar una tarea de importación:

    1. Vaya al Centro de dispositivos de Sidewalk de la consola de AWS IoT.

    2. Seleccione la tarea de importación que desea actualizar y, a continuación, elija Editar.

    3. Proporcione otro archivo de S3 que contenga los números de serie de los dispositivos que desee añadir a la tarea y, a continuación, seleccione Enviar.

    Para eliminar una tarea de importación:

    1. Vaya al Centro de dispositivos de Sidewalk de la consola de AWS IoT.

    2. Seleccione la tarea que desea eliminar y, a continuación, haga clic en Eliminar.

  • Uso de la API AWS IoT Wireless o la AWS CLI

    Utilice las siguientes operaciones API AWS IoT Wireless o comandos de la CLI para actualizar o eliminar la tarea de importación.