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

AWS::Logs::LogGroup

AWS::Logs::LogGroup 资源指定一个日志组。日志组定义日志流的常用属性,如日志流的保留和访问控制规则。每个日志流必须属于一个日志组。

您最多可以为每个账户创建 5000 个日志组。为日志组命名时,您必须使用以下准则。

  • 日志组名称在 AWS 账户的某个区域内必须是唯一的。

  • 日志组名称的长度可介于 1 和 512 个字符之间。

  • 日志组名称包含以下字符:a-z、A-Z、0-9、“_”(下划线)、“-”(连字符)、“/”(正斜杠)和“.”(句点)。

语法

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

JSON

{ "Type" : "AWS::Logs::LogGroup", "Properties" : { "LogGroupName" : String, "RetentionInDays" : Integer } }

YAML

Type: AWS::Logs::LogGroup Properties: LogGroupName: String RetentionInDays: Integer

属性

LogGroupName

日志组的名称。如果您未指定名称,则 AWS CloudFormation 会为日志组生成一个唯一 ID。

必需:否

类型:字符串

最低1

最高512

模式[\.\-_/#A-Za-z0-9]+

Update requires: Replacement

RetentionInDays

在指定的日志组中保留日志事件的天数。可能的值为:1、3、5、7、14、30、60、90、120、150、180、365、400、545、731、1827 和 3653。

必需:否

类型:整数

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回 资源名称。

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

Fn::GetAtt

Fn::GetAtt 内部函数返回此类型的一个指定属性的值。以下为可用属性和示例返回值。

有关使用 Fn::GetAtt 内部函数的更多信息,请参阅 Fn::GetAtt

Arn

日志组的 ARN,例如 arn:aws:logs:us-west-1:123456789012:log-group:/mystack-testgroup-12ABC1AB12A1:*

示例

创建日志组

以下示例创建一个将事件保留 7 天的日志组。

JSON

"myLogGroup": { "Type": "AWS::Logs::LogGroup", "Properties": { "RetentionInDays": 7 } }

YAML

myLogGroup: Type: AWS::Logs::LogGroup Properties: RetentionInDays: 7