Sidewalk 디바이스 대량 프로비저닝 - AWS IoT Wireless
Sidewalk 디바이스 대량 프로비저닝(콘솔)Sidewalk 디바이스 대량 프로비저닝(CLI)가져오기 작업 업데이트 또는 삭제

Sidewalk 디바이스 대량 프로비저닝

이 단원에서는 AWS IoT 콘솔과 AWS CLI를 사용하여 Sidewalk 디바이스를 Amazon Sidewalk용 AWS IoT Core에 대량으로 프로비저닝하는 방법을 보여 줍니다.

Sidewalk 디바이스 대량 프로비저닝(콘솔)

AWS IoT 콘솔을 사용하여 Sidewalk 디바이스를 추가하려면 디바이스 허브의 Sidewalk 탭으로 이동하여 디바이스 대량 프로비저닝을 선택한 후 다음 단계를 수행하세요.

  1. 가져오기 방법 선택

    Amazon Sidewalk용 AWS IoT Core에 대량으로 온보딩할 디바이스를 가져오는 방법을 지정하세요.

    • SMSN을 사용하여 개별 디바이스를 프로비저닝하려면 개별 공장 지원 디바이스 프로비저닝을 선택합니다.

    • 디바이스 목록과 해당 SMS가 포함된 CSV 파일을 제공하여 디바이스를 대량으로 프로비저닝하려면 S3 버킷 사용을 선택합니다.

  2. 온보딩할 디바이스 지정

    디바이스를 온보딩하기 위해 선택한 방법에 따라 디바이스 정보와 일련번호를 추가합니다.

    1. 개별 공장 지원 디바이스 프로비저닝을 선택한 경우 다음 정보를 지정하세요.

      1. 온보딩할 각 디바이스의 이름. 이름은 AWS 계정 및 AWS 리전에서 고유해야 합니다.

      2. SMSN 입력 필드에 디바이스의 Sidewalk 제조 일련번호(SMSN) 제공

      3. 디바이스에서 다른 AWS 서비스로 메시지를 라우팅하는 IoT 규칙을 설명하는 대상

    2. S3 버킷 사용을 선택한 경우:

      1. S3 URL 정보로 구성된 S3 버킷 대상 정보를 제공합니다. CSV 파일을 제공하려면 S3 찾아보기를 선택한 다음 사용하려는 CSV 파일을 선택합니다.

        Amazon Sidewalk용 AWS IoT Core는 S3 버킷에 있는 CSV 파일의 경로인 S3 URL을 자동으로 채웁니다. 경로의 형식은 s3://bucket_name/file_name입니다. Amazon Simple Storage Service 콘솔에서 파일을 보려면 보기를 선택합니다.

      2. 사용자 대신 S3 버킷의 CSV 파일에 대한 액세스를 Amazon Sidewalk용 AWS IoT Core에 허용하는 S3 프로비저닝 역할을 제공합니다. 새로운 서비스 역할을 만들거나 기존 역할을 선택할 수 있습니다.

        새 역할을 생성하려면 역할 이름을 제공할 수도 있고 임의의 이름이 자동으로 생성되도록 비워 둘 수도 있습니다.

      3. 디바이스에서 다른 AWS 서비스로 메시지를 라우팅하는 IoT 규칙을 설명하는 대상을 제공합니다.

  3. 가져오기 작업 시작

    모든 옵션 태그를 이름-값 페어로 제공하고 제출을 선택하여 무선 디바이스 가져오기 작업을 시작합니다.

Sidewalk 디바이스 대량 프로비저닝(CLI)

