

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

# 使用 Ama AWS 支持 zon 集成到事件驱动的应用程序中 EventBridge
<a name="eventbridge-integration"></a>

您可以将事件驱动的应用程序 (EDAs) 整合 AWS 支持 到事件驱动的应用程序中，这些应用程序使用中发生的事件在 AWS 支持 应用程序组件之间进行通信并启动下游进程。

例如，每当您的账户中发生以下 AWS 支持 事件时，您都会收到通知：
+ 创建、解决或重新打开支持案例
+ 将通信添加到现有支持案例

为此，您可以使用 Amazon EventBridge 将事件从其他软件组件路由 AWS 支持 到其他软件组件。Amazon EventBridge 是一项无服务器服务，它使用事件将应用程序组件连接在一起，这样您就可以更轻松地将 AWS 服务集成 AWS 支持 到事件驱动的架构中，而无需额外的代码和操作。

## 如何 EventBridge 路由 AWS 支持 事件
<a name="eventbridge-routes-service-events-aws.support"></a>

以下是处理 AWS 支持 事件的 EventBridge 方式：

与许多 AWS 服务一样， AWS 支持 生成事件并将其发送到 EventBridge 默认*事件总线*。事件总线是接收事件并将其路由到您所指定的目的地或*目标*的路由器。目标可以包括其他 AWS 服务、定制应用程序和 SaaS 合作伙伴应用程序。

EventBridge 根据您在事件总线上创建的*规则*对事件进行路由。对于每条规则，您可以指定筛选条件或*事件模式*，以便仅选择所需的事件。每当向事件总线发送事件时，都要将其 EventBridge 与每条规则进行比较。如果事件符合规则，则将事件 EventBridge 路由到指定的目标。

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


## AWS 支持 事件
<a name="supported-events"></a>

AWS 支持 自动将以下事件发送到默认 EventBridge 事件总线。


| 事件详细信息类型 | 说明 | 
| --- | --- | 
|  [支持案例更新](event-detail-support-case-update.md)  |  表示支持案例中的更改。  | 

### 事件结构
<a name="eventbridge-event-structure"></a>

来自 AWS 服务的所有事件都包含两种类型的数据：
+ 一组常用字段，其中包含有关事件的元数据，例如作为事件来源的 AWS 服务、事件的生成时间、事件发生的账户和地区等。有关这些常规字段的定义，请参阅 *Amazon Events 参考中的 EventBridge 事件*[结构](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)。
+ `detail` 字段包含该特定服务事件专有的数据。

### AWS 支持 活动通过以下方式交付 AWS CloudTrail
<a name="eventbridge-events-via-cloudtrail"></a>

AWS 服务可以将事件直接发送到 EventBridge 默认事件总线。此外，还 AWS CloudTrail 会向发送源自多个 AWS 服务的事件。 EventBridge 这些事件可能包括 API 调用、控制台登录和操作、服务事件和 Ins CloudTrail ights。有关更多信息，请参阅《*EventBridge 用户指南》 AWS CloudTrail*中的[通过交付的AWS 服务事件](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-service-event-cloudtrail.html)。

