AWS IoT Wireless에 대한 이벤트 알림

AWS IoT Wireless는 AWS IoT Core에 온보딩하는 LoRaWAN 및 Sidewalk 디바이스에 대한 이벤트를 알리는 메시지를 게시할 수 있습니다. 예를 들어, 계정의 Sidewalk 디바이스가 프로비저닝되거나 등록되었을 때와 같은 이벤트에 대한 알림을 받을 수 있습니다.

리소스가 이벤트에 대해 알림을 받는 방법

특정 이벤트가 발생하면 이벤트 알림이 게시됩니다. 예를 들어 Sidewalk 디바이스가 프로비저닝될 때 이벤트가 생성됩니다. 이러한 이벤트가 발생할 때마다 단일 이벤트 알림이 전송됩니다. 이벤트 알림은 MQTT를 통해 JSON 페이로드와 함께 게시됩니다. 페이로드 내용은 이벤트 유형에 따라 달라집니다.

참고

이벤트 알림은 한 번 이상 게시됩니다. 하지만 1회 이상 게시하는 것도 가능합니다. 이벤트 알림의 순서는 보장되지 않습니다.

이벤트 및 리소스 유형

다음 표에서는 알림을 수신할 다양한 유형의 이벤트를 보여줍니다. 이벤트 유형은 리소스 유형이 무선 디바이스인지, 무선 게이트웨이인지 또는 Sidewalk 계정인지에 따라 달라집니다. 리소스 수준에서 리소스에 대한 이벤트를 활성화할 수도 있습니다. 이 경우 이벤트가 다음 섹션에 설명된 대로 특정 유형의 모든 리소스 또는 일부 리소스에 적용됩니다. 다양한 이벤트 유형에 대한 자세한 내용은 LoRaWAN 리소스에 대한 이벤트 알림 및 Sidewalk 리소스에 대한 이벤트 알림 섹션을 참조하세요.

리소스를 기반 이벤트 유형
Resource	리소스 유형	이벤트 유형
무선 디바이스	LoRaWAN	조인
	Sidewalk	디바이스 등록 상태 근방
무선 게이트웨이	LoRaWAN	연결 상태
Sidewalk 계정	Sidewalk	디바이스 등록 상태 근방

무선 이벤트 알림 수신 정책

이벤트 알림을 수신하려면 먼저 디바이스가 AWS IoT 디바이스 게이트웨이에 연결하여 MQTT 이벤트 주제를 구독할 수 있는 정책을 사용해야 합니다. 또한 적합한 주제 필터도 구독해야 합니다.

다음은 다양한 무선 이벤트에 대한 알림을 수신하는 데 필요한 정책의 예입니다.

{
    "Version":"2012-10-17",
    "Statement":[{
        "Effect":"Allow",
        "Action":[
            "iot:Subscribe",
            "iot:Receive"
        ],
        "Resource":[
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/join/*",
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/connection_status/*"
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/device_registration_state/*", 
            "arn:aws:iotwireless:region:account:/$aws/iotwireless/events/proximity/*"
        ]
    }]
}

무선 이벤트에 대한 MQTT 주제 형식

무선 리소스에 대한 이벤트 알림을 보내기 위해 AWS IoT는 달러($) 기호로 시작하는 MQTT 예약 주제를 사용합니다. 이러한 예약된 주제를 게시하고 구독할 수 있습니다. 그러나 달러 기호로 시작하는 새 주제를 생성할 수는 없습니다.

참고

MQTT 주제는 AWS 계정에 특정하며 arn:aws:iotwireless:aws-region:AWS-account-ID:topic/Topic 형식을 사용합니다. 자세한 내용은 AWS IoT 개발자 안내서의 MQTT 주제를 참조하세요.

무선 디바이스용으로 예약된 MQTT 주제는 다음 형식을 사용합니다.

• 리소스 수준 주제

  이러한 주제는 AWS IoT Wireless에 온보딩한 AWS 계정에 있는 특정 유형의 리소스에 모두 적용됩니다.

  $aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/resources

• 식별자 수준 주제

  이러한 주제는 리소스 식별자에 의해 지정된 대로 AWS IoT Wireless에 온보딩한 AWS 계정에 있는 특정 유형의 일부 리소스에 적용됩니다.

  $aws/iotwireless/events/{eventName}/{eventType}/{resourceType}/{resourceIdentifierType}/{resourceID}/{id}

리소스 및 식별자 수준의 주제에 대한 자세한 내용은 이벤트 구성 섹션을 참조하세요.

다음 표에서는 다양한 이벤트에 대한 MQTT 주제의 예를 보여줍니다.

이벤트 및 MQTT 주제
Event	MQTT 주제	참고
Sidewalk 디바이스 등록 상태	리소스 수준 주제 $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/wireless_devices 식별자 수준 주제 $aws/iotwireless/events/device_registration_state/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType}은(는) registered 또는 provisioned일 수 있습니다. {resourceType}은(는) sidewalk_accounts 또는 wireless_devices일 수 있습니다. {resourceID}는 sidewalk_accounts의 경우 amazon_id, wireless_devices의 경우 wireless_device_id입니다.
Sidewalk 근접	리소스 수준 주제 $aws/iotwireless/events/proximity/{eventType}/sidewalk/wireless_devices 식별자 수준 주제 $aws/iotwireless/events/proximity/{eventType}/sidewalk/{resourceType}/{resourceID}/{id}	{eventType}은(는) beacon_discovered 또는 beacon_lost일 수 있습니다. {resourceType}은(는) sidewalk_accounts 또는 wireless_devices일 수 있습니다. {resourceID}는 sidewalk_accounts의 경우 amazon_id, wireless_devices의 경우 wireless_device_id입니다.
LoRaWAN 조인	리소스 수준 주제 $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices 식별자 수준 주제 $aws/iotwireless/events/join/{eventType}/lorawan/wireless_devices/{resourceID}/{id}	{eventType}은 join_req_0_received, join_req_2_received 또는 join_accepted일수 있습니다. {resourceID}은(는) wireless_device_id 또는 dev_eui일 수 있습니다.
LoRaWAN 게이트웨이 연결 상태	리소스 수준 주제 $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways 식별자 수준 주제 $aws/iotwireless/events/join/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}	{eventType}은(는) connected 또는 disconnected일 수 있습니다. {resourceID}은(는) wireless_gateway_id 또는 gateway_eui일 수 있습니다.

여러 이벤트에 대한 자세한 내용은 LoRaWAN 리소스에 대한 이벤트 알림 및 Sidewalk 리소스에 대한 이벤트 알림 섹션을 참조하세요.

이러한 주제를 구독한 경우 이벤트 알림 주제 중 하나에 메시지가 게시되면 알림을 받게 됩니다. 자세한 내용은 AWS IoT 개발자 안내서의 MQTT 예약 주제를 참조하세요.

무선 이벤트에 대한 요금

이벤트 구독 및 알림 수신 요금에 대한 자세한 내용은 AWS IoT Core 요금을 참조하세요.