AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS::Config::DeliveryChannel

AWS::Config::DeliveryChannel 资源描述 AWS Config 应将 AWS 资源的通知和更新配置状态发往何处。

创建传输通道时,您可以指定以下内容:

  • AWS Config 将配置快照传送到 Amazon S3 存储桶的频率 (例如,24 小时)

  • AWS Config 向其发送配置快照和配置历史记录文件的 S3 存储桶

  • AWS Config 将配置更改通知 (例如,更新的资源、AWS Config 规则评估以及当 AWS Config 向 S3 存储桶提供配置快照时) 发送到的 Amazon SNS 主题。

有关更多信息,请参阅 AWS Config Developer Guide 中的传送配置项

注意

要启用 AWS Config,您必须创建配置记录器和传输通道。如果要单独创建资源,则必须先创建配置记录器,然后才能创建传输通道。AWS Config 使用配置记录器来捕获资源的配置更改。有关更多信息,请参阅 AWS::Config::ConfigurationRecorder

有关更多信息,请参阅 AWS Config Developer Guide 中的管理传输通道

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::Config::DeliveryChannel", "Properties" : { "ConfigSnapshotDeliveryProperties" : Config snapshot delivery properties, "Name" : String, "S3BucketName" : String, "S3KeyPrefix" : String, "SnsTopicARN" : String } }

YAML

Type: "AWS::Config::DeliveryChannel" Properties: ConfigSnapshotDeliveryProperties: Config snapshot delivery properties Name: String S3BucketName: String S3KeyPrefix: String SnsTopicARN: String

属性

ConfigSnapshotDeliveryProperties

提供 AWS Config 如何将配置快照传输到您的传递通道中的 S3 存储桶的选项。

Required: No

Type: AWS Config DeliveryChannel ConfigSnapshotDeliveryProperties

更新要求无需中断

Name

传递通道的名称。如果您不指定名称,则 AWS CloudFormation 生成一个唯一的物理 ID 并将此 ID 用作传递通道的名称。有关更多信息,请参阅 名称类型

Required: No

Type: String

更新要求:不支持更新。 要更改此名称,必须运行两次不同的更新。在第一次更新中删除此资源,然后在第二次更新中使用新的名称重新创建它。

S3BucketName

用于存储传递通道配置历史记录的 S3 存储桶的名称。

Required: Yes

Type: String

更新要求无需中断

S3KeyPrefix

指定的 S3 存储桶的键前缀(文件夹)。

Required: No

Type: String

更新要求无需中断

SnsTopicARN

作为 AWS Config 通知发送目标的 Amazon Simple Notification Service (Amazon SNS) 主题的 Amazon 资源名称 (ARN)。

Required: No

Type: String

更新要求无需中断

返回值

Ref

当您将 AWS::Config::DeliveryChannel 资源的逻辑 ID 传递给内部函数 Ref 时,此函数返回传递通道名称,例如 default

有关使用 Ref 功能的更多信息,请参阅参考

示例

下面的示例创建将通知发送到指定的 Amazon SNS 主题的传递通道。此传递通道还将配置变更和快照发送到指定的 S3 存储桶。

JSON

"DeliveryChannel": { "Type": "AWS::Config::DeliveryChannel", "Properties": { "ConfigSnapshotDeliveryProperties": { "DeliveryFrequency": "Six_Hours" }, "S3BucketName": {"Ref": "ConfigBucket"}, "SnsTopicARN": {"Ref": "ConfigTopic"} } }

YAML

DeliveryChannel: Type: "AWS::Config::DeliveryChannel" Properties: ConfigSnapshotDeliveryProperties: DeliveryFrequency: "Six_Hours" S3BucketName: Ref: ConfigBucket SnsTopicARN: Ref: ConfigTopic

本页内容: