투케이2K

184. (Aws/Amazon) [Aws Iot Core] 특정 사물 메타 데이터 업데이트 이벤트 감지 토픽 설명 - $aws/events/thing/thingName/update 본문

Aws (Amazon)

184. (Aws/Amazon) [Aws Iot Core] 특정 사물 메타 데이터 업데이트 이벤트 감지 토픽 설명 - $aws/events/thing/thingName/update

투케이2K 2026. 2. 19. 19:46
728x90
반응형

[개발 환경 설정]

개발 환경 : Aws / Amazon Web Services

 

[설명 정리]

// --------------------------------------------------------------------------------------
[개발 및 환경]
// --------------------------------------------------------------------------------------

- 인프라 : Aws / Amazon Web Services


- 기술 구분 : Aws / Aws Iot Core / events / meta data


- 사전) Aws Iot Core 간단 설명 : 

  >> AWS IoT 는 IoT 디바이스를 다른 디바이스 및 AWS 클라우드 서비스에 연결하는 클라우드 서비스를 제공합니다.

  >> 디바이스가에 연결할 수 있는 경우 AWS IoT는 AWS 가 제공하는 클라우드 서비스에 디바이스를 AWS IoT 연결할 수 있습니다.

  >> AWS IoT Core 메시지 브로커는 MQTT 및 MQTT over WSS 프로토콜을 사용하여 메시지를 게시하고 구독하는 디바이스 및 클라이언트를 지원합니다. 
  
    - HTTPS 프로토콜을 사용하여 메시지를 게시하는 디바이스와 클라이언트도 지원합니다.


- 사전) 메타 데이터(metadata) 간단 설명 : 

  >> 메타 데이터란 '데이터에 대한 데이터' 를 의미합니다.

  >> 메타 데이터는 실제 값(value) 이 아니라 그 값이 언제, 어떻게, 어떤 출처로 생성·변경되었는지 같은 부가 정보입니다.

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[설 명] 
// --------------------------------------------------------------------------------------

1. AWS IoT Core 에서는 $aws/events/thing/{thingName}/updated 토픽을 사용해 '특정 사물 (Thing) 의 메타데이터가 업데이트' 되는 이벤트를 감지 할 수 있습니다

  >> thingName 설명 참고 사항 : <thingName> 는 Aws Iot Core 에 등록 된 특정 ThingName 사물 명칭입니다


2. $aws/events/thing/{thingName}/updated 토픽은 자동으로 발행되는 MQTT 이벤트 메시지 토픽으로 AWS IoT가 Thing 속성이 변경되었음을 시스템적으로 알려주는 알림(Notification) 역할을 합니다.


3. $aws/events/thing/{thingName}/updated 토픽 이벤트가 발행되는 상황 : 

  >> $aws/events/thing/{thingName}/updated 토픽은 다음과 같이 사물 (Thing) 의 등록 정보가 변경될 때 발행됩니다

  >> Thing 의 속성 (attributes) 수정

  >> Thing 의 Thing Type 변경

  >> 기타 메타데이터 업데이트

  >> 🟡 (주의) $aws/events/thing/{thingName}/updated 토픽은 AWS IoT Core Shadow 페이로드 정보 변경에 대해서는 동작 되지 않습니다!

    - 디바이스가 MQTT로 전송하는 메시지가 아니라, AWS IoT Registry 가 내부적으로 발생시키는 시스템 이벤트라는 점이 중요합니다.


4. ✅ $aws/events/thing/{thingName}/updated 토픽 이벤트 발생 예시 페이로드 정보 : 

  {
    "eventType": "THING_EVENT",
    "eventId": "f5ae9b94-8b8e-4d8e-8c8f-b3266dd89853",
    "timestamp": 1234567890123,
    "operation": "UPDATED",
    "accountId": "123456789012",
    "thingId": "b604f69c-aa9a-4d4a-829e-c480e958a0b5",
    "thingName": "MyThing",
    "versionNumber": 2,
    "thingTypeName": null,
    "attributes": {
      "attribute1": "value1",
      "attribute2": "value2",
      "attribute3": "value3"
    }
  }


5. ✅ $aws/events/thing/{thingName}/updated 토픽 페이로드 주요 필드 설명 : 

  >> eventType : 항상 "THING_EVENT"  

  >> operation : "UPDATED" — 업데이트 이벤트

  >> thingName : 업데이트된 Thing 의 이름

  >> versionNumber : Thing 정보 버전 (업데이트될 때마다 +1 증가)

  >> attributes : Thing 에 설정된 속성 (키/값)


6. $aws/events/thing/{thingName}/updated 토픽 이벤트 사용 조건 (반드시 필요한 설정) : 

  >> 해당 토픽은 기본적으로 비활성화 상태이기 때문에, 사용하려면 'Registry events' 를 Enable 해야 합니다.

  >> AWS 콘솔 : IoT Core → Settings → Event-based messages → Manage events

  >> CLI 예시 : aws iot update-event-configurations --event-configurations "{\"THING\":{\"Enabled\": true}}"


7. ✅ $aws/events/thing/{thingName}/updated 토픽 사용 예시 : 

  >> Thing 속성 변경에 따른 자동 후처리 로직 실행 (예: Lambda 트리거, Rule Engine 활용)

  >> 사물 자산 관리 및 감사 (Audit) 목적

  >> Thing 메타데이터 업데이트 시 IoT Backend 시스템과 동기화

// --------------------------------------------------------------------------------------






// --------------------------------------------------------------------------------------
[참고 사이트]
// --------------------------------------------------------------------------------------

[Aws Iot Core] MQTT 구독 연결 및 해제 이벤트 감지 토픽 설명 - $aws/events/subscriptions/subscribed

https://kkh0977.tistory.com/8620

https://blog.naver.com/kkh0977/224177733534


[Aws Iot Core] MQTT 세션 연결 및 해제 이벤트 감지 토픽 설명 - $aws/events/presence/connected

https://kkh0977.tistory.com/8569

https://blog.naver.com/kkh0977/224149233152


[AWS 콘솔 이벤트 토픽 설명 사이트]

https://docs.aws.amazon.com/ko_kr/iot/latest/developerguide/reserved-topics.html

// --------------------------------------------------------------------------------------
 
728x90
반응형
Comments