OriginGroupProps

class aws_cdk.aws_cloudfront_origins.OriginGroupProps(*, fallback_origin, primary_origin, fallback_status_codes=None)

Bases: object

Construction properties for OriginGroup.

Parameters:

fallback_origin (IOrigin) – The fallback origin that should serve requests when the primary fails.
primary_origin (IOrigin) – The primary origin that should serve requests for this group.
fallback_status_codes (Optional[Sequence[Union[int, float]]]) – The list of HTTP status codes that, when returned from the primary origin, would cause querying the fallback origin. Default: - 500, 502, 503 and 504

ExampleMetadata:

infused

Example:

my_bucket = s3.Bucket(self, "myBucket")
cloudfront.Distribution(self, "myDist",
    default_behavior=cloudfront.BehaviorOptions(
        origin=origins.OriginGroup(
            primary_origin=origins.S3BucketOrigin.with_origin_access_control(my_bucket),
            fallback_origin=origins.HttpOrigin("www.example.com"),
            # optional, defaults to: 500, 502, 503 and 504
            fallback_status_codes=[404]
        )
    )
)

Attributes

fallback_origin: The fallback origin that should serve requests when the primary fails.

fallback_status_codes

The list of HTTP status codes that, when returned from the primary origin, would cause querying the fallback origin.

Default:

500, 502, 503 and 504

primary_origin: The primary origin that should serve requests for this group.