software.amazon.awscdk.services.cloudfront

Class Distribution.Builder

java.lang.Object

software.amazon.awscdk.services.cloudfront.Distribution.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<Distribution>

Enclosing class:

Distribution

@Stability(value=Experimental)
public static final class Distribution.Builder
extends Object
implements software.amazon.jsii.Builder<Distribution>

(experimental) A fluent builder for Distribution.

Method Summary

Modifier and Type	Method and Description
Distribution.Builder	additionalBehaviors(Map<String,? extends BehaviorOptions> additionalBehaviors) (experimental) Additional behaviors for the distribution, mapped by the pathPattern that specifies which requests to apply the behavior to.
Distribution	build()
Distribution.Builder	certificate(ICertificate certificate) (experimental) A certificate to associate with the distribution.
Distribution.Builder	comment(String comment) (experimental) Any comments you want to include about the distribution.
static Distribution.Builder	create(software.constructs.Construct scope, String id)
Distribution.Builder	defaultBehavior(BehaviorOptions defaultBehavior) (experimental) The default behavior for the distribution.
Distribution.Builder	defaultRootObject(String defaultRootObject) (experimental) The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution.
Distribution.Builder	domainNames(List<String> domainNames) (experimental) Alternative domain names for this distribution.
Distribution.Builder	enabled(Boolean enabled) (experimental) Enable or disable the distribution.
Distribution.Builder	enableIpv6(Boolean enableIpv6) (experimental) Whether CloudFront will respond to IPv6 DNS requests with an IPv6 address.
Distribution.Builder	enableLogging(Boolean enableLogging) (experimental) Enable access logging for the distribution.
Distribution.Builder	errorResponses(List<? extends ErrorResponse> errorResponses) (experimental) How CloudFront should handle requests that are not successful (e.g., PageNotFound).
Distribution.Builder	geoRestriction(GeoRestriction geoRestriction) (experimental) Controls the countries in which your content is distributed.
Distribution.Builder	httpVersion(HttpVersion httpVersion) (experimental) Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront.
Distribution.Builder	logBucket(IBucket logBucket) (experimental) The Amazon S3 bucket to store the access logs in.
Distribution.Builder	logFilePrefix(String logFilePrefix) (experimental) An optional string that you want CloudFront to prefix to the access log filenames for this distribution.
Distribution.Builder	logIncludesCookies(Boolean logIncludesCookies) (experimental) Specifies whether you want CloudFront to include cookies in access logs.
Distribution.Builder	minimumProtocolVersion(SecurityPolicyProtocol minimumProtocolVersion) (experimental) The minimum version of the SSL protocol that you want CloudFront to use for HTTPS connections.
Distribution.Builder	priceClass(PriceClass priceClass) (experimental) The price class that corresponds with the maximum price that you want to pay for CloudFront service.
Distribution.Builder	webAclId(String webAclId) (experimental) Unique identifier that specifies the AWS WAF web ACL to associate with this CloudFront distribution.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

create

@Stability(value=Experimental)
public static Distribution.Builder create(software.constructs.Construct scope,
                                                                         String id)

Parameters:

scope - This parameter is required.

id - This parameter is required.

Returns:

a new instance of Distribution.Builder.

defaultBehavior

@Stability(value=Experimental)
public Distribution.Builder defaultBehavior(BehaviorOptions defaultBehavior)

(experimental) The default behavior for the distribution.

Parameters:

defaultBehavior - The default behavior for the distribution. This parameter is required.

Returns:

this

additionalBehaviors

@Stability(value=Experimental)
public Distribution.Builder additionalBehaviors(Map<String,? extends BehaviorOptions> additionalBehaviors)

(experimental) Additional behaviors for the distribution, mapped by the pathPattern that specifies which requests to apply the behavior to.

Default: - no additional behaviors are added.

Parameters:

additionalBehaviors - Additional behaviors for the distribution, mapped by the pathPattern that specifies which requests to apply the behavior to. This parameter is required.

Returns:

this

certificate

@Stability(value=Experimental)
public Distribution.Builder certificate(ICertificate certificate)

(experimental) A certificate to associate with the distribution.

The certificate must be located in N. Virginia (us-east-1).

Default: - the CloudFront wildcard certificate (*.cloudfront.net) will be used.

Parameters:

certificate - A certificate to associate with the distribution. This parameter is required.

Returns:

this

comment

@Stability(value=Experimental)
public Distribution.Builder comment(String comment)

(experimental) Any comments you want to include about the distribution.

Default: - no comment

Parameters:

comment - Any comments you want to include about the distribution. This parameter is required.

Returns:

this

defaultRootObject

@Stability(value=Experimental)
public Distribution.Builder defaultRootObject(String defaultRootObject)

(experimental) The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution. If no default object is set, the request goes to the origin's root (e.g., example.com/).

Default: - no default root object

Parameters:

defaultRootObject - The object that you want CloudFront to request from your origin (for example, index.html) when a viewer requests the root URL for your distribution. If no default object is set, the request goes to the origin's root (e.g., example.com/). This parameter is required.

Returns:

this

domainNames

@Stability(value=Experimental)
public Distribution.Builder domainNames(List<String> domainNames)

(experimental) Alternative domain names for this distribution.

If you want to use your own domain name, such as www.example.com, instead of the cloudfront.net domain name, you can add an alternate domain name to your distribution. If you attach a certificate to the distribution, you must add (at least one of) the domain names of the certificate to this list.