Sidewalk 디바이스를 Amazon Sidewalk용 AWS IoT Core 계정에 온보딩하려면 디바이스를 개별적으로 추가할지 또는 S3 버킷에 포함된 CSV 파일을 제공할지에 따라 다음 API 작업 중 하나를 사용하세요.

  • S3 CSV 파일을 사용하여 디바이스 대량 업로드

    S3 버킷에 CSV 파일을 제공하여 디바이스를 대량으로 업로드하려면 StartWirelessDeviceImportTask API 작업 또는 start-wireless-device-import-task AWS CLI 명령을 사용합니다. 태스크를 생성할 때 Amazon S3 버킷의 CSV 파일 경로와 CSV 파일에 액세스할 권한을 Amazon Sidewalk용 AWS IoT Core에 부여하는 IAM 역할을 지정합니다.

    태스크가 실행되기 시작하면 Amazon Sidewalk용 AWS IoT Core는 CSV 파일 읽기를 시작하고 파일에 있는 일련번호(SMSN)를 Amazon Sidewalk에서 수신한 제어 로그의 해당 정보와 비교합니다. 일련번호가 일치하면 는 주어진 일련번호에 해당하는 무선 디바이스 레코드를 생성하기 시작합니다.

    다음 명령은 가져오기 작업 생성의 예시를 보여줍니다.

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

    다음은 task.json 파일의 콘텐츠를 보여줍니다.

    task.json의 콘텐츠

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

    이 명령을 실행하면 가져오기 작업의 ID와 ARN이 반환됩니다.

    {    
    "Arn": "arn:aws:iotwireless:us-east-1:123456789012:ImportTask/a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
    "Id": "a1b234c5-67ef-21a2-a1b2-3cd4e5f6789a"
}
  • SMSN을 사용하여 디바이스 개별 프로비저닝

    SMSN을 사용하여 디바이스를 개별적으로 프로비저닝하려면 StartSingleWirelessDeviceImportTask API 작업 또는 start-single-wireless-device-import-task AWS CLI 명령을 사용하세요. 작업을 생성할 때 Sidewalk 대상과 온보딩하려는 디바이스의 일련번호를 지정하세요.

    일련번호가 Amazon Sidewalk에서 수신한 제어 로그의 해당 정보와 일치하면 작업이 실행되고 무선 디바이스 레코드가 생성됩니다.

    다음 명령은 가져오기 작업 생성의 예시를 보여줍니다.

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

    이 명령을 실행하면 가져오기 작업의 ID와 ARN이 반환됩니다.

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

가져오기 작업 업데이트 또는 삭제

가져오기 작업에 디바이스를 더 추가하려는 경우 작업을 업데이트하면 됩니다. 작업이 더 이상 필요하지 않거나 실패한 경우에도 작업을 삭제할 수 있습니다. 작업 업데이트 또는 삭제하는 상황에 대한 자세한 내용은 Sidewalk 대량 프로비저닝 사용 방법 섹션을 참조하세요.

주의

삭제 작업은 영구적이며 취소할 수 없습니다. 이미 성공적으로 완료된 가져오기 작업은 삭제해도 해당 작업을 사용하여 이미 온보딩된 엔드 디바이스는 제거되지 않습니다.

가져오기 작업을 업데이트 또는 삭제하는 방법:

  • AWS IoT 콘솔 사용

    다음 단계에서는 AWS IoT 콘솔을 사용하여 가져오기 작업을 업데이트하거나 삭제하는 방법을 설명합니다.

    가져오기 작업을 업데이트하는 방법:

    1. AWS IoT 콘솔의 Sidewalk 디바이스 허브로 이동합니다.

    2. 업데이트할 가져오기 작업을 선택한 후 편집을 선택합니다.

    3. 작업에 추가할 디바이스의 일련번호가 들어 있는 다른 S3 파일을 제공한 다음 제출을 선택합니다.

    가져오기 작업을 삭제하는 방법:

    1. AWS IoT 콘솔의 Sidewalk 디바이스 허브로 이동합니다.

    2. 삭제하려는 작업을 선택한 다음 삭제를 선택합니다.

  • AWS IoT 무선 API 또는 AWS CLI 사용

    다음 AWS IoT 무선 API 태스크 또는 CLI 명령을 사용하여 가져오기 태스크를 업데이트하거나 삭제합니다.