メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

AWS::Logs::LogGroup

AWS::Logs::LogGroup リソースは、保持およびアクセス制御ルールなど、ログストリームの共通プロパティを定義する Amazon CloudWatch Logs ロググループを作成します。どのログストリームも、1 つのロググループに属している必要があります。

構文

AWS CloudFormation テンプレートでこのエンティティを宣言するには、次の構文を使用します。

JSON

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

YAML

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

プロパティ

LogGroupName

ロググループの名前。 名前を指定しない場合、AWS CloudFormation は一意の物理 ID を生成し、その ID をロググループに使用します。詳細については、「Name タイプ」を参照してください。

重要

名前を指定すると、このリソースの置換が必要な更新はできません。中断が不要であるか、一定の中断が必要な更新であれば、行うことができます。リソースを置き換える必要がある場合は、新しい名前を指定します。

必須: いいえ

Type: String

更新に伴う要件: 置換

RetentionInDays

ログイベントが CloudWatch Logs に保持される日数。ログ イベントが期限切れになると、CloudWatch Logs によって自動的に削除されます。有効な値については、Amazon CloudWatch Logs API Referenceの「PutRetentionPolicy」を参照してください。

Required: No

Type: Integer

更新に伴う要件: 中断はありません。

戻り値

参照番号

このリソースの論理 ID が Ref 組み込み関数に提供されると、Ref によりリソース名が返されます。

Ref 関数の使用方法の詳細については、「Ref」を参照してください。

Fn::GetAtt

Fn::GetAtt は、このタイプの指定された属性の値を返します。以下には、利用可能な属性とサンプル戻り値のリストが示されます。

Arn

CloudWatch Logs ロググループの Amazon リソースネーム (ARN) (arn:aws:logs:us-east-1:123456789012:log-group:/mystack-testgroup-12ABC1AB12A1:* など)。

Fn::GetAtt の使用の詳細については、「Fn::GetAtt」を参照してください。

以下の例では、イベントを 7 日間保持する CloudWatch Logs ロググループを作成します。

JSON

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

YAML

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

追加情報

テンプレートのその他の例は、「Amazon CloudWatch Logs テンプレートスニペット」を参照してください。

このページの内容: