Skip to content
v2.277.0

FailoverStatusCode Enum ​

HTTP status code to failover to second origin.

Example ​

ts
// Configuring origin fallback options for the CloudFrontWebDistribution
new cloudfront.CloudFrontWebDistribution(this, 'ADistribution', {
  originConfigs: [
    {
      s3OriginSource: {
        s3BucketSource: s3.Bucket.fromBucketName(this, 'aBucket', 'amzn-s3-demo-bucket'),
        originPath: '/',
        originHeaders: {
          'myHeader': '42',
        },
        originShieldRegion: 'us-west-2',
      },
      failoverS3OriginSource: {
        s3BucketSource: s3.Bucket.fromBucketName(this, 'aBucketFallback', 'amzn-s3-demo-bucket1'),
        originPath: '/somewhere',
        originHeaders: {
          'myHeader2': '21',
        },
        originShieldRegion: 'us-east-1',
      },
      failoverCriteriaStatusCodes: [cloudfront.FailoverStatusCode.INTERNAL_SERVER_ERROR],
      behaviors: [
        {
          isDefaultBehavior: true,
        },
      ],
    },
  ],
});
python
# Configuring origin fallback options for the CloudFrontWebDistribution
cloudfront.CloudFrontWebDistribution(self, "ADistribution",
    origin_configs=[cloudfront.SourceConfiguration(
        s3_origin_source=cloudfront.S3OriginConfig(
            s3_bucket_source=s3.Bucket.from_bucket_name(self, "aBucket", "amzn-s3-demo-bucket"),
            origin_path="/",
            origin_headers={
                "myHeader": "42"
            },
            origin_shield_region="us-west-2"
        ),
        failover_s3_origin_source=cloudfront.S3OriginConfig(
            s3_bucket_source=s3.Bucket.from_bucket_name(self, "aBucketFallback", "amzn-s3-demo-bucket1"),
            origin_path="/somewhere",
            origin_headers={
                "myHeader2": "21"
            },
            origin_shield_region="us-east-1"
        ),
        failover_criteria_status_codes=[cloudfront.FailoverStatusCode.INTERNAL_SERVER_ERROR],
        behaviors=[cloudfront.Behavior(
            is_default_behavior=True
        )
        ]
    )
    ]
)
java
// Configuring origin fallback options for the CloudFrontWebDistribution
// Configuring origin fallback options for the CloudFrontWebDistribution
CloudFrontWebDistribution.Builder.create(this, "ADistribution")
        .originConfigs(List.of(SourceConfiguration.builder()
                .s3OriginSource(S3OriginConfig.builder()
                        .s3BucketSource(Bucket.fromBucketName(this, "aBucket", "amzn-s3-demo-bucket"))
                        .originPath("/")
                        .originHeaders(Map.of(
                                "myHeader", "42"))
                        .originShieldRegion("us-west-2")
                        .build())
                .failoverS3OriginSource(S3OriginConfig.builder()
                        .s3BucketSource(Bucket.fromBucketName(this, "aBucketFallback", "amzn-s3-demo-bucket1"))
                        .originPath("/somewhere")
                        .originHeaders(Map.of(
                                "myHeader2", "21"))
                        .originShieldRegion("us-east-1")
                        .build())
                .failoverCriteriaStatusCodes(List.of(FailoverStatusCode.INTERNAL_SERVER_ERROR))
                .behaviors(List.of(Behavior.builder()
                        .isDefaultBehavior(true)
                        .build()))
                .build()))
        .build();
csharp
// Install: dotnet add package Amazon.CDK.Lib
// Configuring origin fallback options for the CloudFrontWebDistribution
// Configuring origin fallback options for the CloudFrontWebDistribution
new CloudFrontWebDistribution(this, "ADistribution", new CloudFrontWebDistributionProps {
    OriginConfigs = new [] { new SourceConfiguration {
        S3OriginSource = new S3OriginConfig {
            S3BucketSource = Bucket.FromBucketName(this, "aBucket", "amzn-s3-demo-bucket"),
            OriginPath = "/",
            OriginHeaders = new Dictionary<string, string> {
                { "myHeader", "42" }
            },
            OriginShieldRegion = "us-west-2"
        },
        FailoverS3OriginSource = new S3OriginConfig {
            S3BucketSource = Bucket.FromBucketName(this, "aBucketFallback", "amzn-s3-demo-bucket1"),
            OriginPath = "/somewhere",
            OriginHeaders = new Dictionary<string, string> {
                { "myHeader2", "21" }
            },
            OriginShieldRegion = "us-east-1"
        },
        FailoverCriteriaStatusCodes = new [] { FailoverStatusCode.INTERNAL_SERVER_ERROR },
        Behaviors = new [] { new Behavior {
            IsDefaultBehavior = true
        } }
    } }
});
go
// Install: go get github.com/aws/aws-cdk-go/awscdk/v2
// Configuring origin fallback options for the CloudFrontWebDistribution
// Configuring origin fallback options for the CloudFrontWebDistribution
cloudfront.NewCloudFrontWebDistribution(this, jsii.String("ADistribution"), &CloudFrontWebDistributionProps{
	OriginConfigs: []SourceConfiguration{
		&SourceConfiguration{
			S3OriginSource: &S3OriginConfig{
				S3BucketSource: s3.Bucket_FromBucketName(this, jsii.String("aBucket"), jsii.String("amzn-s3-demo-bucket")),
				OriginPath: jsii.String("/"),
				OriginHeaders: map[string]*string{
					"myHeader": jsii.String("42"),
				},
				OriginShieldRegion: jsii.String("us-west-2"),
			},
			FailoverS3OriginSource: &S3OriginConfig{
				S3BucketSource: s3.Bucket_*FromBucketName(this, jsii.String("aBucketFallback"), jsii.String("amzn-s3-demo-bucket1")),
				OriginPath: jsii.String("/somewhere"),
				OriginHeaders: map[string]*string{
					"myHeader2": jsii.String("21"),
				},
				OriginShieldRegion: jsii.String("us-east-1"),
			},
			FailoverCriteriaStatusCodes: []FailoverStatusCode{
				cloudfront.FailoverStatusCode_INTERNAL_SERVER_ERROR,
			},
			Behaviors: []Behavior{
				&Behavior{
					IsDefaultBehavior: jsii.Boolean(true),
				},
			},
		},
	},
})

Members ​

MemberDescription
FORBIDDENForbidden (403).
NOT_FOUNDNot found (404).
INTERNAL_SERVER_ERRORInternal Server Error (500).
BAD_GATEWAYBad Gateway (502).
SERVICE_UNAVAILABLEService Unavailable (503).
GATEWAY_TIMEOUTGateway Timeout (504).

Referenced by ​

  • SourceConfiguration.failoverCriteriaStatusCodesfailover_criteria_status_codesfailoverCriteriaStatusCodesFailoverCriteriaStatusCodesFailoverCriteriaStatusCodes