有关发送到 AWS 支持 的事件列表 EventBridge，请参阅《[https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html](https://docs.aws.amazon.com/eventbridge/latest/ref/welcome.html)》中的 AWS 支持 主题。

## 创建与事件匹配 AWS 支持 的事件模式
<a name="eventbridge-event-delivery-filter"></a>

事件模式是一种筛选条件，用于指定您要选择的事件应包含的数据。

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

例如，以下事件模式将从 AWS 支持中选择所有支持案例更新事件：

```
{
  "source": ["aws.support"],
  "detail-type": ["Support Case Update"]
}
```

通过在事件本身中包含值，让事件选择更具针对性。例如，以下事件模式与代表正重新打开的案例的支持案例更新事件相匹配：

```
{
  "source": ["aws.support"],
  "detail-type": ["Support Case Update"],
  "detail": {
      "event-name": "ReopenCase"
    }
}
```

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

### 另请参阅
<a name="see-also-eventbridge-support"></a>

有关如何 EventBridge 与一起使用的更多信息 AWS 支持，请参阅以下资源：
+ [如何使用亚马逊自动执行 AWS 支持 API EventBridge](https://aws.amazon.com/blogs/mt/how-to-automate-aws-support-api-with-amazon-eventbridge)
+ [AWS 支持 案例活动通知器已](https://github.com/aws-samples/aws-support-case-activity-notifier)开启 GitHub

# 支持案例更新事件
<a name="event-detail-support-case-update"></a>

以下是 `Support Case Update` 事件的详细信息字段。

下面包含`source`和`detail-type`字段，因为它们包含 AWS 支持 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅 *Amazon Events 参考中的 EventBridge 事件*[结构](https://docs.aws.amazon.com/eventbridge/latest/ref/overiew-event-structure.html)。

```
{
  . . .,
  "detail-type": "Support Case Update",
  "source": "aws.support",
  . . .,
  "detail": {
    "case-id" : "string",
    "display-id" : "string",
    "communication-id" : "string",
    "event-name" : "string",
    "origin" : "string"
  }
}
```

`detail-type`  <a name="support-case-update-detail-type"></a>
标识事件的类型。  
对于这一事件，此值为 `Support Case Update`。

`source`  <a name="support-case-update-source"></a>
标识生成事件的服务。对于 AWS 支持 事件，此值为`aws.support`。

`detail`  <a name="support-case-update-detail"></a>
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。  
对于此事件，此数据包括：    
`case-id`  <a name="support-case-update-case-id"></a>
支持案例 ID。案例 ID 是一个字母数字字符串，格式如下：case-*12345678910-2013-c4c1d2bf33c5cf47*。  
`display-id`  <a name="support-case-update-display-id"></a>
 AWS 支持 中心页面上案例的标识符。  
`communication-id`  <a name="support-case-update-communication-id"></a>
通信 ID。  
`event-name`  <a name="support-case-update-event-name"></a>
*有效值*：`CreateCase` \$1 `AddCommunicationToCase` \$1 `ResolveCase` \$1 `ReopenCase`  
指定支持案例事件的类型。  
`origin`  <a name="support-case-update-origin"></a>
*有效值*：`AWS` \$1 `CUSTOMER`  
指定您或 AWS 支持 代理是否在支持案例中添加了案例通信。  
目前，仅 `event-name` 为 `AddCommunicationToCase` 的事件会包含此值。

**Example 支持案例更新事件示例：支持案例已创建**  <a name="event-detail-support-case-update.example-1"></a>

```
{
    "version": "0",
    "id": "3433df007-9285-55a3-f6d1-536944be45d7",
    "detail-type": "Support Case Update",
    "source": "aws.support",
    "account": "111122223333",
    "time": "2022-02-21T15:51:19Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "case-id": "case-111122223333-muen-2022-7118885805350839",
        "display-id": "1234563851",
        "communication-id": "",
        "event-name": "CreateCase",
        "origin": ""
    }
}
```

**Example Support Case Update 事件示例：对支持案例的 AWS 支持 回复**  <a name="event-detail-support-case-update.example-2"></a>

```
{
    "version": "0",
    "id": "f90cb8cb-32be-1c91-c0ba-d50b4ca5e51b",
    "detail-type": "Support Case Update",
    "source": "aws.support",
    "account": "111122223333",
    "time": "2022-02-21T15:51:31Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "case-id": "case-111122223333-muen-2022-7118885805350839",
        "display-id": "1234563851",
        "communication-id": "ekko:us-east-1:12345678-268a-424b-be08-54613cab84d2",
        "event-name": "AddCommunicationToCase",
        "origin": "AWS"
    }
}
```

**Example 支持案例更新事件示例：支持案例已解决**  <a name="event-detail-support-case-update.example-3"></a>

```
{
    "version": "0",
    "id": "1aa4458d-556f-732e-ddc1-4a5b2fbd14a5",
    "detail-type": "Support Case Update",
    "source": "aws.support",
    "account": "111122223333",
    "time": "2022-02-21T15:51:31Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "case-id": "case-111122223333-muen-2022-7118885805350839",
        "display-id": "1234563851",
        "communication-id": "",
        "event-name": "ResolveCase",
        "origin": ""
    }
}
```

**Example 支持案例更新事件示例：支持案例已重新打开**  <a name="event-detail-support-case-update.example-4"></a>

```
{
    "version": "0",
    "id": "3bb9d8fe-6089-ad27-9508-804209b233ad",
    "detail-type": "Support Case Update",
    "source": "aws.support",
    "account": "111122223333",
    "time": "2022-02-21T15:47:19Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "case-id": "case-111122223333-muen-2021-27f40618fe0303ea",
        "display-id": "1234563851",
        "communication-id": "",
        "event-name": "ReopenCase",
        "origin": ""
    }
}
```