# 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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk), 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**.
1.
**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.
1. Su número de serie de fabricación de Sidewalk (SMSN) en el campo **Escriba SMSN**.
1. Un **Destino** que describa la regla de IoT para enrutar los mensajes del dispositivo a otros Servicios de AWS.
1. 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](https://console.aws.amazon.com/s3/), seleccione **Ver**.
1. 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.
1. Proporcione un **Destino** que describa la regla de IoT para enrutar los mensajes del dispositivo a otros Servicios de AWS.
1. 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartWirelessDeviceImportTask.html) de la API o el comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-wireless-device-import-task.html) 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 [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_StartSingleWirelessDeviceImportTask.html) de la API o el comando [https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/iotwireless/start-single-wireless-device-import-task.html) 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](sidewalk-provision-bulk-import.md#provision-bulk-use).
**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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) de la consola de AWS IoT.
1. Seleccione la tarea de importación que desea actualizar y, a continuación, elija **Editar**.
1. 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](https://console.aws.amazon.com/iot/home#/wireless/devices?tab=sidewalk) de la consola de AWS IoT.
1. 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.
+
**API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateWirelessDeviceImportTask.html) o [https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/update-wireless-device-import-task.html) de la CLI**
Esta operación de API adjunta el contenido de un archivo CSV de Amazon S3 a una tarea de importación existente. Solo puede añadir números de serie de dispositivos no incluidos anteriormente en la tarea.
+
**API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_DeleteWirelessDeviceImportTask.html) o [https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/delete-wireless-device-import-task.html) de la CLI**
Esta operación de API elimina la tarea de importación que se marcó para su eliminación mediante su ID.