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

使用 管理 Transfer Family 事件 Amazon EventBridge

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

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

Transfer Family 事件

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

符合規則事件模式的事件會盡最大努力或持久性交付至指定的目標 （請注意，某些事件可能會不按順序交付）。這些交付層級說明於 Amazon EventBridge Events Reference 中AWS 服務事件的交付層級。

以下事件由 產生 Transfer Family。如需詳細資訊，請參閱Amazon EventBridge 《 使用者指南》中的EventBridge 事件。

SFTP、FTPS 和 FTP 伺服器事件

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

檔案上傳和下載事件

其他檔案操作事件

SFTP 連接器事件

AS2 事件

使用 EventBridge 規則傳送 Transfer Family 事件

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

建立事件的事件模式 Transfer Family

當 將事件 Transfer Family 交付至預設事件匯流排時， EventBridge 會使用為每個規則定義的事件模式來判斷事件是否應交付至規則的目標。事件模式符合所需 Transfer Family 事件中的資料。每個事件模式都是包含下列項目的 JSON 物件：

例如，下列事件模式會比對來自 的所有事件 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 《 使用者指南》中的事件模式。

在 中測試 Transfer Family 事件的事件模式 EventBridge

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

如需詳細資訊，請參閱EventBridge 《 使用者指南》中的使用 EventBridge 沙盒測試事件模式。

Amazon EventBridge 許可

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

您指定的目標可能需要特定許可或組態。如需針對目標使用特定服務的詳細資訊，請參閱Amazon EventBridge 《 使用者指南》中的Amazon EventBridge 目標。

其他 EventBridge 資源

如需如何使用 EventBridge 處理和管理事件的詳細資訊，請參閱Amazon EventBridge 《 使用者指南》中的下列主題。