

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

# Amazon 上的活动 EventBridge
<a name="eb-events"></a>

*事件* 表示环境中发生的改变，这些环境包括 Amazon 环境，SaaS 合作伙伴服务或应用程序，或您的某个应用程序或服务等。以下是事件的示例：
+ 当实例状态发生变更（例如从待处理变为正在运行）时，Amazon EC2 会生成一个事件。
+ Amazon CloudFormation 在创建、更新或删除堆栈时生成一个事件。
+ Amazon CloudTrail 在您进行 API 调用时发布事件。

您还可以设置定期生成的计划事件。

事件表示为 JSON 对象，都具有相似的结构和相同的顶级字段。有关更多信息，请参阅《[事件*参考》中的EventBridge 事件*结构](https://docs.amazonaws.cn/eventbridge/latest/ref/welcome.html#overiew-event-structure)。

## 来自 Amazon 服务的事件
<a name="eb-service-event"></a>

许多 Amazon 服务都会生成 EventBridge 接收到的事件。当你账户中的某项 Amazon 服务向发送事件时 EventBridge，它会转到你账户的默认事件总线。

有关向其发送事件的 Amazon 服务及其发送的事件的列表，请参阅[EventBridge 事件参考](https://docs.amazonaws.cn/eventbridge/latest/ref/welcome.html)。 EventBridge

Amazon 服务在*持久*或*尽力而为的基础 EventBridge *上向发送事件。有关更多信息，请参阅《[事件*参考》中的EventBridge 事件*交付级别](https://docs.amazonaws.cn/eventbridge/latest/ref/welcome.html#event-delivery-level)。

# `PutEvents`在 Amazon 中使用发送事件 EventBridge
<a name="eb-putevents"></a>

该`PutEvents`操作 EventBridge 在单个请求中向发送多个[事件](eb-events.md)。有关更多信息，请参阅 [PutEvents](https://docs.amazonaws.cn/eventbridge/latest/APIReference/API_PutEvents.html)*Amazon EventBridge API 参考和*Amazon CLI 命令*参考*中的 [put-events](https://docs.amazonaws.cn/cli/latest/reference/events/put-events.html)。

每个 `PutEvents` 请求可支持有限数目的条目。有关更多信息，请参阅 [亚马逊 EventBridge 配额](eb-quota.md)。`PutEvents` 操作将尝试按请求的自然顺序处理所有条目。在您致电后`PutEvents`，为每个事件 EventBridge 分配一个唯一的 ID。

以下示例 Java 代码向发送了两个相同的事件 EventBridge。

------
#### [ Amazon SDK for Java Version 2.x ]

```
EventBridgeClient eventBridgeClient =
    EventBridgeClient.builder().build();

PutEventsRequestEntry requestEntry = PutEventsRequestEntry.builder()
    .resources("resource1", "resource2")
    .source("com.mycompany.myapp")
    .detailType("myDetailType")
    .detail("{ \"key1\": \"value1\", \"key2\": \"value2\" }")
    .build();

List <
PutEventsRequestEntry > requestEntries = new ArrayList <
PutEventsRequestEntry > ();
requestEntries.add(requestEntry);

PutEventsRequest eventsRequest = PutEventsRequest.builder()
    .entries(requestEntries)
    .build();

PutEventsResponse result = eventBridgeClient.putEvents(eventsRequest);

for (PutEventsResultEntry resultEntry: result.entries()) {
    if (resultEntry.eventId() != null) {
        System.out.println("Event Id: " + resultEntry.eventId());
    } else {
        System.out.println("PutEvents failed with Error Code: " + resultEntry.errorCode());
    }
}
```

------
#### [ Amazon SDK for Java Version 1.0 ]

```
EventBridgeClient eventBridgeClient =
    EventBridgeClient.builder().build();
    
PutEventsRequestEntry requestEntry = new PutEventsRequestEntry()
        .withTime(new Date())
        .withSource("com.mycompany.myapp")
        .withDetailType("myDetailType")
        .withResources("resource1", "resource2")
        .withDetail("{ \"key1\": \"value1\", \"key2\": \"value2\" }");

PutEventsRequest request = new PutEventsRequest()
        .withEntries(requestEntry, requestEntry);

PutEventsResult result = awsEventsClient.putEvents(request);

for (PutEventsResultEntry resultEntry : result.getEntries()) {
    if (resultEntry.getEventId() != null) {
        System.out.println("Event Id: " + resultEntry.getEventId());
    } else {
        System.out.println("Injection failed with Error Code: " + resultEntry.getErrorCode());
    }
}
```

------

运行此代码后，`PutEvents` 结果将包含一组响应条目。响应数组中的每个条目对应请求数组中的一个条目，顺序按请求和响应从开始到结束的顺序。响应 `Entries` 数组包含的条目数量始终与请求数组相同。

## 使用 `PutEvents` 处理故障
<a name="eb-failure-handling"></a>

默认情况下，如果请求中的单个条目失败，则会 EventBridge 继续处理请求中的其余条目。响应 `Entries` 数组可以包括成功条目和不成功条目。您必须删除不成功的条目，并在后续调用中包括它们。

成功的结果条目包含一个 `Id` 值，不成功的结果条目包括 `ErrorCode` 和 `ErrorMessage` 值。`ErrorCode` 描述错误的类型。`ErrorMessage` 提供有关错误的更多信息。以下示例包含 `PutEvents` 请求的三个结果条目。第二个条目不成功。

```
{
    "FailedEntryCount": 1, 
    "Entries": [
        {
            "EventId": "11710aed-b79e-4468-a20b-bb3c0c3b4860"
        },
        {   "ErrorCode": "InternalFailure",
            "ErrorMessage": "Internal Service Failure"
        },
        {
            "EventId": "d804d26a-88db-4b66-9eaf-9a11c708ae82"
        }
    ]
}
```

**注意**  
如果您使用将事件发布`PutEvents`到不存在的事件总线，则 EventBridge 事件匹配将找不到相应的规则，因此会删除该事件。尽管 EventBridge 会发送`200`响应，但它不会使请求失败，也不会将事件包含在请求响应的`FailedEntryCount`值中。

不成功的条目可包含在后续 `PutEvents` 请求中。首先，要查找请求中是否存在失败的条目，请检查 `PutEventsResult` 中的 `FailedRecordCount` 参数。如果该参数不为零，则可以将每个具有非空值 `ErrorCode` 的 `Entry` 添加到后续请求中。以下示例展示了一个故障处理程序。

```
PutEventsRequestEntry requestEntry = new PutEventsRequestEntry()
        .withTime(new Date())
        .withSource("com.mycompany.myapp")
        .withDetailType("myDetailType")
        .withResources("resource1", "resource2")
        .withDetail("{ \"key1\": \"value1\", \"key2\": \"value2\" }");

List<PutEventsRequestEntry> putEventsRequestEntryList = new ArrayList<>();
for (int i = 0; i < 3; i++) {
    putEventsRequestEntryList.add(requestEntry);
}

PutEventsRequest putEventsRequest = new PutEventsRequest();
putEventsRequest.withEntries(putEventsRequestEntryList);
PutEventsResult putEventsResult = awsEventsClient.putEvents(putEventsRequest);

while (putEventsResult.getFailedEntryCount() > 0) {
    final List<PutEventsRequestEntry> failedEntriesList = new ArrayList<>();
    final List<PutEventsResultEntry> PutEventsResultEntryList = putEventsResult.getEntries();
    for (int i = 0; i < PutEventsResultEntryList.size(); i++) {
        final PutEventsRequestEntry putEventsRequestEntry = putEventsRequestEntryList.get(i);
        final PutEventsResultEntry putEventsResultEntry = PutEventsResultEntryList.get(i);
        if (putEventsResultEntry.getErrorCode() != null) {
            failedEntriesList.add(putEventsRequestEntry);
        }
    }
    putEventsRequestEntryList = failedEntriesList;
    putEventsRequest.setEntries(putEventsRequestEntryList);
    putEventsResult = awsEventsClient.putEvents(putEventsRequest);
    }
```

## 使用发送事件 Amazon CLI
<a name="eb-send-events-aws-cli"></a>

您可以使用 Amazon CLI 向发送自定义事件， EventBridge 以便对其进行处理。以下示例将一个自定义事件放入 EventBridge：

```
aws events put-events \
--entries '[{"Time": "2016-01-14T01:02:03Z", "Source": "com.mycompany.myapp", "Resources": ["resource1", "resource2"], "DetailType": "myDetailType", "Detail": "{ \"key1\": \"value1\", \"key2\": \"value2\" }"}]'
```

您还可以创建包含自定义事件的 JSON 文件。

```
[
  {
    "Time": "2016-01-14T01:02:03Z",
    "Source": "com.mycompany.myapp",
    "Resources": [
      "resource1",
      "resource2"
    ],
    "DetailType": "myDetailType",
    "Detail": "{ \"key1\": \"value1\", \"key2\": \"value2\" }"
  }
]
```

然后，要使用从该 Amazon CLI 文件中读取条目并发送事件，请在命令提示符下键入：

```
aws events put-events --entries file://entries.json
```

## 计算 PutEvents 活动条目大小
<a name="eb-putevent-size"></a>

当您 EventBridge 使用`PutEvents`操作向发送自定义事件时，您可以将最多 10 个事件条目批处理到一个请求中以提高效率。请求的总大小（即请求中所有事件条目的总和）必须小于 1 MB。此限制适用于整个请求，不适用于单个条目。如果单个事件是请求中唯一的条目，则该事件最多可以占用整整 1 MB 的空间。您可以在发送事件之前计算条目大小。



**注意**  
已对*条目* 施加大小限制。即使条目小于大小限制，由于*事件* EventBridge 的 JSON 表示形式中必需的字符和键，因此中的事件也始终大于条目大小。有关更多信息，请参阅 [Amazon 上的活动 EventBridge](eb-events.md)。

EventBridge 按如下方式计算`PutEventsRequestEntry`大小：
+ 如果指定，则 `Time` 参数为 14 字节。
+ `Source` 和 `DetailType` 参数为其 UTF-8 编码形式的字节数。
+ 如果指定，则 `Detail` 参数为其 UTF-8 编码形式的字节数。
+ 如果指定，则 `Resources` 参数的每个条目为其 UTF-8 编码形式的字节数。

以下示例 Java 代码计算给定 `PutEventsRequestEntry` 对象的大小。为了验证是否未违反 1MB 限制，您需要对请求中的所有事件进行计算。

```
int getSize(PutEventsRequestEntry entry) {
    int size = 0;
    if (entry.getTime() != null) {
        size += 14;
    }
    size += entry.getSource().getBytes(StandardCharsets.UTF_8).length;
    size += entry.getDetailType().getBytes(StandardCharsets.UTF_8).length;
    if (entry.getDetail() != null) {
        size += entry.getDetail().getBytes(StandardCharsets.UTF_8).length;
    }
    if (entry.getResources() != null) {
        for (String resource : entry.getResources()) {
            if (resource != null) {
                size += resource.getBytes(StandardCharsets.UTF_8).length;
            }
        }
    }
    return size;
}
```

**注意**  
如果条目大小超过 1MB，我们建议将事件上传到 Amazon S3 存储桶，并在条`PutEvents`目`Object URL`中加入。

# 如何 EventBridge 重试传递事件
<a name="eb-rule-retry-policy"></a>

有时，[事件](eb-events.md)无法成功传送到[规则](eb-rules.md)中指定的[目标](eb-targets.md)。在如下情况下，可能会发生这种状况：
+ 如果目标资源不可用
+ 由于网络状况

如果由于可重试的错误而无法成功将事件传送到目标，则 EventBridge 会重试发送该事件。您可以在目标的**重试策略**设置中设置尝试的时间长度和重试次数。默认情况下， EventBridge 会重试发送事件 24 小时，最多 185 次，并出现[指数级退缩和*抖动*](https://www.amazonaws.cn/blogs/architecture/exponential-backoff-and-jitter/)或随机延迟。

如果在用尽所有重试尝试后仍未传送事件，则该事件将被丢弃，并且 EventBridge不会继续处理该事件。

为避免事件在未能传送到目标后丢失，可以配置死信队列（DLQ）以接收所有失败事件。有关更多信息，请参阅 [使用死信队列处理中未传送的事件 EventBridge](eb-rule-dlq.md)。

# 使用死信队列处理中未传送的事件 EventBridge
<a name="eb-rule-dlq"></a>

为避免在事件未能传送到目标后丢失事件，您可以配置死信队列 (DLQ)，并将所有失败事件发送到该队列，以便日后处理。

EventBridge DLQs 是标准的 Amazon SQS 队列， EventBridge 用于存储无法成功传送到目标的事件。创建规则并添加目标时，可以选择是否使用 DLQ。配置 DLQ 时，可以保留任何未成功传送的事件。然后，您可以解决导致事件传送失败的问题，并在之后处理事件。

当您为规则的目标配置 DLQ 时， EventBridge 会将调用失败的事件发送到选定的 Amazon SQS 队列。

事件错误的处理方式不同。有些事件会在不进行任何重试的情况下被丢弃或发送到 DLQ。例如，对于由于缺少对目标的权限、不再存在的目标资源或由于地址无效或 DNS 查找失败而找不到目标而导致的错误，则在采取措施解决潜在问题之前，不会进行重试尝试。 EventBridge 将这些事件直接发送到目标 DLQ（如果已指定）。

当事件交付失败时，会向 Amazon CloudWatch 指标 EventBridge 发布一个表明目标`invocation`失败的事件。如果您使用 DLQ，则会将其他指标发送到 CloudWatch包括`InvocationsSentToDLQ`和。`InvocationsFailedToBeSentToDLQ`

如果您使用对静态事件 DLQs 进行加密，也可以 Amazon KMS 客户自主管理型密钥 为事件总线指定。有关更多信息，请参阅 [使用死信队列捕获中的加密事件错误 EventBridge](eb-encryption-event-bus-dlq.md)。

您的 DLQ 中的每条消息都将包含以下自定义属性：
+ `RULE_ARN`
+ `TARGET_ARN`
+ `ERROR_CODE`

  以下是 DLQ 可能返回的错误代码示例：
  + `ACTION_DECRYPTION_FAILURE`
  + `CONNECTION_FAILURE`
  + `CROSS_ACCOUNT_INGESTION_FAILED`
  + `CROSS_REGION_INGESTION_FAILED`
  + `ERROR_FROM_TARGET`
  + `EVENT_DECRYPTION_FAILURE`
  + `EVENT_ENCRYPTION_FAILURE`
  + `EVENTS_IN_BATCH_REQUEST_REJECTED`
  + `FAILED_TO_ASSUME_ROLE`
  + `INTERNAL_ERROR`
  + `INVALID_JSON`
  + `INVALID_PARAMETER`
  + `NO_PERMISSIONS`
  + `NO_RESOURCE`
  + `RESOURCE_ALREADY_EXISTS`
  + `RESOURCE_LIMIT_EXCEEDED`
  + `RESOURCE_MODIFICATION_COLLISION`
  + `RULE_DECRYPTION_FAILURE`
  + `SDK_CLIENT_ERROR`
  + `THIRD_ACCOUNT_HOP_DETECTED`
  + `THIRD_REGION_HOP_DETECTED`
  + `THROTTLING`
  + `TIMEOUT`
  + `TRANSIENT_ASSUME_ROLE`
  + `UNKNOWN`
+ `ERROR_MESSAGE`
+ `EXHAUSTED_RETRY_CONDITION`

  可能返回以下条件：
  + `MaximumRetryAttempts`
  + `MaximumEventAgeInSeconds`
+ `RETRY_ATTEMPTS`

 以下视频介绍了设置 DLQs：




**Topics**
+ [

## 使用死信队列的注意事项
](#eb-dlq-considerations)
+ [

## 为死信队列授予权限
](#eb-dlq-perms)
+ [

## 如何从死信队列中重新发送事件
](#eb-dlq-resend)

## 使用死信队列的注意事项
<a name="eb-dlq-considerations"></a>

为配置 DLQ 时，请考虑以下几点。 EventBridge
+ 仅支持[标准队列](https://docs.amazonaws.cn//AWSSimpleQueueService/latest/SQSDeveloperGuide/standard-queues.html)。你不能在中使用 FIFO 队列来获取 DLQ。 EventBridge
+ EventBridge 消息中包含事件元数据和消息属性，包括：错误代码、错误消息、用尽重试条件、规则 ARN、重试尝试和目标 ARN。您可以使用这些值来识别事件和失败原因。
+ 同一账户 DLQs 中的权限：
  + 如果您使用控制台向规则添加目标，并在同一个账户中选择一个 Amazon SQS 队列，则会将授予您 EventBridge 访问该队列的[基于资源的策略](eb-use-resource-based.md)附加到该队列中。
  + 如果您使用 EventBridge API 的`PutTargets`操作为规则添加或更新目标，并且在同一账户中选择了 Amazon SQS 队列，则必须手动向所选队列授予权限。要了解更多信息，请参阅[为死信队列授予权限](#eb-dlq-perms)。
+ 使用不同 Amazon 账户的 Amazon SQS 队列的权限。
  + 如果您通过控制台创建规则，则不会显示其他账户的队列供您选择。您必须提供其他账户中队列的 ARN，然后手动附加基于资源的策略，为该队列授予权限。要了解更多信息，请参阅[为死信队列授予权限](#eb-dlq-perms)。
  + 如果您使用 API 创建规则，则必须手动将基于资源的策略附加到用作死信队列的另一账户中的 SQS 队列。要了解更多信息，请参阅[为死信队列授予权限](#eb-dlq-perms)。
+ 您使用的 Amazon SQS 队列必须位于创建规则的区域。

## 为死信队列授予权限
<a name="eb-dlq-perms"></a>

要成功将事件传送到队列， EventBridge 必须具有执行此操作的权限。使用 EventBridge 控制台指定 DLQ 时，权限会自动添加。这包括：
+ 当您为规则目标配置 DLQ 时。
+ 当您为事件总线配置 DLQ 时，您已指定 EventBridge 使用对静态事件 Amazon KMS 客户托管式密钥 进行加密。

  有关更多信息，请参阅 [使用死信队列捕获中的加密事件错误 EventBridge](eb-encryption-event-bus-dlq.md)。

 如果您使用 API 指定 DLQ，或者使用其他 Amazon 账户中的队列，则必须手动创建基于资源的策略，然后将其附加到队列，用于授予所需权限。

**目标死信队列权限示例**

以下基于资源的策略演示了如何授予向 Amazon SQS 队列发送事件消息所需的权限。 EventBridge 策略示例向 EventBridge 服务授予使用该`SendMessage`操作向名为 “MyEventDLQ” 的队列发送消息的权限。队列必须位于 us-west-2 区域，账户为 123456789012。 Amazon 该`Condition`声明仅允许来自名为 “MyTestRule” 的规则的请求，该规则是在us-west-2区域创建的，账户为123456789012。 Amazon 

```
{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:us-west-2:123456789012:MyEventDLQ",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:us-west-2:123456789012:rule/MyTestRule"
    }
  }
}
```

**事件总线死信队列权限示例**

以下基于资源的策略演示了如何在为事件总线指定 DLQ 时授予所需权限。在本例中，`aws:SourceArn` 指定用于将事件发送到 DLQ 的事件总线的 ARN。在本示例中，队列必须与事件总线位于同一区域。

```
{
  "Sid": "Dead-letter queue permissions",
  "Effect": "Allow",
  "Principal": {
     "Service": "events.amazonaws.com"
  },
  "Action": "sqs:SendMessage",
  "Resource": "arn:aws:sqs:region:account-id:queue-name",
  "Condition": {
    "ArnEquals": {
      "aws:SourceArn": "arn:aws:events:region:account-id:event-bus/event-bus-arn"
    }
  }
}
```

要将策略附加到队列，请使用 Amazon SQS 控制台，打开队列，然后选择**访问策略**并编辑该策略。您也可以使用 Amazon CLI。要了解更多信息，请参阅[Amazon SQS 权限](eb-use-resource-based.md#eb-sqs-permissions)。

## 如何从死信队列中重新发送事件
<a name="eb-dlq-resend"></a>

可以通过两种方式将消息移出 DLQ：
+ 避免编写 Amazon SQS 使用者逻辑 - 将 DLQ 设置为 Lambda 函数的事件源以耗尽 DLQ。
+ 编写 Amazon SQS 使用者逻辑 — 使用 Amazon SQS API Amazon 、SDK Amazon CLI 或编写自定义使用者逻辑，用于轮询、处理和删除 DLQ 中的消息。

# Amazon 通过以下方式交付的服务活动 Amazon CloudTrail
<a name="eb-service-event-cloudtrail"></a>

 Amazon CloudTrail 是一项自动记录 Amazon API 调用等事件的服务。您可以创建使用来自的信息的 EventBridge 规则 CloudTrail。有关的更多信息 CloudTrail，请参阅[什么是 Amazon CloudTrail？](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/cloudtrail-user-guide.html) 。

CloudTrail 将以下类型的事件发送到默认 EventBridge 事件总线。在每种情况下，事件的 `detail-type` 值均为所列的事件类型：
+ `AWS API Call via CloudTrail`

  代表对公共 Amazon 服务 API 的请求的事件。

  有关更多信息，请参阅《*Amazon CloudTrail 用户指南*》中的[了解 CloudTrail 事件](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/cloudtrail-events.html)。
+ `AWS Console Signin via CloudTrail`

  尝试登录 Amazon 管理控制台、 Amazon 讨论论坛和 Su Amazon pport Center。

  有关更多信息，请参阅《Amazon CloudTrail 用户指南》**中的 [Amazon 管理控制台登录事件](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/cloudtrail-event-reference-aws-console-sign-in-events.html)。
+ `AWS Console Action via CloudTrail`

  在控制台中执行的非 API 调用类操作。

  有关更多信息，请参阅《Amazon CloudTrail 用户指南》**中的 [Amazon 管理控制台登录事件](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/cloudtrail-event-reference-aws-console-sign-in-events.html)。
+ `AWS Service Event via CloudTrail`

  事件由 Amazon 服务创建，但不是由对公共 Amazon 服务 API 的请求直接触发的。

  有关更多信息，请参阅《Amazon CloudTrail 用户指南》**中的 [Amazon 服务事件](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/non-api-aws-service-events.html)。
+ `AWS Insight via CloudTrail`

  Insights 事件由客户启用 CloudTrail Insight 功能 CloudTrail 时触发。

  有关更多信息，请参阅《*Amazon CloudTrail 用户指南》*中的 “[CloudTrail 见解](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/cloudtrail-event-reference-insight-details.html)”。

要使用其中一个 CloudTrail `detail-type`值记录事件，必须启用带日志记录的 CloudTrail 跟踪。有关更多信息，请参阅《*Amazon CloudTrail 用户指南》*中的[使用跟 CloudTrail 踪](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/cloudtrail-trails.html)。

 Amazon 服务中发生的某些事件 EventBridge 既可以由服务本身报告，也可以由报告给。 CloudTrail例如，启动实例的 Amazon EC2 API 调用会生成多个事件：
+ `EC2 Instance State-change Notification`当实例进入然后`running`进入状态时 EventBridge，事件直接从 Amazon EC2 发送到。`pending`例如：

  ```
  {
      . . . 
     "detail-type":"EC2 Instance State-change Notification",
     "source":"aws.ec2",
      . . . 
     "detail":{
        "instance-id":"i-abcd1111",
        "state":"pending"
     }
  }
  ```
+ 从发送 CloudTrail 到`AWS API Call via CloudTrail`的事件 EventBridge 表示 API 调用本身。例如：

  ```
  {
      . . . 
     "detail-type":"AWS API Call via CloudTrail",
     "source":"aws.ec2",
      . . . 
     ],
    "detail": {
      "eventSource": "ec2.amazonaws.com",
      "eventName": "StartInstances"
      }
  }
  ```

**注意**  
如果您使用 `Put*Events` API 调用事件作为创建事件模式的基础，请确保最终事件模式不超过 1 MB。任何`Put*Events`请求的最大大小为 1 MB。有关更多信息，请参阅 [](eb-putevents.md)。

有关 CloudTrail 支持的服务的更多信息，请参阅《*CloudTrail 用户指南》*中[CloudTrail 支持的服务和集成](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/cloudtrail-aws-service-specific-topics.html)。

# 接收来自 Amazon 服务的只读管理事件
<a name="eb-service-event-cloudtrail-management"></a>

您可以在默认或自定义事件总线上设置规则，通过接收来自 Amazon 服务的只读*管理事件* CloudTrail。管理事件可让您了解对 Amazon 账户中的资源执行的管理操作。这些也称为控制面板操作。有关更多信息，请参阅《CloudTrail 用户指南》**中的[记录管理事件](https://docs.amazonaws.cn/awscloudtrail/latest/userguide/logging-management-events-with-cloudtrail.html#logging-management-events)。

对于针对默认或自定义事件总线的每条规则，您可以设置规则状态，以控制要接收的事件类型：
+ 禁用该规则，这样就 EventBridge 不会将事件与规则相匹配。
+ 启用该规则，以便将事件 EventBridge 与规则进行匹配，但通过传送的只读 Amazon 管理事件除外 CloudTrail。
+ 启用该规则，以便将所有事件与该规则进行 EventBridge 匹配，*包括*通过传送的只读管理事件 CloudTrail。

合作伙伴事件总线不接收 Amazon 事件。

在决定是否接收只读管理事件时需要考虑以下几点：
+ 某些只读管理事件（例如 Amazon Key Management Service `GetKeyPolicy`和`DescribeKey`或 IAM `GetPolicy` 和`GetRole`事件）的发生量远高于典型的变更事件。
+ 即使这些事件不是以`Describe`、`Get`或开头，您也可能已经收到只读管理事件`List`。其中一个例子`TestEventPattern`来自 EventBridge。

  有关 Amazon 服务不遵守`Describe`、`Get`或`List`命名约定的只读管理事件的列表，请参阅[中的 Amazon 服务生成的管理事件 EventBridge](eb-service-management-event-list.md)。

**使用 Amazon CLI 创建接收只读管理事件的规则**
+ 使用 `put-rule` 命令创建或更新规则，同时使用参数执行以下操作：
  + 指定规则属于默认事件总线或特定的自定义事件总线
  + 将规则状态设置为 `ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS`

  `aws events put-rule --name "ruleForManagementEvents" --event-bus-name "default" --state "ENABLED_WITH_ALL_CLOUDTRAIL_MANAGEMENT_EVENTS"`

**注意**  
仅支持通过 Amazon CLI 和 Amazon CloudFormation 模板为 CloudWatch 管理事件启用规则。

**Example**  
以下示例说明了如何匹配特定事件。最佳实践是定义一个用于匹配特定事件的专用规则，这样既清晰又便于编辑。  
在这种情况下，专用规则与来自的`AssumeRole`管理事件相匹配 Amazon Security Token Service。  

```
{
    "source" : [ "aws.sts" ],
    "detail-type": ["AWS API Call via CloudTrail"],
    "detail" : {
        "eventName" : ["AssumeRole"]
    }
}
```

# 中的 Amazon 服务生成的管理事件 EventBridge
<a name="eb-service-management-event-list"></a>

通常 APIs ，生成的管理（或只读）事件以动词`Describe``Get`、或`List`开头。下表列出了不遵循此命名约定的 Amazon 服务及其生成的管理事件。有关管理事件的更多信息，请参阅[接收来自 Amazon 服务的只读管理事件](eb-service-event-cloudtrail-management.md)。

## 不以 `Describe`、`Get` 或 `List` 开头的管理事件
<a name="eb-service-management-table-list"></a>

下表列出了不遵循以、或开头的典型命名惯例的 Amazon 服务及其生成的管理事件`List`。`Describe` `Get`


| 服务 | 事件名称 | 事件类型 | 
| --- | --- | --- | 
| Alexa for Business | ResolveRoom | API 调用 | 
| Alexa for Business | SearchAddressBooks | API 调用 | 
| Alexa for Business | SearchContacts | API 调用 | 
| Alexa for Business | SearchDevices | API 调用 | 
| Alexa for Business | SearchProfiles | API 调用 | 
| Alexa for Business | SearchRooms | API 调用 | 
| Alexa for Business | SearchSkillGroups | API 调用 | 
| Alexa for Business | SearchUsers | API 调用 | 
| IAM 访问分析器 | ValidatePolicy | API 调用 | 
| Amazon AdSpace 干净的房间 | BatchGetSchema | API 调用 | 
| Amazon Amplify 用户界面生成器 | ExportComponents | API 调用 | 
| Amazon Amplify 用户界面生成器 | ExportForms | API 调用 | 
| Amazon Amplify 用户界面生成器 | ExportThemes | API 调用 | 
| 亚马逊 OpenSearch 服务 | BatchGetCollection | API 调用 | 
| Amazon API Gateway | ExportApi | API 调用 | 
| Amazon AppConfig | ValidateConfiguration | API 调用 | 
| Amazon AppFlow | RetrieveConnectorData | API 调用 | 
| Amazon CloudWatch 应用程序洞察 | UpdateApplicationDashboardConfiguration | API 调用 | 
| Amazon Athena | BatchGetNamedQuery | API 调用 | 
| Amazon Athena | BatchGetPreparedStatement | API 调用 | 
| Amazon Athena | BatchGetQueryExecution | API 调用 | 
| Amazon Athena | CheckQueryCompatibility | API 调用 | 
| Amazon Athena | ExportNotebook | API 调用 | 
| Amazon Auto Scaling | AreScalableTargetsRegistered | API 调用 | 
| Amazon Auto Scaling | 测试 | API 调用 | 
| Amazon Web Services Marketplace | SearchAgreements | API 调用 | 
| Amazon Backup | CreateLegalHold | API 调用 | 
| Amazon Backup | ExportBackupPlanTemplate | API 调用 | 
| Amazon Backup gateway | TestHypervisorConfiguration | API 调用 | 
| Amazon 账单与成本管理 | AWSPaymentInstrumentGateway.Get | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.DescribeMakePaymentPage | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.DescribePaymentsDashboard | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetAccountPreferences | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetAdvancePaySummary | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetAsoBulkDownload | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetBillingContactAddress | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetDocuments | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetEligiblePaymentInstruments | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetEntitiesByIds | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetFundingDocuments | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetKybcValidationStatus | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetOneTimePasswordStatus | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetPaymentHistory | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetPaymentProfileByArn | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetPaymentProfileCurrencies | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetPaymentProfiles | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetPaymentProfileServiceProviders | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetPaymentsDue | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetRemittanceInformation | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetTaxInvoiceMetadata | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetTermsAndConditionsForProgramGroup | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetTransactionsHistory | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetUnappliedFunds | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPortalService.GetUnpaidInvoices | 控制台操作 | 
| Amazon 账单与成本管理 | AWSPaymentPreferenceGateway.Get | 控制台操作 | 
| Amazon 账单与成本管理 | CancelBulkDownload | 控制台操作 | 
| Amazon 账单与成本管理 | DownloadCommercialInvoice | 控制台操作 | 
| Amazon 账单与成本管理 | DownloadCsv | 控制台操作 | 
| Amazon 账单与成本管理 | DownloadDoc | 控制台操作 | 
| Amazon 账单与成本管理 | 下载 ECSVFor BillingPeriod | 控制台操作 | 
| Amazon 账单与成本管理 | DownloadPaymentHistory | 控制台操作 | 
| Amazon 账单与成本管理 | DownloadRegistrationDocument | 控制台操作 | 
| Amazon 账单与成本管理 | DownloadTaxInvoice | 控制台操作 | 
| Amazon 账单与成本管理 | FindBankRedirectPaymentInstruments | 控制台操作 | 
| Amazon 账单与成本管理 | 查找 ECSVFor BillingPeriod | 控制台操作 | 
| Amazon 账单与成本管理 | ValidateReportDestination | 控制台操作 | 
| Amazon 账单与成本管理 | VerifyChinaPaymentEligibility | 控制台操作 | 
| Amazon Braket | SearchCompilations | API 调用 | 
| Amazon Braket | SearchDevices | API 调用 | 
| Amazon Braket | SearchQuantumTasks | API 调用 | 
| Amazon Connect Cases | BatchGetField | API 调用 | 
| Amazon Connect Cases | SearchCases | API 调用 | 
| Amazon Connect Cases | SearchRelatedItems | API 调用 | 
| Amazon Chime | RetrieveDataExports | API 调用 | 
| Amazon Chime | SearchChannels | API 调用 | 
| Amazon Chime SDK 身份 | DeleteProfile | 服务事件 | 
| Amazon Chime SDK 身份 | DeleteWorkTalkAccount | 服务事件 | 
| Amazon 干净的房间 | BatchGetSchema | API 调用 | 
| Amazon Cloud Directory | BatchRead | API 调用 | 
| Amazon Cloud Directory | LookupPolicy | API 调用 | 
| Amazon CloudFormation | DetectStackDrift | API 调用 | 
| Amazon CloudFormation | DetectStackResourceDrift | API 调用 | 
| Amazon CloudFormation | DetectStackSetDrift | API 调用 | 
| Amazon CloudFormation | EstimateTemplateCost | API 调用 | 
| Amazon CloudFormation | ValidateTemplate | API 调用 | 
| Amazon CloudShell | RedeemCode | API 调用 | 
| Amazon CloudTrail | LookupEvents | API 调用 | 
| Amazon CodeArtifact | ReadFromRepository | API 调用 | 
| Amazon CodeArtifact | SearchPackages | API 调用 | 
| Amazon CodeArtifact | VerifyResourcesExistForTagris | API 调用 | 
| Amazon CodeBuild | BatchGetBuildBatches | API 调用 | 
| Amazon CodeBuild | BatchGetBuilds | API 调用 | 
| Amazon CodeBuild | BatchGetProjects | API 调用 | 
| Amazon CodeBuild | BatchGetReportGroups | API 调用 | 
| Amazon CodeBuild | BatchGetReports | API 调用 | 
| Amazon CodeBuild | BatchPutCodeCoverages | API 调用 | 
| Amazon CodeBuild | BatchPutTestCases | API 调用 | 
| Amazon CodeBuild | RequestBadge | 服务事件 | 
| Amazon CodeCommit | BatchDescribeMergeConflicts | API 调用 | 
| Amazon CodeCommit | BatchGetCommits | API 调用 | 
| Amazon CodeCommit | BatchGetPullRequests | API 调用 | 
| Amazon CodeCommit | BatchGetRepositories | API 调用 | 
| Amazon CodeCommit | EvaluatePullRequestApprovalRules | API 调用 | 
| Amazon CodeCommit | GitPull | API 调用 | 
| Amazon CodeDeploy | BatchGetApplicationRevisions | API 调用 | 
| Amazon CodeDeploy | BatchGetApplications | API 调用 | 
| Amazon CodeDeploy | BatchGetDeploymentGroups | API 调用 | 
| Amazon CodeDeploy | BatchGetDeploymentInstances | API 调用 | 
| Amazon CodeDeploy | BatchGetDeployments | API 调用 | 
| Amazon CodeDeploy | BatchGetDeploymentTargets | API 调用 | 
| Amazon CodeDeploy | BatchGetOnPremisesInstances | API 调用 | 
| Amazon P CodeGuru rofiler | BatchGetFrameMetricData | API 调用 | 
| Amazon P CodeGuru rofiler | SubmitFeedback | API 调用 | 
| Amazon CodePipeline | PollForJobs | API 调用 | 
| Amazon CodePipeline | PollForThirdPartyJobs | API 调用 | 
| CodeConnections | StartAppRegistrationHandshake | API 调用 | 
| CodeConnections | 开始OAuth握手 | API 调用 | 
| CodeConnections | ValidateHostWebhook | API 调用 | 
| Amazon CodeWhisperer | CreateCodeScan | API 调用 | 
| Amazon CodeWhisperer | CreateProfile | API 调用 | 
| Amazon CodeWhisperer | CreateUploadUrl | API 调用 | 
| Amazon CodeWhisperer | GenerateRecommendations | API 调用 | 
| Amazon CodeWhisperer | UpdateProfile | API 调用 | 
| Amazon Cognito Identity | LookupDeveloperIdentity | API 调用 | 
| Amazon Cognito 用户群体 | AdminGetDevice | API 调用 | 
| Amazon Cognito 用户群体 | AdminGetUser | API 调用 | 
| Amazon Cognito 用户群体 | AdminListDevices | API 调用 | 
| Amazon Cognito 用户群体 | AdminListGroupsForUser | API 调用 | 
| Amazon Cognito 用户群体 | AdminListUserAuthEvents | API 调用 | 
| Amazon Cognito 用户群体 | Beta\$1Authorize\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | Confirm\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | ConfirmForgotPassword\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | Error\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | ForgotPassword\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | IntrospectToken | API 调用 | 
| Amazon Cognito 用户群体 | Login\$1Error\$1POST | 服务事件 | 
| Amazon Cognito 用户群体 | Login\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | Mfa\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | MfaOption\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | ResetPassword\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | Signup\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | UserInfo\$1GET | 服务事件 | 
| Amazon Cognito 用户群体 | UserInfo\$1POST | 服务事件 | 
| Amazon Cognito Sync | BulkPublish | API 调用 | 
| Amazon Comprehend | BatchContainsPiiEntities | API 调用 | 
| Amazon Comprehend | BatchDetectDominantLanguage | API 调用 | 
| Amazon Comprehend | BatchDetectEntities | API 调用 | 
| Amazon Comprehend | BatchDetectKeyPhrases | API 调用 | 
| Amazon Comprehend | BatchDetectPiiEntities | API 调用 | 
| Amazon Comprehend | BatchDetectSentiment | API 调用 | 
| Amazon Comprehend | BatchDetectSyntax | API 调用 | 
| Amazon Comprehend | BatchDetectTargetedSentiment | API 调用 | 
| Amazon Comprehend | ClassifyDocument | API 调用 | 
| Amazon Comprehend | ContainsPiiEntities | API 调用 | 
| Amazon Comprehend | DetectDominantLanguage | API 调用 | 
| Amazon Comprehend | DetectEntities | API 调用 | 
| Amazon Comprehend | DetectKeyPhrases | API 调用 | 
| Amazon Comprehend | DetectPiiEntities | API 调用 | 
| Amazon Comprehend | DetectSentiment | API 调用 | 
| Amazon Comprehend | DetectSyntax | API 调用 | 
| Amazon Comprehend | DetectTargetedSentiment | API 调用 | 
| Amazon Comprehend | DetectToxicContent | API 调用 | 
| Amazon Compute Optimizer | ExportAutoScalingGroupRecommendations | API 调用 | 
| Amazon Compute Optimizer | 出口EBSVolume建议 | API 调用 | 
| Amazon Compute Optimizer | 出口ECInstance建议 | API 调用 | 
| Amazon Compute Optimizer | 出口ECSService建议 | API 调用 | 
| Amazon Compute Optimizer | ExportLambdaFunctionRecommendations | API 调用 | 
| Amazon Compute Optimizer | 出口RDSInstance建议 | API 调用 | 
| Amazon Config | BatchGetAggregateResourceConfig | API 调用 | 
| Amazon Config | BatchGetResourceConfig | API 调用 | 
| Amazon Config | SelectAggregateResourceConfig | API 调用 | 
| Amazon Config | SelectResourceConfig | API 调用 | 
| Amazon Connect | AdminGetEmergencyAccessToken | API 调用 | 
| Amazon Connect | SearchQueues | API 调用 | 
| Amazon Connect | SearchRoutingProfiles | API 调用 | 
| Amazon Connect | SearchSecurityProfiles | API 调用 | 
| Amazon Connect | SearchUsers | API 调用 | 
| Amazon Glue DataBrew | SendProjectSessionAction | API 调用 | 
| Amazon Data Pipeline | EvaluateExpression | API 调用 | 
| Amazon Data Pipeline | QueryObjects | API 调用 | 
| Amazon Data Pipeline | ValidatePipelineDefinition | API 调用 | 
| Amazon DataSync | VerifyResourcesExistForTagris | API 调用 | 
| Amazon DeepLens | BatchGetDevice | API 调用 | 
| Amazon DeepLens | BatchGetModel | API 调用 | 
| Amazon DeepLens | BatchGetProject | API 调用 | 
| Amazon DeepLens | CreateDeviceCertificates | API 调用 | 
| Amazon DeepRacer | AdminGetAccountConfig | API 调用 | 
| Amazon DeepRacer | AdminListAssociatedUsers | API 调用 | 
| Amazon DeepRacer | TestRewardFunction | API 调用 | 
| Amazon DeepRacer | VerifyResourcesExistForTagris | API 调用 | 
| Amazon Detective | BatchGetGraphMemberDatasources | API 调用 | 
| Amazon Detective | BatchGetMembershipDatasources | API 调用 | 
| Amazon Detective | SearchGraph | API 调用 | 
| Amazon DevOps Guru | SearchInsights | API 调用 | 
| Amazon DevOps Guru | SearchOrganizationInsights | API 调用 | 
| Amazon Database Migration Service | BatchStartRecommendations | API 调用 | 
| Amazon Database Migration Service | ModifyRecommendation | API 调用 | 
| Amazon Database Migration Service | StartRecommendations | API 调用 | 
| Amazon Database Migration Service | VerifyResourcesExistForTagris | API 调用 | 
| Amazon Directory Service | VerifyTrust | API 调用 | 
| Amazon Elastic Compute Cloud | ConfirmProductInstance | API 调用 | 
| Amazon Elastic Compute Cloud | ReportInstanceStatus | API 调用 | 
| Amazon Elastic Container Registry | BatchCheckLayerAvailability | API 调用 | 
| Amazon Elastic Container Registry | BatchGetImage | API 调用 | 
| Amazon Elastic Container Registry | BatchGetImageReferrer | API 调用 | 
| Amazon Elastic Container Registry | BatchGetRepositoryScanningConfiguration | API 调用 | 
| Amazon Elastic Container Registry | DryRunEvent | 服务事件 | 
| Amazon Elastic Container Registry | PolicyExecutionEvent | 服务事件 | 
| Amazon Elastic Container Registry Public | BatchCheckLayerAvailability | API 调用 | 
| Amazon Elastic Container Service | DiscoverPollEndpoint | API 调用 | 
| Amazon Elastic Container Service | FindSubfleetRoute | API 调用 | 
| Amazon Elastic Container Service | ValidateResources | API 调用 | 
| Amazon Elastic Container Service | VerifyTaskSetsExist | API 调用 | 
| Amazon Elastic Kubernetes Service | AccessKubernetesApi | API 调用 | 
| Amazon Elastic Beanstalk | 查看 DNSAvailability | API 调用 | 
| Amazon Elastic Beanstalk | RequestEnvironmentInfo | API 调用 | 
| Amazon Elastic Beanstalk | RetrieveEnvironmentInfo | API 调用 | 
| Amazon Elastic Beanstalk | ValidateConfigurationSettings | API 调用 | 
| Amazon Elastic File System | NewClientConnection | 服务事件 | 
| Amazon Elastic File System | UpdateClientConnection | 服务事件 | 
| Amazon Elastic Transcoder | ReadJob | API 调用 | 
| Amazon Elastic Transcoder | ReadPipeline | API 调用 | 
| Amazon Elastic Transcoder | ReadPreset | API 调用 | 
| Amazon EventBridge | TestEventPattern | API 调用 | 
| Amazon EventBridge | TestScheduleExpression | API 调用 | 
| Amazon FinSpace API | BatchListCatalogNodesByDataset | API 调用 | 
| Amazon FinSpace API | BatchListNodesByDataset | API 调用 | 
| Amazon FinSpace API | BatchValidateAccess | API 调用 | 
| Amazon FinSpace API | CreateAuditRecordsQuery | API 调用 | 
| Amazon FinSpace API | SearchDatasets | API 调用 | 
| Amazon FinSpace API | SearchDatasetsV | API 调用 | 
| Amazon FinSpace API | ValidateIdToken | API 调用 | 
| Amazon Firewall Manager | DisassociateAdminAccount | API 调用 | 
| Amazon Forecast | InvokeForecastEndpoint | API 调用 | 
| Amazon Forecast | QueryFeature | API 调用 | 
| Amazon Forecast | QueryForecast | API 调用 | 
| Amazon Forecast | QueryWhatIfForecast | API 调用 | 
| Amazon Forecast | VerifyResourcesExistForTagris | API 调用 | 
| Amazon Fraud Detector | BatchGetVariable | API 调用 | 
| Amazon Fraud Detector | VerifyResourcesExistForTagris | API 调用 | 
| FreeRTOS | VerifyEmailAddress | API 调用 | 
| 亚马逊 GameLift 服务器 | RequestUploadCredentials | API 调用 | 
| 亚马逊 GameLift 服务器 | ResolveAlias | API 调用 | 
| 亚马逊 GameLift 服务器 | SearchGameSessions | API 调用 | 
| 亚马逊 GameLift 服务器 | ValidateMatchmakingRuleSet | API 调用 | 
| Amazon GameSparks | ExportSnapshot | API 调用 | 
| Amazon Location Service | BatchGetDevicePosition | API 调用 | 
| Amazon Location Service | CalculateRoute | API 调用 | 
| Amazon Location Service | CalculateRouteMatrix | API 调用 | 
| Amazon Location Service | SearchPlaceIndexForPosition | API 调用 | 
| Amazon Location Service | SearchPlaceIndexForSuggestions | API 调用 | 
| Amazon Location Service | SearchPlaceIndexForText | API 调用 | 
| Amazon Glacier | InitiateJob | API 调用 | 
| Amazon Glue | BatchGetBlueprints | API 调用 | 
| Amazon Glue | BatchGetColumnStatisticsForTable | API 调用 | 
| Amazon Glue | BatchGetCrawlers | API 调用 | 
| Amazon Glue | BatchGetCustomEntityTypes | API 调用 | 
| Amazon Glue | BatchGetDataQualityResult | API 调用 | 
| Amazon Glue | BatchGetDevEndpoints | API 调用 | 
| Amazon Glue | BatchGetJobs | API 调用 | 
| Amazon Glue | BatchGetMLTransform | API 调用 | 
| Amazon Glue | BatchGetPartition | API 调用 | 
| Amazon Glue | BatchGetTriggers | API 调用 | 
| Amazon Glue | BatchGetWorkflows | API 调用 | 
| Amazon Glue | QueryJobRuns | API 调用 | 
| Amazon Glue | QueryJobRunsAggregated | API 调用 | 
| Amazon Glue | QueryJobs | API 调用 | 
| Amazon Glue | QuerySchemaVersionMetadata | API 调用 | 
| Amazon Glue | SearchTables | API 调用 | 
| Amazon HealthLake | ReadResource | API 调用 | 
| Amazon HealthLake | SearchWithGet | API 调用 | 
| Amazon HealthLake | SearchWithPost | API 调用 | 
| Amazon Identity and Access Management | GenerateCredentialReport | API 调用 | 
| Amazon Identity and Access Management | GenerateOrganizationsAccessReport | API 调用 | 
| Amazon Identity and Access Management | GenerateServiceLastAccessedDetails | API 调用 | 
| Amazon Identity and Access Management | SimulateCustomPolicy | API 调用 | 
| Amazon Identity and Access Management | SimulatePrincipalPolicy | API 调用 | 
| Amazon 身份存储 | IsMemberInGroups | API 调用 | 
| Amazon 身份存储验证 | BatchGetSession | API 调用 | 
| Amazon Inspector Classic | PreviewAgents | API 调用 | 
| Amazon Inspector Classic | BatchGetAccountStatus | API 调用 | 
| Amazon Inspector Classic | BatchGetFreeTrialInfo | API 调用 | 
| Amazon Inspector Classic | BatchGetMember | API 调用 | 
| Amazon Web Services 开票 | ValidateDocumentDeliveryS3LocationInfo | API 调用 | 
| Amazon IoT | SearchIndex | API 调用 | 
| Amazon IoT | TestAuthorization | API 调用 | 
| Amazon IoT | TestInvokeAuthorizer | API 调用 | 
| Amazon IoT | ValidateSecurityProfileBehaviors | API 调用 | 
| Amazon IoT Analytics | SampleChannelData | API 调用 | 
| Amazon IoT SiteWise | GatewaysVerifyResourcesExistForTagrisInternal | API 调用 | 
| Amazon IoT Things Graph | SearchEntities | API 调用 | 
| Amazon IoT Things Graph | SearchFlowExecutions | API 调用 | 
| Amazon IoT Things Graph | SearchFlowTemplates | API 调用 | 
| Amazon IoT Things Graph | SearchSystemInstances | API 调用 | 
| Amazon IoT Things Graph | SearchSystemTemplates | API 调用 | 
| Amazon IoT Things Graph | SearchThings | API 调用 | 
| Amazon IoT TwinMaker | ExecuteQuery | API 调用 | 
| Amazon IoT Wireless | CreateNetworkAnalyzerConfiguration | API 调用 | 
| Amazon IoT Wireless | DeleteNetworkAnalyzerConfiguration | API 调用 | 
| Amazon IoT Wireless | DeregisterWirelessDevice | API 调用 | 
| Amazon Interactive Video Service | BatchGetChannel | API 调用 | 
| Amazon Interactive Video Service | BatchGetStreamKey | API 调用 | 
| Amazon Kendra | BatchGetDocumentStatus | API 调用 | 
| Amazon Kendra | Query | API 调用 | 
| 适用于 Apache Flink 的亚马逊托管服务 | DiscoverInputSchema | API 调用 | 
| Amazon Key Management Service | Decrypt | API 调用 | 
| Amazon Key Management Service | Encrypt | API 调用 | 
| Amazon Key Management Service | GenerateDataKey | API 调用 | 
| Amazon Key Management Service | GenerateDataKeyPair | API 调用 | 
| Amazon Key Management Service | GenerateDataKeyPairWithoutPlaintext | API 调用 | 
| Amazon Key Management Service | GenerateDataKeyWithoutPlaintext | API 调用 | 
| Amazon Key Management Service | GenerateMac | API 调用 | 
| Amazon Key Management Service | GenerateRandom | API 调用 | 
| Amazon Key Management Service | ReEncrypt | API 调用 | 
| Amazon Key Management Service | 签名 | API 调用 | 
| Amazon Key Management Service | Verify | API 调用 | 
| Amazon Key Management Service | VerifyMac | API 调用 | 
| Amazon Lake Formation | SearchDatabasesByLFTags | API 调用 | 
| Amazon Lake Formation | SearchTablesByLFTags | API 调用 | 
| Amazon Lake Formation | StartQueryPlanning | API 调用 | 
| Amazon Lex | BatchCreateCustomVocabularyItem | API 调用 | 
| Amazon Lex | BatchDeleteCustomVocabularyItem | API 调用 | 
| Amazon Lex | BatchUpdateCustomVocabularyItem | API 调用 | 
| Amazon Lex | DeleteCustomVocabulary | API 调用 | 
| Amazon Lex | SearchAssociatedTranscripts | API 调用 | 
| Amazon Lightsail | 创建 GUISession AccessDetails | API 调用 | 
| Amazon Lightsail | DownloadDefaultKeyPair | API 调用 | 
| Amazon Lightsail | IsVpcPeered | API 调用 | 
| Amazon CloudWatch 日志 | FilterLogEvents | API 调用 | 
| Amazon Macie | BatchGetCustomDataIdentifiers | API 调用 | 
| Amazon Macie | UpdateFindingsFilter | API 调用 | 
| AWS Elemental MediaConnect | ManagedDescribeFlow | API 调用 | 
| AWS Elemental MediaConnect | PrivateDescribeFlowMeta | API 调用 | 
| Amazon Application Migration Service | OperationalDescribeJobLogItems | API 调用 | 
| Amazon Application Migration Service | OperationalDescribeJobs | API 调用 | 
| Amazon Application Migration Service | OperationalDescribeReplicationConfigurationTemplates | API 调用 | 
| Amazon Application Migration Service | OperationalDescribeSourceServer | API 调用 | 
| Amazon Application Migration Service | OperationalGetLaunchConfiguration | API 调用 | 
| Amazon Application Migration Service | OperationalListSourceServers | API 调用 | 
| Amazon Application Migration Service | VerifyClientRoleForMgn | API 调用 | 
| Amazon HealthOmics | VerifyResourceExists | API 调用 | 
| Amazon HealthOmics | VerifyResourcesExistForTagris | API 调用 | 
| Amazon Polly | SynthesizeLongSpeech | API 调用 | 
| Amazon Polly | SynthesizeSpeech | API 调用 | 
| Amazon Polly | SynthesizeSpeechGet | API 调用 | 
| Amazon 提供托管专用网络的服务 | Ping | API 调用 | 
| Amazon Proton | DeleteEnvironmentTemplateVersion | API 调用 | 
| Amazon Proton | DeleteServiceTemplateVersion | API 调用 | 
| Amazon QLDB | ShowCatalog | API 调用 | 
| Amazon Quick | GenerateEmbedUrlForAnonymousUser | API 调用 | 
| Amazon Quick | GenerateEmbedUrlForRegisteredUser | API 调用 | 
| Amazon Quick | QueryDatabase | 服务事件 | 
| Amazon Quick | SearchAnalyses | API 调用 | 
| Amazon Quick | SearchDashboards | API 调用 | 
| Amazon Quick | SearchDataSets | API 调用 | 
| Amazon Quick | SearchDataSources | API 调用 | 
| Amazon Quick | SearchFolders | API 调用 | 
| Amazon Quick | SearchGroups | API 调用 | 
| Amazon Quick | SearchUsers | API 调用 | 
| Amazon Relational Database Service | DownloadCompleteDBLog文件 | API 调用 | 
| Amazon Relational Database Service | 下载 DBLog FilePortion | API 调用 | 
| Amazon Rekognition | CompareFaces | API 调用 | 
| Amazon Rekognition | DetectCustomLabels | API 调用 | 
| Amazon Rekognition | DetectFaces | API 调用 | 
| Amazon Rekognition | DetectLabels | API 调用 | 
| Amazon Rekognition | DetectModerationLabels | API 调用 | 
| Amazon Rekognition | DetectProtectiveEquipment | API 调用 | 
| Amazon Rekognition | DetectText | API 调用 | 
| Amazon Rekognition | RecognizeCelebrities | API 调用 | 
| Amazon Rekognition | SearchFaces | API 调用 | 
| Amazon Rekognition | SearchFacesByImage | API 调用 | 
| Amazon Rekognition | SearchUsers | API 调用 | 
| Amazon Rekognition | SearchUsersByImage | API 调用 | 
| Amazon 资源探索器 | BatchGetView | API 调用 | 
| Amazon 资源探索器 | Search | API 调用 | 
| Amazon Resource Groups | SearchResources | API 调用 | 
| Amazon Resource Groups | ValidateResourceSharing | API 调用 | 
| Amazon RoboMaker | BatchDescribeSimulationJob | API 调用 | 
| Amazon Route 53 | 测试DNSAnswer | API 调用 | 
| Amazon Route 53 Domains | checkAvailabilities | API 调用 | 
| Amazon Route 53 Domains | CheckDomainAvailability | API 调用 | 
| Amazon Route 53 Domains | checkDomainTransferability | API 调用 | 
| Amazon Route 53 Domains | CheckDomainTransferability | API 调用 | 
| Amazon Route 53 Domains | isEmailReachable | API 调用 | 
| Amazon Route 53 Domains | searchDomains | API 调用 | 
| Amazon Route 53 Domains | sendVerificationMessage | API 调用 | 
| Amazon Route 53 Domains | ViewBilling | API 调用 | 
| Amazon Route 53 Domains | viewBilling | API 调用 | 
| 亚马逊 CloudWatch RUM | BatchGetRumMetricDefinitions | API 调用 | 
| Amazon Simple Storage Service | echo | API 调用 | 
| Amazon Simple Storage Service | GenerateInventory | 服务事件 | 
| 亚马逊 SageMaker AI | BatchDescribeModelPackage | API 调用 | 
| 亚马逊 SageMaker AI | DeleteModelCard | API 调用 | 
| 亚马逊 SageMaker AI | QueryLineage | API 调用 | 
| 亚马逊 SageMaker AI | RenderUiTemplate | API 调用 | 
| 亚马逊 SageMaker AI | Search | API 调用 | 
| 亚马逊 EventBridge 架构 | ExportSchema | API 调用 | 
| 亚马逊 EventBridge 架构 | SearchSchemas | API 调用 | 
| Amazon SimpleDB | DomainMetadata | API 调用 | 
| Amazon Secrets Manager | ValidateResourcePolicy | API 调用 | 
| Amazon Service Catalog | ScanProvisionedProducts | API 调用 | 
| Amazon Service Catalog | SearchProducts | API 调用 | 
| Amazon Service Catalog | SearchProductsAsAdmin | API 调用 | 
| Amazon Service Catalog | SearchProvisionedProducts | API 调用 | 
| Amazon SES | BatchGetMetricData | API 调用 | 
| Amazon SES | TestRenderEmailTemplate | API 调用 | 
| Amazon SES | TestRenderTemplate | API 调用 | 
| Amazon Simple Notification Service | CheckIfPhoneNumberIsOptedOut | API 调用 | 
| Amazon SQL Workbench | BatchGetNotebookCell | API 调用 | 
| Amazon SQL Workbench | ExportNotebook | API 调用 | 
| Amazon EC2 Systems Manager | ExecuteApi | API 调用 | 
| Amazon Systems Manager Incident Manager | DeleteContactChannel | API 调用 | 
| Amazon IAM Identity Center | IsMemberInGroup | API 调用 | 
| Amazon IAM Identity Center | SearchGroups | API 调用 | 
| Amazon IAM Identity Center | SearchUsers | API 调用 | 
| Amazon STS | AssumeRole | API 调用 | 
| Amazon STS | AssumeRoleWithSAML | API 调用 | 
| Amazon STS | AssumeRoleWithWebIdentity | API 调用 | 
| Amazon STS | DecodeAuthorizationMessage | API 调用 | 
| Amazon 税务设置 | BatchGetTaxExemptions | API 调用 | 
| Amazon WAFV2 | CheckCapacity | API 调用 | 
| Amazon WAFV2 | GenerateMobileSdkReleaseUrl | API 调用 | 
| Amazon Well-Architected Tool | ExportLens | API 调用 | 
| Amazon Well-Architected Tool | TagResource | API 调用 | 
| Amazon Well-Architected Tool | UntagResource | API 调用 | 
| Amazon Well-Architected Tool | UpdateGlobalSettings | API 调用 | 
| Amazon Connect Wisdom | QueryAssistant | API 调用 | 
| Amazon Connect Wisdom | SearchContent | API 调用 | 
| Amazon Connect Wisdom | SearchSessions | API 调用 | 
| Amazon WorkDocs | AbortDocumentVersionUpload | API 调用 | 
| Amazon WorkDocs | AddUsersToGroup | API 调用 | 
| Amazon WorkDocs | BatchGetUsers | API 调用 | 
| Amazon WorkDocs | CheckAlias | API 调用 | 
| Amazon WorkDocs | CompleteDocumentVersionUpload | API 调用 | 
| Amazon WorkDocs | CreateAnnotation | API 调用 | 
| Amazon WorkDocs | CreateComment | API 调用 | 
| Amazon WorkDocs | CreateFeedbackRequest | API 调用 | 
| Amazon WorkDocs | CreateFolder | API 调用 | 
| Amazon WorkDocs | CreateGroup | API 调用 | 
| Amazon WorkDocs | CreateShare | API 调用 | 
| Amazon WorkDocs | CreateUser | API 调用 | 
| Amazon WorkDocs | DeleteAnnotation | API 调用 | 
| Amazon WorkDocs | DeleteComment | API 调用 | 
| Amazon WorkDocs | DeleteDocument | API 调用 | 
| Amazon WorkDocs | DeleteFeedbackRequest | API 调用 | 
| Amazon WorkDocs | DeleteFolder | API 调用 | 
| Amazon WorkDocs | DeleteFolderContents | API 调用 | 
| Amazon WorkDocs | DeleteGroup | API 调用 | 
| Amazon WorkDocs | DeleteOrganizationShare | API 调用 | 
| Amazon WorkDocs | DeleteUser | API 调用 | 
| Amazon WorkDocs | DownloadDocumentVersion | API 调用 | 
| Amazon WorkDocs | DownloadDocumentVersionUnderlays | API 调用 | 
| Amazon WorkDocs | InitiateDocumentVersionUpload | API 调用 | 
| Amazon WorkDocs | LogoutUser | API 调用 | 
| Amazon WorkDocs | PaginatedOrganizationActivity | API 调用 | 
| Amazon WorkDocs | PublishAnnotations | API 调用 | 
| Amazon WorkDocs | PublishComments | API 调用 | 
| Amazon WorkDocs | RestoreDocument | API 调用 | 
| Amazon WorkDocs | RestoreFolder | API 调用 | 
| Amazon WorkDocs | SearchGroups | API 调用 | 
| Amazon WorkDocs | SearchOrganizationUsers | API 调用 | 
| Amazon WorkDocs | TransferUserResources | API 调用 | 
| Amazon WorkDocs | UpdateAnnotation | API 调用 | 
| Amazon WorkDocs | UpdateComment | API 调用 | 
| Amazon WorkDocs | UpdateDocument | API 调用 | 
| Amazon WorkDocs | UpdateDocumentVersion | API 调用 | 
| Amazon WorkDocs | UpdateFolder | API 调用 | 
| Amazon WorkDocs | UpdateGroup | API 调用 | 
| Amazon WorkDocs | UpdateOrganization | API 调用 | 
| Amazon WorkDocs | UpdateUser | API 调用 | 
| Amazon WorkMail | AssumeImpersonationRole | API 调用 | 
| Amazon WorkMail | QueryDnsRecords | API 调用 | 
| Amazon WorkMail | SearchMembers | API 调用 | 
| Amazon WorkMail | TestAvailabilityConfiguration | API 调用 | 
| Amazon WorkMail | TestInboundMailFlowRules | API 调用 | 
| Amazon WorkMail | TestOutboundMailFlowRules | API 调用 | 

# 亚马逊 EventBridge 活动详情参考
<a name="event-reference"></a>

EventBridge 本身会发出以下事件。与任何其他 Amazon 服务一样，这些事件会自动发送到默认事件总线。

有关所有事件中包含的元数据字段的定义，请参阅《事件参考》**中的 [Amazon 服务事件元数据](https://docs.amazonaws.cn/eventbridge/latest/ref/events-structure.html)。


| 事件详细信息类型 | 说明 | 
| --- | --- | 
|   [Scheduled Event](#event-detail-scheduled-event)   |  表示计划的事件。 | 
|   [Schema Created](#event-detail-schema-created)   |  表示创建新事件架构。 | 
|   [Schema Version Created](#event-detail-schema-version-created)   |  表示创建新版本或现有事件架构的新版本。  | 
|   [连接状态事件](#event-detail-connection-state)   |  表示连接状态的变化。  | 
|   [API 目标状态事件](#event-detail-api-destination-state)   |  表示 API 目标状态的变化。  | 

## 计划事件
<a name="event-reference-schedules"></a>

EventBridge 将以下计划事件发送到默认事件总线。有关更多信息，请参阅 [调度器](using-eventbridge-scheduler.md)。

### Scheduled Event
<a name="event-detail-scheduled-event"></a>

表示计划的事件。

之所以包括`source`和`detail-type`字段，是因为它们包含 EventBridge 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅《事件参考》**中的 [Amazon 服务事件元数据](https://docs.amazonaws.cn/eventbridge/latest/ref/events-structure.html)。

```
{
  . . .,
  "detail-type": "Scheduled Event",
  "source": "aws.events",
  . . .,
  "detail": {}
}
```

`detail-type`  <a name="scheduled-event-detail-type"></a>
标识事件的类型。  
对于这一事件，此值为 `Scheduled Event`。  
是否必需：是

`source`  <a name="scheduled-event-source"></a>
标识生成事件的服务。对于 EventBridge 事件，此值为 `aws.events`。  
是否必需：是

`detail`  <a name="scheduled-event-detail"></a>
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。  
是否必需：是  
对于 `Scheduled Event` 事件，此对象中没有必填字段。

**Example “Scheduled Event”事件示例**  <a name="event-detail-scheduled-event.example"></a>

```
{
  "version": "0",
  "id": "89d1a02d-5ec7-412e-82f5-13505f849b41",
  "detail-type": "Scheduled Event",
  "source": "aws.events",
  "account": "123456789012",
  "time": "2016-12-30T18:44:49Z",
  "region": "us-east-1",
  "resources": ["arn:aws:events:us-east-1:123456789012:rule/SampleRule"],
  "detail": {}
}
```

## 架构注册表事件
<a name="event-reference-schemas"></a>

EventBridge 将以下架构注册表事件发送到默认事件总线。有关更多信息，请参阅 [](eb-schema.md)。

### Schema Created
<a name="event-detail-schema-created"></a>

表示创建新架构。

创建架构后， EventBridge 会同时发送`Schema Created`和`Schema Version Created`事件。

之所以包括`source`和`detail-type`字段，是因为它们包含 EventBridge 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅《事件参考》**中的 [Amazon 服务事件元数据](https://docs.amazonaws.cn/eventbridge/latest/ref/events-structure.html)。

```
{
  . . .,
  "detail-type": "Schema Created",
  "source": "aws.schemas",
  . . .,
  "detail": {
    "SchemaName" : "String",
    "SchemaType" : "String",
    "RegistryName" : "String",
    "CreationDate" : "DateTime",
    "Version" : "Number"
  }
}
```

`detail-type`  <a name="schema-created-detail-type"></a>
标识事件的类型。  
对于这一事件，此值为 `Schema Created`。  
是否必需：是

`source`  <a name="schema-created-source"></a>
标识生成事件的服务。对于 EventBridge 事件，此值为 `aws.schemas`。  
是否必需：是

`detail`  <a name="schema-created-detail"></a>
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。  
是否必需：是  
对于这一事件，此数据包括：    
`SchemaName`  <a name="schema-created-schema-name"></a>
架构的名称。  
是否必需：是  
`SchemaType`  <a name="schema-created-schema-type"></a>
架构的类型。  
有效值：`OpenApi3` \$1 `JSONSchemaDraft4`  
是否必需：是  
`RegistryName`  <a name="schema-created-registry-name"></a>
包含该架构的注册表的名称。  
是否必需：是  
`CreationDate`  <a name="schema-created-creation-date"></a>
架构的创建日期。  
是否必需：是  
`Version`  <a name="schema-created-version"></a>
架构的版本。  
对于 `Schema Created` 事件，此值将始终为 `1`。  
是否必需：是

**Example “Schema Created”事件示例**  <a name="event-detail-schema-created.example"></a>

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-012345678901",
  "detail-type": "Schema Created",
  "source": "aws.schemas",
  "account": "123456789012",
  "time": "2019-05-31T21:49:54Z",
  "region": "us-east-1",
  "resources": ["arn:aws:schemas:us-east-1::schema/myRegistry/mySchema"],
  "detail": {
    "SchemaName": "mySchema",
    "SchemaType": "OpenApi3",
    "RegistryName": "myRegistry",
    "CreationDate": "2019-11-29T20:08:55Z",
    "Version": "1"
  }
}
```

### Schema Version Created
<a name="event-detail-schema-version-created"></a>

表示创建新版本或现有事件架构的新版本。

创建架构后， EventBridge 会同时发送`Schema Created`和`Schema Version Created`事件。

之所以包括`source`和`detail-type`字段，是因为它们包含 EventBridge 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅《事件参考》**中的 [Amazon 服务事件元数据](https://docs.amazonaws.cn/eventbridge/latest/ref/events-structure.html)。

```
{
  . . .,
  "detail-type": "Schema Version Created",
  "source": "aws.schemas",
  . . .,
  "detail": {
    "SchemaName" : "String",
    "SchemaType" : "String",
    "RegistryName" : "String",
    "CreationDate" : "DateTime",
    "Version" : "Number"
  }
}
```

`detail-type`  <a name="schema-version-created-detail-type"></a>
标识事件的类型。  
对于这一事件，此值为 `Schema Version Created`。  
是否必需：是

`source`  <a name="schema-version-created-source"></a>
标识生成事件的服务。对于 EventBridge 事件，此值为 `aws.schemas`。  
是否必需：是

`detail`  <a name="schema-version-created-detail"></a>
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。  
是否必需：是  
对于这一事件，此数据包括：    
`SchemaName`  <a name="schema-version-created-schema-name"></a>
架构的名称。  
是否必需：是  
`SchemaType`  <a name="schema-version-created-schema-type"></a>
架构的类型。  
有效值：`OpenApi3` \$1 `JSONSchemaDraft4`  
是否必需：是  
`RegistryName`  <a name="schema-version-created-registry-name"></a>
包含该架构的注册表的名称。  
是否必需：是  
`CreationDate`  <a name="schema-version-created-creation-date"></a>
此架构版本的创建日期。  
是否必需：是  
`Version`  <a name="schema-version-created-version"></a>
架构的版本。  
是否必需：是

**Example “Schema Version Created”事件示例**  <a name="event-detail-schema-version-created.example"></a>

```
{
  "version": "0",
  "id": "01234567-0123-0123-0123-012345678901",
  "detail-type": "Schema Version Created",
  "source": "aws.schemas",
  "account": "123456789012",
  "time": "2019-05-31T21:49:54Z",
  "region": "us-east-1",
  "resources": ["arn:aws:schemas:us-east-1::schema/myRegistry/mySchema"],
  "detail": {
    "SchemaName": "mySchema",
    "SchemaType": "OpenApi3",
    "RegistryName": "myRegistry",
    "CreationDate": "2019-11-29T20:08:55Z",
    "Version": "5"
  }
}
```

## 连接事件
<a name="event-reference-connections"></a>

EventBridge 将以下连接事件发送到默认事件总线。有关更多信息，请参阅 [Connections](eb-target-connection.md)。

### 连接状态事件
<a name="event-detail-connection-state"></a>

这些事件分别代表新连接或现有连接状态的变化。

之所以包括`source`和`detail-type`字段，是因为它们包含 EventBridge 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅《事件参考》**中的 [Amazon 服务事件元数据](https://docs.amazonaws.cn/eventbridge/latest/ref/events-structure.html)。

```
{
  . . .,
  "detail-type": "Connection status",
  "source": "aws.events",
  . . .,
  "detail": {
    "ConnectionName" : "String",
    "StateReason" : "String",
    "Timestamp" : "DateTime"
  }
}
```

`detail-type`  <a name="connection-state-detail-type"></a>
标识事件的类型。  
对于此事件，此值可以为以下选项之一：  
+ `Connection Creation Started`
+ `Connection Update Started`
+ `Connection Deletion Started`
+ `Connection Activated`
+ `Connection Authorized`
+ `Connection Authorization Started`
+ `Connection Deauthorization Started`
+ `Connection Deauthorized`
+ `Connection Failed Connectivity`
是否必需：是

`source`  <a name="connection-state-source"></a>
标识生成事件的服务。对于 EventBridge 事件，此值为`aws.events`。  
是否必需：是

`detail`  <a name="connection-state-detail"></a>
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。  
是否必需：是  
对于这一事件，此数据包括：    
`ConnectionName`  <a name="connection-state-connection-name"></a>
连接的名称。  
是否必需：是  
`StateReason`  <a name="connection-state-state-reason"></a>
连接状态发生变化的原因。  
必需：否  
`Timestamp`  <a name="connection-state-timestamp"></a>
连接状态发生变化的时间和日期。  
是否必需：是

**Example 示例连接状态事件**  <a name="event-detail-connection-state.example"></a>

```
{
    "version": "0",
    "id": "1d7a4ac6-a50a-745f-a331-a0d802f7badb",
    "detail-type": "Connection Creation Started",
    "source": "aws.events",
    "account": "123456789012",
    "time": "2024-10-28T09:08:20Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:events:us-east-1:123456789012:connection/sample-connection/ee7e4d52-8df0-4bed-a0d5-fa7dea43fcf8"
    ],
    "detail": {
        "ConnectionName": "sample-connection",
        "Timestamp": "2024-10-24 09:26:35 +0000 UTC"
    }
}
```

## API 目标事件
<a name="event-reference-api-destinations"></a>

EventBridge 将以下 API 目标事件发送到默认事件总线。有关更多信息，请参阅 [API 目标](eb-api-destinations.md)。

### API 目标状态事件
<a name="event-detail-api-destination-state"></a>

这些事件分别表示 API 目标状态的变化。

之所以包括`source`和`detail-type`字段，是因为它们包含 EventBridge 事件的特定值。有关所有事件中包含的其他元数据字段的定义，请参阅《事件参考》**中的 [Amazon 服务事件元数据](https://docs.amazonaws.cn/eventbridge/latest/ref/events-structure.html)。

```
{
  . . .,
  "detail-type": "API Destination status",
  "source": "aws.events",
  . . .,
  "detail": {
    "ApiDestinationName" : "String",
    "Timestamp" : "DateTime"
  }
}
```

`detail-type`  <a name="api-destination-state-detail-type"></a>
标识事件的类型。  
对于此事件，此值可以为以下选项之一：  
+ `API Destination Activated`
+ `API Destination Deactivated`
是否必需：是

`source`  <a name="api-destination-state-source"></a>
标识生成事件的服务。对于 EventBridge 事件，此值为`aws.events`。  
是否必需：是

`detail`  <a name="api-destination-state-detail"></a>
包含关于事件信息的 JSON 对象。生成事件的服务决定该字段的内容。  
是否必需：是  
对于这一事件，此数据包括：    
`ApiDestinationName`  <a name="api-destination-state-connection-name"></a>
API 目标的名称。  
是否必需：是  
`Timestamp`  <a name="api-destination-state-timestamp"></a>
API 目标状态发生变化的时间和日期。  
是否必需：是

**Example API 目标状态事件示例**  <a name="event-detail-api-destination-state.example"></a>

```
{
    "version": "0",
    "id": "1d7a4ac6-a50a-745f-a331-a0d802f7badb",
    "detail-type": "API Destination Deactivated",
    "source": "aws.events",
    "account": "123456789012",
    "time": "2024-10-28T09:08:20Z",
    "region": "us-east-1",
    "resources": [
        "arn:aws:events:us-east-1:123456789012:api-destination/sample-api-destination/ee7e4d52-8df0-4bed-a0d5-fa7dea43fcf8"
    ],
    "detail": {
        "ApiDestinationName": "sample-api-destination",
        "Timestamp": "2024-10-24 09:26:35 +0000 UTC"
    }
}
```