LogRetentionProps

class aws_cdk.aws_logs.LogRetentionProps(*, log_group_name, retention, log_group_region=None, log_retention_retry_options=None, role=None)

Bases: object

Construction properties for a LogRetention.

Parameters
  • log_group_name (str) – The log group name.

  • retention (RetentionDays) – The number of days log events are kept in CloudWatch Logs.

  • log_group_region (Optional[str]) – The region where the log group should be created. Default: - same region as the stack

  • log_retention_retry_options (Optional[LogRetentionRetryOptions]) – Retry options for all AWS API calls. Default: - AWS SDK default retry options

  • role (Optional[IRole]) – The IAM role for the Lambda function associated with the custom resource. Default: - A new role is created

ExampleMetadata

fixture=_generated

Example:

# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk.aws_iam as iam
import aws_cdk.aws_logs as logs
import aws_cdk.core as cdk

# role: iam.Role

log_retention_props = logs.LogRetentionProps(
    log_group_name="logGroupName",
    retention=logs.RetentionDays.ONE_DAY,

    # the properties below are optional
    log_group_region="logGroupRegion",
    log_retention_retry_options=logs.LogRetentionRetryOptions(
        base=cdk.Duration.minutes(30),
        max_retries=123
    ),
    role=role
)

Attributes

log_group_name

The log group name.

Return type

str

log_group_region

The region where the log group should be created.

Default
  • same region as the stack

Return type

Optional[str]

log_retention_retry_options

Retry options for all AWS API calls.

Default
  • AWS SDK default retry options

Return type

Optional[LogRetentionRetryOptions]

retention

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

Return type

RetentionDays

role

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

Default
  • A new role is created

Return type

Optional[IRole]