AWS::Config::ConfigurationRecorder - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::Config::ConfigurationRecorder

AWS::Config::ConfigurationRecorder 资源描述了 AWS Config 记录其配置更改的 AWS 资源类型。配置记录器以配置项目的形式将受支持资源的配置存储在您的账户中。

注意

要启用 AWS Config,您必须创建配置记录器和传输通道。AWS Config 使用传输通道将配置变更传输给您的 Amazon S3 存储桶或 Amazon SNS 主题。有关更多信息,请参阅 AWS::Config::DeliveryChannel

传输通道一旦可用,AWS CloudFormation 即启动记录器。要停止记录器,可以删除堆栈中的配置记录器。有关更多信息,请参阅《AWS Config 开发人员指南》中的配置记录器

语法

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

JSON

{ "Type" : "AWS::Config::ConfigurationRecorder", "Properties" : { "Name" : String, "RecordingGroup" : RecordingGroup, "RoleARN" : String } }

YAML

Type: AWS::Config::ConfigurationRecorder Properties: Name: String RecordingGroup: RecordingGroup RoleARN: String

属性

Name

配置记录器的名称。如果不指定名称,则 AWS CloudFormation 会生成一个唯一的物理 ID 并将该 ID 用于配置记录器名称。有关更多信息,请参阅名称类型

注意

配置记录器一经创建即无法重命名。如果不想使用 AWS CloudFormatio 生成的名称,请为该属性指定一个值。

不支持更新。

必需:否

类型:字符串

最低1

最高256

Update requires: Replacement

RecordingGroup

指示是记录所有受支持资源的配置还是特定资源类型列表的配置。您列出的资源类型必须受 AWS Config 的支持。

必需:否

类型RecordingGroup

Update requires: No interruption

RoleARN

AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称 (ARN),用于对您指定的传递通道发出读/写请求和获取受支持的 AWS 资源的配置详细信息。有关更多信息,请参阅《AWS Config 开发人员指南》中的 分配给 AWS Config 的 IAM 角色的权限

必需:是

类型:字符串

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回配置记录器名称,例如 default。

For more information about using the Ref function, see Ref.

示例

配置记录器

下面的示例创建一个适用于 EC2 卷的配置记录器。

JSON

"ConfigRecorder": { "Type": "AWS::Config::ConfigurationRecorder", "Properties": { "Name": "default", "RecordingGroup": { "ResourceTypes": ["AWS::EC2::Volume"] }, "RoleARN": {"Fn::GetAtt": ["ConfigRole", "Arn"]} } }

YAML

ConfigRecorder: Type: AWS::Config::ConfigurationRecorder Properties: Name: default RecordingGroup: ResourceTypes: - "AWS::EC2::Volume" RoleARN: Fn::GetAtt: - ConfigRole - Arn