Skip to content
v2.277.0

SourceConfiguration Struct ​

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 its 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.

Example ​

ts
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import * as cdk from 'aws-cdk-lib';
import { aws_cloudfront as cloudfront } from 'aws-cdk-lib';
import { aws_iam as iam } from 'aws-cdk-lib';
import { aws_lambda as lambda } from 'aws-cdk-lib';
import { aws_s3 as s3 } from 'aws-cdk-lib';
import { aws_cloudfront as interfaces_cloudfront } from 'aws-cdk-lib/interfaces';

declare const bucket: s3.Bucket;
declare const cloudFrontOriginAccessIdentityRef: interfaces_cloudfront.ICloudFrontOriginAccessIdentityRef & iam.IGrantable;
declare const functionRef: interfaces_cloudfront.IFunctionRef;
declare const keyGroupRef: interfaces_cloudfront.IKeyGroupRef;
declare const version: lambda.Version;
const sourceConfiguration: cloudfront.SourceConfiguration = {
  behaviors: [{
    allowedMethods: cloudfront.CloudFrontAllowedMethods.GET_HEAD,
    cachedMethods: cloudfront.CloudFrontAllowedCachedMethods.GET_HEAD,
    compress: false,
    defaultTtl: cdk.Duration.minutes(30),
    forwardedValues: {
      queryString: false,

      // the properties below are optional
      cookies: {
        forward: 'forward',

        // the properties below are optional
        whitelistedNames: ['whitelistedNames'],
      },
      headers: ['headers'],
      queryStringCacheKeys: ['queryStringCacheKeys'],
    },
    functionAssociations: [{
      eventType: cloudfront.FunctionEventType.VIEWER_REQUEST,
      function: functionRef,
    }],
    isDefaultBehavior: false,
    lambdaFunctionAssociations: [{
      eventType: cloudfront.LambdaEdgeEventType.ORIGIN_REQUEST,
      lambdaFunction: version,

      // the properties below are optional
      includeBody: false,
    }],
    maxTtl: cdk.Duration.minutes(30),
    minTtl: cdk.Duration.minutes(30),
    pathPattern: 'pathPattern',
    trustedKeyGroups: [keyGroupRef],
    trustedSigners: ['trustedSigners'],
    viewerProtocolPolicy: cloudfront.ViewerProtocolPolicy.HTTPS_ONLY,
  }],

  // the properties below are optional
  connectionAttempts: 123,
  connectionTimeout: cdk.Duration.minutes(30),
  customOriginSource: {
    domainName: 'domainName',

    // the properties below are optional
    allowedOriginSSLVersions: [cloudfront.OriginSslPolicy.SSL_V3],
    httpPort: 123,
    httpsPort: 123,
    originHeaders: {
      originHeadersKey: 'originHeaders',
    },
    originKeepaliveTimeout: cdk.Duration.minutes(30),
    originPath: 'originPath',
    originProtocolPolicy: cloudfront.OriginProtocolPolicy.HTTP_ONLY,
    originReadTimeout: cdk.Duration.minutes(30),
    originShieldRegion: 'originShieldRegion',
  },
  failoverCriteriaStatusCodes: [cloudfront.FailoverStatusCode.FORBIDDEN],
  failoverCustomOriginSource: {
    domainName: 'domainName',

    // the properties below are optional
    allowedOriginSSLVersions: [cloudfront.OriginSslPolicy.SSL_V3],
    httpPort: 123,
    httpsPort: 123,
    originHeaders: {
      originHeadersKey: 'originHeaders',
    },
    originKeepaliveTimeout: cdk.Duration.minutes(30),
    originPath: 'originPath',
    originProtocolPolicy: cloudfront.OriginProtocolPolicy.HTTP_ONLY,
    originReadTimeout: cdk.Duration.minutes(30),
    originShieldRegion: 'originShieldRegion',
  },
  failoverS3OriginSource: {
    s3BucketSource: bucket,

    // the properties below are optional
    originAccessIdentity: cloudFrontOriginAccessIdentityRef,
    originHeaders: {
      originHeadersKey: 'originHeaders',
    },
    originPath: 'originPath',
    originShieldRegion: 'originShieldRegion',
  },
  originShieldRegion: 'originShieldRegion',
  s3OriginSource: {
    s3BucketSource: bucket,

    // the properties below are optional
    originAccessIdentity: cloudFrontOriginAccessIdentityRef,
    originHeaders: {
      originHeadersKey: 'originHeaders',
    },
    originPath: 'originPath',
    originShieldRegion: 'originShieldRegion',
  },
};
python
# The code below shows an example of how to instantiate this type.
# The values are placeholders you should change.
import aws_cdk as cdk
from aws_cdk import aws_cloudfront as cloudfront
from aws_cdk import aws_iam as iam
from aws_cdk import aws_lambda as lambda_
from aws_cdk import aws_s3 as s3
from aws_cdk.interfaces import aws_cloudfront as interfaces_cloudfront

# bucket: s3.Bucket
# cloud_front_origin_access_identity_ref: interfaces_cloudfront.ICloudFrontOriginAccessIdentityRef & iam.IGrantable
# function_ref: interfaces_cloudfront.IFunctionRef
# key_group_ref: interfaces_cloudfront.IKeyGroupRef
# version: lambda.Version

source_configuration = cloudfront.SourceConfiguration(
    behaviors=[cloudfront.Behavior(
        allowed_methods=cloudfront.CloudFrontAllowedMethods.GET_HEAD,
        cached_methods=cloudfront.CloudFrontAllowedCachedMethods.GET_HEAD,
        compress=False,
        default_ttl=cdk.Duration.minutes(30),
        forwarded_values=cloudfront.CfnDistribution.ForwardedValuesProperty(
            query_string=False,

            # the properties below are optional
            cookies=cloudfront.CfnDistribution.CookiesProperty(
                forward="forward",

                # the properties below are optional
                whitelisted_names=["whitelistedNames"]
            ),
            headers=["headers"],
            query_string_cache_keys=["queryStringCacheKeys"]
        ),
        function_associations=[cloudfront.FunctionAssociation(
            event_type=cloudfront.FunctionEventType.VIEWER_REQUEST,
            function=function_ref
        )],
        is_default_behavior=False,
        lambda_function_associations=[cloudfront.LambdaFunctionAssociation(
            event_type=cloudfront.LambdaEdgeEventType.ORIGIN_REQUEST,
            lambda_function=version,

            # the properties below are optional
            include_body=False
        )],
        max_ttl=cdk.Duration.minutes(30),
        min_ttl=cdk.Duration.minutes(30),
        path_pattern="pathPattern",
        trusted_key_groups=[key_group_ref],
        trusted_signers=["trustedSigners"],
        viewer_protocol_policy=cloudfront.ViewerProtocolPolicy.HTTPS_ONLY
    )],

    # the properties below are optional
    connection_attempts=123,
    connection_timeout=cdk.Duration.minutes(30),
    custom_origin_source=cloudfront.CustomOriginConfig(
        domain_name="domainName",

        # the properties below are optional
        allowed_origin_ssl_versions=[cloudfront.OriginSslPolicy.SSL_V3],
        http_port=123,
        https_port=123,
        origin_headers={
            "origin_headers_key": "originHeaders"
        },
        origin_keepalive_timeout=cdk.Duration.minutes(30),
        origin_path="originPath",
        origin_protocol_policy=cloudfront.OriginProtocolPolicy.HTTP_ONLY,
        origin_read_timeout=cdk.Duration.minutes(30),
        origin_shield_region="originShieldRegion"
    ),
    failover_criteria_status_codes=[cloudfront.FailoverStatusCode.FORBIDDEN],
    failover_custom_origin_source=cloudfront.CustomOriginConfig(
        domain_name="domainName",

        # the properties below are optional
        allowed_origin_ssl_versions=[cloudfront.OriginSslPolicy.SSL_V3],
        http_port=123,
        https_port=123,
        origin_headers={
            "origin_headers_key": "originHeaders"
        },
        origin_keepalive_timeout=cdk.Duration.minutes(30),
        origin_path="originPath",
        origin_protocol_policy=cloudfront.OriginProtocolPolicy.HTTP_ONLY,
        origin_read_timeout=cdk.Duration.minutes(30),
        origin_shield_region="originShieldRegion"
    ),
    failover_s3_origin_source=cloudfront.S3OriginConfig(
        s3_bucket_source=bucket,

        # the properties below are optional
        origin_access_identity=cloud_front_origin_access_identity_ref,
        origin_headers={
            "origin_headers_key": "originHeaders"
        },
        origin_path="originPath",
        origin_shield_region="originShieldRegion"
    ),
    origin_shield_region="originShieldRegion",
    s3_origin_source=cloudfront.S3OriginConfig(
        s3_bucket_source=bucket,

        # the properties below are optional
        origin_access_identity=cloud_front_origin_access_identity_ref,
        origin_headers={
            "origin_headers_key": "originHeaders"
        },
        origin_path="originPath",
        origin_shield_region="originShieldRegion"
    )
)
java
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import software.amazon.awscdk.*;
import software.amazon.awscdk.services.cloudfront.*;
import software.amazon.awscdk.services.iam.*;
import software.amazon.awscdk.services.lambda.*;
import software.amazon.awscdk.services.s3.*;
import software.amazon.awscdk.interfaces.cloudfront.*;

