# 連線狀態事件
<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**  
在閘道標籤或閘道文件中可找到的閘道唯一識別符。