# 接続ステータスイベント
<a name="iot-lorawan-gateway-events"></a>

AWS IoT Core for LoRaWAN では、AWS IoT にオンボードした LoRaWAN ゲートウェイの接続ステータスイベントを通知するメッセージを発行できます。LoRaWAN ゲートウェイの接続ステータスが接続済みまたは切断済みに変更されたときに通知する接続ステータスイベント。

## 接続ステータスイベントの仕組み
<a name="iot-lorawan-gateway-events-work"></a>

ゲートウェイを AWS IoT Core for LoRaWAN にオンボーディングした後、ゲートウェイを AWS IoT Core for LoRaWAN に接続して、その接続ステータスを確認できます。このイベントは、ゲートウェイ接続ステータスが接続済みまたは切断済みに変更されたときに通知します。ゲートウェイのオンボーディングおよび AWS IoT Core for LoRaWAN への接続の詳細については、「[ゲートウェイを AWS IoT Core for LoRaWAN にオンボードする](lorawan-onboard-gateways.md)」および「[LoRaWAN ゲートウェイを接続し、接続ステータスを確認する](lorawan-gateway-connection-status.md)」を参照してください。

## LoRaWAN ゲートウェイの MQTT トピックの形式
<a name="lorawan-gateway-message-format"></a>

LoRaWAN ゲートウェイ用に予約された MQTT トピックでは、次の形式を使用します。これらのトピックをサブスクライブしている場合は、AWS アカウント に登録されているすべての LoRaWAN ゲートウェイが通知を受信できます。
+ リソースレベルのトピックの場合:

  `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_gateways`
+ 識別子のトピックの場合:

  `$aws/iotwireless/events/{eventName}/{eventType}/lorawan/wireless_gateways/{resourceID}/{id}`

コードの説明は以下のとおりです。

**\$1eventName\$1**  
\$1eventName\$1 は `connection_status` である必要があります。

**\$1eventType\$1**  
\$1eventType\$1 は、`connected` または `disconnected` のいずれかになります。

**\$1resourceID\$1**  
\$1resourceID\$1 は `gateway_eui` または `wireless_gateway_id` のいずれかになります。

たとえば、次のトピックをサブスクライブして、すべてのゲートウェイが AWS IoT Core for LoRaWAN に接続されたときにイベント通知を受け取ることができます。

`$aws/iotwireless/events/connection_status/connected/lorawan/wireless_gateways/wireless_gateway_id/{id}`

また、ワイルドカード文字 `+` を使用して、複数のトピックを同時にサブスクライブできます。ワイルドカード文字 `+` は、次のトピックなど、その文字を含むレベル内の任意の文字列に一致します。

`$aws/iotwireless/events/connection_status/connected/lorawan/wireless_gateways/wireless_gateway_id/+`

**注記**  
予約済みトピックをサブスクライブするには、ワイルドカード文字 `#` を使用できません。

トピックをサブスクライブするときに `+` ワイルドカードを使用する方法の詳細については、*AWS IoT デベロッパーガイド*の「[MQTT トピックフィルター](https://docs.aws.amazon.com/iot/latest/developerguide/topicfilters.html)」を参照してください。

## 接続ステータスイベントのメッセージペイロード
<a name="iot-lorawan-gateway-payload"></a>

以下は、接続ステータスイベントのメッセージペイロードを示しています。

```
{
 // General fields
    "eventId": "string", 
    "eventType": "connected|disconnected",
    "WirelessGatewayId": "string",
    "timestamp": "timestamp",
 
 // Event-specific fields
    "LoRaWAN": {
        "GatewayEui": "string"        
    }
}
```

ペイロードには以下の属性が含まれます。

**eventId**  
AWS IoT Core for LoRaWAN によって生成される一意のイベント ID (文字列)。

**eventType**  
発生したイベントのタイプ。`connected` または `disconnected` のいずれかを設定できます。

**wirelessGatewayId**  
LoRaWAN ゲートウェイの ID。

**timestamp**  
イベントが発生したときの Unix タイムスタンプ。

**GatewayEui**  
ゲートウェイラベルまたはゲートウェイのドキュメントにあるゲートウェイの一意の識別子。