使用 管理 Transfer Family 事件 Amazon EventBridge - AWS Transfer Family

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

使用 管理 Transfer Family 事件 Amazon EventBridge

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

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

AWS 服務會將事件傳送至 EventBridge 預設事件匯流排。如果事件符合規則的事件模式, 會將事件 EventBridge 傳送至為該規則指定的目標。

Transfer Family 事件

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

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

  • SFTP、FTPS 和 FTP 伺服器的伺服器層級事件會盡最大努力交付。

  • SFTP 連接器事件會以持久的方式交付。

  • AS2 事件會以持久的方式交付。

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

SFTP、FTPS 和 FTP 伺服器事件

下表列出 SFTP、FTPS 和 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 通訊協定的檔案失敗。

其他檔案操作事件

事件詳細資訊類型 描述

FTP 伺服器目錄建立已完成

已成功為 FTP 通訊協定建立目錄。

FTP 伺服器目錄建立失敗

FTP 通訊協定嘗試建立目錄失敗。

FTP 伺服器目錄刪除已完成

已成功刪除 FTP 通訊協定的目錄。

FTP 伺服器目錄刪除失敗

FTP 通訊協定嘗試刪除目錄失敗。

FTP 伺服器檔案刪除已完成

已成功刪除 FTP 通訊協定的檔案。

FTP 伺服器檔案刪除失敗

FTP 通訊協定嘗試刪除檔案失敗。

FTP 伺服器檔案重新命名已完成

已成功重新命名 FTP 通訊協定的檔案。

FTP 伺服器檔案重新命名失敗

嘗試重新命名 FTP 通訊協定的檔案失敗。

FTPS 伺服器目錄建立已完成

已成功為 FTPS 通訊協定建立目錄。

FTPS 伺服器目錄建立失敗

FTPS 通訊協定嘗試建立目錄失敗。

FTPS 伺服器目錄刪除已完成

已成功刪除 FTPS 通訊協定的目錄。

FTPS 伺服器目錄刪除失敗

FTPS 通訊協定嘗試刪除目錄失敗。

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 連接器事件

注意

這些事件會以持久性層級交付至 EventBridge,如 Amazon EventBridge Events ReferenceAWS 服務事件的交付層級所述。

事件詳細資訊類型 描述

SFTP 連接器檔案傳送已完成

從連接器到遠端 SFTP 伺服器的檔案傳輸已成功完成。

SFTP 連接器檔案傳送失敗

從連接器到遠端 SFTP 伺服器的檔案傳輸失敗。

SFTP 連接器檔案擷取已完成

從遠端 SFTP 伺服器到連接器的檔案傳輸已成功完成。

SFTP 連接器檔案擷取失敗

從遠端 SFTP 伺服器到連接器的檔案傳輸失敗。

SFTP 連接器目錄清單已完成

開始檔案目錄,列出已成功完成的呼叫。

SFTP 連接器目錄清單失敗

失敗的啟動檔案目錄清單。

SFTP 連接器遠端移動已完成

檔案或目錄已在遠端伺服器上成功移動或重新命名。

SFTP 連接器遠端移動失敗

檔案或目錄無法在遠端伺服器上移動或重新命名。

已完成 SFTP 連接器遠端刪除

檔案或目錄已成功在遠端伺服器上刪除。

SFTP 連接器遠端刪除失敗

檔案或目錄無法在遠端伺服器上刪除。

AS2 事件

注意

這些事件會以持久性層級交付至 EventBridge,如 Amazon EventBridge Events ReferenceAWS 服務事件的交付層級所述。

事件詳細資訊類型 描述

AS2 承載接收已完成

已收到 AS2 訊息的承載。

AS2 承載接收失敗

尚未收到 AS2 訊息的承載。

AS2 承載傳送已完成

AS2 訊息的承載已成功傳送。

AS2 承載傳送失敗

AS2 訊息的承載無法傳送。

AS2 MDN 接收已完成

已收到 AS2 訊息的訊息處置通知。

AS2 MDN 接收失敗

尚未收到 AS2 訊息的訊息處置通知。

AS2 MDN 傳送已完成

AS2 訊息的訊息處置通知已成功傳送。

AS2 MDN 傳送失敗

AS2 訊息的訊息處置通知無法傳送。

使用 EventBridge 規則傳送 Transfer Family 事件

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

在 Amazon EventBridge 中擷取 AWS Transfer Family 事件
  1. 登入 AWS Management Console ,並在 https://https://console.aws.amazon.com/events/ 開啟 Amazon EventBridge 主控台。

  2. 在導覽窗格中,選擇規則,然後選擇建立規則

  3. 輸入規則的描述性名稱,並選擇性輸入描述。

  4. 針對規則類型,選取具有事件模式的規則,然後選擇下一步

  5. 事件來源區段中,選取AWS 事件或 EventBridge 合作夥伴事件

  6. 建立方法區段中,選擇使用模式表單

  7. 事件模式區段中,提供下列資訊。

    1. 事件來源欄位中,選擇 AWS 服務

    2. 針對AWS 服務,選擇轉接

    3. 針對事件類型,選擇您要觸發規則的 Transfer Family 事件類型。

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

    4. 如果您看到事件類型規格 1 區段,請選取您要擷取的特定事件 (或選取任何事件以擷取所選事件類型的所有事件)。

    5. (選用) 使用事件模式編輯器來指定事件詳細資訊的篩選條件。

    6. 選擇下一步

  8. 選取目標中可用的選項中選擇目標。從下列可用的目標中進行選擇。

    • AWS 服務。熱門選項是用於無伺服器運算的 Lambda 函數、用於訊息處理的 Amazon SQS 佇列、用於通知的 Amazon SNS 主題,以及 AWS Step Functions 用於協調工作流程。

    • EventBridge API 目的地。如果您想要將事件傳送到 外部的 HTTP 端點 AWS,您可以使用 API 目的地做為目標。

    • EventBridge 事件匯流排。您可以將事件傳送至相同帳戶和區域中的另一個事件匯流排,或不同帳戶或區域中的事件匯流排。

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

    如需選取目標的說明,請參閱《Amazon EventBridge 使用者指南》中的選取目標

  9. 為您的目標設定任何其他選項,然後選擇下一步

  10. (選用) 將標籤新增至規則,然後選擇下一步

  11. 檢閱和建立畫面中,如果一切看起來都不錯,請選擇建立規則

建立事件的事件模式 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

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

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

Amazon EventBridge 許可

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

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

其他 EventBridge 資源

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

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

  • 如需事件結構的資訊,請參閱事件

  • 如需建構事件模式 EventBridge 以讓 在比對事件與規則時使用的資訊,請參閱事件模式

  • 如需建立規則以指定哪些事件 EventBridge 程序的詳細資訊,請參閱規則

  • 如需如何指定傳送 EventBridge 相符事件之服務或其他目的地的資訊,請參閱目標