Class LoggingConfig
- java.lang.Object
-
- software.amazon.awssdk.services.cloudfront.model.LoggingConfig
-
- All Implemented Interfaces:
Serializable
,SdkPojo
,ToCopyableBuilder<LoggingConfig.Builder,LoggingConfig>
@Generated("software.amazon.awssdk:codegen") public final class LoggingConfig extends Object implements SdkPojo, Serializable, ToCopyableBuilder<LoggingConfig.Builder,LoggingConfig>
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.
- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static interface
LoggingConfig.Builder
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description String
bucket()
The Amazon S3 bucket to store the access logs in, for example,amzn-s3-demo-bucket.s3.amazonaws.com
.static LoggingConfig.Builder
builder()
Boolean
enabled()
Specifies whether you want CloudFront to save access logs to an Amazon S3 bucket.boolean
equals(Object obj)
boolean
equalsBySdkFields(Object obj)
<T> Optional<T>
getValueForField(String fieldName, Class<T> clazz)
int
hashCode()
Boolean
includeCookies()
Specifies whether you want CloudFront to include cookies in access logs, specifytrue
forIncludeCookies
.String
prefix()
An optional string that you want CloudFront to prefix to the access logfilenames
for this distribution, for example,myprefix/
.Map<String,SdkField<?>>
sdkFieldNameToField()
List<SdkField<?>>
sdkFields()
static Class<? extends LoggingConfig.Builder>
serializableBuilderClass()
LoggingConfig.Builder
toBuilder()
String
toString()
Returns a string representation of this object.-
Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait
-
Methods inherited from interface software.amazon.awssdk.utils.builder.ToCopyableBuilder
copy
-
-
-
-
Method Detail
-
enabled
public final Boolean 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.- Returns:
- 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.
-
includeCookies
public final Boolean 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
.- Returns:
- 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
.
-
bucket
public final String bucket()
The Amazon S3 bucket to store the access logs in, for example,
amzn-s3-demo-bucket.s3.amazonaws.com
.- Returns:
- The Amazon S3 bucket to store the access logs in, for example,
amzn-s3-demo-bucket.s3.amazonaws.com
.
-
prefix
public final String 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.- Returns:
- 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.
-
toBuilder
public LoggingConfig.Builder toBuilder()
- Specified by:
toBuilder
in interfaceToCopyableBuilder<LoggingConfig.Builder,LoggingConfig>
-
builder
public static LoggingConfig.Builder builder()
-
serializableBuilderClass
public static Class<? extends LoggingConfig.Builder> serializableBuilderClass()
-
equalsBySdkFields
public final boolean equalsBySdkFields(Object obj)
- Specified by:
equalsBySdkFields
in interfaceSdkPojo
-
toString
public final String toString()
Returns a string representation of this object. This is useful for testing and debugging. Sensitive data will be redacted from this string using a placeholder value.
-
sdkFieldNameToField
public final Map<String,SdkField<?>> sdkFieldNameToField()
- Specified by:
sdkFieldNameToField
in interfaceSdkPojo
-
-