/AWS1/CL_FNTLOGGINGCONFIG¶
A complex type that specifies whether access logs are written for the distribution.
If you already enabled standard logging (legacy) and you want to enable standard logging (v2) to send your access logs to Amazon S3, we recommend that you specify a different Amazon S3 bucket or use a separate path in the same bucket (for example, use a log prefix or partitioning). This helps you keep track of which log files are associated with which logging subscription and prevents log files from overwriting each other. For more information, see Standard logging (access logs) in the Amazon CloudFront Developer Guide.
CONSTRUCTOR
¶
IMPORTING¶
Optional arguments:¶
iv_enabled
TYPE /AWS1/FNTBOOLEAN
/AWS1/FNTBOOLEAN
¶
Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify
false
forEnabled
, and specify emptyBucket
andPrefix
elements. If you specifyfalse
forEnabled
but you specify values forBucket
andprefix
, the values are automatically deleted.
iv_includecookies
TYPE /AWS1/FNTBOOLEAN
/AWS1/FNTBOOLEAN
¶
Specifies whether you want CloudFront to include cookies in access logs, specify
true
forIncludeCookies
. 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, specifyfalse
forIncludeCookies
.
iv_bucket
TYPE /AWS1/FNTSTRING
/AWS1/FNTSTRING
¶
The Amazon S3 bucket to store the access logs in, for example,
amzn-s3-demo-bucket.s3.amazonaws.com
.
iv_prefix
TYPE /AWS1/FNTSTRING
/AWS1/FNTSTRING
¶
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 emptyPrefix
element in theLogging
element.
Queryable Attributes¶
Enabled¶
Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket. If you don't want to enable logging when you create a distribution or if you want to disable logging for an existing distribution, specify
false
forEnabled
, and specify emptyBucket
andPrefix
elements. If you specifyfalse
forEnabled
but you specify values forBucket
andprefix
, the values are automatically deleted.
Accessible with the following methods¶
Method | Description |
---|---|
GET_ENABLED() |
Getter for ENABLED, with configurable default |
ASK_ENABLED() |
Getter for ENABLED w/ exceptions if field has no value |
HAS_ENABLED() |
Determine if ENABLED has a value |
IncludeCookies¶
Specifies whether you want CloudFront to include cookies in access logs, specify
true
forIncludeCookies
. 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, specifyfalse
forIncludeCookies
.
Accessible with the following methods¶
Method | Description |
---|---|
GET_INCLUDECOOKIES() |
Getter for INCLUDECOOKIES, with configurable default |
ASK_INCLUDECOOKIES() |
Getter for INCLUDECOOKIES w/ exceptions if field has no valu |
HAS_INCLUDECOOKIES() |
Determine if INCLUDECOOKIES has a value |
Bucket¶
The Amazon S3 bucket to store the access logs in, for example,
amzn-s3-demo-bucket.s3.amazonaws.com
.
Accessible with the following methods¶
Method | Description |
---|---|
GET_BUCKET() |
Getter for BUCKET, with configurable default |
ASK_BUCKET() |
Getter for BUCKET w/ exceptions if field has no value |
HAS_BUCKET() |
Determine if BUCKET has a value |
Prefix¶
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 emptyPrefix
element in theLogging
element.
Accessible with the following methods¶
Method | Description |
---|---|
GET_PREFIX() |
Getter for PREFIX, with configurable default |
ASK_PREFIX() |
Getter for PREFIX w/ exceptions if field has no value |
HAS_PREFIX() |
Determine if PREFIX has a value |