訂閱 Amazon One Enterprise 事件裝置狀態變更事件類型使用者設定檔事件類型範例事件裝置運作狀態已變更為正常運作裝置運作狀態已變更為嚴重裝置連線已變更為線上裝置連線已變更為離線

在 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 裝置和使用者設定檔狀態變更事件會使用 EventBridge 發佈，並且可以透過建立新的規則在 EventBridge 主控台中啟用。儘管事件沒有排序，但它們具有時間戳記，可讓您使用資料。事件會盡可能發出。

訂閱 Amazon One Enterprise 事件

前往 https：//https://console.aws.amazon.com/events/ 登入您的 AWS 主控台。
在 https://console.aws.amazon.com/events/ 開啟 EventBridge 主控台。
在導覽窗格中的匯流排下，選擇規則。
選擇建立規則。
在預設規則詳細資訊頁面上，為規則指派名稱。
選擇 Rule with an event pattern (具有事件模式的規則)，然後選擇 Next (下一步)。
在 建置事件模式 頁面中的 事件來源，選擇 AWS 事件或 EventBridge 合作夥伴事件。
在範例事件類型下，選擇 AWS Events。
針對建立方法，選擇自訂模式。

在事件模式區段中，新增事件來源為 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"]
       }

您可以從上述清單中選擇所需的詳細資訊類型，並移除不需要的詳細資訊類型。

選擇下一步。
在選取目標 (Select target) 頁面上，選取您選擇的目標，其中包含 Lambda 函數、SQS 佇列或 SNS 主題。如需設定目標的資訊，請參閱 Amazon EventBridge 目標。

例如，若要檢視人員打卡的時間，請選擇「成功辨識」。然後查看事件詳細資訊（在附錄中提供），以查看誰打卡上班。

若要完成工作流程，您可以執行外部 API 或其他目標。
或者，您可以設定標籤。
在 檢閱和建立 頁面上，選擇 建立規則。如需設定規則的詳細資訊，請參閱《EventBridge 使用者指南》中的 EventBridge 規則。

裝置狀態變更事件類型

裝置狀態變更事件會在 JSON 中產生。針對每一個事件類型，JSON blob 會傳送至您選擇的目標 (如規則中所設定)。下列詳細資訊類型可供使用：

某些警示（已清除）: 裝置已通過一或多個運作狀態檢查。
偵測到新的 Alert (s): 裝置未通過一或多個運作狀態檢查。

事件物件

resources

包含發佈裝置狀態變更事件的 deviceInstance arn 清單。

資料

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 以成功進行身分驗證時。
辨識失敗: 當指紋掃描的辨識失敗時。

事件物件

resources

包含發佈使用者描述檔事件的使用者描述檔 arn 清單。

資料

accountId

啟動請求之裝置的相關 AWS 帳戶。

requestSource

這是啟動請求之裝置的 deviceInstanceId。

createdTimestamp

建立事件的時間。

userStatus

使用者的目前狀態。
可能的值：ACTIVE、DELETED

associatedId

使用者的相關聯 ID，例如徽章 ID。

reason

未成功事件將顯示此值。它包含事件失敗的原因。

範例事件

下列範例顯示 Amazon One Enterprise 的事件。

裝置運作狀態已變更為正常運作

裝置已通過所有運作狀態檢查。


{
        "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"
            }
        }
      }

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

監控

CloudTrail 日誌