本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
# 在 Amazon EventBridge 中監控 Amazon One Enterprise 事件
您可以在 EventBridge 中監控 Amazon One Enterprise 事件，從您自己的應用程式、software-as-a-service(SaaS) 應用程式 AWS 和服務提供即時資料串流。EventBridge 會將該資料路由到目標，例如 AWS Lambda 和 Amazon Simple Notification Service。這些事件提供近乎即時的系統事件串流，描述 AWS 資源的變更。
## 訂閱 Amazon One Enterprise 事件
Amazon One 裝置和使用者設定檔狀態變更事件會使用 EventBridge 發佈，並且可以透過建立新的規則在 EventBridge 主控台中啟用。儘管事件沒有排序，但它們具有時間戳記，可讓您使用資料。事件會[盡可能](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html)發出。
**訂閱 Amazon One Enterprise 事件**
1. 前往 https：//[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 登入您的 AWS 主控台。
1. 在 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 開啟 EventBridge 主控台。
1. 在導覽窗格中的**匯流排**下，選擇**規則**。
1. 選擇**建立規則**。
1. 在**預設規則詳細資訊**頁面上，為規則指派名稱。
1. 選擇**具有事件模式的規則**，然後選擇**下一步**。
1. 在**建置事件模式**頁面的**事件來源**下，確認已選取 **AWS 事件或 EventBridge 合作夥伴事件**。
1. 在**範例事件類型**下，選擇 **AWS Events**。
1. 針對**建立方法**，選擇**自訂模式**。
1. 在**事件模式**區段中，新增事件來源為 `aws:one`和必要詳細資訊類型的 JSON：
```
"
source": ["aws.one"],
"detail-type": ["New Successful Enrollment",
"New Successful Un-enrollment",
"Unsuccessful Enrollment",
"Unsuccessful Un-enrollment",
"Successful Recognition",
"Unsuccessful Recognition",
"New Alert(s) Detected",
"Some Alert(s) Cleared"]
}
```
您可以從上述清單中選擇所需的詳細資訊類型，並移除不需要的詳細資訊類型。
1. 選擇**下一步**。
1. 在**選取目標 (Select target) **頁面上，選取您選擇的目標，其中包含 Lambda 函數、SQS 佇列或 SNS 主題。如需設定目標的資訊，請參閱 [ Amazon EventBridge 目標](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)。
例如，若要檢視何時有人打卡上班，請選擇**「成功辨識」**。然後查看事件詳細資訊 （在附錄中提供），以查看誰打卡上班。
若要完成工作流程，您可以執行外部 API 或其他目標。
1. 或者，您可以設定標籤。
1. 在 **檢閱和建立** 頁面上，選擇 **建立規則**。如需設定規則的詳細資訊，請參閱《[EventBridge 使用者指南](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)》中的 EventBridge 規則。
## 裝置狀態變更事件類型
裝置狀態變更事件會在 JSON 中產生。針對每一個事件類型，JSON blob 會傳送至您選擇的目標 (如規則中所設定)。可用的詳細資訊類型如下：
**某些警示 （已清除）**
裝置已通過一或多個運作狀態檢查。
**偵測到新的 Alert(s)**
裝置未通過一或多個運作狀態檢查。
**Topics**
**resources**
包含發佈裝置狀態變更事件的 deviceInstance arn 清單。
**data**
clearedAlerts
+ 代表 deviceInstance 先前失敗的運作狀態檢查。
+ 包含警示類型的 statusCode 和 reportedAt 時間戳記。
+ 可能statusCode值：NetworkDisconnected、USBDisconnected
currentAlerts
+ 代表 deviceInstance 的目前狀態。
+ 包含警示類型的 statusCode 和 reportedAt 時間戳記。
+ 可能statusCode值：NetworkDisconnected、USBDisconnected
newAlerts
+ 代表 deviceInstance 的新失敗運作狀態檢查。
+ 包含警示類型的 statusCode 和 reportedAt 時間戳記。
+ 可能statusCode值：NetworkDisconnected、USBDisconnected
currentAlertsCount
+ 運作狀態檢查目前因 deviceInstance 失敗的計數。
assetTagId
+ 與 deviceInstance 相關聯之裝置的 assetTagId。
deviceInstanceName
+ 發佈裝置狀態事件的 deviceInstance 名稱。
siteName
+ 存在 deviceInstance 的網站名稱。
siteArn
+ Arn 適用於存在 deviceInstance 的網站。
## 使用者設定檔事件類型
使用者描述檔相關的事件詳細資訊類型為：
**新的成功註冊**
當使用者成功註冊時。
**新的成功取消註冊**
當使用者成功取消註冊時。
**註冊失敗**
當使用者無法註冊時。
**未成功取消註冊**
當使用者無法取消註冊時。
**成功辨識**
當使用者掃描 Palm 以成功進行身分驗證時。
**辨識失敗**
當指紋掃描的辨識失敗時。
**Topics**
**resources**
包含發佈使用者描述檔事件的使用者描述檔 arn 清單。
**data**
accountId
+ 啟動請求之裝置的相關 AWS 帳戶。
requestSource
+ 這是啟動請求之裝置的 deviceInstanceId。
createdTimestamp
+ 建立事件的時間。
userStatus
+ 使用者的目前狀態。
+ 可能的值：ACTIVE、DELETED
associatedId
+ 使用者的相關聯 ID，例如徽章 ID。
reason
+ 未成功事件將顯示此值。它包含事件失敗的原因。
## 範例事件
下列範例顯示 Amazon One Enterprise 的事件。
**Topics**
+ [訂閱 Amazon One Enterprise 事件](#subscribe-device-status-events)
+ [裝置狀態變更事件類型](#device-status-change-event-types)
+ [使用者設定檔事件類型](#user-profile-event-types)
+ [範例事件](#sample-event)
+ [裝置運作狀態已變更為正常運作](#device-health-to-healthy)
+ [裝置運作狀態已變更為嚴重](#device-health-to-critical)
+ [裝置連線已變更為線上](#device-connectivity-to-online)
+ [裝置連線已變更為離線](#device-connectivity-to-offline)
## 裝置運作狀態已變更為正常運作
裝置已通過所有運作狀態檢查。
```
{
"version": "0",
"id": "51e022b4-7ce6-34e0-264b-370948fc1123",
"detail-type": "Some Alert(s) Cleared",
"source": "aws.one",
"account": "123456789012",
"time": "2025-07-17T19:32:42Z",
"region": "us-east-1",
"resources":
[
"arn:aws:one:us-east-1:123456789012:deviceInstance/F5JRte5Jz21Tqx"
],
"detail":
{
"version": "1.0.0",
"data":
{
"clearedAlerts":
[
{
"statusCode": "USBDisconnected",
"reportedAt": "Thu Jul 17 19:32:42 UTC 2025"
}
],
"currentAlerts":
[],
"currentAlertsCount": 0,
"assetTagId": "0000123456",
"deviceInstanceName": "device_name",
"siteName": "site_name",
"siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
}
}
}
```
## 裝置運作狀態已變更為嚴重
裝置未通過一或多個運作狀態檢查。
```
{
"version": "0",
"id": "07af4893-ef9f-965a-d245-3f0c8bd3c123",
"detail-type": "New Alert(s) Detected",
"source": "aws.one",
"account": "123456789012",
"time": "2025-07-17T19:26:58Z",
"region": "us-east-1",
"resources":
[
"arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234"
],
"detail":
{
"version": "1.0.0",
"data":
{
"newAlerts":
[
{
"statusCode": "USBDisconnected",
"reportedAt": "Thu Jul 17 19:26:58 UTC 2025"
}
],
"currentAlerts":
[
{
"statusCode": "USBDisconnected",
"reportedAt": "Thu Jul 17 19:26:58 UTC 2025"
}
],
"currentAlertsCount": 1,
"assetTagId": "0000123456",
"deviceInstanceName": "device_name",
"siteName": "site_name",
"siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
}
}
}
```
## 裝置連線已變更為線上
裝置現在已連線至網際網路。
```
{
"version": "0",
"id": "e6ecea28-dd60-5061-29f8-dfbc902f4123",
"detail-type": "Some Alert(s) Cleared",
"source": "aws.one",
"account": "123456789012",
"time": "2025-07-17T18:28:23Z",
"region": "us-east-1",
"resources":
[
"arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234"
],
"detail":
{
"version": "1.0.0",
"data":
{
"clearedAlerts":
[
{
"statusCode": "NetworkDisconnected",
"reportedAt": "Thu Jul 17 18:28:23 UTC 2025"
}
],
"currentAlerts":
[],
"currentAlertsCount": 0,
"assetTagId": "0000123456",
"deviceInstanceName": "device_name",
"siteName": "site_name",
"siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
}
}
}
```
## 裝置連線已變更為離線
裝置不再連接到網際網路。
```
{
"version": "0",
"id": "e6ecea28-dd60-5061-29f8-dfbc902f4123",
"detail-type": "New Alert(s) Detected",
"source": "aws.one",
"account": "123456789012",
"time": "2025-07-17T18:28:23Z",
"region": "us-east-1",
"resources":
[
"arn:aws:one:us-east-1:123456789012:deviceInstance/12345678901234"
],
"detail":
{
"version": "1.0.0",
"data":
{
"newAlerts":
[
{
"statusCode": "NetworkDisconnected",
"reportedAt": "Thu Jul 17 18:28:23 UTC 2025"
}
],
"currentAlerts":
[
{
"statusCode": "NetworkDisconnected",
"reportedAt": "Thu Jul 17 18:28:23 UTC 2025"
}
],
"currentAlertsCount": 1,
"assetTagId": "0000123456",
"deviceInstanceName": "device_name",
"siteName": "site_name",
"siteArn": "arn:aws:one:us-east-1:123456789012:site/12345678901234"
}
}
}
```