Bucket bucket;
ICloudFrontOriginAccessIdentityRef /* & IGrantable */ cloudFrontOriginAccessIdentityRef;
IFunctionRef functionRef;
IKeyGroupRef keyGroupRef;
Version version;

SourceConfiguration sourceConfiguration = SourceConfiguration.builder()
        .behaviors(List.of(Behavior.builder()
                .allowedMethods(CloudFrontAllowedMethods.GET_HEAD)
                .cachedMethods(CloudFrontAllowedCachedMethods.GET_HEAD)
                .compress(false)
                .defaultTtl(Duration.minutes(30))
                .forwardedValues(ForwardedValuesProperty.builder()
                        .queryString(false)

                        // the properties below are optional
                        .cookies(CookiesProperty.builder()
                                .forward("forward")

                                // the properties below are optional
                                .whitelistedNames(List.of("whitelistedNames"))
                                .build())
                        .headers(List.of("headers"))
                        .queryStringCacheKeys(List.of("queryStringCacheKeys"))
                        .build())
                .functionAssociations(List.of(FunctionAssociation.builder()
                        .eventType(FunctionEventType.VIEWER_REQUEST)
                        .function(functionRef)
                        .build()))
                .isDefaultBehavior(false)
                .lambdaFunctionAssociations(List.of(LambdaFunctionAssociation.builder()
                        .eventType(LambdaEdgeEventType.ORIGIN_REQUEST)
                        .lambdaFunction(version)

                        // the properties below are optional
                        .includeBody(false)
                        .build()))
                .maxTtl(Duration.minutes(30))
                .minTtl(Duration.minutes(30))
                .pathPattern("pathPattern")
                .trustedKeyGroups(List.of(keyGroupRef))
                .trustedSigners(List.of("trustedSigners"))
                .viewerProtocolPolicy(ViewerProtocolPolicy.HTTPS_ONLY)
                .build()))

        // the properties below are optional
        .connectionAttempts(123)
        .connectionTimeout(Duration.minutes(30))
        .customOriginSource(CustomOriginConfig.builder()
                .domainName("domainName")

                // the properties below are optional
                .allowedOriginSSLVersions(List.of(OriginSslPolicy.SSL_V3))
                .httpPort(123)
                .httpsPort(123)
                .originHeaders(Map.of(
                        "originHeadersKey", "originHeaders"))
                .originKeepaliveTimeout(Duration.minutes(30))
                .originPath("originPath")
                .originProtocolPolicy(OriginProtocolPolicy.HTTP_ONLY)
                .originReadTimeout(Duration.minutes(30))
                .originShieldRegion("originShieldRegion")
                .build())
        .failoverCriteriaStatusCodes(List.of(FailoverStatusCode.FORBIDDEN))
        .failoverCustomOriginSource(CustomOriginConfig.builder()
                .domainName("domainName")

                // the properties below are optional
                .allowedOriginSSLVersions(List.of(OriginSslPolicy.SSL_V3))
                .httpPort(123)
                .httpsPort(123)
                .originHeaders(Map.of(
                        "originHeadersKey", "originHeaders"))
                .originKeepaliveTimeout(Duration.minutes(30))
                .originPath("originPath")
                .originProtocolPolicy(OriginProtocolPolicy.HTTP_ONLY)
                .originReadTimeout(Duration.minutes(30))
                .originShieldRegion("originShieldRegion")
                .build())
        .failoverS3OriginSource(S3OriginConfig.builder()
                .s3BucketSource(bucket)

                // the properties below are optional
                .originAccessIdentity(cloudFrontOriginAccessIdentityRef)
                .originHeaders(Map.of(
                        "originHeadersKey", "originHeaders"))
                .originPath("originPath")
                .originShieldRegion("originShieldRegion")
                .build())
        .originShieldRegion("originShieldRegion")
        .s3OriginSource(S3OriginConfig.builder()
                .s3BucketSource(bucket)

                // the properties below are optional
                .originAccessIdentity(cloudFrontOriginAccessIdentityRef)
                .originHeaders(Map.of(
                        "originHeadersKey", "originHeaders"))
                .originPath("originPath")
                .originShieldRegion("originShieldRegion")
                .build())
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
using Amazon.CDK;
using Amazon.CDK.AWS.CloudFront;
using Amazon.CDK.AWS.IAM;
using Amazon.CDK.AWS.Lambda;
using Amazon.CDK.AWS.S3;
using Amazon.CDK.Interfaces.CloudFront;

Bucket bucket;
ICloudFrontOriginAccessIdentityRef /* & IGrantable */ cloudFrontOriginAccessIdentityRef;
IFunctionRef functionRef;
IKeyGroupRef keyGroupRef;
Version version;

var sourceConfiguration = new SourceConfiguration {
    Behaviors = new [] { new Behavior {
        AllowedMethods = CloudFrontAllowedMethods.GET_HEAD,
        CachedMethods = CloudFrontAllowedCachedMethods.GET_HEAD,
        Compress = false,
        DefaultTtl = Duration.Minutes(30),
        ForwardedValues = new ForwardedValuesProperty {
            QueryString = false,

            // the properties below are optional
            Cookies = new CookiesProperty {
                Forward = "forward",

                // the properties below are optional
                WhitelistedNames = new [] { "whitelistedNames" }
            },
            Headers = new [] { "headers" },
            QueryStringCacheKeys = new [] { "queryStringCacheKeys" }
        },
        FunctionAssociations = new [] { new FunctionAssociation {
            EventType = FunctionEventType.VIEWER_REQUEST,
            Function = functionRef
        } },
        IsDefaultBehavior = false,
        LambdaFunctionAssociations = new [] { new LambdaFunctionAssociation {
            EventType = LambdaEdgeEventType.ORIGIN_REQUEST,
            LambdaFunction = version,

            // the properties below are optional
            IncludeBody = false
        } },
        MaxTtl = Duration.Minutes(30),
        MinTtl = Duration.Minutes(30),
        PathPattern = "pathPattern",
        TrustedKeyGroups = new [] { keyGroupRef },
        TrustedSigners = new [] { "trustedSigners" },
        ViewerProtocolPolicy = ViewerProtocolPolicy.HTTPS_ONLY
    } },

    // the properties below are optional
    ConnectionAttempts = 123,
    ConnectionTimeout = Duration.Minutes(30),
    CustomOriginSource = new CustomOriginConfig {
        DomainName = "domainName",

        // the properties below are optional
        AllowedOriginSSLVersions = new [] { OriginSslPolicy.SSL_V3 },
        HttpPort = 123,
        HttpsPort = 123,
        OriginHeaders = new Dictionary<string, string> {
            { "originHeadersKey", "originHeaders" }
        },
        OriginKeepaliveTimeout = Duration.Minutes(30),
        OriginPath = "originPath",
        OriginProtocolPolicy = OriginProtocolPolicy.HTTP_ONLY,
        OriginReadTimeout = Duration.Minutes(30),
        OriginShieldRegion = "originShieldRegion"
    },
    FailoverCriteriaStatusCodes = new [] { FailoverStatusCode.FORBIDDEN },
    FailoverCustomOriginSource = new CustomOriginConfig {
        DomainName = "domainName",

        // the properties below are optional
        AllowedOriginSSLVersions = new [] { OriginSslPolicy.SSL_V3 },
        HttpPort = 123,
        HttpsPort = 123,
        OriginHeaders = new Dictionary<string, string> {
            { "originHeadersKey", "originHeaders" }
        },
        OriginKeepaliveTimeout = Duration.Minutes(30),
        OriginPath = "originPath",
        OriginProtocolPolicy = OriginProtocolPolicy.HTTP_ONLY,
        OriginReadTimeout = Duration.Minutes(30),
        OriginShieldRegion = "originShieldRegion"
    },
    FailoverS3OriginSource = new S3OriginConfig {
        S3BucketSource = bucket,

        // the properties below are optional
        OriginAccessIdentity = cloudFrontOriginAccessIdentityRef,
        OriginHeaders = new Dictionary<string, string> {
            { "originHeadersKey", "originHeaders" }
        },
        OriginPath = "originPath",
        OriginShieldRegion = "originShieldRegion"
    },
    OriginShieldRegion = "originShieldRegion",
    S3OriginSource = new S3OriginConfig {
        S3BucketSource = bucket,

        // the properties below are optional
        OriginAccessIdentity = cloudFrontOriginAccessIdentityRef,
        OriginHeaders = new Dictionary<string, string> {
            { "originHeadersKey", "originHeaders" }
        },
        OriginPath = "originPath",
        OriginShieldRegion = "originShieldRegion"
    }
};
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"
import "github.com/aws/aws-cdk-go/awscdk"

