aws-cdk-lib.aws_cloudfront.CfnDistribution.LoggingProperty

interface LoggingProperty

LanguageType name
.NETAmazon.CDK.AWS.CloudFront.CfnDistribution.LoggingProperty
Gogithub.com/aws/aws-cdk-go/awscdk/v2/awscloudfront#CfnDistribution_LoggingProperty
Javasoftware.amazon.awscdk.services.cloudfront.CfnDistribution.LoggingProperty
Pythonaws_cdk.aws_cloudfront.CfnDistribution.LoggingProperty
TypeScript aws-cdk-lib » aws_cloudfront » CfnDistribution » LoggingProperty

A complex type that controls whether access logs are written for the distribution.

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_cloudfront as cloudfront } from 'aws-cdk-lib';
const loggingProperty: cloudfront.CfnDistribution.LoggingProperty = {
  bucket: 'bucket',

  // the properties below are optional
  includeCookies: false,
  prefix: 'prefix',
};

Properties

NameTypeDescription
bucketstringThe Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com .
includeCookies?boolean | IResolvableSpecifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies .
prefix?stringAn optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/ .

bucket

Type: string

The Amazon S3 bucket to store the access logs in, for example, myawslogbucket.s3.amazonaws.com .


includeCookies?

Type: boolean | IResolvable (optional)

Specifies whether you want CloudFront to include cookies in access logs, specify true for IncludeCookies .

If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specify false for IncludeCookies .


prefix?

Type: string (optional)

An optional string that you want CloudFront to prefix to the access log filenames for this distribution, for example, myprefix/ .

If you want to enable logging, but you don't want to specify a prefix, you still must include an empty Prefix element in the Logging element.