AWS CloudFormation
User Guide (Version )

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.

AWS::CloudFront::Distribution CustomOriginConfig

A custom origin or an Amazon S3 bucket configured as a website endpoint.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

{ "HTTPPort" : Integer, "HTTPSPort" : Integer, "OriginKeepaliveTimeout" : Integer, "OriginProtocolPolicy" : String, "OriginReadTimeout" : Integer, "OriginSSLProtocols" : [ String, ... ] }

YAML

HTTPPort: Integer HTTPSPort: Integer OriginKeepaliveTimeout: Integer OriginProtocolPolicy: String OriginReadTimeout: Integer OriginSSLProtocols: - String

Properties

HTTPPort

The HTTP port the custom origin listens on.

Required: No

Type: Integer

Update requires: No interruption

HTTPSPort

The HTTPS port the custom origin listens on.

Required: No

Type: Integer

Update requires: No interruption

OriginKeepaliveTimeout

You can create a custom keep-alive timeout. All timeout units are in seconds. The default keep-alive timeout is 5 seconds, but you can configure custom timeout lengths using the CloudFront API. The minimum timeout length is 1 second; the maximum is 60 seconds.

If you need to increase the maximum time limit, contact the AWS Support Center.

Required: No

Type: Integer

Update requires: No interruption

OriginProtocolPolicy

The origin protocol policy to apply to your origin.

Required: Yes

Type: String

Allowed Values: http-only | https-only | match-viewer

Update requires: No interruption

OriginReadTimeout

You can create a custom origin read timeout. All timeout units are in seconds. The default origin read timeout is 30 seconds, but you can configure custom timeout lengths using the CloudFront API. The minimum timeout length is 4 seconds; the maximum is 60 seconds.

If you need to increase the maximum time limit, contact the AWS Support Center.

Required: No

Type: Integer

Update requires: No interruption

OriginSSLProtocols

The SSL/TLS protocols that you want CloudFront to use when communicating with your origin over HTTPS.

Required: No

Type: List of String

Update requires: No interruption

See Also

On this page: