간단한 설정을 사용하여 디바이스 온보딩 및 운영 - 에 대한 관리형 통합 AWS IoT Device Management
사전 조건

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

간단한 설정을 사용하여 디바이스 온보딩 및 운영

관리형 사물을 생성하고 허브에 연결하여 관리형 통합 허브에 온보딩되도록 디바이스를 설정합니다. 이 섹션에서는 간단한 설정을 사용하여 디바이스 온보딩 프로세스를 완료하는 단계를 설명합니다.

사전 조건

디바이스 온보딩을 시도하기 전에 다음 단계를 완료합니다.

1단계: 자격 증명 로커 생성

디바이스에 대한 자격 증명 로커를 생성합니다.

자격 증명 로커를 생성하려면

  • create-credential-locker 명령을 사용합니다. 이 명령을 실행하면 Wi-Fi 설정 키 페어 및 디바이스 인증서를 포함한 모든 제조 리소스가 생성됩니다.

    create-credential-locker 예

    aws iot-managed-integrations create-credential-locker \
  --name "DEVICE_NAME"

    응답:

    {    
  "Id": "LOCKER_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:credential-locker/LOCKER_ID
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    자세한 내용은 관리형 통합 명령 참조의 create-credential-locker 명령을 참조하세요 AWS CLI .

2단계: 허브에 자격 증명 로커 추가

허브에 자격 증명 로커를 추가합니다.

허브에 자격 증명 로커를 추가하려면

  • 다음 명령을 사용하여 허브에 자격 증명 로커를 추가합니다.

    aws iotmi --region AWS_REGION --endpoint AWS_ENDPOINT update-managed-thing \
--identifier "HUB_MANAGED_THING_ID" --credential-locker-id "LOCKER_ID"

3단계: 자격 증명으로 관리형 사물을 생성합니다.

디바이스의 자격 증명을 사용하여 관리형 사물을 생성합니다. 각 디바이스에는 자체 관리형 사물이 필요합니다.

관리형 사물을 생성하려면

  • create-managed-thing 명령을 사용하여 디바이스에 대한 관리형 사물을 생성합니다.

    create-managed-thing 예

    #ZWAVE: 
aws iot-managed-integrations create-managed-thing --role DEVICE \
--authentication-material '900137947003133...' \ #auth material from zwave qr code
--authentication-material-type ZWAVE_QR_BAR_CODE \
--credential-locker-id ${locker_id}

#ZIGBEE:
aws iot-managed-integrations create-managed-thing --role DEVICE \
--authentication-material 'Z:286...$I:A4DC00.' \ #auth material from zigbee qr code
--authentication-material-type ZIGBEE_QR_BAR_CODE \
--credential-locker-id ${locker_id}
    참고

    Z-wave 및 Zigbee 디바이스에는 별도의 명령이 있습니다.

    응답:

    {    
  "Id": "DEVICE_MANAGED_THING_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/DEVICE_MANAGED_THING_ID"
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    자세한 내용은 관리형 통합 명령 참조의 create-managed-thing 명령을 참조하세요 AWS CLI .

4단계: 디바이스를 연결하고 상태를 확인합니다.

디바이스를 연결하고 상태를 확인합니다.

  • get-managed-thing 명령을 사용하여 디바이스의 상태를 확인합니다.

    get-managed-thing 예

    #KINESIS NOTIFICATION:
{
    "version": "1.0.0",
    "messageId": "4ac684bb7f4c41adbb2eecc1e7991xxx",
    "messageType": "DEVICE_LIFE_CYCLE",
    "source": "aws.iotmanagedintegrations",
    "customerAccountId": "12345678901",
    "timestamp": "2025-06-10T05:30:59.852659650Z",
    "region": "us-east-1",
    "resources": ["XXX"],
    "payload": {
        "deviceDetails": {
            "id": "1e84f61fa79a41219534b6fd57052XXX",
            "arn": "XXX",
            "createdAt": "2025-06-09T06:24:34.336120179Z",
            "updatedAt": "2025-06-10T05:30:59.784157019Z"
        },
        "status": "ACTIVATED"
    }
}
aws iot-managed-integrations get-managed-thing \
--identifier :"DEVICE_MANAGED_THING_ID"

    응답:

    {    
  "Id": "DEVICE_MANAGED_THING_ID"
  "Arn": "arn:aws:iotmanagedintegrations:AWS_REGION:AWS_ACCOUNT_ID:managed-thing/MANAGED_THING_ID"
  "CreatedAt": "2025-06-09T13:58:52.977000+08:00"
}

    자세한 내용은 관리형 통합 명령 참조의 get-managed-thing 명령을 참조하세요 AWS CLI .

5단계: 디바이스 기능 가져오기

get-managed-thing-capabilities 명령을 사용하여 엔드포인트 ID를 가져오고 디바이스에 대해 가능한 작업 목록을 봅니다.

디바이스의 기능을 가져오려면

  • get-managed-thing-capabilities 명령을 사용하고 엔드포인트 ID를 기록해 둡니다.

    get-managed-thing-capabilties 예

    aws iotmi get-managed-thing-capabilities \
--identifier "DEVICE_MANAGED_THING_ID"

    응답:

    {    
    "ManagedThingId": "1e84f61fa79a41219534b6fd57052cbc",
    "CapabilityReport": {
        "version": "1.0.0",
        "nodeId": "zw.FCB10009+06",
        "endpoints": [
            {
                "id": "ENDPOINT_ID"
                "deviceTypes": [
                    "On/Off Switch"
                ],
                "capabilities": [
                    {
                        "id": "matter.OnOff@1.4",
                        "name": "On/Off",
                        "version": "6",
                        "properties": [
                            "OnOff"
                        ],
                        "actions": [
                            "Off",
                            "On"
                        ],
                        "events": []
                    }
                    ...
}

    자세한 내용은 관리형 통합 명령 참조의 get-managed-thing-capabilities 명령을 참조하세요 AWS CLI .

6단계: 관리형 사물에 명령 전송

send-managed-thing-command 명령을 사용하여 토글 작업 명령을 관리형 사물로 보냅니다.

관리형 사물에 명령을 보내려면

  • send-managed-thing-command 명령을 사용하여 관리형 사물에 명령을 보냅니다.

    send-managed-thing-command 예

    json=$(jq -cr '.|@json') <<EOF
[
  {
    "endpointId": "1",
    "capabilities": [
      {
        "id": "matter.OnOff@1.4",
        "name": "On/Off",
        "version": "1",
        "actions": [
          {
            "name": "Toggle",
            "parameters": {}
          }
        ]
      }
    ]
  }
]
EOF
aws iot-managed-integrations send-managed-thing-command \
--managed-thing-id "DEVICE_MANAGED_THING_ID" --endpoints "ENDPOINT_ID"
    참고

    이 예제에서는 jq cli를에 사용하지만 전체 endpointId 문자열을 전달할 수도 있습니다.

    응답:

    {    
"TraceId": "TRACE_ID"
}

    자세한 내용은 관리형 통합 명령 참조의 send-managed-thing-command 명령을 참조하세요 AWS CLI .

7단계: 허브에서 관리형 사물 제거

관리형 사물을 제거하여 허브를 정리합니다.

관리형 사물을 삭제하려면

  • delete-managed-thing 명령을 사용하여 디바이스 허브에서 관리형 사물을 제거합니다.

    delete-managed-thing 예

    aws iot-managed-integrations delete-managed-thing \
--identifier "DEVICE_MANAGED_THING_ID"

    자세한 내용은 관리형 통합 명령 참조의 delete-managed-thing 명령을 참조하세요 AWS CLI .

    참고

    디바이스가 DELETE_IN_PROGRESS 상태로 멈춘 경우 --force 플래그를에 추가합니다delete-managed-thing command.

    참고

    Z파 디바이스의 경우 명령을 실행한 후 디바이스를 페어링 모드로 전환해야 합니다.