software.amazon.awscdk.services.cloudfront

Interface CfnDistribution.OriginProperty

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

CfnDistribution.OriginProperty.Jsii$Proxy

Enclosing class:

CfnDistribution

@Stability(value=Stable)
public static interface CfnDistribution.OriginProperty
extends software.amazon.jsii.JsiiSerializable

An origin.

An origin is the location where content is stored, and from which CloudFront gets content to serve to viewers. To specify an origin:

• Use S3OriginConfig to specify an Amazon S3 bucket that is not configured with static website hosting.
• Use CustomOriginConfig to specify all other kinds of origins, including:
• An Amazon S3 bucket that is configured with static website hosting
• An Elastic Load Balancing load balancer
• An AWS Elemental MediaPackage endpoint
• An AWS Elemental MediaStore container
• Any other HTTP server, running on an Amazon EC2 instance or any other kind of host

For the current maximum number of origins that you can specify per distribution, see General Quotas on Web Distributions in the Amazon CloudFront Developer Guide (quotas were formerly referred to as limits).

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.cloudfront.*;
 OriginProperty originProperty = OriginProperty.builder()
         .domainName("domainName")
         .id("id")
         // the properties below are optional
         .connectionAttempts(123)
         .connectionTimeout(123)
         .customOriginConfig(CustomOriginConfigProperty.builder()
                 .originProtocolPolicy("originProtocolPolicy")
                 // the properties below are optional
                 .httpPort(123)
                 .httpsPort(123)
                 .originKeepaliveTimeout(123)
                 .originReadTimeout(123)
                 .originSslProtocols(List.of("originSslProtocols"))
                 .build())
         .originAccessControlId("originAccessControlId")
         .originCustomHeaders(List.of(OriginCustomHeaderProperty.builder()
                 .headerName("headerName")
                 .headerValue("headerValue")
                 .build()))
         .originPath("originPath")
         .originShield(OriginShieldProperty.builder()
                 .enabled(false)
                 .originShieldRegion("originShieldRegion")
                 .build())
         .s3OriginConfig(S3OriginConfigProperty.builder()
                 .originAccessIdentity("originAccessIdentity")
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	CfnDistribution.OriginProperty.Builder A builder for CfnDistribution.OriginProperty
static class	CfnDistribution.OriginProperty.Jsii$Proxy An implementation for CfnDistribution.OriginProperty

Method Summary

Modifier and Type	Method and Description
static CfnDistribution.OriginProperty.Builder	builder()
default Number	getConnectionAttempts() The number of times that CloudFront attempts to connect to the origin.
default Number	getConnectionTimeout() The number of seconds that CloudFront waits when trying to establish a connection to the origin.
default Object	getCustomOriginConfig() Use this type to specify an origin that is not an Amazon S3 bucket, with one exception.
String	getDomainName() The domain name for the origin.
String	getId() A unique identifier for the origin.
default String	getOriginAccessControlId() `CfnDistribution.OriginProperty.OriginAccessControlId`.
default Object	getOriginCustomHeaders() A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin.
default String	getOriginPath() An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin.
default Object	getOriginShield() CloudFront Origin Shield.
default Object	getS3OriginConfig() Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getDomainName

@Stability(value=Stable)
 @NotNull
String getDomainName()

The domain name for the origin.

For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide .

getId

@Stability(value=Stable)
 @NotNull
String getId()

A unique identifier for the origin. This value must be unique within the distribution.

Use this value to specify the TargetOriginId in a CacheBehavior or DefaultCacheBehavior .

getConnectionAttempts

@Stability(value=Stable)
 @Nullable
default Number getConnectionAttempts()

The number of times that CloudFront attempts to connect to the origin.

The minimum number is 1, the maximum is 3, and the default (if you don’t specify otherwise) is 3.

For a custom origin (including an Amazon S3 bucket that’s configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout .

For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide .

getConnectionTimeout

@Stability(value=Stable)
 @Nullable
default Number getConnectionTimeout()

The number of seconds that CloudFront waits when trying to establish a connection to the origin.

The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don’t specify otherwise) is 10 seconds.

For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide .

getCustomOriginConfig

@Stability(value=Stable)
 @Nullable
default Object getCustomOriginConfig()

Use this type to specify an origin that is not an Amazon S3 bucket, with one exception.

If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the S3OriginConfig type instead.

getOriginAccessControlId

@Stability(value=Stable)
 @Nullable
default String getOriginAccessControlId()

`CfnDistribution.OriginProperty.OriginAccessControlId`.

getOriginCustomHeaders

@Stability(value=Stable)
 @Nullable
default Object getOriginCustomHeaders()

A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin.

For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide .

getOriginPath

@Stability(value=Stable)
 @Nullable
default String getOriginPath()

An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin.

For more information, see Origin Path in the Amazon CloudFront Developer Guide .

getOriginShield

@Stability(value=Stable)
 @Nullable
default Object getOriginShield()

CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin.

For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide .

getS3OriginConfig

@Stability(value=Stable)
 @Nullable
default Object getS3OriginConfig()

Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting.

To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the CustomOriginConfig type instead.

builder

@Stability(value=Stable)
static CfnDistribution.OriginProperty.Builder builder()

Returns:

a CfnDistribution.OriginProperty.Builder of CfnDistribution.OriginProperty