使用管理 Transfer Family 事件 Amazon EventBridge - Amazon Transfer Family
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

使用管理 Transfer Family 事件 Amazon EventBridge

Amazon EventBridge 是一项无服务器服务,它使用事件将应用程序组件连接在一起,这使您可以更轻松地构建可扩展的事件驱动应用程序。事件驱动架构是一种构建松散耦合的软件系统的风格,这些系统通过发射和响应事件来协同工作。事件代表资源或环境中的变化。

与许多 Amazon 服务一样, Transfer Family 生成事件并将其发送到 EventBridge 默认事件总线。请注意,默认事件总线会在每个 Amazon 账户中自动配置。事件总线是接收事件并将其传送到零个或多个目的地或目标的路由器。您可以为事件总线指定规则,该总线在事件到达时对其进行评估。每条规则都会检查事件是否与规则的事件模式相匹配。如果事件匹配,则事件总线会将事件发送到一个或多个指定的目标。

Amazon 服务将事件发送到 EventBridge 默认事件总线。如果事件与规则的事件模式匹配,则 EventBridge 会将该事件发送到为该规则指定的目标。

Transfer Family 事件

Transfer Family 自动将事件发送到默认 EventBridge 事件总线。您可以在事件总线上创建规则,其中每条规则都包含一个事件模式和一个或多个目标。与规则的事件模式相匹配的事件会尽最大努力传送到指定的目标,但是,有些事件可能会乱序传送。

以下事件由生成 Transfer Family。有关更多信息,请参阅《Amazon EventBridge 用户指南》中的EventBridge 事件

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 协议的文件失败。

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 邮件的邮件处置通知。

AS2 MDN 发送已完成

AS2 邮件的邮件处置通知已成功发送。

AS2 MDN 发送失败

AS2 邮件的邮件处置通知发送失败。

使用 EventBridge 规则发送 Transfer Family 事件

如果要 EventBridge 使用默认事件总线向目标发送 Transfer Family 事件,则必须创建一个规则,其中包含与所需事件中的数据匹配 Transfer Family 的事件模式。

您可以按照以下常规步骤创建规则:

  1. 为规则创建事件模式,指定以下内容:

    • Transfer Family 是规则正在评估的事件的来源。

    • (可选)要与之匹配的任何其他事件数据。

    有关更多信息,请参阅 为事件创建 Transfer Family 事件模式

  2. (可选)创建输入转换器,在将信息 EventBridge 发送到规则目标之前,对事件中的数据进行自定义。

    有关更多信息,请参阅《EventBridge 用户指南》中的输入转换

  3. 指定要 EventBridge 向其发送与事件模式匹配的事件的目标。

    目标可以是其他 Amazon 服务、软件即服务 (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

您可以使用 EventBridge 沙盒快速定义和测试事件模式,而不必完成创建或编辑规则的更广泛过程。使用沙盒,您可以定义事件模式,并使用示例事件来确认该模式是否与所需事件相匹配。 EventBridge 允许您选择通过直接从沙箱中使用该事件模式来创建新规则。

有关更多信息,请参阅《EventBridge 用户指南》中的使用 EventBridge 沙盒测试事件模式

Amazon EventBridge 权限

Transfer Family 不需要任何其他权限即可向其发送事件 Amazon EventBridge。

您指定的目标可能需要特定的权限或配置。有关为目标使用特定服务的更多详细信息,请参阅《Amazon EventBridge 用户指南》中的 Amazon EventBridge 目标

其他 EventBridge 资源

有关如何使用 EventBridge 来处理和管理事件的更多信息,请参阅《Amazon EventBridge 用户指南》中的以下主题。

  • 有关事件总线工作原理的详细信息,请参阅 Amazon EventBridge 事件总线

  • 有关事件结构的信息,请参阅事件

  • 有关构造事件模式 EventBridge 以便在将事件与规则进行匹配时使用的信息,请参阅事件模式

  • 有关创建规则以指定 EventBridge 所处理事件的信息,请参阅规则

  • 有关如何指定向哪些服务或其他目的地 EventBridge 发送匹配事件的信息,请参阅目标