使用管理 Transfer Family 事件 Amazon EventBridge

Amazon EventBridge 是一種使用事件將應用程式元件連接在一起的無伺服器服務，可讓您更輕鬆地建置可擴充的事件驅動應用程式。事件驅動架構是一種構建鬆散耦合的軟件系統的風格，該軟件系統通過發出和響應事件來協同工作。事件代表資源或環境中的變化。

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

主題

• Transfer Family 事件
• 使用 EventBridge 規則傳送 Transfer Family 事件
• Amazon EventBridge 權限
• 其他 EventBridge 資源
• Transfer Family 事件詳細參考

Transfer Family 事件

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

下列事件由產生 Transfer Family。若要取得更多資訊，請參閱《Amazon EventBridge 使用指南》中的EventBridge 事件。

SFTP、FTP 伺服器和 FTP 伺服器事件

事件明細類型	描述
FTP 檔案伺服器下載完成	已成功下載 FTP 通訊協定的檔案。
FTP 檔案伺服器下載失敗	FTP 通訊協定的嘗試下載檔案失敗。
FTP 檔案伺服器上傳完成	FTP 通訊協定的檔案已成功上傳。
FTP 檔案伺服器上傳失敗	FTP 通訊協定的嘗試上傳檔案失敗。
FTPS 檔案伺服器下載完成	已成功下載 FTPS 通訊協定的檔案。
FTPS 檔案伺服器下載失敗	FTPS 通訊協定的嘗試下載檔案失敗。
FTPS 檔案伺服器上傳完成	已成功上傳 FTPS 通訊協定的檔案。
FTPS 檔案伺服器上傳失敗	FTPS 通訊協定的嘗試上傳檔案失敗。
SFTP 伺服器檔案下載完成	SFTP 通訊協定的檔案已成功下載。
SFTP 伺服器檔案下載失敗	SFTP 通訊協定的嘗試下載檔案失敗。
SFTP 伺服器檔案上傳完成	SFTP 通訊協定的檔案已成功上傳。
SFTP 伺服器檔案上傳失敗	SFTP 通訊協定的嘗試上傳檔案失敗。

SFTP 連接器事件

事件明細類型	描述
SFTP 連接器檔案傳送完成	從連接器到遠端 SFTP 伺服器的檔案傳輸已成功完成。
SFTP 連接器檔案傳送失敗	從連接器到遠端 SFTP 伺服器的檔案傳輸失敗。
SFTP 連接器檔案擷取完成	從遠端 SFTP 伺服器到連接器的檔案傳輸已成功完成。
SFTP 連接器檔案擷取失敗	從遠端 SFTP 伺服器到連接器的檔案傳輸失敗。
SFTP 連接器目錄清單已完成	已成功完成的開始檔案目錄列出呼叫。
SFTP 連接器目錄清單失敗	失敗的起始檔案目錄清單。

A2S 活動

事件明細類型	描述
AS2 承載接收已完成	已收到 AS2 訊息的裝載。
AS2 裝載接收失敗	尚未收到 AS2 訊息的裝載。
AS2 承載傳送完成	AS2 訊息的裝載已成功傳送。
AS2 裝載傳送失敗	AS2 訊息的裝載無法傳送。
AS2 MDN 接收完成	已收到 AS2 訊息的訊息配置通知。
AS2 MDN 接收失敗	尚未收到 AS2 訊息的郵件配置通知。
MDN 傳送完成	AS2 訊息的郵件配置通知已成功傳送。
AS2 MDN 傳送失敗	AS2 郵件的郵件配置通知無法傳送。

使用 EventBridge 規則傳送 Transfer Family 事件

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

您可以依照下列一般步驟建立規則：

1. 為指定下列項目的規則建立事件模式：

   • Transfer Family 是規則評估的事件來源。

   • (選擇性) 任何其他要比對的事件資料。

   如需詳細資訊，請參閱 建立事件的 Transfer Family 事件模式。

2. (選擇性) 建立輸入轉換器，在將資訊 EventBridge 傳送至規則目標之前自訂事件中的資料。

   如需詳細資訊，請參閱《EventBridge 使用指南》中的〈輸入轉換〉。

3. 指定您要 EventBridge 傳遞符合事件模式之事件的目標。

   目標可以是其他 AWS 服務、軟體即服務 (SaaS) 應用程式、API 目標或其他自訂端點。如需詳細資訊，請參閱《EventBridge 使用者指南》中的目標。

如需建立事件匯流排規則的完整指示，請參閱《使用指南》中的〈建立對事件做出反應的規則EventBridge 〉。

建立事件的 Transfer Family 事件模式

將事件傳 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 使用指南中的事件模式。

測試 Transfer Family 事件模式 EventBridge

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

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

Amazon EventBridge 權限

Transfer Family 不需要任何其他權限即可將事件傳遞給 Amazon EventBridge。

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

其他 EventBridge 資源

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

• 如需事件匯流排如何運作的詳細資訊，請參閱Amazon EventBridge 事件匯流排。

• 如需有關事件結構的資訊，請參閱事件。

• 如需建構事件模式以便在符合規則時 EventBridge 使用的相關資訊，請參閱事件模式。

• 如需建立規則以指定 EventBridge 處理哪些事件的相關資訊，請參閱規則。

• 如需如何指定 EventBridge 將相符事件傳送至哪些服務或其他目的地的資訊，請參閱目標。