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

使用 管理 Transfer Family 事件 Amazon EventBridge

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

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

Transfer Family 事件

Transfer Family 會自動將事件傳送至預設 EventBridge 事件匯流排。您可以在事件匯流排上建立規則，其中每個規則都包含事件模式和一或多個目標。符合規則事件模式的事件會盡最大努力交付至指定的目標，不過，某些事件可能會不按順序交付。

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

SFTP、 FTPS和 FTP 伺服器事件

SFTP 連接器事件

A2S 事件

使用 EventBridge 規則傳送 Transfer Family 事件

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

您可以遵循下列一般步驟來建立規則：

如需建立事件匯流排規則的完整說明，請參閱 EventBridge 使用者指南 中的建立對事件做出反應的規則。

建立事件的事件模式 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下載 username:

{
  "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 使用者指南中的下列主題。