Package software.amazon.awscdk.services.cloudfront.origins

Interface VpcOriginProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable, OriginOptions, OriginProps

All Known Subinterfaces:

VpcOriginWithEndpointProps

All Known Implementing Classes:

VpcOriginProps.Jsii$Proxy, VpcOriginWithEndpointProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.139.0 (build 26a6b54)",
           date="2026-09-10T17:51:41.073Z")
@Stability(Stable)
public interface VpcOriginProps
extends software.amazon.jsii.JsiiSerializable, OriginProps

Properties to define a VPC origin.

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.origins.*;
 VpcOriginProps vpcOriginProps = VpcOriginProps.builder()
         .connectionAttempts(123)
         .connectionTimeout(Duration.minutes(30))
         .customHeaders(Map.of(
                 "customHeadersKey", "customHeaders"))
         .domainName("domainName")
         .keepaliveTimeout(Duration.minutes(30))
         .originAccessControlId("originAccessControlId")
         .originId("originId")
         .originPath("originPath")
         .originShieldEnabled(false)
         .originShieldRegion("originShieldRegion")
         .readTimeout(Duration.minutes(30))
         .responseCompletionTimeout(Duration.minutes(30))
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static VpcOriginProps.Builder	builder()
default String	getDomainName()	The domain name associated with your VPC origin.
default Duration	getKeepaliveTimeout()	Specifies how long, in seconds, CloudFront persists its connection 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.jsii.JsiiSerializable

$jsii$toJson

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

getConnectionAttempts, getConnectionTimeout, getCustomHeaders, getOriginAccessControlId, getOriginId, getOriginShieldEnabled, getOriginShieldRegion, getResponseCompletionTimeout

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

getOriginPath

Method Details

getDomainName

@Stability(Stable)
@Nullable
default String getDomainName()

The domain name associated with your VPC origin.

Default: - The default domain name of the endpoint.

getKeepaliveTimeout

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

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

The minimum is 1 second. The maximum is governed by the keep-alive timeout per origin quota, which is adjustable, so the effective maximum depends on the target account.

The default quota allows up to 300 seconds; higher values require an approved limit increase in the target account, and otherwise produce an error at deploy time.

Default: Duration.seconds(5)

getReadTimeout

@Stability(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 minimum is 1 second. The maximum is governed by the origin response timeout quota, which is adjustable, so the effective maximum depends on the target account.

The default quota allows up to 120 seconds; higher values require an approved limit increase in the target account, and otherwise produce an error at deploy time.

Default: Duration.seconds(30)

builder

@Stability(Stable)
static VpcOriginProps.Builder builder()

Returns:

a VpcOriginProps.Builder of VpcOriginProps