# Operaciones de API de AWS IoT Core para Amazon Sidewalk para el aprovisionamiento por lotes
Puede realizar las siguientes operaciones de API para el aprovisionamiento por lotes de los dispositivos finales de Sidewalk:
+ API [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) o la CLI [https://docs.aws.amazon.com/cli/latest/reference/start-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/start-wireless-device-import-task.html)
+ API [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) o la CLI [https://docs.aws.amazon.com/cli/latest/reference/start-single-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/start-single-wireless-device-import-task.html)
+ API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListWirelessDeviceImportTasks.html) o la CLI [https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html](https://docs.aws.amazon.com/cli/latest/reference/list-wireless-device-import-tasks.html)
+ API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html) o la CLI [https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/list-devices-for-wireless-device-import-task.html)
+ API [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html) o la CLI [https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html](https://docs.aws.amazon.com/cli/latest/reference/get-wireless-device-import-task.html)
+ 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 la CLI [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)
+ 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 la CLI [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)
En las secciones siguientes se muestra cómo obtener, enumerar, actualizar y eliminar tareas de importación. Para obtener más información acerca de cómo crear tareas de importación, consulte [Operaciones de API de AWS IoT Core para Amazon Sidewalk para el aprovisionamiento por lotes](#iot-sidewalk-apis-provisioning).
## Obtención de información sobre la tarea de importación
Puede utilizar la operación [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListDevicesForWirelessDeviceImportTask.html) de la API para recuperar información sobre una tarea de importación concreta y el estado de incorporación de los dispositivos incluidos en la misma. Como entrada para la operación de la API, especifique el ID de la tarea de importación que obtuvo de las operaciones `StartWirelessDeviceImportTask` o `StartSingleWirelessDeviceImportTask` de la API. A continuación, la API devolverá información sobre la tarea de importación que coincida con el identificador especificado.
El siguiente es un ejemplo del comando de la CLI:
```
aws iotwireless list-devices-for-wireless-device-import-task --id {{e2a5995e-743b-41f2-a1e4-3ca6a5c5249f}}
```
Al ejecutar este comando, se devuelve la información de la tarea de importación y el estado de incorporación del dispositivo.
```
{
"DestinationName": "{{SidewalkDestination}}",
"ImportedWirelessDeviceList": [
{
"Sidewalk": {
"OnboardingStatus": "{{ONBOARDED}}",
"LastUpdateTime": "{{2023-02021T06:11:09.151Z}}",
"SidewalkManufacturingSn": "{{82B83C8B35E856F43CE9C3D59B418CC96B996071016DB1C3BE5901F0F3071A4A}}"
},
"Sidewalk": {
"OnboardingStatus": "{{PENDING}}",
"LastUpdateTime": "{{2023-02021T06:22:12.061Z}}",
"SidewalkManufacturingSn": "{{12345ABCDE6789FABDESBDEF123456789012345FEABC0123679AFEBC01234EF}}"
},
}
]
}
```
## Obtención de un resumen del dispositivo sobre la tarea de importación
Para obtener un resumen de la información sobre el estado de incorporación de los dispositivos que ha añadido a una tarea de importación concreta, utiliza la operación [https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetWirelessDeviceImportTask.html) de la API. El siguiente es un ejemplo del comando de la CLI.
```
aws iotwireless get-wireless-device-import-task --Id {{"e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"}}
```
En el siguiente código, se muestra un ejemplo de respuesta del comando.
```
{
"NumberOfFailedImportedDevices": 2,
"NumberOfOnboardedImportedDevices": 4,
"NumberOfPendingImportedDevices": 1
}
```
## Agregación de dispositivos para importar la tarea
Use la operación `UpdateWirelessDeviceImportTask` de la API para agregar dispositivos a una tarea de importación existente que haya agregado. Puede utilizar esta operación de API para añadir los números de serie (SMSN) de los dispositivos que no estaban incluidos anteriormente en la tarea que creó mediante la operación `StartWirelessDeviceImportTask` de la API.
Para añadir dispositivos a la tarea de importación, como parte de la solicitud de API, especifique un nuevo archivo CSV en un bucket de Amazon S3 que contenga los números de serie de los dispositivos que se van a añadir. La solicitud solo se aceptará si el proceso de incorporación aún no se ha iniciado en el caso de los dispositivos que se encuentran actualmente en la tarea de importación. Si el proceso de incorporación ya se ha iniciado, la solicitud de la API `UpdateWirelessDeviceImportTask` producirá un error.
Si aún quiere añadir dispositivos a la tarea de importación, puede realizar la operación `UpdateWirelessDeviceImportTask` de la API por segunda vez. Antes de realizar esta operación de API, la primera solicitud de la API `UpdateWirelessDeviceImportTask` debe haber completado el procesamiento del archivo CSV en el bucket de S3.
**nota**
Al realizar una solicitud de la `ListImportedWirelessDeviceTasks`, actualmente no se devuelve la URL de S3 del nuevo archivo CSV especificado mediante la operación `UpdateWirelessDeviceImportTask` de la API. En su lugar, la operación de la API devuelve la URL de S3 de la solicitud enviada originalmente mediante la solicitud de la `StartWirelessDeviceImportTask`.
El siguiente es un ejemplo del comando de la CLI.
```
aws iotwireless update-wireless-device-import task \
--Id {{"e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"}} \
--sidewalk '{"FileForCreateDevices": "s3://{{import_task_bucket}}/{{import_file3}}"}'
```
## Enumeración de las tareas de importación en la Cuenta de AWS
Utilice la API `ListWirelessDeviceImportTasks` o el comando `list-imported-wireless-device-tasks` de la CLI para enumerar las tareas de importación en la Cuenta de AWS. El siguiente es un ejemplo del comando de la CLI.
```
aws iotwireless list-wireless-device-import-tasks
```
Al ejecutar este comando, se devuelve una lista de tareas de importación que ha creado. La lista incluye sus archivos CSV de Amazon S3 y el rol de IAM que se especificó, el ID de la tarea de importación y la información resumida del estado de incorporación del dispositivo.
```
{
"ImportWirelessDeviceTaskList": [
{
"FileForCreateDevices": "s3://{{import_task_bucket}}/{{import_file1}}",
"ImportTaskId": "{{e2a5995e-743b-41f2-a1e4-3ca6a5c5249f}}",
"NumberOfFailedImportedDevices": 1,
"NumberOfOnboardedImportedDevices": 3,
"NumberOfPendingImportedDevices": 2,
"Role": "arn:aws:iam::{{123456789012}}:role/{{service-role}}/{{ACF1zBEI}}",
"TimeStamp": "1012202218:23:55"
},
{
"FileForCreateDevices": "s3://{{import_task_bucket}}/{{import_file2}}",
"ImportTaskId": "{{a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a}}",
"NumberOfFailedImportedDevices": 2,
"NumberOfOnboardedImportedDevices": 4,
"NumberOfPendingImportedDevices": 1,
"Role": "arn:aws:iam::{{123456789012}}:role/{{service-role}}/{{CDEFaBC1}}",
"TimeStamp": "1201202210:12:20"
}
]
}
```
## Eliminación de las tareas de importación de la Cuenta de AWS
Para eliminar una tarea de importación, pase el ID de dicha tarea a la operación `DeleteWirelessDeviceImportTask` de la API o al comando `delete-wireless-device-import-task` de la CLI.
**aviso**
Las acciones de eliminación no se pueden deshacer. La tarea de importación se eliminará permanentemente de la Cuenta de AWS.
Cuando se realiza la solicitud a la API `DeleteWirelessDeviceImportTask`, se inicia un proceso en segundo plano para eliminar la tarea de importación. Cuando la solicitud está en curso, se van eliminando los números de serie (SMSN) de los dispositivos incluidos en las tareas de importación. Solo cuando se haya completado la eliminación, podrá ver esta información mediante las operaciones `ListImportedWirelessDeviceTasks` o `GetImportedWirelessDeviceTasks` de la API.
Si una tarea de importación aún contiene dispositivos a la espera de su incorporación, la solicitud `DeleteWirelessDeviceImportTask` de la API se procesará solo después de que todos los dispositivos de la tarea de importación se hayan incorporado o no se haya podido hacerlo. Una tarea de importación caduca a los 90 días y, una vez caducada, se puede eliminar de la cuenta. Sin embargo, los dispositivos que se hayan incorporado correctamente mediante la tarea de importación no se eliminarán.
**nota**
Si intenta crear otra tarea de importación que incluya el número de serie de un dispositivo que está pendiente de eliminación mediante la solicitud `DeleteWirelessDeviceImportTask` de la API, la operación `StartWirelessDeviceImportTask` de la API devolverá un error.
El siguiente es un ejemplo del comando de la CLI:
```
aws iotwireless delete-import-task --Id "{{e2a5995e-743b-41f2-a1e4-3ca6a5c5249f}}"
```
Este comando no proporciona ninguna salida. Una vez eliminada la tarea, para comprobar que la tarea de importación se ha eliminado de la cuenta, puede usar la operación `GetWirelessDeviceImportTask` o `ListWirelessDeviceImportTasks` de la API.