Amazon CloudFront
API Reference (API Version 2019-03-26)

The AWS Documentation website is getting a new look!
Try it now and let us know what you think. Switch to the new look >>

You can return to the original look by selecting English in the language selector above.


An origin group includes two origins (a primary origin and a second 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 specifiy the origin group instead of a single origin, and CloudFront will failover from the primary origin to the second origin under the failover conditions that you've chosen.



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

Type: OriginGroupFailoverCriteria object

Required: Yes


The origin group's ID.

Type: String

Required: Yes


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

Type: OriginGroupMembers object

Required: Yes

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: