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

# 使用管理 Transfer Family 事件 Amazon EventBridge
<a name="eventbridge"></a>

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

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

![\[Amazon 服务将事件发送到 EventBridge 默认事件总线。如果事件与规则的事件模式匹配，则 EventBridge 将该事件发送到为该规则指定的目标。\]](http://docs.amazonaws.cn/transfer/latest/userguide/images/eventbridge-integration-how-it-works.png)


**Topics**
+ [Transfer Family 事件](#supported-events)
+ [使用 EventBridge 规则发送 Transfer Family 事件](#eventbridge-using-events-rules)
+ [Amazon EventBridge 权限](#eventbridge-permissions)
+ [其他 EventBridge 资源](#eventbridge-additonal-resources)
+ [Transfer Family 事件详情参考](events-detail-reference.md)

## Transfer Family 事件
<a name="supported-events"></a>

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

与规则的事件模式相匹配的事件会*尽力*或*持久*地传送到指定目标（请注意，某些事件可能会乱序传送）。这些配送级别在《*亚马逊 EventBridge 事件参考*》中[Amazon 服务事件的配送级别](https://docs.amazonaws.cn/eventbridge/latest/ref/event-delivery-level.html)中进行了描述。
+ SFTP、FTPS 和 FTP 服务器的服务器级事件是在尽力交付的基础上进行的。
+ SFTP 连接器事件在持久的基础上交付。
+ 这些 AS2 活动是在持久的基础上举办的。

以下事件由生成 Transfer Family。有关更多信息，请参阅《Amazon EventBridge 用户指南》**中的 [EventBridge 事件](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-events.html)。

### SFTP、FTPS 和 FTP 服务器事件
<a name="supported-events-servers"></a>

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

**文件上传和下载事件**


| 事件详细信息类型 | 说明 | 
| --- | --- | 
|  [FTP 服务器文件下载已完成](events-detail-reference.md#event-detail-server-events)  |  已成功下载适用于 FTP 协议的文件。  | 
|  [FTP 服务器文件下载失败](events-detail-reference.md#event-detail-server-events)  |  尝试下载 FTP 协议的文件失败。  | 
|  [FTP 服务器文件上传已完成](events-detail-reference.md#event-detail-server-events)  |  已成功上传适用于 FTP 协议的文件。  | 
|  [FTP 服务器文件上传失败](events-detail-reference.md#event-detail-server-events)  |  尝试上传 FTP 协议的文件失败。  | 
|  [FTPS 服务器文件下载已完成](events-detail-reference.md#event-detail-server-events)  |  已成功下载适用于 FTPS 协议的文件。  | 
|  [FTPS 服务器文件下载失败](events-detail-reference.md#event-detail-server-events)  |  尝试下载 FTPS 协议的文件失败。  | 
|  [FTPS 服务器文件上传已完成](events-detail-reference.md#event-detail-server-events)  |  已成功上传适用于 FTPS 协议的文件。  | 
|  [FTPS 服务器文件上传失败](events-detail-reference.md#event-detail-server-events)  |  尝试上传 FTPS 协议的文件失败。  | 
|  [SFTP 服务器文件下载已完成](events-detail-reference.md#event-detail-server-events)  |  已成功下载适用于 SFTP 协议的文件。  | 
|  [SFTP 服务器文件下载失败](events-detail-reference.md#event-detail-server-events)  |  尝试下载 SFTP 协议的文件失败。  | 
|  [SFTP 服务器文件上传已完成](events-detail-reference.md#event-detail-server-events)  |  已成功上传适用于 SFTP 协议的文件。  | 
|  [SFTP 服务器文件上传失败](events-detail-reference.md#event-detail-server-events)  |  尝试上传 SFTP 协议的文件失败。  | 

**其他文件操作事件**


| 事件详细信息类型 | 说明 | 
| --- | --- | 
|  [FTP 服务器目录创建已完成](events-detail-reference.md#event-detail-server-events)  |  已成功为 FTP 协议创建目录。  | 
|  [创建 FTP 服务器目录失败](events-detail-reference.md#event-detail-server-events)  |  尝试为 FTP 协议创建目录失败。  | 
|  [FTP 服务器目录删除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功删除 FTP 协议的目录。  | 
|  [删除 FTP 服务器目录失败](events-detail-reference.md#event-detail-server-events)  |  尝试删除 FTP 协议的目录失败。  | 
|  [FTP 服务器文件删除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功删除符合 FTP 协议的文件。  | 
|  [FTP 服务器文件删除失败](events-detail-reference.md#event-detail-server-events)  |  尝试删除 FTP 协议的文件失败。  | 
|  [FTP 服务器文件重命名已完成](events-detail-reference.md#event-detail-server-events)  |  文件已成功重命名为 FTP 协议。  | 
|  [FTP 服务器文件重命名失败](events-detail-reference.md#event-detail-server-events)  |  尝试重命名 FTP 协议的文件失败。  | 
|  [FTPS 服务器目录创建已完成](events-detail-reference.md#event-detail-server-events)  |  已成功为 FTPS 协议创建目录。  | 
|  [创建 FTPS 服务器目录失败](events-detail-reference.md#event-detail-server-events)  |  尝试为 FTPS 协议创建目录失败。  | 
|  [FTPS 服务器目录删除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功删除 FTPS 协议的目录。  | 
|  [删除 FTPS 服务器目录失败](events-detail-reference.md#event-detail-server-events)  |  尝试删除 FTPS 协议的目录失败。  | 
|  [FTPS 服务器文件删除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功删除 FTPS 协议的文件。  | 
|  [删除 FTPS 服务器文件失败](events-detail-reference.md#event-detail-server-events)  |  尝试删除 FTPS 协议的文件失败。  | 
|  [FTPS 服务器文件重命名已完成](events-detail-reference.md#event-detail-server-events)  |  已成功为 FTPS 协议重命名文件。  | 
|  [FTPS 服务器文件重命名失败](events-detail-reference.md#event-detail-server-events)  |  尝试重命名 FTPS 协议的文件失败。  | 
|  [SFTP 服务器目录创建已完成](events-detail-reference.md#event-detail-server-events)  |  已成功为 SFTP 协议创建目录。  | 
|  [创建 SFTP 服务器目录失败](events-detail-reference.md#event-detail-server-events)  |  尝试为 SFTP 协议创建目录失败。  | 
|  [SFTP 服务器目录删除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功删除 SFTP 协议的目录。  | 
|  [删除 SFTP 服务器目录失败](events-detail-reference.md#event-detail-server-events)  |  尝试删除 SFTP 协议的目录失败。  | 
|  [SFTP 服务器文件删除已完成](events-detail-reference.md#event-detail-server-events)  |  已成功删除 SFTP 协议的文件。  | 
|  [删除 SFTP 服务器文件失败](events-detail-reference.md#event-detail-server-events)  |  尝试删除 SFTP 协议的文件失败。  | 
|  [SFTP 服务器文件重命名已完成](events-detail-reference.md#event-detail-server-events)  |  已成功重命名 SFTP 协议的文件。  | 
|  [SFTP 服务器文件重命名失败](events-detail-reference.md#event-detail-server-events)  |  尝试重命名 SFTP 协议的文件失败。  | 

### SFTP 连接器事件
<a name="supported-events-connectors"></a>

**注意**  
这些事件按持久级别传送，如《*Amazon EventBridge 事件参考*》中[Amazon 服务事件的交付级别](https://docs.amazonaws.cn/eventbridge/latest/ref/event-delivery-level.html)中所述。 EventBridge 


| 事件详细信息类型 | 说明 | 
| --- | --- | 
|  [SFTP 连接器文件发送已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 已成功完成从连接器到远程 SFTP 服务器的文件传输。 | 
|  [SFTP 连接器文件发送失败](events-detail-reference.md#event-detail-sftp-connector-events)  | 从连接器向远程 SFTP 服务器传输文件失败。 | 
|  [SFTP 连接器文件检索已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 已成功完成从远程 SFTP 服务器到连接器的文件传输。 | 
|  [检索 SFTP 连接器文件失败](events-detail-reference.md#event-detail-sftp-connector-events)  | 从远程 SFTP 服务器向连接器传输文件失败。 | 
|  [SFTP 连接器目录列表已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 已成功完成的启动文件目录列出调用。 | 
|  [SFTP 连接器目录列表失败](events-detail-reference.md#event-detail-sftp-connector-events)  | 失败的起始文件目录列表。 | 
|  [SFTP 连接器远程移动已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 已在远程服务器上成功移动或重命名文件或目录。 | 
|  [SFTP 连接器远程移动失败](events-detail-reference.md#event-detail-sftp-connector-events)  | 无法在远程服务器上移动或重命名文件或目录。 | 
|  [SFTP 连接器远程删除已完成](events-detail-reference.md#event-detail-sftp-connector-events)  | 已成功删除远程服务器上的文件或目录。 | 
|  [SFTP 连接器远程删除失败](events-detail-reference.md#event-detail-sftp-connector-events)  | 无法删除远程服务器上的文件或目录。 | 

### AS2 事件
<a name="supported-events-as2"></a>

**注意**  
这些事件按持久级别传送，如《*Amazon EventBridge 事件参考*》中[Amazon 服务事件的交付级别](https://docs.amazonaws.cn/eventbridge/latest/ref/event-delivery-level.html)中所述。 EventBridge 


| 事件详细信息类型 | 说明 | 
| --- | --- | 
|  [AS2 有效载荷接收已完成](events-detail-reference.md#event-detail-as2-server-events)  | 已收到 AS2 消息的有效负载。 | 
|  [AS2 有效载荷接收失败](events-detail-reference.md#event-detail-as2-server-events)  | 尚未收到 AS2 消息的有效负载。 | 
|  [AS2 有效载荷发送已完成](events-detail-reference.md#event-detail-as2-server-events)  |  AS2 消息的有效负载已成功发送。 | 
|  [AS2 有效载荷发送失败](events-detail-reference.md#event-detail-as2-server-events)  |  AS2 消息的有效负载发送失败。 | 
|  [AS2 MDN 接收已完成](events-detail-reference.md#event-detail-as2-server-events)  | 已收到一封 AS2 邮件的消息处置通知。 | 
|  [AS2 MDN 接收失败](events-detail-reference.md#event-detail-as2-server-events)  | 尚未收到留言的 AS2 留言处置通知。 | 
|  [AS2 MDN 发送已完成](events-detail-reference.md#event-detail-as2-server-events)  | 已成功发送 AS2 消息的消息处置通知。 | 
|  [AS2 MDN 发送失败](events-detail-reference.md#event-detail-as2-server-events)  | 某封邮件的 AS2 邮件处理通知发送失败。 | 

## 使用 EventBridge 规则发送 Transfer Family 事件
<a name="eventbridge-using-events-rules"></a>

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

**在 Amazon 中捕捉 Amazon Transfer Family 事件 EventBridge**

1. 登录 Amazon Web Services 管理控制台 并打开 Amazon EventBridge 控制台，网址为[https://console.aws.amazon.com/events/](https://console.amazonaws.cn/events/)。

1. 在导航窗格中，选择**规则**，然后选择**创建规则**。

1. 输入规则的描述性名称，也可以输入描述。

1. 对于**规则类型**，选择**带有事件模式的规则**，然后选择**下一步**。

1. 在**事件来源**部分，选择**Amazon 事件或 EventBridge 合作伙伴事件**。

1. 在 “**创建方法**” 部分中，选择 “**使用图案表单**”。

1. 在**事件模式**部分，提供以下信息。

   1. 对于**事件源**，选择**Amazon 服务**。

   1. 要获得**Amazon 服务**，请选择 “**转移**”。

   1. 对于**事件类型**，选择要触发规则的 Transfer Family 事件类型。

      根据您选择**的事件类型**，可能会显示**事件类型规范 1** 部分。

   1. 如果您看到 “**事件类型规范 1**” 部分，请选择要捕获的特定事件（或选择 “**任何事件**” 以捕获所选事件类型的所有事件）。

   1. （可选）使用**事件模式**编辑器为事件详细信息指定过滤器。

   1. 选择**下一步**。

1. 从 “选择目标**” 中的可用选项中选择一个目标**。从以下可用目标中进行选择。
   + **Amazon 服务**。热门选项包括用于无服务器计算的 Lambda 函数、用于消息处理的 Amazon SQS 队列、用于通知和编排工作流程的 Amazon SNS 主题。 Amazon Step Functions 
   + **EventBridge API 目的地**。如果您想将事件发送到外部的 HTTP 终端节点 Amazon，则可以使用 API 目标作为目标。
   + **EventBridge 活动巴士**。您可以将事件发送到另一个事件总线，可以是同一账户和区域中的另一条事件总线，也可以是不同的账户或区域。

     有关创建事件总线规则的全面说明，请参阅 *Amazon EventBridge 用户指南*中的[创建对事件做出反应的规则](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-create-rule.html)。

   有关选择目标的帮助，请参阅 *Amazon EventBridge 用户指南*中的[选择目标](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-create-rule.html#eb-create-rule-target)。

1. 为您的目标配置任何其他选项，然后选择**下一步**。

1. （可选）向规则添加标签，然后选择**下一步**。

1. 在 “**查看并创建**” 屏幕中，如果一切正常，请选择 “**创建规则**”。

### 为事件创建 Transfer Family 事件模式
<a name="eventbridge-using-events-rules-patterns"></a>

将事件 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"}]
}
```

以下事件模式示例与用户*username*成功下载的 SFTP 相匹配：

```
{
  "source": ["aws.transfer"],
  "detail-type": ["SFTP Server File Download Completed"],
  "detail": {
    "username": [username]
  }
}
```

有关写入事件模式的更多信息，请参阅《EventBridge 用户指南》**中的[事件模式](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-event-patterns.html)。

### 测试事件模式中的 Transfer Family 事件 EventBridge
<a name="eventbridge-using-events-testing"></a>

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

有关更多信息，请参阅*EventBridge 用户指南*[中的使用 EventBridge 沙盒测试事件模式](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-event-pattern-sandbox.html)。

## Amazon EventBridge 权限
<a name="eventbridge-permissions"></a>

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

您指定的目标可能需要特定的权限或配置。有关为目标使用特定服务的更多详细信息，请参阅《Amazon EventBridge 用户指南》**中的 [Amazon EventBridge 目标](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-targets.html)。

## 其他 EventBridge 资源
<a name="eventbridge-additonal-resources"></a>

有关如何使用 EventBridge 处理和管理事件的更多信息，请参阅[https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-what-is.html](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-what-is.html)中的以下主题。
+ 有关事件总线工作原理的详细信息，请参阅 [Amazon EventBridge 事件总线](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-event-bus.html)。
+ 有关事件结构的信息，请参阅[事件](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-events.html)。
+ 有关构造事件模式 EventBridge 以便在将事件与规则进行匹配时使用的信息，请参阅[事件模式](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-event-patterns.html)。
+ 有关创建规则以指定 EventBridge 所处理事件的信息，请参阅[规则](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-rules.html)。
+ 有关如何指定向哪些服务或其他目的地 EventBridge 发送匹配事件的信息，请参阅[目标](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-targets.html)。