# Operazioni API AWS IoT Core per Amazon Sidewalk per il provisioning in blocco
È possibile eseguire le seguenti operazioni API per il provisioning in blocco dei dispositivi finali 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 interfaccia a riga di comando [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 interfaccia a riga di comando [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 interfaccia a riga di comando [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 interfaccia a riga di comando [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 interfaccia a riga di comando [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 interfaccia a riga di comando [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 interfaccia a riga di comando [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)
Nelle sezioni seguenti viene illustrato come ottenere, elencare, aggiornare ed eliminare le attività di importazione. Per ulteriori informazioni sulla creazione di attività di importazione, consultare [Operazioni API AWS IoT Core per Amazon Sidewalk per il provisioning in blocco](#iot-sidewalk-apis-provisioning).
## Ottenere informazioni sull'attività di importazione
È possibile utilizzare l'operazione 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) per recuperare informazioni su una particolare attività di importazione e sullo stato di onboarding dei dispositivi in tale attività. Come input per l'operazione API, specifica l'ID dell'attività di importazione ottenuto dalle operazioni API `StartWirelessDeviceImportTask` o `StartSingleWirelessDeviceImportTask`. L'API restituirà quindi le informazioni sull'attività di importazione corrispondenti all'identificatore specificato.
Di seguito viene illustrato un esempio del comando dell'interfaccia a riga di comando:
```
aws iotwireless list-devices-for-wireless-device-import-task --id e2a5995e-743b-41f2-a1e4-3ca6a5c5249f
```
L'esecuzione di questo comando restituisce le informazioni sull'attività di importazione e lo stato di onboarding 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"
},
}
]
}
```
## Ottenere il riepilogo delle attività di importazione dei dispositivi
Per ottenere un conteggio delle informazioni di riepilogo dello stato di onboarding dei dispositivi aggiunti a una particolare attività di importazione, utilizza l'operazione 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). Di seguito viene illustrato un esempio del comando dell'interfaccia a riga di comando.
```
aws iotwireless get-wireless-device-import-task --Id "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
```
Il codice riportato di seguito mostra una risposta di esempio del comando.
```
{
"NumberOfFailedImportedDevices": 2,
"NumberOfOnboardedImportedDevices": 4,
"NumberOfPendingImportedDevices": 1
}
```
## Aggiunta di dispositivi all'attività di importazione
Utilizza l'operazione API `UpdateWirelessDeviceImportTask` per aggiungere dispositivi a un'attività di importazione esistente aggiunta. Puoi utilizzare questa operazione API per aggiungere i numeri di serie (SMSN) dei dispositivi che in precedenza non erano inclusi nell'attività creata utilizzando l'operazione API `StartWirelessDeviceImportTask`.
Per aggiungere dispositivi all'attività di importazione, come parte della richiesta API, specifica un nuovo file CSV in un bucket Amazon S3 contenente i numeri di serie dei dispositivi da aggiungere. La richiesta verrà accettata solo se il processo di onboarding non è già stato avviato per i dispositivi attualmente contenuti nell'attività di importazione. Se il processo di onboarding è già stato avviato, la richiesta API `UpdateWirelessDeviceImportTask` non andrà a buon fine.
Se desideri comunque aggiungere dispositivi all'attività di importazione, puoi eseguire l'operazione API `UpdateWirelessDeviceImportTask` una seconda volta. Prima di eseguire questa operazione API, la prima richiesta API `UpdateWirelessDeviceImportTask` deve aver completato l'elaborazione del file CSV nel bucket S3.
**Nota**
Quando esegui una richiesta API `ListImportedWirelessDeviceTasks`, l'URL S3 del nuovo file CSV specificato utilizzando l'operazione API `UpdateWirelessDeviceImportTask` non viene attualmente restituito. L'operazione API restituisce invece l'URL S3 della richiesta inviata originariamente utilizzando la richiesta API `StartWirelessDeviceImportTask`.
Di seguito viene illustrato un esempio del comando dell'interfaccia a riga di comando.
```
aws iotwireless update-wireless-device-import task \
--Id "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f" \
--sidewalk '{"FileForCreateDevices": "s3://import_task_bucket/import_file3"}'
```
## Elencare le attività di importazione in Account AWS
Utilizza l'API `ListWirelessDeviceImportTasks` o il comando dell'interfaccia a riga di comando `list-imported-wireless-device-tasks` per elencare le attività di importazione in Account AWS. Di seguito viene illustrato un esempio del comando dell'interfaccia a riga di comando.
```
aws iotwireless list-wireless-device-import-tasks
```
L'esecuzione di questo comando restituisce un elenco delle attività di importazione create. L'elenco include i file CSV di Amazon S3 e il ruolo IAM specificato, l'ID dell'attività di importazione e informazioni di riepilogo dello stato di inserimento 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"
}
]
}
```
## Eliminazione delle attività di importazione da Account AWS
Per eliminare un'attività di importazione, passa l'ID dell'attività di importazione all'operazione API `DeleteWirelessDeviceImportTask` o al comando dell'interfaccia a riga di comando `delete-wireless-device-import-task`.
**avvertimento**
Le operazioni di eliminazione non possono essere annullate. L'attività di importazione verrà rimossa definitivamente da Account AWS.
Quando esegui la richiesta API `DeleteWirelessDeviceImportTask`, un processo in background avvia l'eliminazione dell'attività di importazione. Quando la richiesta è in corso, i numeri di serie (SMSN) dei dispositivi nelle attività di importazione sono inclusi nel processo di eliminazione. Solo dopo il completamento dell'eliminazione potrai visualizzare queste informazioni utilizzando le operazioni API `ListImportedWirelessDeviceTasks` o `GetImportedWirelessDeviceTasks`.
Se un'attività di importazione contiene ancora dispositivi per i quali non è ancora stato eseguito l'onboarding, la richiesta API `DeleteWirelessDeviceImportTask` verrà elaborata solo dopo che sarà stato eseguito l'onboarding di tutti i dispositivi nell'attività di importazione o l'onboarding non è andato a buon fine. Un'attività di importazione scade dopo 90 giorni e, una volta scaduta, può essere eliminata dall'account. Tuttavia, i dispositivi che per i quali è stato eseguito l'onboarding utilizzando l'attività di importazione non verranno eliminati.
**Nota**
Se tenti di creare un'altra attività di importazione che include il numero di serie di un dispositivo in attesa di eliminazione utilizzando la richiesta API `DeleteWirelessDeviceImportTask`, l'operazione API `StartWirelessDeviceImportTask` restituirà un errore.
Di seguito viene illustrato un esempio del comando dell'interfaccia a riga di comando:
```
aws iotwireless delete-import-task --Id "e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"
```
Il comando non produce output. Dopo che l'attività è stata eliminata, per verificare che l'attività di importazione sia stata rimossa dall'account, puoi utilizzare l'operazione API `GetWirelessDeviceImportTask` o `ListWirelessDeviceImportTasks`.