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

# 使用 管理 Transfer Family 事件 Amazon EventBridge
<a name="eventbridge"></a>

Amazon EventBridge 是一種無伺服器服務，使用事件將應用程式元件連接在一起，可讓您更輕鬆地建置可擴展的事件驅動型應用程式。事件驅動型架構是一種透過發出和回應事件來建置鬆耦合軟體系統的方式。事件代表資源或環境中的變更。

如同許多 AWS 服務， Transfer Family 會產生事件並將其傳送至 EventBridge 預設事件匯流排。請注意，預設事件匯流排會自動佈建在每個 AWS 帳戶中。事件匯流排是接收事件，並將事件傳遞至零個或多個目的地或*目標*的路由器。您可以為事件匯流排指定規則，以在事件到達時評估事件。每項規則都會檢查事件是否與規則的*事件模式*相符。如果事件相符，事件匯流排會將事件傳送至一或多個指定的目標。

![\[AWS 服務會將事件傳送至 EventBridge 預設事件匯流排。如果事件符合規則的事件模式， 會將事件 EventBridge 傳送至為該規則指定的目標。\]](http://docs.aws.amazon.com/zh_tw/transfer/latest/userguide/images/eventbridge-integration-how-it-works.png)


**Topics**
+ [Transfer Family 事件](#supported-events)
+ [使用 EventBridge 規則傳送 Transfer Family 事件](#eventbridge-using-events-rules)
+ [Amazon EventBridge 許可](#eventbridge-permissions)
+ [其他 EventBridge 資源](#eventbridge-additonal-resources)
+ [Transfer Family 事件詳細資訊參考](events-detail-reference.md)

## Transfer Family 事件
<a name="supported-events"></a>

Transfer Family 會自動將事件傳送至預設 EventBridge 事件匯流排。您可以在事件匯流排上建立規則，其中每個規則都包含事件模式和一或多個目標。

符合規則事件模式的事件會*盡最大努力*或*持久性*交付至指定的目標 （請注意，某些事件可能會不按順序交付）。這些交付層級說明於 *Amazon EventBridge Events Reference* 中[AWS 服務事件的交付層級](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)。
+ SFTP、FTPS 和 FTP 伺服器的伺服器層級事件會盡最大努力交付。
+ SFTP 連接器事件會以持久的方式交付。
+ AS2 事件會以持久的方式交付。

下列事件是由 產生 Transfer Family。如需詳細資訊，請參閱*Amazon EventBridge 《 使用者指南*》中的[EventBridge 事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)。

### SFTP、FTPS 和 FTP 伺服器事件
<a name="supported-events-servers"></a>

下表列出 SFTP、FTPS 和 FTP 伺服器的事件，依事件類型組織。

**檔案上傳和下載事件**


| 事件詳細資訊類型 | Description | 
| --- | --- | 
|  [FTP 伺服器檔案下載已完成](events-detail-reference.md#event-detail-server-events)  |  已成功下載 FTP 通訊協定的檔案。  | 
|  [FTP 伺服器檔案下載失敗](events-detail-reference.md#event-detail-server-events)  |  FTP 通訊協定嘗試下載檔案失敗。  | 
|  [FTP 伺服器檔案上傳已完成](events-detail-reference.md#event-detail-server-events)  |  已成功上傳 FTP 通訊協定的檔案。  | 
|  [FTP 伺服器檔案上傳失敗](events-detail-reference.md#event-detail-server-events)  |  FTP 通訊協定嘗試上傳檔案失敗。  | 
|  [FTPS 伺服器檔案下載已完成](events-detail-reference.md#event-detail-server-events)  |  已成功下載 FTPS 通訊協定的檔案。  | 
|  [FTPS 伺服器檔案下載失敗](events-detail-reference.md#event-detail-server-events)  |  FTPS 通訊協定嘗試下載檔案失敗。  | 
|  [FTPS 伺服器檔案上傳已完成](events-detail-reference.md#event-detail-server-events)  |  已成功上傳 FTPS 通訊協定的檔案。  | 
|  [FTPS 伺服器檔案上傳失敗](events-detail-reference.md#event-detail-server-events)  |  FTPS 通訊協定嘗試上傳檔案失敗。  | 
|  [SFTP 伺服器檔案下載已完成](events-detail-reference.md#event-detail-server-events)  |  已成功下載 SFTP 通訊協定的檔案。  | 
|  [SFTP 伺服器檔案下載失敗](events-detail-reference.md#event-detail-server-events)  |  嘗試下載 SFTP 通訊協定的檔案失敗。  | 
|  [已完成 SFTP 伺服器檔案上傳](events-detail-reference.md#event-detail-server-events)  |  SFTP 通訊協定的檔案已成功上傳。  | 
|  [SFTP 伺服器檔案上傳失敗](events-detail-reference.md#event-detail-server-events)  |  嘗試上傳 SFTP 通訊協定的檔案失敗。  | 

**其他檔案操作事件**


| 事件詳細資訊類型 | Description | 
| --- | --- | 
|  [FTP 伺服器目錄建立已完成](events-detail-reference.md#event-detail-server-events)  |  已成功為 FTP 通訊協定建立目錄。  | 
|  [FTP 伺服器目錄建立失敗](events-detail-reference.md#event-detail-server-events)  |  FTP 通訊協定嘗試建立目錄失敗。  | 
|  [FTP 伺服器目錄刪除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功刪除 FTP 通訊協定的目錄。  | 
|  [FTP 伺服器目錄刪除失敗](events-detail-reference.md#event-detail-server-events)  |  FTP 通訊協定嘗試刪除目錄失敗。  | 
|  [FTP 伺服器檔案刪除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功刪除 FTP 通訊協定的檔案。  | 
|  [FTP 伺服器檔案刪除失敗](events-detail-reference.md#event-detail-server-events)  |  FTP 通訊協定嘗試刪除檔案失敗。  | 
|  [FTP 伺服器檔案重新命名已完成](events-detail-reference.md#event-detail-server-events)  |  已成功重新命名 FTP 通訊協定的檔案。  | 
|  [FTP 伺服器檔案重新命名失敗](events-detail-reference.md#event-detail-server-events)  |  嘗試重新命名 FTP 通訊協定的檔案失敗。  | 
|  [FTPS 伺服器目錄建立已完成](events-detail-reference.md#event-detail-server-events)  |  已成功為 FTPS 通訊協定建立目錄。  | 
|  [FTPS 伺服器目錄建立失敗](events-detail-reference.md#event-detail-server-events)  |  FTPS 通訊協定嘗試建立目錄失敗。  | 
|  [FTPS 伺服器目錄刪除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功刪除 FTPS 通訊協定的目錄。  | 
|  [FTPS 伺服器目錄刪除失敗](events-detail-reference.md#event-detail-server-events)  |  FTPS 通訊協定嘗試刪除目錄失敗。  | 
|  [FTPS 伺服器檔案刪除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功刪除 FTPS 通訊協定的檔案。  | 
|  [FTPS 伺服器檔案刪除失敗](events-detail-reference.md#event-detail-server-events)  |  FTPS 通訊協定嘗試刪除檔案失敗。  | 
|  [FTPS 伺服器檔案重新命名已完成](events-detail-reference.md#event-detail-server-events)  |  已成功重新命名 FTPS 通訊協定的檔案。  | 
|  [FTPS 伺服器檔案重新命名失敗](events-detail-reference.md#event-detail-server-events)  |  FTPS 通訊協定嘗試重新命名檔案失敗。  | 
|  [SFTP 伺服器目錄建立已完成](events-detail-reference.md#event-detail-server-events)  |  已成功為 SFTP 通訊協定建立目錄。  | 
|  [SFTP 伺服器目錄建立失敗](events-detail-reference.md#event-detail-server-events)  |  SFTP 通訊協定嘗試建立目錄失敗。  | 
|  [已完成 SFTP 伺服器目錄刪除](events-detail-reference.md#event-detail-server-events)  |  SFTP 通訊協定的目錄已成功刪除。  | 
|  [SFTP 伺服器目錄刪除失敗](events-detail-reference.md#event-detail-server-events)  |  嘗試刪除 SFTP 通訊協定的目錄失敗。  | 
|  [SFTP 伺服器檔案刪除已完成](events-detail-reference.md#event-detail-server-events)  |  SFTP 通訊協定的檔案已成功刪除。  | 
|  [SFTP 伺服器檔案刪除失敗](events-detail-reference.md#event-detail-server-events)  |  嘗試刪除 SFTP 通訊協定的檔案失敗。  | 
|  [SFTP 伺服器檔案重新命名已完成](events-detail-reference.md#event-detail-server-events)  |  SFTP 通訊協定的檔案已成功重新命名。  | 
|  [SFTP 伺服器檔案重新命名失敗](events-detail-reference.md#event-detail-server-events)  |  嘗試重新命名 SFTP 通訊協定的檔案失敗。  | 

### SFTP 連接器事件
<a name="supported-events-connectors"></a>

**注意**  
這些事件會以持久性層級交付至 EventBridge，如 *Amazon EventBridge Events Reference* 中[AWS 服務事件的交付層級](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)所述。


| 事件詳細資訊類型 | Description | 
| --- | --- | 
|  [SFTP 連接器檔案傳送已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 從連接器到遠端 SFTP 伺服器的檔案傳輸已成功完成。 | 
|  [SFTP 連接器檔案傳送失敗](events-detail-reference.md#event-detail-sftp-connector-events)  | 從連接器到遠端 SFTP 伺服器的檔案傳輸失敗。 | 
|  [SFTP 連接器檔案擷取已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 從遠端 SFTP 伺服器到連接器的檔案傳輸已成功完成。 | 
|  [SFTP 連接器檔案擷取失敗](events-detail-reference.md#event-detail-sftp-connector-events)  | 從遠端 SFTP 伺服器到連接器的檔案傳輸失敗。 | 
|  [SFTP 連接器目錄清單已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 開始檔案目錄，列出已成功完成的呼叫。 | 
|  [SFTP 連接器目錄清單失敗](events-detail-reference.md#event-detail-sftp-connector-events)  | 失敗的啟動檔案目錄清單。 | 
|  [SFTP 連接器遠端移動已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 檔案或目錄已在遠端伺服器上成功移動或重新命名。 | 
|  [SFTP 連接器遠端移動失敗](events-detail-reference.md#event-detail-sftp-connector-events)  | 檔案或目錄無法在遠端伺服器上移動或重新命名。 | 
|  [SFTP 連接器遠端刪除已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 檔案或目錄已成功在遠端伺服器上刪除。 | 
|  [SFTP 連接器遠端刪除失敗](events-detail-reference.md#event-detail-sftp-connector-events)  | 檔案或目錄無法在遠端伺服器上刪除。 | 

### AS2 事件
<a name="supported-events-as2"></a>

**注意**  
這些事件會以耐久的層級交付至 EventBridge，如 *Amazon EventBridge Events Reference* 中[AWS 服務事件的交付層級](https://docs.aws.amazon.com/eventbridge/latest/ref/event-delivery-level.html)所述。


| 事件詳細資訊類型 | Description | 
| --- | --- | 
|  [AS2 承載接收已完成](events-detail-reference.md#event-detail-as2-server-events)  | 已收到 AS2 訊息的承載。 | 
|  [AS2 承載接收失敗](events-detail-reference.md#event-detail-as2-server-events)  | 尚未收到 AS2 訊息的承載。 | 
|  [AS2 承載傳送已完成](events-detail-reference.md#event-detail-as2-server-events)  | AS2 訊息的承載已成功傳送。 | 
|  [AS2 承載傳送失敗](events-detail-reference.md#event-detail-as2-server-events)  | AS2 訊息的承載無法傳送。 | 
|  [AS2 MDN 接收已完成](events-detail-reference.md#event-detail-as2-server-events)  | 已收到 AS2 訊息的訊息處置通知。 | 
|  [AS2 MDN 接收失敗](events-detail-reference.md#event-detail-as2-server-events)  | 尚未收到 AS2 訊息的訊息處置通知。 | 
|  [AS2 MDN 傳送已完成](events-detail-reference.md#event-detail-as2-server-events)  | AS2 訊息的訊息處置通知已成功傳送。 | 
|  [AS2 MDN 傳送失敗](events-detail-reference.md#event-detail-as2-server-events)  | AS2 訊息的訊息處置通知無法傳送。 | 

## 使用 EventBridge 規則傳送 Transfer Family 事件
<a name="eventbridge-using-events-rules"></a>

如果您希望 EventBridge 預設事件匯流排將 Transfer Family 事件傳送至目標，您必須建立規則，其中包含符合所需 Transfer Family 事件中資料的事件模式。

**在 Amazon EventBridge 中擷取 AWS Transfer Family 事件**

1. 登入 AWS 管理主控台 ，並在 https：//[https://console.aws.amazon.com/events/](https://console.aws.amazon.com/events/) 開啟 Amazon EventBridge 主控台。

1. 在導覽窗格中，選擇**規則**，然後選擇**建立規則**。

1. 輸入規則的描述性名稱，然後選擇性地輸入描述。

1. 針對**規則類型**，選取**具有事件模式的規則**，然後選擇**下一步**。

1. 在**事件來源**區段中，選取**AWS 事件或 EventBridge 合作夥伴事件**。

1. 在**建立方法**區段中，選擇**使用模式表單**。

1. 在**事件模式**區段中，提供下列資訊。

   1. 在**事件來源**欄位中，選擇 **AWS 服務**。

   1. 針對**AWS 服務**，選擇**轉接**。

   1. 針對**事件類型**，選擇您要觸發規則的 Transfer Family 事件類型。

      根據您的**事件類型**選擇，您可能會看到**事件類型規格 1 **區段。

   1. 如果您看到**事件類型規格 1** 區段，請選取您要擷取的特定事件 （或選取**任何事件**以擷取所選事件類型的所有事件）。

   1. （選用） 使用**事件模式**編輯器來指定事件詳細資訊的篩選條件。

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

1. 從**選取目標中可用的選項中選擇目標**。從下列可用的目標中進行選擇。
   + **AWS 服務**。熱門選項是用於無伺服器運算的 Lambda 函數、用於訊息處理的 Amazon SQS 佇列、用於通知的 Amazon SNS 主題，以及 AWS Step Functions 用於協調工作流程。
   + **EventBridge API 目的地**。如果您想要將事件傳送至 外部的 HTTP 端點 AWS，您可以使用 API 目的地做為目標。
   + **EventBridge 事件匯流排**。您可以將事件傳送至相同帳戶和區域中的另一個事件匯流排，或不同帳戶或區域中的事件匯流排。

     如需建立事件匯流排規則的完整說明，請參閱《*Amazon EventBridge 使用者指南*》中的[建立對事件做出反應的規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html)。

   如需選取目標的說明，請參閱《*Amazon EventBridge 使用者指南*》中的[選取目標](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-create-rule.html#eb-create-rule-target)。

1. 為您的目標設定任何其他選項，然後選擇**下一步**。

1. （選用） 將標籤新增至規則，然後選擇**下一步**。

1. 在**檢閱和建立**畫面中，如果一切看起來都不錯，請選擇**建立規則**。

### 建立事件的事件模式 Transfer Family
<a name="eventbridge-using-events-rules-patterns"></a>

當 將事件 Transfer Family 交付至預設事件匯流排時， EventBridge 會使用為每個規則定義的事件模式來判斷事件是否應交付至規則的目標。事件模式符合所需 Transfer Family 事件中的資料。每個事件模式都是包含下列項目的 JSON 物件：
+ 識別傳送事件之服務的 `source` 屬性。對於 Transfer Family 事件，來源為 `aws.transfer`。
+ （選用） `detail-type` 屬性，其中包含要比對的事件類型陣列。
+ （選用） `detail` 屬性，其中包含要比對的任何其他事件資料。

例如，下列事件模式會比對來自 的所有事件 Transfer Family：

```
{
  "source": ["aws.transfer"]
}
```

下列事件模式範例符合所有 SFTP 連接器事件：

```
{
  "source": ["aws.transfer"],
  "detail-type": ["SFTP Connector File Send Completed", "SFTP Connector File Retrieve Completed",
                  "SFTP Connector File Retrieve Failed", "SFTP Connector File Send Failed"]
}
```

下列事件模式範例符合所有 Transfer Family 失敗事件：

```
{
  "source": ["aws.transfer"],
  "detail-type": [{"wildcard", "*Failed"}]
}
```

下列事件模式範例符合使用者*使用者名稱*的成功 SFTP 下載：

```
{
  "source": ["aws.transfer"],
  "detail-type": ["SFTP Server File Download Completed"],
  "detail": {
    "username": [username]
  }
}
```

如需撰寫事件模式的詳細資訊，請參閱*EventBridge 《 使用者指南*》中的[事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)。

### 在 中測試 Transfer Family 事件的事件模式 EventBridge
<a name="eventbridge-using-events-testing"></a>

您可以使用 EventBridge 沙盒快速定義和測試事件模式，而無需完成更廣泛的規則建立或編輯程序。您可以使用沙盒定義事件模式，並使用範例事件來確認模式符合所需的事件。 EventBridge 可讓您直接從沙盒使用該事件模式來建立新規則。

如需詳細資訊，請參閱*EventBridge 《 使用者指南*》中的[使用 EventBridge 沙盒測試事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-pattern-sandbox.html)。

## Amazon EventBridge 許可
<a name="eventbridge-permissions"></a>

Transfer Family 不需要任何額外的許可即可交付事件 Amazon EventBridge。

您指定的目標可能需要特定許可或組態。如需針對目標使用特定服務的詳細資訊，請參閱*Amazon EventBridge 《 使用者指南*》中的[Amazon EventBridge 目標](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)。

## 其他 EventBridge 資源
<a name="eventbridge-additonal-resources"></a>

如需如何使用 EventBridge 處理和管理事件的詳細資訊，請參閱[https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html)》中的下列主題。
+ 如需事件匯流排如何運作的詳細資訊，請參閱[Amazon EventBridge 事件匯流排](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-bus.html)。
+ 如需事件結構的資訊，請參閱[事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)。
+ 如需建構事件模式 EventBridge 以讓 在比對事件與規則時使用的資訊，請參閱[事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)。
+ 如需建立規則以指定哪些事件 EventBridge 程序的詳細資訊，請參閱[規則](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-rules.html)。
+ 如需如何指定傳送 EventBridge 相符事件之服務或其他目的地的資訊，請參閱[目標](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-targets.html)。