Package software.amazon.awscdk.services.cloudfront

Interface CfnDistributionProps

All Superinterfaces:
software.amazon.jsii.JsiiSerializable
All Known Implementing Classes:
CfnDistributionProps.Jsii$Proxy
@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)", date="2025-11-20T23:37:16.292Z") @Stability(Stable) public interface CfnDistributionProps extends software.amazon.jsii.JsiiSerializable
Properties for defining a CfnDistribution.

Example: 

 // The code below shows an example of how to instantiate this type.
 // The values are placeholders you should change.
 import software.amazon.awscdk.services.cloudfront.*;
 CfnDistributionProps cfnDistributionProps = CfnDistributionProps.builder()
         .distributionConfig(DistributionConfigProperty.builder()
                 .defaultCacheBehavior(DefaultCacheBehaviorProperty.builder()
                         .targetOriginId("targetOriginId")
                         .viewerProtocolPolicy("viewerProtocolPolicy")
                         // the properties below are optional
                         .allowedMethods(List.of("allowedMethods"))
                         .cachedMethods(List.of("cachedMethods"))
                         .cachePolicyId("cachePolicyId")
                         .compress(false)
                         .defaultTtl(123)
                         .fieldLevelEncryptionId("fieldLevelEncryptionId")
                         .forwardedValues(ForwardedValuesProperty.builder()
                                 .queryString(false)
                                 // the properties below are optional
                                 .cookies(CookiesProperty.builder()
                                         .forward("forward")
                                         // the properties below are optional
                                         .whitelistedNames(List.of("whitelistedNames"))
                                         .build())
                                 .headers(List.of("headers"))
                                 .queryStringCacheKeys(List.of("queryStringCacheKeys"))
                                 .build())
                         .functionAssociations(List.of(FunctionAssociationProperty.builder()
                                 .eventType("eventType")
                                 .functionArn("functionArn")
                                 .build()))
                         .grpcConfig(GrpcConfigProperty.builder()
                                 .enabled(false)
                                 .build())
                         .lambdaFunctionAssociations(List.of(LambdaFunctionAssociationProperty.builder()
                                 .eventType("eventType")
                                 .includeBody(false)
                                 .lambdaFunctionArn("lambdaFunctionArn")
                                 .build()))
                         .maxTtl(123)
                         .minTtl(123)
                         .originRequestPolicyId("originRequestPolicyId")
                         .realtimeLogConfigArn("realtimeLogConfigArn")
                         .responseHeadersPolicyId("responseHeadersPolicyId")
                         .smoothStreaming(false)
                         .trustedKeyGroups(List.of("trustedKeyGroups"))
                         .trustedSigners(List.of("trustedSigners"))
                         .build())
                 .enabled(false)
                 // the properties below are optional
                 .aliases(List.of("aliases"))
                 .anycastIpListId("anycastIpListId")
                 .cacheBehaviors(List.of(CacheBehaviorProperty.builder()
                         .pathPattern("pathPattern")
                         .targetOriginId("targetOriginId")
                         .viewerProtocolPolicy("viewerProtocolPolicy")
                         // the properties below are optional
                         .allowedMethods(List.of("allowedMethods"))
                         .cachedMethods(List.of("cachedMethods"))
                         .cachePolicyId("cachePolicyId")
                         .compress(false)
                         .defaultTtl(123)
                         .fieldLevelEncryptionId("fieldLevelEncryptionId")
                         .forwardedValues(ForwardedValuesProperty.builder()
                                 .queryString(false)
                                 // the properties below are optional
                                 .cookies(CookiesProperty.builder()
                                         .forward("forward")
                                         // the properties below are optional
                                         .whitelistedNames(List.of("whitelistedNames"))
                                         .build())
                                 .headers(List.of("headers"))
                                 .queryStringCacheKeys(List.of("queryStringCacheKeys"))
                                 .build())
                         .functionAssociations(List.of(FunctionAssociationProperty.builder()
                                 .eventType("eventType")
                                 .functionArn("functionArn")
                                 .build()))
                         .grpcConfig(GrpcConfigProperty.builder()
                                 .enabled(false)
                                 .build())
                         .lambdaFunctionAssociations(List.of(LambdaFunctionAssociationProperty.builder()
                                 .eventType("eventType")
                                 .includeBody(false)
                                 .lambdaFunctionArn("lambdaFunctionArn")
                                 .build()))
                         .maxTtl(123)
                         .minTtl(123)
                         .originRequestPolicyId("originRequestPolicyId")
                         .realtimeLogConfigArn("realtimeLogConfigArn")
                         .responseHeadersPolicyId("responseHeadersPolicyId")
                         .smoothStreaming(false)
                         .trustedKeyGroups(List.of("trustedKeyGroups"))
                         .trustedSigners(List.of("trustedSigners"))
                         .build()))
                 .cnamEs(List.of("cnamEs"))
                 .comment("comment")
                 .connectionMode("connectionMode")
                 .continuousDeploymentPolicyId("continuousDeploymentPolicyId")
                 .customErrorResponses(List.of(CustomErrorResponseProperty.builder()
                         .errorCode(123)
                         // the properties below are optional
                         .errorCachingMinTtl(123)
                         .responseCode(123)
                         .responsePagePath("responsePagePath")
                         .build()))
                 .customOrigin(LegacyCustomOriginProperty.builder()
                         .dnsName("dnsName")
                         .originProtocolPolicy("originProtocolPolicy")
                         .originSslProtocols(List.of("originSslProtocols"))
                         // the properties below are optional
                         .httpPort(123)
                         .httpsPort(123)
                         .build())
                 .defaultRootObject("defaultRootObject")
                 .httpVersion("httpVersion")
                 .ipv6Enabled(false)
                 .logging(LoggingProperty.builder()
                         .bucket("bucket")
                         .includeCookies(false)
                         .prefix("prefix")
                         .build())
                 .originGroups(OriginGroupsProperty.builder()
                         .quantity(123)
                         // the properties below are optional
                         .items(List.of(OriginGroupProperty.builder()
                                 .failoverCriteria(OriginGroupFailoverCriteriaProperty.builder()
                                         .statusCodes(StatusCodesProperty.builder()
                                                 .items(List.of(123))
                                                 .quantity(123)
                                                 .build())
                                         .build())
                                 .id("id")
                                 .members(OriginGroupMembersProperty.builder()
                                         .items(List.of(OriginGroupMemberProperty.builder()
                                                 .originId("originId")
                                                 .build()))
                                         .quantity(123)
                                         .build())
                                 // the properties below are optional
                                 .selectionCriteria("selectionCriteria")
                                 .build()))
                         .build())
                 .origins(List.of(OriginProperty.builder()
                         .domainName("domainName")
                         .id("id")
                         // the properties below are optional
                         .connectionAttempts(123)
                         .connectionTimeout(123)
                         .customOriginConfig(CustomOriginConfigProperty.builder()
                                 .originProtocolPolicy("originProtocolPolicy")
                                 // the properties below are optional
                                 .httpPort(123)
                                 .httpsPort(123)
                                 .ipAddressType("ipAddressType")
                                 .originKeepaliveTimeout(123)
                                 .originReadTimeout(123)
                                 .originSslProtocols(List.of("originSslProtocols"))
                                 .build())
                         .originAccessControlId("originAccessControlId")
                         .originCustomHeaders(List.of(OriginCustomHeaderProperty.builder()
                                 .headerName("headerName")
                                 .headerValue("headerValue")
                                 .build()))
                         .originPath("originPath")
                         .originShield(OriginShieldProperty.builder()
                                 .enabled(false)
                                 .originShieldRegion("originShieldRegion")
                                 .build())
                         .responseCompletionTimeout(123)
                         .s3OriginConfig(S3OriginConfigProperty.builder()
                                 .originAccessIdentity("originAccessIdentity")
                                 .originReadTimeout(123)
                                 .build())
                         .vpcOriginConfig(VpcOriginConfigProperty.builder()
                                 .vpcOriginId("vpcOriginId")
                                 // the properties below are optional
                                 .originKeepaliveTimeout(123)
                                 .originReadTimeout(123)
                                 .ownerAccountId("ownerAccountId")
                                 .build())
                         .build()))
                 .priceClass("priceClass")
                 .restrictions(RestrictionsProperty.builder()
                         .geoRestriction(GeoRestrictionProperty.builder()
                                 .restrictionType("restrictionType")
                                 // the properties below are optional
                                 .locations(List.of("locations"))
                                 .build())
                         .build())
                 .s3Origin(LegacyS3OriginProperty.builder()
                         .dnsName("dnsName")
                         // the properties below are optional
                         .originAccessIdentity("originAccessIdentity")
                         .build())
                 .staging(false)
                 .tenantConfig(TenantConfigProperty.builder()
                         .parameterDefinitions(List.of(ParameterDefinitionProperty.builder()
                                 .definition(DefinitionProperty.builder()
                                         .stringSchema(StringSchemaProperty.builder()
                                                 .required(false)
                                                 // the properties below are optional
                                                 .comment("comment")
                                                 .defaultValue("defaultValue")
                                                 .build())
                                         .build())
                                 .name("name")
                                 .build()))
                         .build())
                 .viewerCertificate(ViewerCertificateProperty.builder()
                         .acmCertificateArn("acmCertificateArn")
                         .cloudFrontDefaultCertificate(false)
                         .iamCertificateId("iamCertificateId")
                         .minimumProtocolVersion("minimumProtocolVersion")
                         .sslSupportMethod("sslSupportMethod")
                         .build())
                 .webAclId("webAclId")
                 .build())
         // the properties below are optional
         .tags(List.of(CfnTag.builder()
                 .key("key")
                 .value("value")
                 .build()))
         .build();

See Also: