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

Interface FunctionUrlOriginProps

All Superinterfaces:

software.amazon.jsii.JsiiSerializable, OriginOptions, OriginProps

All Known Subinterfaces:

FunctionUrlOriginWithOACProps

All Known Implementing Classes:

FunctionUrlOriginProps.Jsii$Proxy, FunctionUrlOriginWithOACProps.Jsii$Proxy

@Generated(value="jsii-pacmak/1.139.0 (build 26a6b54)",
           date="2026-09-02T11:03:05.661Z")
@Stability(Stable)
public interface FunctionUrlOriginProps
extends software.amazon.jsii.JsiiSerializable, OriginProps

Properties for a Lambda Function URL Origin.

Example:

 import software.amazon.awscdk.services.lambda.*;
 Function fn;
 FunctionUrl fnUrl = fn.addFunctionUrl(FunctionUrlOptions.builder().authType(FunctionUrlAuthType.NONE).build());
 Distribution.Builder.create(this, "Distribution")
         .defaultBehavior(BehaviorOptions.builder()
                 .origin(FunctionUrlOrigin.Builder.create(fnUrl)
                         .readTimeout(Duration.seconds(30))
                         .responseCompletionTimeout(Duration.seconds(90))
                         .keepaliveTimeout(Duration.seconds(45))
                         .build())
                 .build())
         .build();
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static FunctionUrlOriginProps.Builder	builder()
default OriginIpAddressType	getIpAddressType()	Specifies which IP protocol CloudFront uses when connecting to your 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.

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

getIpAddressType

@Stability(Stable)
@Nullable
default OriginIpAddressType getIpAddressType()

Specifies which IP protocol CloudFront uses when connecting to your origin.

If your origin uses both IPv4 and IPv6 protocols, you can choose dualstack to help optimize reliability.

Default: OriginIpAddressType.IPV4

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.

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 FunctionUrlOriginProps.Builder builder()

Returns:

a FunctionUrlOriginProps.Builder of FunctionUrlOriginProps