software.amazon.awscdk.services.cloudfront

Interface SourceConfiguration

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

SourceConfiguration.Jsii$Proxy

@Generated(value="jsii-pacmak/1.24.0 (build b722f66)",
           date="2021-03-11T13:46:52.432Z")
 @Stability(value=Stable)
public interface SourceConfiguration
extends software.amazon.jsii.JsiiSerializable

A source configuration is a wrapper for CloudFront origins and behaviors.

An origin is what CloudFront will "be in front of" - that is, CloudFront will pull it's assets from an origin.

If you're using s3 as a source - pass the s3Origin property, otherwise, pass the customOriginSource property.

One or the other must be passed, and it is invalid to pass both in the same SourceConfiguration.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	SourceConfiguration.Builder A builder for SourceConfiguration
static class	SourceConfiguration.Jsii$Proxy An implementation for SourceConfiguration

Method Summary

Modifier and Type	Method and Description
static SourceConfiguration.Builder	builder()
List<Behavior>	getBehaviors() The behaviors associated with this source.
default Number	getConnectionAttempts() The number of times that CloudFront attempts to connect to the origin.
default Duration	getConnectionTimeout() The number of seconds that CloudFront waits when trying to establish a connection to the origin.
default CustomOriginConfig	getCustomOriginSource() A custom origin source - for all non-s3 sources.
default List<FailoverStatusCode>	getFailoverCriteriaStatusCodes() HTTP status code to failover to second origin.
default CustomOriginConfig	getFailoverCustomOriginSource() A custom origin source for failover in case the s3OriginSource returns invalid status code.
default S3OriginConfig	getFailoverS3OriginSource() An s3 origin source for failover in case the s3OriginSource returns invalid status code.
default Map<String,String>	getOriginHeaders() Deprecated. Use originHeaders on s3OriginSource or customOriginSource
default String	getOriginPath() Deprecated. Use originPath on s3OriginSource or customOriginSource
default S3OriginConfig	getS3OriginSource() An s3 origin source - if you're using s3 for your assets.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getBehaviors

@Stability(value=Stable)
 @NotNull
List<Behavior> getBehaviors()

The behaviors associated with this source.

At least one (default) behavior must be included.

getConnectionAttempts

@Stability(value=Stable)
 @Nullable
default Number getConnectionAttempts()

The number of times that CloudFront attempts to connect to the origin.

You can specify 1, 2, or 3 as the number of attempts.

Default: 3

getConnectionTimeout

@Stability(value=Stable)
 @Nullable
default Duration getConnectionTimeout()

The number of seconds that CloudFront waits when trying to establish a connection to the origin.

You can specify a number of seconds between 1 and 10 (inclusive).

Default: cdk.Duration.seconds(10)

getCustomOriginSource

@Stability(value=Stable)
 @Nullable
default CustomOriginConfig getCustomOriginSource()

A custom origin source - for all non-s3 sources.

getFailoverCriteriaStatusCodes

@Stability(value=Stable)
 @Nullable
default List<FailoverStatusCode> getFailoverCriteriaStatusCodes()

HTTP status code to failover to second origin.

Default: [500, 502, 503, 504]

getFailoverCustomOriginSource

@Stability(value=Stable)
 @Nullable
default CustomOriginConfig getFailoverCustomOriginSource()

A custom origin source for failover in case the s3OriginSource returns invalid status code.

Default: - no failover configuration

getFailoverS3OriginSource

@Stability(value=Stable)
 @Nullable
default S3OriginConfig getFailoverS3OriginSource()

An s3 origin source for failover in case the s3OriginSource returns invalid status code.

Default: - no failover configuration

getOriginHeaders

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default Map<String,String> getOriginHeaders()

Deprecated. Use originHeaders on s3OriginSource or customOriginSource

(deprecated) Any additional headers to pass to the origin.

Default: - No additional headers are passed.

getOriginPath

@Stability(value=Deprecated)
 @Deprecated
 @Nullable
default String getOriginPath()

Deprecated. Use originPath on s3OriginSource or customOriginSource

(deprecated) The relative path to the origin root to use for sources.

Default: /

getS3OriginSource

@Stability(value=Stable)
 @Nullable
default S3OriginConfig getS3OriginSource()

An s3 origin source - if you're using s3 for your assets.

builder

@Stability(value=Stable)
static SourceConfiguration.Builder builder()

Returns:

a SourceConfiguration.Builder of SourceConfiguration