Skip to content

CloudFront  >  Structures  >  OriginGroup

OriginGroup

Structure Class

OriginGroup dataclass

Bases: _SerdeShape

An origin group includes two origins (a primary origin and a secondary origin to failover to) and a failover criteria that you specify. You create an origin group to support origin failover in CloudFront. When you create or update a distribution, you can specify the origin group instead of a single origin, and CloudFront will failover from the primary origin to the secondary origin under the failover conditions that you've chosen.

Optionally, you can choose selection criteria for your origin group to specify how your origins are selected when your distribution routes viewer requests.

Attributes

failover_criteria instance-attribute
failover_criteria: OriginGroupFailoverCriteria

A complex type that contains information about the failover criteria for an origin group.

id instance-attribute
id: str

The origin group's ID.

members instance-attribute

A complex type that contains information about the origins in an origin group.

selection_criteria class-attribute instance-attribute
selection_criteria: str | None = ...

The selection criteria for the origin group. For more information, see Create an origin group in the Amazon CloudFront Developer Guide.