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

使用管理 Transfer Family 事件 Amazon EventBridge

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

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

Transfer Family 事件

Transfer Family 自动将事件发送到默认 EventBridge 事件总线。您可以在事件总线上创建规则，其中每条规则都包含一个事件模式和一个或多个目标。

与规则的事件模式相匹配的事件会尽力或持久地传送到指定目标（请注意，某些事件可能会乱序传送）。这些配送级别在《亚马逊 EventBridge 事件参考》中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"}]
}

以下事件模式示例与用户username成功下载的 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 用户指南》中的以下主题。