为以下各项配置亚马逊SNS通知 CloudTrail

当您向 Amazon S3 存储桶 CloudTrail 发布新的日志文件时，您会收到通知。您可以使用亚马逊简单通知服务 (AmazonSNS) 来管理通知。

通知是可选的。如果您需要通知，则可以配置 CloudTrail 为每当发送新的日志文件时，向 Amazon SNS 主题发送更新信息。要接收这些通知，您可以使用 Amazon 订SNS阅该主题。作为订阅者，您可以将更新发送到亚马逊简单队列服务 (AmazonSQS) 队列，这使您能够以编程方式处理这些通知。

配置 CloudTrail 为发送通知

您可以将跟踪配置为使用 Amazon SNS 主题。您可以使用 CloudTrail 控制台或aws cloudtrail create-trailCLI命令来创建主题。 CloudTrail 为您创建 Amazon SNS 主题并附上相应的政策，以便 CloudTrail 有权发布该主题。

创建SNS主题名称时，名称必须满足以下要求：

• 介于 1 到 256 个字符之间

• 包含大写和小写ASCII字母、数字、下划线或连字符

当您为应用于所有区域的跟踪配置通知时，来自所有区域的通知都将发送到您指定的亚马逊SNS主题。如果您有一个或多个区域特定的跟踪，须为每个区域分别创建一个主题，并单独订阅每个主题。

要接收通知，请订阅 CloudTrail 使用SNS的一个或多个亚马逊主题。您可以使用亚马逊SNS控制台或亚马逊SNSCLI命令执行此操作。有关更多信息，请参阅《亚马逊简单通知服务开发者指南》中的订阅亚马逊SNS主题。

注意

CloudTrail 当日志文件写入 Amazon S3 存储桶时会发送通知。有效账户可以生成大量通知。如果您使用电子邮件或进行订阅SMS，则可能会收到大量消息。我们建议您使用亚马逊简单队列服务 (AmazonSQS) 进行订阅，该服务允许您以编程方式处理通知。有关更多信息，请参阅《亚马逊简单SQS队列服务开发者指南》中的为亚马逊队列订阅亚马逊SNS主题（控制台）。

Amazon SNS 通知由一个包含Message字段的JSON对象组成。此 Message 字段列出了日志文件的完整路径，如以下示例所示：

{
    "s3Bucket": "amzn-s3-demo-bucket","s3ObjectKey": ["AWSLogs/123456789012/CloudTrail/us-east-2/2013/12/13/123456789012_CloudTrail_us-west-2_20131213T1920Z_LnPgDQnpkSKEsppV.json.gz"]
}

如果多个日志文件都传输到了 Amazon S3 存储桶，则一条通知中可能包括多个日志，如以下示例所示：

{
    "s3Bucket": "amzn-s3-demo-bucket",
    "s3ObjectKey": [
        "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2215Z_kpaMYavMQA9Ahp7L.json.gz",
        "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2210Z_zqDkyQv3TK8ZdLr0.json.gz",
        "AWSLogs/123456789012/CloudTrail/us-east-2/2016/08/11/123456789012_CloudTrail_us-east-2_20160811T2205Z_jaMVRa6JfdLCJYHP.json.gz"
    ]
}

如果您选择通过电子邮件接收通知，则电子邮件的正文将包含 Message 字段的内容。有关JSON结构的信息，请参阅《亚马逊简单通知服务开发者指南》中的 Fanout to Amazon SQS 队列。只有该Message字段显示 CloudTrail 信息。其他字段包含来自 Amazon SNS 服务的信息。

如果您使用创建跟踪 CloudTrail API，则可以通过CreateTrail或UpdateTrail操作指定要 CloudTrail 向其发送通知的现有 Amazon SNS 主题。您必须确保该主题存在，并且该主题具有允许 CloudTrail 向其发送通知的权限。请参阅 适用于 Amazon 的SNS主题政策 CloudTrail。

其他 资源

有关亚马逊SNS主题和订阅这些主题的更多信息，请参阅《亚马逊简单通知服务开发者指南》。