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

# 在 Amazon EventBridge 中建立事件封存
<a name="eb-archive-event"></a>

當您在 EventBridge 中建立封存時，您可以透過指定事件[模式來判斷要傳送至封存的事件](eb-event-patterns.md)。EventBridge 會將符合事件模式的事件傳送至封存。您也可以設定保留期間，以在將其捨棄之前將事件儲存於封存中。

您也可以在建立[事件匯流排時建立](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-event-bus.html)封存。這些封存具有無限期的保留政策，沒有事件篩選條件，但可在建立封存後[更新](https://docs.aws.amazon.com/eventbridge/latest/userguide/event-bus-update-archive.html)。

**Topics**
+ [

## 定義封存
](#eb-create-archive-define)
+ [

## 建置事件模式 （選用）
](#eb-create-archive-event-pattern)

## 定義封存
<a name="eb-create-archive-define"></a>

首先，輸入封存的名稱和描述，並指定接收事件的事件匯流排。您也可以選擇性地設定在封存中保留事件的時間長度。

**定義封存**

1. 前往 [https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 開啟 Amazon EventBridge 主控台。

1. 導覽至來源事件匯流排，或直接建立封存：
   + 在導覽窗格中，選擇**事件匯流排**。

     在事件匯流排詳細資訊頁面上，選擇**封存**索引標籤。
   + 在導覽窗格中，選擇**封存**。

1. 選擇**建立封存**。

1. 在**封存詳細資訊**下，輸入封存的名稱和選擇性的描述。

    在所選取的區域中，此名稱對於您的賬戶必須是唯一的。建立封存後無法修改名稱。

1. 針對**來源**，選取您要將事件傳送至封存的事件匯流排

   如果您從現有的事件匯流排詳細資訊頁面導覽，則預設會顯示該事件匯流排的名稱。

   建立封存後，就無法變更來源事件匯流排。

1. 針對**保留期間**，指定在封存中保留事件的時間長度：
   + 選擇**無限期**可將事件保留於封存中，而不會刪除它們。
   + 針對設定的保留期間，輸入 EventBridge 應該從封存中刪除事件的天數。

1. 針對**加密**，選擇 EventBridge 在加密封存中存放的事件時要使用的 KMS 金鑰。
**重要**  
如果您已指定 EventBridge 使用客戶受管金鑰來加密來源事件匯流排，我們強烈建議您也為事件匯流排的任何封存指定客戶受管金鑰。
   + 選擇**用於 AWS 擁有的金鑰** EventBridge，以使用 加密資料 AWS 擁有的金鑰。

      AWS 擁有的金鑰 這是 EventBridge 擁有和管理的 KMS 金鑰，可用於多個 AWS 帳戶。一般而言，除非您需要稽核或控制保護 資源的加密金鑰，否則 AWS 擁有的金鑰 是不錯的選擇。

     此為預設值。
   + 選擇**使用 EventBridge 的客戶受管金鑰**，以使用您指定或建立的客戶受管金鑰來加密資料。 EventBridge 

     客戶受管金鑰是您帳戶中建立、擁有和管理 AWS 的 KMS 金鑰。您可以完全控制這些 KMS 金鑰。

     1. 指定現有的客戶受管金鑰，或選擇**建立新的 KMS 金鑰 />**。

       EventBridge 會顯示金鑰狀態，以及與指定客戶受管金鑰相關聯的任何金鑰別名。

1. 選擇**下一步**。

## 建置事件模式 （選用）
<a name="eb-create-archive-event-pattern"></a>

接下來，作為選用步驟，您可以建置事件模式來篩選 EventBridge 傳送至封存的事件。若要這麼做，請指定事件來源、選擇事件模式的基礎，然後定義要比對的屬性和值。您也可以在 JSON 中產生事件模式，並根據範例事件進行測試。

如需事件模式的詳細資訊，請參閱 [](eb-event-patterns.md)。

**若要建置事件模式**

1. 在**事件來源**欄位中，選擇 **AWS 事件或 EventBridge 合作夥伴事件**。

1. (選用 ) 在**範例事件**區段中，選擇您要測試事件模式的**範例事件類型**。

   可使用以下範例事件類型：
   + **AWS 事件 **– 從支援的事件中選取 AWS 服務。
   + **EventBridge 合作夥伴事件**：從支援 EventBridge 的第三方服務 (例如 Salesforce) 所發出的事件中選取。
   + **輸入我自己的**：以 JSON 文字輸入您自己的事件。

     您也可以使用 AWS 或 合作夥伴事件做為建立自訂事件的起點。

     1. 選取 **AWS 活動**或 **EventBridge 合作夥伴事件**。

     1. 使用**範例事件**下拉式清單，選取要用作自訂事件起點的事件。

        EventBridge 會顯示範例事件。

     1. 選取**複製**。

     1. 針對**事件類型**選取**輸入我自己的**。

     1. 在 JSON 編輯窗格中刪除範例事件結構，並將 AWS 或 合作夥伴事件貼到位。

     1. 編輯事件 JSON 以建立您自己的範例事件。

1. 選擇**建立方法**。您可以從 EventBridge 結構描述或範本建立事件模式，也可以建立自訂事件模式。

------
#### [ Existing schema ]

   若要使用現有的 EventBridge 結構描述建立事件模式，請執行下列動作：

   1. 在**建立方法**區段中，針對**方法**，選取**使用結構描述**。

   1. 在**事件模式**區段中，針對**結構描述類型**，選取**從結構描述登錄檔選取結構描述**。

   1. 針對**結構描述登錄檔**，選擇下拉式方塊，然後輸入結構描述登錄檔的名稱，例如 `aws.events`。您也可以從出現的下拉式清單中選取選項。

   1. 針對**結構描述**，選擇下拉式方塊，然後輸入要使用的結構描述名稱。例如 `aws.s3@ObjectDeleted`。您也可以從出現的下拉式清單中選取選項。

   1. 在**模型**區段中，選擇任何屬性旁的**編輯**按鈕以開啟其屬性內容。視需要設定**關係**與**值**欄位，然後選擇**設定**以儲存屬性。
**注意**  
如需有關屬性定義的資訊，請選擇屬性名稱旁邊的**資訊**圖示。如需有關如何在事件中設定屬性內容的參考資料，請開啟屬性內容對話方塊的**註記**區段。  
若要刪除屬性的内容，請選擇該屬性的**編輯**按鈕，然後選擇**清除**。

   1. 選擇**在 JSON 中產生事件模式**，以 JSON 文字產生並驗證您的事件模式。

   1. (選用) 若要根據您的測試模式測試範例事件，請選擇**測試模式**。

      EventBridge 會顯示一個訊息方塊，說明您的範例事件是否符合事件模式。

      您也可以選擇以下其中一個選項：
      + **複製**：將事件模式複製到設備的剪貼板。
      + **美化**：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。

------
#### [ Custom schema ]

   若要撰寫自訂結構描述並將其轉換為事件模式，請執行下列動作：

   1. 在**建立方法**區段中，針對**方法**，選擇**使用結構描述**。

   1. 在**事件模式**區段中，針對**結構描述類型**，選擇**輸入結構描述**。

   1. 將結構描述輸入文字方塊。您必須將結構描述格式化為有效的 JSON 文字。

   1. 在**模型**區段中，選擇任何屬性旁的**編輯**按鈕以開啟其屬性內容。視需要設定**關係**與**值**欄位，然後選擇**設定**以儲存屬性。
**注意**  
如需有關屬性定義的資訊，請選擇屬性名稱旁邊的**資訊**圖示。如需有關如何在事件中設定屬性內容的參考資料，請開啟屬性內容對話方塊的**註記**區段。  
若要刪除屬性的内容，請選擇該屬性的**編輯**按鈕，然後選擇**清除**。

   1. 選擇**在 JSON 中產生事件模式**，以 JSON 文字產生並驗證您的事件模式。

   1. (選用) 若要根據您的測試模式測試範例事件，請選擇**測試模式**。

      EventBridge 會顯示一個訊息方塊，說明您的範例事件是否符合事件模式。

      您也可以選擇以下其中一個選項：
      + **複製**：將事件模式複製到設備的剪貼板。
      + **美化**：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。

------
#### [ Event pattern ]

   若要以 JSON 格式撰寫自訂事件模式，請執行下列動作：

   1. 在**建立方法**區段中，針對**方法**，選擇**自訂模式 (JSON 編輯器)**。

   1. 針對**事件模式**，請在 JSON 格式文字中輸入您的自訂事件模式。

   1. (選用) 若要根據您的測試模式測試範例事件，請選擇**測試模式**。

      EventBridge 會顯示一個訊息方塊，說明您的範例事件是否符合事件模式。

      您也可以選擇以下其中一個選項：
      + **複製**：將事件模式複製到設備的剪貼板。
      + **美化**：透過新增換行符號、定位鍵和空格鍵，讓 JSON 文字更易於閱讀。
      + **事件模式表單**：打開模式生成器的事件模式。如果模式無法依原樣在模式產生器中呈現，EventBridge 會在開啟模式產生器之前警告您。

------

1. 選擇**建立封存**。

若要確認事件已成功傳送至封存，您可以使用 EventBridge API 的 [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_DescribeArchive.html) 作業來查看 `EventCount` 是否反映封存中的事件數目。如果事件數目為 0，則封存中無任何事件。