

# 무선 리소스에 이벤트 사용
<a name="iot-wireless-control-events"></a>

예약된 주제의 구독자가 메시지를 수신하려면 먼저 이벤트 알림을 사용하도록 설정해야 합니다. 이를 위해 AWS Management Console이나 AWS IoT 무선 API 또는 AWS CLI를 사용할 수 있습니다.

## 이벤트 구성
<a name="iot-wireless-control-events-config"></a>

특정 유형에 속하는 모든 리소스 또는 개별 무선 리소스에 대한 알림을 보내도록 이벤트를 구성할 수 있습니다. 리소스 유형은 무선 게이트웨이, Sidewalk 파트너 계정 또는 LoRaWan 또는 Sidewalk 디바이스일 수 있는 무선 디바이스일 수 있습니다. 무선 디바이스에 대해 활성화할 수 있는 이벤트 유형에 대한 자세한 내용은 [LoRaWAN 리소스 이벤트 유형](iot-lorawan-events.md#iot-lorawan-event-types) 및 [Sidewalk 리소스의 이벤트 유형](iot-sidewalk-events.md#iot-sidewalk-event-types) 섹션을 참조하세요.

**모든 리소스**  
특정 리소스 유형에 속하는 AWS 계정 내의 모든 리소스와 같은 이벤트의 경우 알림이 수신되도록 활성화할 수 있습니다. 예를 들어, AWS IoT Core for LoRaWAN으로 온보딩한 모든 LoRaWAN 게이트웨이의 연결 상태 변경 사항을 알려주는 이벤트를 활성화할 수 있습니다. 이러한 이벤트를 모니터링하면 리소스 플릿의 특정 LoRaWAN 게이트웨이의 연결이 끊어지거나 AWS 계정 내의 여러 Sidewalk 디바이스에 대해 비콘이 손실되는 경우 알림을 받는 데 도움이 됩니다.

**개별 리소스**  
이벤트 구성에 개별 LoRaWAN 및 Sidewalk 리소스를 추가하고 이에 대해 알림을 활성화할 수도 있습니다. 이렇게 하면 특정 유형의 개별 리소스를 모니터링할 수 있습니다. 예를 들어, 일부 LoRaWAN 및 Sidewalk 디바이스를 구성에 추가하고 이러한 리소스에 대한 조인 또는 디바이스 등록 상태 이벤트에 대한 알림을 받을 수 있습니다.

## 필수 조건
<a name="iot-wireless-control-events-prereq"></a>

LoRaWAN 또는 Sidewalk 리소스에는 이벤트 알림을 수신할 수 있는 적절한 정책이 있어야 합니다. 자세한 내용은 [무선 이벤트 알림 수신 정책](iot-wireless-events.md#iot-wireless-events-policy) 단원을 참조하십시오.

## AWS Management Console을 사용하여 알림 활성화
<a name="iot-wireless-control-events-console"></a>

콘솔에서 이벤트 메시지를 활성화하려면 AWS IoT 콘솔의 [설정(Settings)](console.aws.amazon.com/iot/home/settings/) 탭에서 **LoRaWAN 및 Sidewalk 이벤트 알림(LoRaWAN and Sidewalk event notification)** 섹션으로 이동합니다.

특정 리소스 유형에 속하는 AWS 계정 내의 모든 리소스에 대한 알림이 수신되도록 활성화하고 모니터링할 수 있습니다.

**모든 리소스에 대한 알림을 활성화하는 방법**

1. **LoRaWAN 및 Sidewalk 이벤트 알림(LoRaWAN and Sidewalk event notification)** 섹션에서 **모든 리소스(All resources)** 탭으로 이동하여 **작업(Action)**을 선택한 다음 **이벤트 관리(Manage events)**를 선택합니다.

1. 모니터링할 이벤트를 활성화한 다음 **이벤트 업데이트(Update events)**를 선택합니다. 특정 이벤트를 더 이상 모니터링하지 않으려면 **작업(Actions)**을 선택하고 **이벤트 관리(Manage events)**를 선택한 후 해당 이벤트를 비활성화합니다.

특정 리소스 유형에 속하는 AWS 계정 내의 개별 리소스에 대한 알림이 수신되도록 활성화하고 모니터링할 수도 있습니다.

**개별 리소스에 대한 알림을 활성화하는 방법**

1. **LoRaWAN 및 Sidewalk 이벤트 알림(LoRaWAN and Sidewalk event notification)** 섹션에서 **작업(Action)**을 선택한 다음 **리소스 추가(Add resources)**를 선택합니다.

1. 알림을 받을 리소스와 이벤트를 선택합니다.

   1. **LoRaWAN 리소스(LoRaWAN resources)**와 **Sidewalk 리소스(Sidewalk resources)** 중 어떤 리소스에 대한 이벤트를 모니터링할지 선택합니다.

   1. 리소스 유형에 따라 리소스에 대해 활성화하려는 이벤트를 선택할 수 있습니다. 그런 다음 이러한 이벤트를 구독하고 알림을 받을 수 있습니다. 선택 항목:
      + **LoRaWAN 리소스(LoRaWAN resources)**: LoRaWAN 디바이스에 대한 **조인(join)** 이벤트 또는 LoRaWAN 게이트웨이에 대한 **연결 상태(connection status)** 이벤트를 활성화할 수 있습니다.
      + Sidewalk 리소스: Sidewalk 파트너 계정 및 Sidewalk 디바이스에 대해 **디바이스 등록 상태**, **근접** 이벤트 또는 둘 다를 활성화할 수 있습니다.

1. 선택한 리소스 유형 및 이벤트에 따라 모니터링할 무선 디바이스 또는 게이트웨이를 선택합니다. 모든 리소스에 대해 최대 250개의 리소스를 선택할 수 있습니다.

1. **제출(Submit)**을 선택하여 리소스를 추가합니다.

추가하는 리소스는 콘솔의 **LoRaWAN 및 Sidewalk 이벤트 알림(LoRaWAN and Sidewalk event notification)** 섹션에서 MQTT 주제와 함께 리소스 유형 탭에 표시됩니다.
+ **LoRaWAN 조인(LoRaWAN join)** 이벤트 및 Sidewalk 디바이스에 대한 이벤트는 콘솔의 **무선 디바이스(Wireless devices)** 섹션에 표시됩니다.
+ LoRaWAN 게이트웨이에 대한 **연결 상태(Connection status)** 이벤트는 **무선 게이트웨이(Wireless gateways)** 섹션에 표시됩니다.
+ Sidewalk 계정에 대한 **디바이스 등록 상태(Device registration state)** 및 **근접(proximity)** 이벤트는 **Sidewalk 계정(Sidewalk accounts)** 탭에 표시됩니다.

**MQTT 클라이언트를 사용하여 주제 구독**  
이벤트를 모든 리소스와 개별 리소스 중 어느 유형에 대해 활성화했는지에 따라 활성화한 이벤트는 MQTT 주제와 함께 콘솔의 **모든 리소스(All resources)** 탭 또는 지정된 리소스 유형의 탭에 표시됩니다.
+ MQTT 주제 중 하나를 선택하는 경우 MQTT 클라이언트로 이동하여 이러한 주제를 구독하고 메시지를 받을 수 있습니다.
+ 여러 이벤트를 추가한 경우 여러 이벤트 주제를 구독하고 해당 항목에 대한 알림을 받을 수 있습니다. 여러 주제를 구독하려면 주제를 선택하고 **작업(Action)**을 선택한 다음 **구독(Subscribe)**을 선택합니다.

## AWS CLI를 사용하여 알림 활성화
<a name="iot-wireless-control-events-cli"></a>

AWS IoT 무선 API 또는 AWS CLI를 사용하여 이벤트를 구성하고 구성에 리소스를 추가할 수 있습니다.

**모든 리소스에 대한 알림을 활성화하는 방법**  
특정 리소스 유형에 속하는 AWS 계정의 모든 리소스에 대해 알림을 활성화하고 [UpdateEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) API 또는 [cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/update-event-configuration-by-resource-types.html) CLI 명령을 사용하여 모니터링할 수 있습니다. 예:

```
aws iotwireless update-event-configuration-by-resource-types \ 
   --cli-input-json input.json
```

**input.json 내용**

```
{   
   "DeviceRegistrationState": { 
      "Sidewalk": { 
         "AmazonIdEventTopic": "Enabled"
      }
   },
   "ConnectionStatus": { 
      "LoRaWAN": { 
         "WirelessGatewayEventTopic": "Enabled"
      }
   }
}
```

**참고**  
모든 큰따옴표(")는 백슬래시(\\)로 이스케이프됩니다.

[GetEventConfigurationByResourceTypes](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) API를 호출하거나 [cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html](cli/latest/reference/iotwireless/get-event-configuration-by-resource-types.html) CLI 명령을 사용하여 현재 이벤트 구성을 가져올 수 있습니다. 예:

```
aws iotwireless get-event-configuration-by-resource-types
```

**개별 리소스에 대한 알림을 활성화하는 방법**  
API 또는 CLI를 사용하여 이벤트 구성에 개별 리소스를 추가하고 게시할 이벤트 유형을 제어하려면 [UpdateResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_UpdateResourceEventConfiguration.html) API를 호출하거나 [cli/latest/reference/iotwireless/update-resource-event-configuration.html](cli/latest/reference/iotwireless/update-resource-event-configuration.html) CLI 명령을 사용합니다. 예:

```
aws iotwireless update-resource-event-configuration \ 
   --identifer 1ffd32c8-8130-4194-96df-622f072a315f \ 
   --identifier-type WirelessDeviceId \ 
   --cli-input-json input.json
```

**input.json 내용**

```
{  
   "Join": { 
      "LoRaWAN": { 
         "DevEuiEventTopic": "Disabled"
      },
      "WirelessDeviceIdEventTopic": "Enabled"
   }
}
```

**참고**  
모든 큰따옴표(")는 백슬래시(\\)로 이스케이프됩니다.

[GetResourceEventConfiguration](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_GetResourceEventConfiguration.html) API를 호출하거나 [cli/latest/reference/iotwireless/get-resource-event-configuration.html](cli/latest/reference/iotwireless/get-resource-event-configuration.html) CLI 명령을 사용하여 현재 이벤트 구성을 가져올 수 있습니다. 예:

```
aws iotwireless get-resource-event-configuration \ 
    --identifier-type WirelessDeviceId \ 
    --identifier 1ffd32c8-8130-4194-96df-622f072a315f
```

**이벤트 구성 나열**  
AWS IoT 무선 API 또는 AWS CLI를 사용하여 하나 이상의 이벤트 주제가 활성화된 이벤트 구성을 나열할 수도 있습니다. 구성을 나열하려면 [ListEventConfigurations](https://docs.aws.amazon.com/iot-wireless/2020-11-22/apireference/API_ListEventConfigurations.html) API 작업 또는 [cli/latest/reference/iotwireless/list-event-configurations.html](cli/latest/reference/iotwireless/list-event-configurations.html) CLI 명령을 사용합니다. 예:

```
aws iotwireless list-event-configurations --resource-type WirelessDevice
```