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

# 使用 建立 FHIR 訂閱 AWS HealthLake
<a name="managing-fhir-subscriptions-create"></a>

下列指南說明如何使用 建立 FHIR 訂閱 AWS HealthLake。

**建立 FHIR 訂閱**

1. 建立 `SubscriptionTopic`。

   範例訂閱主題資源：

   ```
   {
     "resourceType": "SubscriptionTopic",
     "url": "http://example.org/FHIR/SubscriptionTopic/encounter-create",
     "version": "1.0.0-fhir.r4b",
     "title": "encounter-create",
     "status": "unknown",
     "description": "Example topic for new encounters",
     "resourceTrigger": [
       {
         "description": "Encounter Create",
         "resource": "Encounter",
         "supportedInteraction": ["create", "update"]
       }
     ]
   }
   ```

1. 準備您的通知端點 （自訂頻道）。下列步驟是確保端點會收到通知的必要步驟

   **使用 REST Hook 時**
   + 如果使用 CM\_CMK 資料存放區，`events.amazonaws.com`請信任您的 KMS 金鑰政策。
   + 如果使用 CM\_CMK 資料存放區，您必須將`EventBridgeApiDestinations`標籤新增至值為 的 KMS 金鑰 `true`
   + HealthLake 使用 OAuth 來驗證 REST Hook 端點。因此，建立 REST hook 訂閱時，您必須在 channel.\_type.extension【\*】 中傳入 client-id、 client-secret 和 oAuth-endpoint-url。

   如果使用 CM\_CMK 資料存放區，範例 KMS 金鑰政策：

   ```
   {
     "Sid": "AllowEventBridgeToUseKMSKey",
     "Effect": "Allow",
     "Principal": {
       "Service": ["events.amazonaws.com", "healthlake.amazonaws.com"]
     },
     "Action": ["kms:GenerateDataKey*", "kms:Decrypt", "kms:DescribeKey"],
     "Resource": "*"
   }
   ```

   **使用 EventBridge 時**
   + 如果使用 CM\_CMK 資料存放區，`events.amazonaws.com`請信任您的 KMS 金鑰政策。
   + 驗證您的 EventBridge 資源政策信任`healthlake.amazonaws.com`為服務主體。
   + 使用 CM\_CMK 和 EventBridge 是端點時，請確認您使用與**資料存放**區 KMS 金鑰**相同的** KMS 金鑰來加密 EventBridge 匯流排。
   + 確認您的 EventBridge 匯流排至少有 1 個規則符合 HealthLake 產生的事件。

   EventBridge 頻道匯流排的資源政策範例：

   ```
   {
     "Version": "2012-10-17",		 	 	 
     "Statement": [
       {
         "Sid": "allowHealthlakeToPutEvents",
         "Effect": "Allow",
         "Principal": {
           "Service": "healthlake.amazonaws.com"
         },
         "Action": "events:PutEvents",
         "Resource": "arn:aws:healthlake:us-east-1:{{111122223333}}:event-bus/FhirSubscriptions-bus"
       }
     ]
     }
   ```

   從 HealthLake 接收事件的 EventBridge 規則事件模式範例：

   ```
   {
       "detail-type": ["FHIR Subscription Notification"],
       "source": ["healthlake"]
   }
   ```
**注意**  
HealthLake 支援 2 個來源：  
`“healthlake”`：僅適用於訂閱。
`“aws.healthlake”`：接收 HealthLake 服務事件。
建立 FHIR 訂閱事件匯流排的規則時，請使用 `“healthlake”`做為來源。

1. 建立您的 `Subscription`

   使用下列項目提交訂閱資源：
   + 狀態： `"requested"`
   + 您所選 ID `SubscriptionTopic` 的參考 
   + 篩選條件。如需詳細資訊，請參閱篩選支援篩選條件的通知。
   + 頻道組態