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

# 使用 Amazon EventBridge 監控 HealthLake 事件
<a name="monitoring-eventbridge"></a>

Amazon EventBridge 是一種無伺服器服務，該服務使用事件將應用程式元件連接在一起，讓您更輕鬆地建置可擴展的事件驅動型應用程式。EventBridge 的基礎是建立將[事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)路由到[目標](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)的[規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。 AWS HealthLake 提供對 EventBridge 的持久狀態變更交付。如需詳細資訊，請參閱《Amazon EventBridge 使用者指南》**中的[什麼是 Amazon EventBridge？](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)

**注意**  
若要了解如何將 HealthLake 事件傳送至 Amazon EventBridge，請參閱 *AWS for Industries* 部落格中的 [ 的 Amazon EventBridge 整合 AWS HealthLake](https://aws.amazon.com/blogs/industries/amazon-eventbridge-integration-for-aws-healthlake)。

**Topics**
+ [傳送至 EventBridge 的 HealthLake 事件](#event-notifications-listing)
+ [HealthLake 事件結構](#event-notifications-structure)

## 傳送至 EventBridge 的 HealthLake 事件
<a name="event-notifications-listing"></a>

下表列出傳送至 EventBridge 以進行處理的所有 HealthLake 事件。

<a name="event-notifications-table"></a>[See the AWS documentation website for more details](http://docs.aws.amazon.com/zh_tw/healthlake/latest/devguide/monitoring-eventbridge.html)

## HealthLake 事件結構
<a name="event-notifications-structure"></a>

HealthLake 事件是具有 JSON 結構的物件，也包含中繼資料詳細資訊。您可以使用中繼資料做為輸入，以重新建立事件或了解詳細資訊。所有相關聯的中繼資料欄位都會列在下表程式碼範例下的資料表中。如需詳細資訊，請參閱《*Amazon EventBridge 使用者指南*》中的[AWS 服務事件中繼資料](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。

**注意**  
若要了解如何將 HealthLake 事件傳送至 Amazon EventBridge，請參閱 *AWS for Industries* 部落格中的 [ 的 Amazon EventBridge 整合 AWS HealthLake](https://aws.amazon.com/blogs/industries/amazon-eventbridge-integration-for-aws-healthlake)。

### 資料存放區事件
<a name="event-notifications-data-store"></a>

------
#### [ Data Store Creating ]

**狀態 - `CREATING`**

```
{
    "version": "0",
    "id": "514ad836-bb8a-4523-a10b-fa2756c3bdb0",
    "detail-type": "Data Store Creating",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T08:58:12Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "datastoreName": "your-data-store-name",
        "datastoreTypeVersion": "R4",
        "datastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/eeb8005725ae22b35b4edbdc68cf2dfd/r4/"
    }
}
```

------
#### [ Data Store Active ]

**狀態 - `ACTIVE`**

```
{
    "version": "0",
    "id": "d57105bc-0d2d-4009-b34d-453e2567c599",
    "detail-type": "Data Store Active",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T09:16:51Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "datastoreName": "your-data-store-name",
        "datastoreTypeVersion": "R4",
        "datastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/eeb8005725ae22b35b4edbdc68cf2dfd/r4/"
    }
}
```

------
#### [ Data Store Deleting ]

**狀態 - `DELETING`**

```
{
    "version": "0",
    "id": "d135ee1f-e14a-4730-8766-7b98f822c94a",
    "detail-type": "Data Store Deleting",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T12:44:47Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "datastoreName": "your-data-store-name",
        "datastoreTypeVersion": "R4",
        "datastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/eeb8005725ae22b35b4edbdc68cf2dfd/r4/"
    }
}
```

------
#### [ Data Store Deleted ]

**狀態 - `DELETED`**

```
{
    "version": "0",
    "id": "6d880b86-e115-4947-81a9-494db704571a",
    "detail-type": "Data Store Deleted",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-05-12T12:58:03Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "datastoreName": "your-data-store-name",
        "datastoreTypeVersion": "R4",
        "datastoreEndpoint": "https://healthlake.us-east-1.amazonaws.com/datastore/eeb8005725ae22b35b4edbdc68cf2dfd/r4/"
    }
}
```

------


**資料存放區事件 - 中繼資料描述**  

| 名稱 | 類型 | Description | 
| --- | --- | --- | 
| version | string | EventBridge 事件結構描述版本。 | 
| id | string | 為每個事件產生的第 4 版 UUID。 | 
| detail-type | string | 正在傳送的事件類型。 | 
| source | string | 識別產生事件的服務。 | 
| account | string | 資料存放區擁有者的 12 位數 AWS 帳戶 ID。 | 
| time | string | 事件發生的時間。 | 
| region | string | 識別資料存放區的 AWS 區域。 | 
| resources | 陣列 （字串） | 包含資料存放區 ARN 的 JSON 陣列。 | 
| detail | object | 包含事件相關資訊的 JSON 物件。 | 
| detail.datastoreId | string | 與狀態變更事件相關聯的資料存放區 ID。 | 
| detail.datastoreName | string | 資料存放區名稱。 | 
| detail.datastoreTypeVersion | string | 資料存放區 FHIR 版本。 | 
| detail.datastoreEndpoint | string | 資料存放區端點。 | 

### 匯入任務事件
<a name="event-notifications-import-jobs"></a>

------
#### [ Import Job Submitted ]

**狀態 - `SUBMITTED`**

```
{
    "version": "0",
    "id": "25e606f7-800c-da41-45df-0e68587250c9",
    "detail-type": "Import Job Submitted",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T01:50:51Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------
#### [ Import Job In Progress ]

**狀態 - `IN_PROGRESS`**

```
{
    "version": "0",
    "id": "cc886b49-2737-19c4-7c4e-84ac9429ab73",
    "detail-type": "Import Job In Progress",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T01:51:23Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------
#### [ Import Job Completed ]

**狀態 - `COMPLETED`**

```
{
    "version": "0",
    "id": "36c865ef-da41-76ef-c882-3ba8dad8656b",
    "detail-type": "Import Job Completed",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------
#### [ Import Job Completed With Errors ]

**狀態 - `COMPLETED_WITH_ERRORS`**

```
{
    "version": "0",
    "id": "b61387d7-bffe-4f01-8291-65dc4be52cc1",
    "detail-type": "Import Job Completed With Errors",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------
#### [ Import Job Failed ]

**狀態 - `FAILED`**

```
{
    "version": "0",
    "id": "c4d65575-d1a7-4040-9c6c-c225bf6723c5",
    "detail-type": "Import Job Failed",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "08c60716d6321710893ff88410e902c2",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "inputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/input/"
        }
    }
}
```

------


**匯入任務事件 - 中繼資料描述**  

| 名稱 | 類型 | Description | 
| --- | --- | --- | 
| version | string | EventBridge 事件結構描述版本。 | 
| id | string | 為每個事件產生的第 4 版 UUID。 | 
| detail-type | string | 正在傳送的事件類型。 | 
| source | string | 識別產生事件的服務。 | 
| account | string | 資料存放區擁有者的 12 位數 AWS 帳戶 ID。 | 
| time | string | 事件發生的時間。 | 
| region | string | 識別資料存放區的 AWS 區域。 | 
| resources | 陣列 （字串） | 包含資料存放區 ARN 的 JSON 陣列。 | 
| detail | object | 包含事件相關資訊的 JSON 物件。 | 
| detail.jobId | string | 與狀態變更事件相關聯的匯入任務 ID。 | 
| detail.submitTime | string | 匯入任務提交的時間。 | 
| detail.datastoreId | string | 產生狀態變更事件的資料存放區。 | 
| detail.inputDataConfig | string | Amazon S3 儲存貯體的輸入字首路徑，其中包含要匯入的 FHIR 檔案。 | 

### 匯出任務事件
<a name="event-notifications-export-jobs"></a>

------
#### [ Export Job Submitted ]

**狀態 - `SUBMITTED`**

```
{
    "version": "0",
    "id": "f8af7d04-2221-4f02-a01a-6fc3ae403bab",
    "detail-type": "Export Job Submitted",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T01:50:51Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------
#### [ Export Job In Progress ]

**狀態 - `IN_PROGRESS`**

```
{
    "version": "0",
    "id": "7bb7e39c-707d-4a83-8532-cee015299100",
    "detail-type": "Export Job In Progress",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T01:51:23Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------
#### [ Export Job Completed ]

**狀態 - `COMPLETED`**

```
{
    "version": "0",
    "id": "d7629aa7-e63a-4b84-858c-96a62b57ebc8",
    "detail-type": "Export Job Completed",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------
#### [ Export Job Completed With Errors ]

**狀態 - `COMPLETED_WITH_ERRORS`**

```
{
    "version": "0",
    "id": "5fa50bc5-50e3-4bc4-b66a-1b1d2f7b07a7",
    "detail-type": "Export Job Completed With Errors",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------
#### [ Export Job Failed ]

**狀態 - `FAILED`**

```
{
    "version": "0",
    "id": "49fce45e-7e02-4846-8582-e7f19ca039cb",
    "detail-type": "Export Job Failed",
    "source": "aws.healthlake",
    "account": "123456789012",
    "time": "2023-12-08T02:14:42Z",
    "region": "us-east-1",
    "resources":
    [
        "arn:aws:healthlake:us-east-1:123456789012:datastore/fhir/eeb8005725ae22b35b4edbdc68cf2dfd"
    ],
    "detail":
    {
        "jobId": "45e899e545bf774710388260fc60b143",
        "submitTime": "2023-12-08T01:50:50.986Z",
        "datastoreId": "eeb8005725ae22b35b4edbdc68cf2dfd",
        "outputDataConfig":
        {
            "s3Uri": "s3://{{amzn-s3-demo-source-bucket}}/output/"
        }
    }
}
```

------


**匯出任務事件 - 中繼資料描述**  

| 名稱 | 類型 | Description | 
| --- | --- | --- | 
| version | string | EventBridge 事件結構描述版本。 | 
| id | string | 為每個事件產生的第 4 版 UUID。 | 
| detail-type | string | 正在傳送的事件類型。 | 
| source | string | 識別產生事件的服務。 | 
| account | string | 資料存放區擁有者的 12 位數 AWS 帳戶 ID。 | 
| time | string | 事件發生的時間。 | 
| region | string | 識別資料存放區的 AWS 區域。 | 
| resources | 陣列 （字串） | 包含資料存放區 ARN 的 JSON 陣列。 | 
| detail | object | 包含事件相關資訊的 JSON 物件。 | 
| detail.jobId | string | 與狀態變更事件相關聯的匯出任務 ID。 | 
| detail.submitTime | string | 匯出任務提交的時間。 | 
| detail.datastoreId | string | 產生狀態變更事件的資料存放區。 | 
| detail.outputDataConfig | string | Amazon S3 儲存貯體的輸出字首路徑，其中包含要匯出的 FHIR 檔案。 |