本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

生命週期事件

AWS IoT 可以在MQTT主題上發佈生命週期事件。預設情況下，這些事件可用且無法停用。

連線/中斷連線事件

AWS IoT 當用戶端連線或中斷連線時， 會將訊息發佈至下列MQTT主題：

以下是發佈至$aws/events/presence/connected/clientId主題的連線/中斷連線訊息中包含的JSON元素清單。

連線訊息具有以下結構。

{
    "clientId": "186b5",
    "thingName": "exampleThing",
    "timestamp": 1573002230757,
    "eventType": "connected",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "principalIdentifier": "12345678901234567890123456789012",
    "ipAddress": "192.0.2.0",
    "versionNumber": 0
}

中斷連線訊息具有以下結構。

{
    "clientId": "186b5",
    "thingName": "exampleThing",
    "timestamp": 1573002340451,
    "eventType": "disconnected",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "principalIdentifier": "12345678901234567890123456789012",
    "clientInitiatedDisconnect": true,
    "disconnectReason": "CLIENT_INITIATED_DISCONNECT",
    "versionNumber": 0
}

處理用戶端中斷連線

最佳實務是一律為生命週期事件實作等待狀態，包括 Last Will and Testament (LWT) 訊息。收到中斷連線的訊息時，您的程式碼會等待一段時間並驗證裝置是否仍然離線，才採取動作。其中一種方法是使用SQS延遲佇列。當用戶端收到 LWT或生命週期事件時，您可以佇列訊息 （例如 5 秒）。當該訊息變為可用並由 Lambda 或其他服務進行處理時，您可以在進行下一個動作前，先檢查該裝置是否仍處於離線狀態。

連線嘗試失敗事件

AWS IoT MQTT 當用戶端未獲授權連線，或設定最後一個遺囑和試驗，且用戶端未獲授權發佈至最後一個遺囑主題時， 會將訊息發佈至下列主題。

$aws/events/presence/connect_failed/clientId

以下是發佈至 $aws/events/presence/connect_failed/clientId主題的連線授權訊息中包含的JSON元素清單。

連線失敗訊息具有下列結構。

{
    "clientId": "186b5",
    "thingName": "exampleThing",
    "timestamp": 1460065214626,
    "eventType": "connect_failed",
    "connectFailureReason": "AUTHORIZATION_FAILED",
    "principalIdentifier": "12345678901234567890123456789012",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "ipAddress" : "192.0.2.0"
}

訂閱/取消訂閱事件

AWS IoT 當用戶端訂閱或取消訂閱MQTT主題時， 會將訊息發佈至下列MQTT主題：

$aws/events/subscriptions/subscribed/clientId

或

$aws/events/subscriptions/unsubscribed/clientId

其中 clientId 是連線至訊息代理程式的MQTT AWS IoT 用戶端 ID。

發佈至此主題的訊息具有以下結構：

{
    "clientId": "186b5",
    "thingName": "exampleThing",
    "timestamp": 1460065214626,
    "eventType": "subscribed" | "unsubscribed",
    "sessionIdentifier": "00000000-0000-0000-0000-000000000000",
    "principalIdentifier": "12345678901234567890123456789012",
    "topics" : ["foo/bar","device/data","dog/cat"]
}

以下是發佈至 和 $aws/events/subscriptions/subscribed/clientId$aws/events/subscriptions/unsubscribed/clientId主題的訂閱和取消訂閱訊息中包含的JSON元素清單。