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

生命週期事件

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 是連線至 AWS IoT 訊息代理程式的 MQTT 用戶端 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 元素。