# 대량 프로비저닝을 위한 AWS IoT Core for Amazon Sidewalk API 작업
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) API 또는 [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) CLI
+ [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) API 또는 [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) CLI
+ [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) API 또는 [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) CLI
+ [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) API 또는 [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) CLI
+ [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) API 또는 [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) CLI
+ [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) API 또는 [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) CLI
+ [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) API 또는 [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) CLI
다음 섹션에서는 가져오기 작업을 가져오고, 나열하고, 업데이트하고, 삭제하는 방법을 보여줍니다. 가져오기 작업 생성에 대한 자세한 내용은 [대량 프로비저닝을 위한 AWS IoT Core for Amazon Sidewalk API 작업](#iot-sidewalk-apis-provisioning) 섹션을 참조하세요.
## 가져오기 작업에 대한 정보 가져오기
[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) API 작업을 사용하여 특정 가져오기 작업과 해당 작업에 포함된 디바이스의 온보딩 상태에 대한 정보를 검색할 수 있습니다. `StartWirelessDeviceImportTask` 또는 `StartSingleWirelessDeviceImportTask` API 작업에서 얻은 가져오기 작업 ID를 API 작업에 대한 입력으로 지정하세요. 그러면 API가 지정된 식별자와 일치하는 가져오기 작업에 대한 정보를 반환합니다.
다음은 CLI 명령의 예시입니다.
```
aws iotwireless list-devices-for-wireless-device-import-task --id {{e2a5995e-743b-41f2-a1e4-3ca6a5c5249f}}
```
이 명령을 실행하면 가져오기 작업 정보와 디바이스 온보딩 상태가 반환됩니다.
```
{
"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}}"
},
}
]
}
```
## 가져오기 작업 디바이스 요약 가져오기
특정 가져오기 작업에 추가한 디바이스의 온보딩 상태에 대한 요약 정보의 수를 가져오려면 [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) API 작업을 사용하세요. 다음은 CLI 명령의 예시입니다.
```
aws iotwireless get-wireless-device-import-task --Id {{"e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"}}
```
다음 코드는 명령의 샘플 응답을 보여줍니다.
```
{
"NumberOfFailedImportedDevices": 2,
"NumberOfOnboardedImportedDevices": 4,
"NumberOfPendingImportedDevices": 1
}
```
## 가져오기 작업에 디바이스 추가
`UpdateWirelessDeviceImportTask` API 작업을 사용하여 추가한 기존 가져오기 작업에 디바이스를 추가합니다. `StartWirelessDeviceImportTask` API 작업을 사용하여 생성한 작업에 이전에 포함되지 않았던 디바이스의 일련번호(SMSN)를 추가하는 데 이 API 작업을 사용할 수 있습니다.
디바이스를 가져오기 작업에 추가하려면 API 요청의 일부로 추가할 디바이스의 일련번호가 포함된 Amazon S3 버킷에 새 CSV 파일을 지정하세요. 요청은 현재 가져오기 작업 중인 디바이스에 대한 온보딩 프로세스가 아직 시작되지 않은 경우에만 수락됩니다. 온보딩 프로세스가 이미 시작된 경우 `UpdateWirelessDeviceImportTask` API 요청은 실패합니다.
여전히 가져오기 작업에 디바이스를 추가하려는 경우 `UpdateWirelessDeviceImportTask` API 작업을 다시 수행할 수 있습니다. 이 API 작업을 수행하기 전에 첫 번째 `UpdateWirelessDeviceImportTask` API 요청에서 S3 버킷의 CSV 파일 처리가 완료된 상태여야 합니다.
**참고**
`ListImportedWirelessDeviceTasks` API 요청을 수행할 때 `UpdateWirelessDeviceImportTask` API 작업을 사용하여 지정된 새 CSV 파일의 S3 URL은 현재 반환되지 않습니다. 대신 API 작업은 원래 `StartWirelessDeviceImportTask` API 요청을 사용하여 전송된 요청의 S3 URL을 반환합니다.
다음은 CLI 명령의 예시입니다.
```
aws iotwireless update-wireless-device-import task \
--Id {{"e2a5995e-743b-41f2-a1e4-3ca6a5c5249f"}} \
--sidewalk '{"FileForCreateDevices": "s3://{{import_task_bucket}}/{{import_file3}}"}'
```
## AWS 계정에서 가져오기 작업 나열
`ListWirelessDeviceImportTasks` API 또는 `list-imported-wireless-device-tasks` CLI 명령을 사용하여 AWS 계정에서 가져오기 작업을 나열합니다. 다음은 CLI 명령의 예시입니다.
```
aws iotwireless list-wireless-device-import-tasks
```
이 명령을 실행하면 생성한 가져오기 작업 목록이 반환됩니다. 목록에는 Amazon S3 CSV 파일과 지정된 IAM 역할, 가져오기 작업 ID, 디바이스 온보딩 상태의 요약 정보가 포함됩니다.
```
{
"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"
}
]
}
```
## AWS 계정에서 가져오기 작업 삭제
가져오기 작업을 삭제하려면 가져오기 작업 ID를 `DeleteWirelessDeviceImportTask` API 작업 또는 `delete-wireless-device-import-task` CLI 명령에 전달하세요.
**주의**
삭제 작업은 취소할 수 없습니다. 가져오기 작업이 AWS 계정에서 영구적으로 제거됩니다.
`DeleteWirelessDeviceImportTask` API 요청을 수행할 때 백그라운드 프로세스가 가져오기 작업을 삭제하기 시작합니다. 요청이 진행 중이면 가져오기 작업에 있는 디바이스의 일련번호(SMSN)가 삭제되는 중입니다. 삭제가 완료된 후에야 `ListImportedWirelessDeviceTasks` 또는 `GetImportedWirelessDeviceTasks` API 작업을 사용하여 이 정보를 볼 수 있습니다.
가져오기 작업에 여전히 온보딩 대기 중인 디바이스가 포함되어 있는 경우, 가져오기 작업에 포함된 모든 디바이스가 온보딩되거나 온보딩에 실패한 후에만 `DeleteWirelessDeviceImportTask` API 요청이 처리됩니다. 가져오기 작업은 90일 후에 만료되며 작업이 만료되면 계정에서 삭제할 수 있습니다. 하지만 가져오기 작업을 사용하여 성공적으로 온보딩된 디바이스는 삭제되지 않습니다.
**참고**
`DeleteWirelessDeviceImportTask` API 요청을 사용하여 삭제 보류 중인 디바이스의 일련번호가 포함된 다른 가져오기 작업을 생성하려고 하면 `StartWirelessDeviceImportTask` API 작업에서 오류가 반환됩니다.
다음은 CLI 명령의 예시입니다.
```
aws iotwireless delete-import-task --Id "{{e2a5995e-743b-41f2-a1e4-3ca6a5c5249f}}"
```
이 명령은 출력을 생성하지 않습니다. 작업이 삭제된 후 계정에서 가져오기 작업이 제거되었는지 확인하려면 `GetWirelessDeviceImportTask` API 작업 또는 `ListWirelessDeviceImportTasks` API 작업을 사용하면 됩니다.