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

管理 Transfer Family 使用的事件 Amazon EventBridge

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

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

Transfer Family events

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

与规则的事件模式相匹配的事件会尽最大努力或持久地传送到指定的目标（请注意，某些事件可能会出现顺序交付）。这些配送级别在《亚马逊 EventBridge 活动参考》中的 AWS 服务事件配送等级中进行了描述。

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

SFTP、FTPS 和 FTP 服务器事件

下表列出了按事件类型组织的 SFTP、FTPS 和 FTP 服务器的事件。

文件上传和下载活动

其他文件操作事件

SFTP 连接器事件

AS2 活动

正在发送 Transfer Family 使用的事件 EventBridge 规则

如果您希望 EventBridge 默认事件总线向目标发送 Transfer Family 事件，则必须创建一条规则，其中包含与所需事件中的数据相匹配 Transfer Family 的事件模式。

为以下对象创建事件模式 Transfer Family events

将事件 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 用户指南》中的以下主题。