var bucket Bucket
var cloudFrontOriginAccessIdentityRef interface { ICloudFrontOriginAccessIdentityRef; IGrantable }
var functionRef IFunctionRef
var keyGroupRef IKeyGroupRef
var version Version

sourceConfiguration := &SourceConfiguration{
	Behaviors: []Behavior{
		&Behavior{
			AllowedMethods: awscdk.Aws_cloudfront.CloudFrontAllowedMethods_GET_HEAD,
			CachedMethods: awscdk.*Aws_cloudfront.CloudFrontAllowedCachedMethods_GET_HEAD,
			Compress: jsii.Boolean(false),
			DefaultTtl: cdk.Duration_Minutes(jsii.Number(30)),
			ForwardedValues: &ForwardedValuesProperty{
				QueryString: jsii.Boolean(false),

				// the properties below are optional
				Cookies: &CookiesProperty{
					Forward: jsii.String("forward"),

					// the properties below are optional
					WhitelistedNames: []*string{
						jsii.String("whitelistedNames"),
					},
				},
				Headers: []*string{
					jsii.String("headers"),
				},
				QueryStringCacheKeys: []*string{
					jsii.String("queryStringCacheKeys"),
				},
			},
			FunctionAssociations: []FunctionAssociation{
				&FunctionAssociation{
					EventType: awscdk.*Aws_cloudfront.FunctionEventType_VIEWER_REQUEST,
					Function: functionRef,
				},
			},
			IsDefaultBehavior: jsii.Boolean(false),
			LambdaFunctionAssociations: []LambdaFunctionAssociation{
				&LambdaFunctionAssociation{
					EventType: awscdk.*Aws_cloudfront.LambdaEdgeEventType_ORIGIN_REQUEST,
					LambdaFunction: version,

					// the properties below are optional
					IncludeBody: jsii.Boolean(false),
				},
			},
			MaxTtl: cdk.Duration_*Minutes(jsii.Number(30)),
			MinTtl: cdk.Duration_*Minutes(jsii.Number(30)),
			PathPattern: jsii.String("pathPattern"),
			TrustedKeyGroups: []IKeyGroupRef{
				keyGroupRef,
			},
			TrustedSigners: []*string{
				jsii.String("trustedSigners"),
			},
			ViewerProtocolPolicy: awscdk.*Aws_cloudfront.ViewerProtocolPolicy_HTTPS_ONLY,
		},
	},

	// the properties below are optional
	ConnectionAttempts: jsii.Number(123),
	ConnectionTimeout: cdk.Duration_*Minutes(jsii.Number(30)),
	CustomOriginSource: &CustomOriginConfig{
		DomainName: jsii.String("domainName"),

		// the properties below are optional
		AllowedOriginSSLVersions: []OriginSslPolicy{
			awscdk.*Aws_cloudfront.OriginSslPolicy_SSL_V3,
		},
		HttpPort: jsii.Number(123),
		HttpsPort: jsii.Number(123),
		OriginHeaders: map[string]*string{
			"originHeadersKey": jsii.String("originHeaders"),
		},
		OriginKeepaliveTimeout: cdk.Duration_*Minutes(jsii.Number(30)),
		OriginPath: jsii.String("originPath"),
		OriginProtocolPolicy: awscdk.*Aws_cloudfront.OriginProtocolPolicy_HTTP_ONLY,
		OriginReadTimeout: cdk.Duration_*Minutes(jsii.Number(30)),
		OriginShieldRegion: jsii.String("originShieldRegion"),
	},
	FailoverCriteriaStatusCodes: []FailoverStatusCode{
		awscdk.*Aws_cloudfront.FailoverStatusCode_FORBIDDEN,
	},
	FailoverCustomOriginSource: &CustomOriginConfig{
		DomainName: jsii.String("domainName"),

		// the properties below are optional
		AllowedOriginSSLVersions: []OriginSslPolicy{
			awscdk.*Aws_cloudfront.OriginSslPolicy_SSL_V3,
		},
		HttpPort: jsii.Number(123),
		HttpsPort: jsii.Number(123),
		OriginHeaders: map[string]*string{
			"originHeadersKey": jsii.String("originHeaders"),
		},
		OriginKeepaliveTimeout: cdk.Duration_*Minutes(jsii.Number(30)),
		OriginPath: jsii.String("originPath"),
		OriginProtocolPolicy: awscdk.*Aws_cloudfront.OriginProtocolPolicy_HTTP_ONLY,
		OriginReadTimeout: cdk.Duration_*Minutes(jsii.Number(30)),
		OriginShieldRegion: jsii.String("originShieldRegion"),
	},
	FailoverS3OriginSource: &S3OriginConfig{
		S3BucketSource: bucket,

		// the properties below are optional
		OriginAccessIdentity: cloudFrontOriginAccessIdentityRef,
		OriginHeaders: map[string]*string{
			"originHeadersKey": jsii.String("originHeaders"),
		},
		OriginPath: jsii.String("originPath"),
		OriginShieldRegion: jsii.String("originShieldRegion"),
	},
	OriginShieldRegion: jsii.String("originShieldRegion"),
	S3OriginSource: &S3OriginConfig{
		S3BucketSource: bucket,

		// the properties below are optional
		OriginAccessIdentity: cloudFrontOriginAccessIdentityRef,
		OriginHeaders: map[string]*string{
			"originHeadersKey": jsii.String("originHeaders"),
		},
		OriginPath: jsii.String("originPath"),
		OriginShieldRegion: jsii.String("originShieldRegion"),
	},
}

