software.amazon.awscdk.services.cloudfront.origins

Interface HttpOriginProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable, OriginOptions, OriginProps

All Known Subinterfaces:

LoadBalancerV2OriginProps

All Known Implementing Classes:

HttpOriginProps.Jsii$Proxy, LoadBalancerV2OriginProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.67.0 (build 2c027f5)",
           date="2022-09-19T20:26:37.174Z")
 @Stability(value=Stable)
public interface HttpOriginProps
extends software.amazon.jsii.JsiiSerializable, OriginProps

Properties for an Origin backed by an S3 website-configured bucket, load balancer, or custom HTTP server.

Example:

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.*;
 import software.amazon.awscdk.services.cloudfront.*;
 import software.amazon.awscdk.services.cloudfront.origins.*;
 HttpOriginProps httpOriginProps = HttpOriginProps.builder()
         .connectionAttempts(123)
         .connectionTimeout(Duration.minutes(30))
         .customHeaders(Map.of(
                 "customHeadersKey", "customHeaders"))
         .httpPort(123)
         .httpsPort(123)
         .keepaliveTimeout(Duration.minutes(30))
         .originPath("originPath")
         .originShieldRegion("originShieldRegion")
         .originSslProtocols(List.of(OriginSslPolicy.SSL_V3))
         .protocolPolicy(OriginProtocolPolicy.HTTP_ONLY)
         .readTimeout(Duration.minutes(30))
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method and Description
static HttpOriginProps.Builder	builder()
default Number	getHttpPort() The HTTP port that CloudFront uses to connect to the origin.
default Number	getHttpsPort() The HTTPS port that CloudFront uses to connect to the origin.
default Duration	getKeepaliveTimeout() Specifies how long, in seconds, CloudFront persists its connection to the origin.
default List<OriginSslPolicy>	getOriginSslProtocols() The SSL versions to use when interacting with the origin.
default OriginProtocolPolicy	getProtocolPolicy() Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin.
default Duration	getReadTimeout() Specifies how long, in seconds, CloudFront waits for a response from the origin, also known as the origin response timeout.

Methods inherited from interface software.amazon.awscdk.services.cloudfront.OriginProps

getOriginPath

Methods inherited from interface software.amazon.awscdk.services.cloudfront.OriginOptions

getConnectionAttempts, getConnectionTimeout, getCustomHeaders, getOriginShieldRegion

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Detail

getHttpPort

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

The HTTP port that CloudFront uses to connect to the origin.

Default: 80

getHttpsPort

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

The HTTPS port that CloudFront uses to connect to the origin.

Default: 443

getKeepaliveTimeout

@Stability(value=Stable)
 @Nullable
default Duration getKeepaliveTimeout()

Specifies how long, in seconds, CloudFront persists its connection to the origin.

The valid range is from 1 to 180 seconds, inclusive.

Note that values over 60 seconds are possible only after a limit increase request for the origin response timeout quota has been approved in the target account; otherwise, values over 60 seconds will produce an error at deploy time.

Default: Duration.seconds(5)

getOriginSslProtocols

@Stability(value=Stable)
 @Nullable
default List<OriginSslPolicy> getOriginSslProtocols()

The SSL versions to use when interacting with the origin.

Default: OriginSslPolicy.TLS_V1_2

getProtocolPolicy

@Stability(value=Stable)
 @Nullable
default OriginProtocolPolicy getProtocolPolicy()

Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin.

Default: OriginProtocolPolicy.HTTPS_ONLY

getReadTimeout

@Stability(value=Stable)
 @Nullable
default Duration getReadTimeout()

Specifies how long, in seconds, CloudFront waits for a response from the origin, also known as the origin response timeout.

The valid range is from 1 to 180 seconds, inclusive.

Note that values over 60 seconds are possible only after a limit increase request for the origin response timeout quota has been approved in the target account; otherwise, values over 60 seconds will produce an error at deploy time.

Default: Duration.seconds(30)

builder

@Stability(value=Stable)
static HttpOriginProps.Builder builder()

Specified by:

builder in interface OriginOptions

Specified by:

builder in interface OriginProps

Returns:

a HttpOriginProps.Builder of HttpOriginProps