interface LoadBalancerV2OriginProps
Language | Type name |
---|---|
.NET | Amazon.CDK.AWS.CloudFront.Origins.LoadBalancerV2OriginProps |
Java | software.amazon.awscdk.services.cloudfront.origins.LoadBalancerV2OriginProps |
Python | aws_cdk.aws_cloudfront_origins.LoadBalancerV2OriginProps |
TypeScript (source) | @aws-cdk/aws-cloudfront-origins » LoadBalancerV2OriginProps |
Properties for an Origin backed by a v2 load balancer.
Example
import * as elbv2 from '@aws-cdk/aws-elasticloadbalancingv2';
declare const loadBalancer: elbv2.ApplicationLoadBalancer;
const origin = new origins.LoadBalancerV2Origin(loadBalancer, {
connectionAttempts: 3,
connectionTimeout: Duration.seconds(5),
readTimeout: Duration.seconds(45),
keepaliveTimeout: Duration.seconds(45),
protocolPolicy: cloudfront.OriginProtocolPolicy.MATCH_VIEWER,
});
Properties
Name | Type | Description |
---|---|---|
connection | number | The number of times that CloudFront attempts to connect to the origin; |
connection | Duration | The number of seconds that CloudFront waits when trying to establish a connection to the origin. |
custom | { [string]: string } | A list of HTTP header names and values that CloudFront adds to requests it sends to the origin. |
http | number | The HTTP port that CloudFront uses to connect to the origin. |
https | number | The HTTPS port that CloudFront uses to connect to the origin. |
keepalive | Duration | Specifies how long, in seconds, CloudFront persists its connection to the origin. |
origin | string | An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin. |
origin | string | When you enable Origin Shield in the AWS Region that has the lowest latency to your origin, you can get better network performance. |
origin | Origin [] | The SSL versions to use when interacting with the origin. |
protocol | Origin | Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. |
read | Duration | Specifies how long, in seconds, CloudFront waits for a response from the origin, also known as the origin response timeout. |
connectionAttempts?
Type:
number
(optional, default: 3)
The number of times that CloudFront attempts to connect to the origin;
valid values are 1, 2, or 3 attempts.
connectionTimeout?
Type:
Duration
(optional, default: Duration.seconds(10))
The number of seconds that CloudFront waits when trying to establish a connection to the origin.
Valid values are 1-10 seconds, inclusive.
customHeaders?
Type:
{ [string]: string }
(optional, default: {})
A list of HTTP header names and values that CloudFront adds to requests it sends to the origin.
httpPort?
Type:
number
(optional, default: 80)
The HTTP port that CloudFront uses to connect to the origin.
httpsPort?
Type:
number
(optional, default: 443)
The HTTPS port that CloudFront uses to connect to the origin.
keepaliveTimeout?
Type:
Duration
(optional, default: Duration.seconds(5))
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.
originPath?
Type:
string
(optional, default: '/')
An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin.
Must begin, but not end, with '/' (e.g., '/production/images').
originShieldRegion?
Type:
string
(optional, default: origin shield not enabled)
When you enable Origin Shield in the AWS Region that has the lowest latency to your origin, you can get better network performance.
See also: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/origin-shield.html
originSslProtocols?
Type:
Origin
[]
(optional, default: OriginSslPolicy.TLS_V1_2)
The SSL versions to use when interacting with the origin.
protocolPolicy?
Type:
Origin
(optional, default: OriginProtocolPolicy.HTTPS_ONLY)
Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin.
readTimeout?
Type:
Duration
(optional, default: Duration.seconds(30))
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.