

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

# 使用管理 AWS Supply Chain 事件 Amazon EventBridge
<a name="eventbridge-integration"></a>

使用 EventBridge，您可以自动执行其他服务，以响应 Step Functions 标准工作流程的执行状态变化。

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

下面将介绍操作方式：

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

![\[AWS 服务将事件发送到 EventBridge 默认事件总线。如果事件与规则的事件模式匹配，则 EventBridge 将该事件发送到为该规则指定的目标。\]](http://docs.aws.amazon.com/zh_cn/aws-supply-chain/latest/adminguide/images/eventbridge-integration-how-it-works.png)


**Topics**
+ [AWS Supply Chain 事件](#supported-events)
+ [使用 EventBridge 规则交付 AWS Supply Chain 事件](#eventbridge-using-events-rules)
+ [AWS Supply Chain 事件详情参考](events-detail-reference.md)

## AWS Supply Chain 事件
<a name="supported-events"></a>

AWS Supply Chain 自动将以下事件发送到默认 EventBridge 事件总线。与规则的事件模式相匹配的事件将[按](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event.html#eb-service-event-delivery-level)原样传送到指定的目标。事件可能不按顺序传送。

有关更多信息，请参阅《Amazon EventBridge 用户指南》**中的 [EventBridge 事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)。


| 事件详细信息类型 | 说明 | 
| --- | --- | 
|  [AWS 供应链数据集成状态变更](events-detail-reference.md#event-detail-event-name-1-no-caps-or-spaces)  |  显示每个已收录到 AWS Supply Chain的文件的状态。 | 

## 使用 EventBridge 规则交付 AWS Supply Chain 事件
<a name="eventbridge-using-events-rules"></a>

要让 EventBridge 默认事件总线向目标发送 AWS Supply Chain 事件，必须创建规则。每条规则都包含一个事件模式，该模式与事件总线上接收到的每个事件进行 EventBridge 匹配。如果事件数据与指定的事件模式匹配，则将该事件 EventBridge 传送到规则的目标。

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

### 创建与事件匹配 AWS Supply Chain 的事件模式
<a name="eventbridge-using-events-rules-patterns"></a>

每个事件模式是一个 JSON 对象，其中包含：
+ 标识发送事件的服务的 `source` 属性。对于 AWS Supply Chain 事件，来源是`aws.supplychain`。
+ （可选）：包含要匹配的事件类型数组的 `detail-type` 属性。
+ （可选）：包含要匹配的其他事件数据的 `detail` 属性。

例如，以下事件模式与来自的所有`AWS Supply Chain Data Integration Status Change`事件匹配 AWS Supply Chain：

```
{
  "source": ["aws.supplychain"],
  "detail-type": ["AWS Supply Chain Data Integration Status Change"]
}
```

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

# AWS Supply Chain 事件详情参考
<a name="events-detail-reference"></a>

来自 AWS 服务的所有事件都有一组公共字段，其中包含有关事件的元数据，例如作为事件来源的 AWS 服务、事件的生成时间、事件发生的账户和区域等。有关这些常规字段的定义，请参阅《Amazon EventBridge 用户指南》**中的[事件结构参考](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events-structure.html)。

此外，每个事件都有一个 `detail` 字段，其中包该特定事件专有的数据。下面的参考定义了各种 AWS Supply Chain 事件的详细信息字段。

使用 EventBridge 来选择和管理 AWS Supply Chain 事件时，记住以下几点很有用：
+ 来自的所有事件的`source`字段均设置 AWS Supply Chain 为`aws.supplychain`。
+ `detail-type` 字段指定事件类型。

  例如 `AWS Supply Chain Data Integration Status Change`。
+ `detail` 字段包含该特定事件专有的数据。

有关如何构造使规则能够匹配 AWS Supply Chain 事件的事件模式的信息，请参阅《Amazon EventBridge 用户指南》**中的[事件模式](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html)。

有关事件及其 EventBridge 处理方式的更多信息，请参阅《*Amazon EventBridge 用户指南*》中的[Amazon EventBridge 事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-events.html)。

## AWS 供应链数据集成状态变更
<a name="event-detail-event-name-1-no-caps-or-spaces"></a>

以下是该`AWS Supply Chain Data Integration Status Change event`事件的示例。

```
                  
{
    "version": "0",
    "id": "instanceID",
    "detail-type": "AWS Supply Chain Data Integration Status Change",
    "source": "aws.supplychain",
    "account": "acccountID",
    "time": "2024-03-30T12:26:13Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "version": "1.0",
        "instanceId": "instanceID",
        "flowArn": "arn:aws:scn:region:acccountID:instance/instanceID/data-integration-flows/flowname",
        "flowExecutionId": "flowExecutionId",
        "status": "IN_PROGRESS",
        "startTime": "2024-03-30T12:26:13Z",
        "endTime": "",
        "message": "",
        "sourceType": "S3",
        "sourceInfo": {
            "s3Source": {
                "bucketName": "aws-supply-chain-data-instanceID",
                "key": "flowname"
            }
        }
    }
}
```

`endTime`仅在*状态*为失败或成功时可用。