Properties ​

behaviorsBehavior[]behaviorstyping.List[Behavior]behaviorsList<Behavior>BehaviorsBehavior[]Behaviors*[]Behaviorrequired#
The behaviors associated with this source.

At least one (default) behavior must be included.

connectionAttemptsoptionalnumberconnection_attemptsoptionalint | floatconnectionAttemptsoptionalNumberConnectionAttemptsoptionaldoubleConnectionAttemptsoptional*float64= 3#
The number of times that CloudFront attempts to connect to the origin.

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

connectionTimeoutoptionalDurationconnection_timeoutoptionalDurationconnectionTimeoutoptionalDurationConnectionTimeoutoptionalDurationConnectionTimeoutoptionalDuration= cdk.Duration.seconds(10)#
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).

customOriginSourceoptionalCustomOriginConfigcustom_origin_sourceoptionalCustomOriginConfigcustomOriginSourceoptionalCustomOriginConfigCustomOriginSourceoptionalCustomOriginConfigCustomOriginSourceoptionalCustomOriginConfig#
A custom origin source - for all non-s3 sources.
failoverCriteriaStatusCodesoptionalFailoverStatusCode[]failover_criteria_status_codesoptionaltyping.List[FailoverStatusCode]failoverCriteriaStatusCodesoptionalList<FailoverStatusCode>FailoverCriteriaStatusCodesoptionalFailoverStatusCode[]FailoverCriteriaStatusCodesoptional*[]FailoverStatusCode#
HTTP status code to failover to second origin.

Default: [500, 502, 503, 504]

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

Default: no failover configuration

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

Default: no failover configuration

originShieldRegionoptionalstringorigin_shield_regionoptionalstroriginShieldRegionoptionalStringOriginShieldRegionoptionalstringOriginShieldRegionoptional*string#
When you enable Origin Shield in the AWS Region that has the lowest latency to your origin, you can get better network performance.

Default: origin shield not enabled

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