教程：使用 Amazon EventBridge 监控对您的组织进行的重要更改

以组织管理账户的管理员身份登录Amazon，然后通过 https://console.amazonaws.cn/cloudtrail/ 打开 CloudTrail 控制台。

在控制台右上角的导航栏中，选择美国东部（弗吉尼亚北部）区域。如果您选择其他区域，Amazon Organizations 不会在 Amazon EventBridge 配置设置中作为一个选项出现，CloudTrail 也不会捕获 Amazon Organizations 的相关信息。

在导航窗格中，选择 Trails（跟踪记录）。

选择创建跟踪。

对于 Trail name (跟踪名称)，输入 My-Test-Trail。

执行下列选项之一来指定 CloudTrail 将日志提交到的位置：

选择下一步。

在 Choose log events（选择日志事件）页面的 Management events（管理事件）部分中，选择 Read（读取）和 Write（写入）。

选择下一步。

检查您的选择，然后选择 Create trail（创建跟踪）。

从 Amazon Lambda 打开 https://console.amazonaws.cn/lambda/ 控制台。

如果您是首次使用 Lambda，请在欢迎页面上选择 Get Started Now（立即开始使用）；否则，选择 Create function（创建函数）。

在 Create function（创建函数）页面中，选择 Use a blueprint（使用蓝图）。

从 Blueprints (蓝图) 搜索框中，为筛选条件输入 hello，然后选择 hello-world 蓝图。

选择 配置。

在 Basic information (基本信息) 页面上，执行以下操作：

1. 对于 Lambda 函数名称，在 Name (名称) 文本框中输入 LogOrganizationEvents。

2. 对于 Role (角色)，选择 Create a new role with basic Lambda permissions (创建具有基本 Lambda 权限的新角色)。此角色授予您的 Lambda 函数访问所需数据的权限和写入输出日志的权限。

编辑 Lambda 函数的代码，如以下示例所示。

console.log('Loading function');

exports.handler = async (event, context) => {
    console.log('LogOrganizationsEvents');
    console.log('Received event:', JSON.stringify(event, null, 2));
    return event.key1;  // Echo back the first key value
    // throw new Error('Something went wrong');
};

该示例代码使用 LogOrganizationEvents 标记字符串记录事件，后跟组成事件的 JSON 字符串。

选择 Create function (创建函数)。

从 https://console.amazonaws.cn/sns/v3/ 打开 Amazon SNS 控制台。

在导航窗格中，选择 Topics（主题）。

选择 创建新主题。

1. 对于 Topic name (主题名称)，输入 OrganizationsCloudWatchTopic。

2. 对于 Display name (显示名称)，输入 OrgsCWEvnt。

3. 选择创建主题。

现在，您可以创建该主题的订阅。选择您刚刚创建的主题的 ARN。

选择创建订阅。

1. 在 Create subscription (创建订阅) 页面上，为 Protocol (协议) 选择 Email (电子邮件)。

2. 对于 Endpoint (终端节点)，输入您的电子邮件地址。

3. 选择 Create subscription (创建订阅)。Amazon 将向前一步中指定的电子邮件地址发送电子邮件。收到这封电子邮件后，选择电子邮件中的 Confirm subscription (确认订阅) 链接，验证您已成功接收到这封电子邮件。

4. 返回控制台并刷新页面。Pending confirmation 消息消失，现已替换为有效的订阅 ID。

在 https://console.amazonaws.cn/events/ 打开 Amazon EventBridge 控制台。

您必须将控制台设置为美国东部（弗吉尼亚州北部）区域，否则有关 Organizations 的信息不可用。在控制台右上角的导航栏中，选择美国东部（弗吉尼亚北部）区域。

有关创建规则的说明，请参阅 Amazon EventBridge 用户指南中的 Getting started with Amazon EventBridge（Amazon EventBridge 入门）。

从 https://console.amazonaws.cn/cloudwatch/ 打开 CloudWatch 控制台。

在导航窗格中，选择 Logs (日志)。

在 Log Groups (日志组) 下，选择与您的 Lambda 函数关联的组：/aws/lambda/LogOrganizationEvents。

每个组包含一个或多个流，应该有一个今天的组。选择该存储桶。

查看日志。您应该可以看到与以下内容类似的行：

选择条目中间的行，查看收到事件的完整 JSON 文本。您可以在输出的 requestParameters 和 responseElements 部分查看 API 请求的所有详细信息。

2017-03-09T22:45:05.101Z 0999eb20-051a-11e7-a426-cddb46425f16 Received event:
{
    "version": "0",
    "id": "123456-EXAMPLE-GUID-123456",
    "detail-type": "AWS API Call via CloudTrail",
    "source": "aws.organizations",
    "account": "123456789012",
    "time": "2017-03-09T22:44:26Z",
    "region": "us-east-1",
    "resources": [],
    "detail": {
        "eventVersion": "1.04",
        "userIdentity": {
            ...
        },
        "eventTime": "2017-03-09T22:44:26Z",
        "eventSource": "organizations.amazonaws.com",
        "eventName": "CreateOrganizationalUnit",
        "awsRegion": "us-east-1",
        "sourceIPAddress": "192.168.0.1",
        "userAgent": "AWS Organizations Console, aws-internal/3",
        "requestParameters": {
            "parentId": "r-exampleRootId",
            "name": "TestCWEOU"
        },
        "responseElements": {
            "organizationalUnit": {
                "name": "TestCWEOU",
                "id": "ou-exampleRootId-exampleOUId",
                "arn": "arn:aws:organizations::1234567789012:ou/o-exampleOrgId/ou-exampleRootId-exampeOUId"
            }
        },
        "requestID": "123456-EXAMPLE-GUID-123456",
        "eventID": "123456-EXAMPLE-GUID-123456",
        "eventType": "AwsApiCall"
    }
}

检查您的电子邮件账户是否收到来自 OrgsCWEvnt 的邮件（您的 Amazon SNS 主题的显示名称）。电子邮件正文中包含与上一步所示的日志条目相同的 JSON 文本输出。

使用 CloudTrail 控制台 删除您通过步骤 1 创建的、名为 My-Test-Trail 的跟踪。

如果您在步骤 1 中创建了 Amazon S3 存储桶，请使用 Amazon S3 控制台将其删除。

使用 Lambda 控制台删除您通过步骤 2 创建的、名为 LogOrganizationEvents 的函数。

使用 Amazon SNS 控制台删除您通过步骤 3 创建的、名为OrganizationsCloudWatchTopic 的 Amazon SNS 主题。

使用 CloudWatch 控制台，删除您通过步骤 4 创建的名为 OrgsMonitorRule 的 EventBridge 规则。

使用 Organizations 控制台删除您通过步骤 5 创建的、名为 TestCWEOU 的 OU。