class LogRetention (construct)

Language	Type name
.NET	Amazon.CDK.AWS.Logs.LogRetention
Java	software.amazon.awscdk.services.logs.LogRetention
Python	aws_cdk.aws_logs.LogRetention
TypeScript (source)	@aws-cdk/aws-logs » LogRetention

Implements IConstruct, IConstruct, IDependable

Creates a custom resource to control the retention policy of a CloudWatch Logs log group.

The log group is created if it doesn't already exist. The policy is removed when retentionDays is undefined or equal to Infinity. Log group can be created in the region that is different from stack region by specifying logGroupRegion

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as iam from '@aws-cdk/aws-iam';
import * as logs from '@aws-cdk/aws-logs';
import * as cdk from '@aws-cdk/core';

declare const role: iam.Role;
const logRetention = new logs.LogRetention(this, 'MyLogRetention', {
  logGroupName: 'logGroupName',
  retention: logs.RetentionDays.ONE_DAY,

  // the properties below are optional
  logGroupRegion: 'logGroupRegion',
  logRetentionRetryOptions: {
    base: cdk.Duration.minutes(30),
    maxRetries: 123,
  },
  role: role,
});

Initializer

new LogRetention(scope: Construct, id: string, props: LogRetentionProps)

Parameters

• scope Construct
• id string
• props LogRetentionProps

Construct Props

Name	Type	Description
logGroupName	string	The log group name.
retention	RetentionDays	The number of days log events are kept in CloudWatch Logs.
logGroupRegion?	string	The region where the log group should be created.
logRetentionRetryOptions?	LogRetentionRetryOptions	Retry options for all AWS API calls.
role?	IRole	The IAM role for the Lambda function associated with the custom resource.

---

logGroupName

Type: string

The log group name.

---

retention

Type: RetentionDays

The number of days log events are kept in CloudWatch Logs.

---

logGroupRegion?

Type: string (optional, default: same region as the stack)

The region where the log group should be created.

---

logRetentionRetryOptions?

Type: LogRetentionRetryOptions (optional, default: AWS SDK default retry options)

Retry options for all AWS API calls.

---

role?

Type: IRole (optional, default: A new role is created)

The IAM role for the Lambda function associated with the custom resource.

Properties

Name	Type	Description
logGroupArn	string	The ARN of the LogGroup.
node	ConstructNode	The construct tree node associated with this construct.

---

logGroupArn

Type: string

The ARN of the LogGroup.

---

node

Type: ConstructNode

The construct tree node associated with this construct.

Methods

Name	Description
toString()	Returns a string representation of this construct.

---

toString()

public toString(): string

Returns

• string

Returns a string representation of this construct.