本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 在亚马逊的 ARC 中使用区域切换 EventBridge
使用亚马逊 EventBridge，您可以设置事件驱动的规则，在亚马逊应用程序恢复控制器 (ARC) 中监控您的区域切换资源，然后启动使用其他 Amazon 服务的目标操作。例如，您可以设置一个规则，每当区域切换计划完成执行时，通过向 Amazon SNS 主题发信号来发送电子邮件通知。
您可以在亚马逊中创建规则 EventBridge ，对以下 ARC 区域切换事件采取行动：
+ *区域切换计划执行。*该事件表明区域切换计划已运行（已执行）。
+ *区域切换计划评估。*该事件表明区域切换计划评估已完成。
要捕获您感兴趣的特定 ARC 事件，请定义 EventBridge 可用于检测事件的事件特定模式。事件规律与它们匹配的事件具有相同的结构。模式引用了您要匹配的字段，并提供您所查找的值。
尽最大努力发出事件。 EventBridge 在正常运行环境下，它们几乎实时地从 ARC 交付到。但是，可能会出现延迟或阻止事件交付的情况。
有关 EventBridge 规则如何处理事件模式的信息，请参阅中的[事件和事件模式 EventBridge](https://docs.amazonaws.cn/eventbridge/latest/userguide/eventbridge-and-event-patterns.html)。
## 使用监控区域交换机资源 EventBridge
使用 EventBridge，您可以创建规则，定义在 ARC 为区域切换资源发出事件时要采取的操作。
要将事件模式键入或复制粘贴到 EventBridge 控制台中，请在控制台中选择 “**输入我自己的**选项” 选项。为帮助确定对您有用的事件规律，本主题包括[区域切换模式示例](#arc-eventbridge-examples-region-switch)。
**要为资源事件创建规则**
1. 在以下位置打开亚马逊 EventBridge 控制台[https://console.aws.amazon.com/events/](https://console.amazonaws.cn/events/)。
1. Amazon Web Services 区域 要在其中创建规则，请选择您创建计划以监控事件的区域。
1. 选择 **Create rule (创建规则)**。
1. 输入规则的 **Name (名称)** 和“Description (描述)”（可选）。
1. 对于**事件总线**，保留默认值，即**默认**。
1. 选择**下一步**。
1. 对于**构建事件规律**步骤，对于**事件源**，保留默认值，即 **Amazon 事件**。
1. 在**示例事件**下，选择**输入我自己的**。
1. 对于**示例事件**，键入或复制并粘贴事件规律。有关示例，请参阅下一节。
## 区域切换模式示例
事件规律与它们匹配的事件具有相同的结构。模式引用了您要匹配的字段，并提供您所查找的值。
您可以将此部分中的事件模式复制并粘贴 EventBridge 到中以创建可用于监控 ARC 操作和资源的规则。
以下事件模式提供了一些示例，您可以在 ARC EventBridge 的区域切换功能中使用这些示例。
+ *从区域切换中选择所有事件 PlanExecution*。
```
{
"source": [ "aws.arc-region-switch" ],
"detail-type": [ "ARC Region switch Plan Execution" ]
}
```
+ *从区域切换中选择所有事件 PlanEvaluation*。
```
{
"source": [ "aws.arc-region-switch" ],
"detail-type": [ "ARC Region Switch Plan Evaluation" ]
}
```
以下是*区域切换计划执行*的 ARC 事件示例：
```
{
"version": "0",
"id": "1111111-bbbb-aaaa-cccc-dddddEXAMPLE", # Random uuid
"detail-type": "ARC Region Switch Plan Execution",
"source": "aws.arc-region-switch",
"account": "111122223333",
"time": "2023-11-16T23:38:14Z",
"region": "us-east-1",
"resources": ["arn:aws:arc-region-switch::111122223333:plan/aaaaaExample"], # planArn
"detail": {
"version": "0.0.1",
"eventType": "ExecutionStarted",
"executionId": "bbbbbbEXAMPLE",
"executionAction": "activating/deactivating {region}",
"idempotencyKey": "1111111-2222-3333-4444-5555555555", # As there is a possibility of dual logging
}
}
```
以下是*区域切换计划步骤级别执行*的 ARC 事件示例：
```
{
"version": "0",
"id": "1111111-bbbb-aaaa-cccc-dddddEXAMPLE", # Random uuid
"detail-type": "ARC Region Switch Plan Execution",
"source": "aws.arc-region-switch",
"account": "111122223333",
"time": "2023-11-16T23:38:14Z",
"region": "us-east-1",
"resources": ["arn:aws:arc-region-switch::111122223333:plan/aaaaaExample"], # planArn
"detail": {
"version": "0.0.1",
"eventType": "StepStarted",
"executionId": "bbbbbbEXAMPLE",
"executionAction": "activating/deactivating {region}",
"idempotencyKey": "1111111-2222-3333-4444-5555555555", # As there is a possibility of dual logging
"stepDetails" : {
"stepName": "Routing control step",
"resource": ["arn:aws:route53-recovery-control::111122223333:controlpanel/abcdefghiEXAMPLE/routingcontrol/jklmnopqrsEXAMPLE"]
}
}
}
```
以下是*区域切换计划评估警告*的 ARC 事件示例：
对于区域切换计划评估，当返回警告时会发出一个事件。如果警告未被清除，则每 24 小时仅针对该警告发出一次事件。该事件清除后，不会针对该警告发出更多事件。
```
{
"version": "0",
"id": "05d4d2d5-9c76-bfea-72d2-d4614802adb4", # Random uuid
"detail-type": "ARC Region Switch Plan Execution",
"source": "aws.arc-region-switch",
"account": "111122223333",
"time": "2023-11-16T23:38:14Z",
"region": "us-east-1",
"resources": ["arn:aws:arc-region-switch::111122223333:plan/a2b89be4821bfd1d"],
"detail": {
"version": "0.0.1",
"idempotencyKey": "1111111-2222-3333-4444-5555555555",
"metadata": {
"evaluationTime" : "timestamp",
"warning" : "There is a plan evaluation warning for arn:aws:arc-region-switch::111122223333:plan/a2b89be4821bfd1d. Navigate to the Region switch console to resolve."
}
}
}
```
## 指定用作目标的 CloudWatch 日志组
创建 EventBridge 规则时，必须指定发送与该规则匹配的事件的目标。有关可用目标的列表 EventBridge，请参阅 EventBridge 控制台中可用的[目标](https://docs.amazonaws.cn/eventbridge/latest/userguide/eb-targets.html#eb-console-targets)。您可以向 EventBridge 规则中添加的目标之一是 Amazon CloudWatch 日志组。本节描述了将 CloudWatch 日志组添加为目标的要求，并提供了在创建规则时添加日志组的过程。
要将 CloudWatch 日志组添加为目标，可以执行以下操作之一：
+ 创建新日志组
+ 选择现有日志组
如果您在创建规则时使用控制台指定了新的日志组，则 EventBridge 会自动为您创建日志组。确保您用作 EventBridge 规则目标的日志组以开头`/aws/events`。如果要选择现有的日志组，请注意，只有以 `/aws/events` 开头的日志组才会作为选项出现在下拉菜单中。有关更多信息，请参阅《*亚马逊 CloudWatch 用户指南》[中的](https://docs.amazonaws.cn/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#Create-Log-Group)创建新日志组*。
如果您通过控制台之外的 CloudWatch 操作创建或使用 CloudWatch 日志组作为目标，请确保正确设置权限。如果您使用控制台向 EventBridge 规则添加日志组，则该日志组的基于资源的策略会自动更新。但是，如果您使用 Amazon Command Line Interface 或 Amazon SDK 来指定日志组，则必须更新该日志组的基于资源的策略。以下示例策略说明了您必须在日志组的基于资源的策略中定义的权限：
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Action": [
"logs:CreateLogStream",
"logs:PutLogEvents"
],
"Effect": "Allow",
"Principal": {
"Service": [
"events.amazonaws.com",
"delivery.logs.amazonaws.com"
]
},
"Resource": "arn:aws:logs:us-east-1:222222222222:log-group:/aws/events/*:*",
"Sid": "TrustEventsToStoreLogEvent"
}
]
}
```
------
您无法使用控制台为日志组配置基于资源的策略。要向基于资源的策略添加所需的权限，请使用 CloudWatch [ PutResourcePolicy ](https://docs.amazonaws.cn/AmazonCloudWatchLogs/latest/APIReference/API_PutResourcePolicy.html) API 操作。然后，您可以使用 [describe-resource-policies](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/logs/describe-resource-policies.html) CLI 命令来检查您的策略是否已正确应用。
**为资源事件创建规则并指定 CloudWatch 日志组目标**
1. 在以下位置打开亚马逊 EventBridge 控制台[https://console.aws.amazon.com/events/](https://console.amazonaws.cn/events/)。
1. 选择 Amazon Web Services 区域 要在其中创建规则的。
1. 选择**创建规则**，然后输入有关该规则的所有信息，例如事件规律或计划详细信息。
有关创建就绪情况 EventBridge 规则的更多信息，请参阅使用[监控准备情况检查资源 EventBridge](eventbridge-readiness.md#RCEventBridgeCreateRule)。
1. 在**选择目标**页面上，选择**CloudWatch**作为目标。
1. 从下拉菜单中选择一个 CloudWatch 日志组。