Default: - The distribution will only support the default generated name (e.g., d111111abcdef8.cloudfront.net)

Parameters:

domainNames - Alternative domain names for this distribution. This parameter is required.

Returns:

this

enabled

@Stability(value=Experimental)
public Distribution.Builder enabled(Boolean enabled)

(experimental) Enable or disable the distribution.

Default: true

Parameters:

enabled - Enable or disable the distribution. This parameter is required.

Returns:

this

enableIpv6

@Stability(value=Experimental)
public Distribution.Builder enableIpv6(Boolean enableIpv6)

(experimental) Whether CloudFront will respond to IPv6 DNS requests with an IPv6 address.

If you specify false, CloudFront responds to IPv6 DNS requests with the DNS response code NOERROR and with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution.

Default: true

Parameters:

enableIpv6 - Whether CloudFront will respond to IPv6 DNS requests with an IPv6 address. This parameter is required.

Returns:

this

enableLogging

@Stability(value=Experimental)
public Distribution.Builder enableLogging(Boolean enableLogging)

(experimental) Enable access logging for the distribution.

Default: - false, unless `logBucket` is specified.

Parameters:

enableLogging - Enable access logging for the distribution. This parameter is required.

Returns:

this

errorResponses

@Stability(value=Experimental)
public Distribution.Builder errorResponses(List<? extends ErrorResponse> errorResponses)

(experimental) How CloudFront should handle requests that are not successful (e.g., PageNotFound).

Default: - No custom error responses.

Parameters:

errorResponses - How CloudFront should handle requests that are not successful (e.g., PageNotFound). This parameter is required.

Returns:

this

geoRestriction

@Stability(value=Experimental)
public Distribution.Builder geoRestriction(GeoRestriction geoRestriction)

(experimental) Controls the countries in which your content is distributed.

Default: - No geographic restrictions

Parameters:

geoRestriction - Controls the countries in which your content is distributed. This parameter is required.

Returns:

this

httpVersion

@Stability(value=Experimental)
public Distribution.Builder httpVersion(HttpVersion httpVersion)

(experimental) Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront.

For viewers and CloudFront to use HTTP/2, viewers must support TLS 1.2 or later, and must support server name identification (SNI).

Default: HttpVersion.HTTP2

Parameters:

httpVersion - Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. This parameter is required.

Returns:

this

logBucket

@Stability(value=Experimental)
public Distribution.Builder logBucket(IBucket logBucket)

(experimental) The Amazon S3 bucket to store the access logs in.

Default: - A bucket is created if `enableLogging` is true

Parameters:

logBucket - The Amazon S3 bucket to store the access logs in. This parameter is required.

Returns:

this

logFilePrefix

@Stability(value=Experimental)
public Distribution.Builder logFilePrefix(String logFilePrefix)

(experimental) An optional string that you want CloudFront to prefix to the access log filenames for this distribution.

Default: - no prefix

Parameters:

logFilePrefix - An optional string that you want CloudFront to prefix to the access log filenames for this distribution. This parameter is required.

Returns:

this

logIncludesCookies

@Stability(value=Experimental)
public Distribution.Builder logIncludesCookies(Boolean logIncludesCookies)

(experimental) Specifies whether you want CloudFront to include cookies in access logs.

Default: false

Parameters:

logIncludesCookies - Specifies whether you want CloudFront to include cookies in access logs. This parameter is required.

Returns:

this

minimumProtocolVersion

@Stability(value=Experimental)
public Distribution.Builder minimumProtocolVersion(SecurityPolicyProtocol minimumProtocolVersion)

(experimental) The minimum version of the SSL protocol that you want CloudFront to use for HTTPS connections.

CloudFront serves your objects only to browsers or devices that support at least the SSL version that you specify.

Default: SecurityPolicyProtocol.TLS_V1_2_2019

Parameters:

minimumProtocolVersion - The minimum version of the SSL protocol that you want CloudFront to use for HTTPS connections. This parameter is required.

Returns:

this

priceClass

@Stability(value=Experimental)
public Distribution.Builder priceClass(PriceClass priceClass)

(experimental) The price class that corresponds with the maximum price that you want to pay for CloudFront service.

If you specify PriceClass_All, CloudFront responds to requests for your objects from all CloudFront edge locations. If you specify a price class other than PriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class.

Default: PriceClass.PRICE_CLASS_ALL

Parameters:

priceClass - The price class that corresponds with the maximum price that you want to pay for CloudFront service. This parameter is required.

Returns:

this

webAclId

@Stability(value=Experimental)
public Distribution.Builder webAclId(String webAclId)

(experimental) Unique identifier that specifies the AWS WAF web ACL to associate with this CloudFront distribution.

To specify a web ACL created using the latest version of AWS WAF, use the ACL ARN, for example arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/473e64fd-f30b-4765-81a0-62ad96dd167a. To specify a web ACL created using AWS WAF Classic, use the ACL ID, for example 473e64fd-f30b-4765-81a0-62ad96dd167a.

Default: - No AWS Web Application Firewall web access control list (web ACL).

Parameters:

webAclId - Unique identifier that specifies the AWS WAF web ACL to associate with this CloudFront distribution. This parameter is required.

Returns:

this

See Also:

https://docs.aws.amazon.com/cloudfront/latest/APIReference/API_CreateDistribution.html#API_CreateDistribution_RequestParameters.

build

@Stability(value=Experimental)
public Distribution build()

Specified by:

build in interface software.amazon.jsii.Builder<Distribution>