We recommend new projects start with resources from the AWS provider.
aws-native.cloudfront.Distribution
We recommend new projects start with resources from the AWS provider.
A distribution tells CloudFront where you want content to be delivered from, and the details about how to track and manage content delivery.
Create Distribution Resource
Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.
Constructor syntax
new Distribution(name: string, args: DistributionArgs, opts?: CustomResourceOptions);@overload
def Distribution(resource_name: str,
                 args: DistributionArgs,
                 opts: Optional[ResourceOptions] = None)
@overload
def Distribution(resource_name: str,
                 opts: Optional[ResourceOptions] = None,
                 distribution_config: Optional[DistributionConfigArgs] = None,
                 tags: Optional[Sequence[_root_inputs.TagArgs]] = None)func NewDistribution(ctx *Context, name string, args DistributionArgs, opts ...ResourceOption) (*Distribution, error)public Distribution(string name, DistributionArgs args, CustomResourceOptions? opts = null)
public Distribution(String name, DistributionArgs args)
public Distribution(String name, DistributionArgs args, CustomResourceOptions options)
type: aws-native:cloudfront:Distribution
properties: # The arguments to resource properties.
options: # Bag of options to control resource's behavior.
Parameters
- name string
- The unique name of the resource.
- args DistributionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- resource_name str
- The unique name of the resource.
- args DistributionArgs
- The arguments to resource properties.
- opts ResourceOptions
- Bag of options to control resource's behavior.
- ctx Context
- Context object for the current deployment.
- name string
- The unique name of the resource.
- args DistributionArgs
- The arguments to resource properties.
- opts ResourceOption
- Bag of options to control resource's behavior.
- name string
- The unique name of the resource.
- args DistributionArgs
- The arguments to resource properties.
- opts CustomResourceOptions
- Bag of options to control resource's behavior.
- name String
- The unique name of the resource.
- args DistributionArgs
- The arguments to resource properties.
- options CustomResourceOptions
- Bag of options to control resource's behavior.
Distribution Resource Properties
To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.
Inputs
In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.
The Distribution resource accepts the following input properties:
- DistributionConfig Pulumi.Aws Native. Cloud Front. Inputs. Distribution Config 
- The distribution's configuration.
- 
List<Pulumi.Aws Native. Inputs. Tag> 
- A complex type that contains zero or more Tagelements.
- DistributionConfig DistributionConfig Args 
- The distribution's configuration.
- 
TagArgs 
- A complex type that contains zero or more Tagelements.
- distributionConfig DistributionConfig 
- The distribution's configuration.
- List<Tag>
- A complex type that contains zero or more Tagelements.
- distributionConfig DistributionConfig 
- The distribution's configuration.
- Tag[]
- A complex type that contains zero or more Tagelements.
- distribution_config DistributionConfig Args 
- The distribution's configuration.
- 
Sequence[TagArgs] 
- A complex type that contains zero or more Tagelements.
- distributionConfig Property Map
- The distribution's configuration.
- List<Property Map>
- A complex type that contains zero or more Tagelements.
Outputs
All input properties are implicitly available as output properties. Additionally, the Distribution resource produces the following output properties:
- AwsId string
- The distribution's identifier. For example: E1U5RQF7T870K0.
- DomainName string
- The domain name of the resource, such as d111111abcdef8.cloudfront.net.
- Id string
- The provider-assigned unique ID for this managed resource.
- AwsId string
- The distribution's identifier. For example: E1U5RQF7T870K0.
- DomainName string
- The domain name of the resource, such as d111111abcdef8.cloudfront.net.
- Id string
- The provider-assigned unique ID for this managed resource.
- awsId String
- The distribution's identifier. For example: E1U5RQF7T870K0.
- domainName String
- The domain name of the resource, such as d111111abcdef8.cloudfront.net.
- id String
- The provider-assigned unique ID for this managed resource.
- awsId string
- The distribution's identifier. For example: E1U5RQF7T870K0.
- domainName string
- The domain name of the resource, such as d111111abcdef8.cloudfront.net.
- id string
- The provider-assigned unique ID for this managed resource.
- aws_id str
- The distribution's identifier. For example: E1U5RQF7T870K0.
- domain_name str
- The domain name of the resource, such as d111111abcdef8.cloudfront.net.
- id str
- The provider-assigned unique ID for this managed resource.
- awsId String
- The distribution's identifier. For example: E1U5RQF7T870K0.
- domainName String
- The domain name of the resource, such as d111111abcdef8.cloudfront.net.
- id String
- The provider-assigned unique ID for this managed resource.
Supporting Types
DistributionCacheBehavior, DistributionCacheBehaviorArgs      
A complex type that describes how CloudFront processes requests.
You must create at least as many cache behaviors (including the default cache behavior) as you have origins if you want CloudFront to serve objects from all of the origins. Each cache behavior specifies the one origin from which you want CloudFront to get objects. If you have two origins and only the default cache behavior, the default cache behavior will cause CloudFront to get objects from one of the origins, but the other origin is never used.
For the current quota (formerly known as limit) on the number of cache behaviors that you can add to a distribution, see Quotas in the Amazon CloudFront Developer Guide.
If you don't want to specify any cache behaviors, include only an empty CacheBehaviors element. Don't specify an empty individual CacheBehavior element, because this is invalid. For more information, see CacheBehaviors.
To delete all cache behaviors in an existing distribution, update the distribution configuration and include only an empty CacheBehaviors element.
To add, change, or remove one or more cache behaviors, update the distribution configuration and specify all of the cache behaviors that you want to include in the updated distribution.
If your minimum TTL is greater than 0, CloudFront will cache content for at least the duration specified in the cache policy's minimum TTL, even if the Cache-Control: no-cache, no-store, or private directives are present in the origin headers.
For more information about cache behaviors, see Cache Behavior Settings in the Amazon CloudFront Developer Guide.- PathPattern string
- The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. You can optionally include a slash (/) at the beginning of the path pattern. For example,/images/*.jpg. CloudFront behavior is the same with or without the leading/. The path pattern for the default cache behavior is*and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior. For more information, see Path Pattern in the Amazon CloudFront Developer Guide.
- TargetOrigin stringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they match this cache behavior.
- ViewerProtocol stringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- AllowedMethods List<string>
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- CachePolicy stringId 
- The unique identifier of the cache policy that is attached to this cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- CachedMethods List<string>
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- Compress bool
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- DefaultTtl double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- FieldLevel stringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for this cache behavior.
- ForwardedValues Pulumi.Aws Native. Cloud Front. Inputs. Distribution Forwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- FunctionAssociations List<Pulumi.Aws Native. Cloud Front. Inputs. Distribution Function Association> 
- A list of CloudFront functions that are associated with this cache behavior. CloudFront functions must be published to the LIVEstage to associate them with a cache behavior.
- GrpcConfig Pulumi.Aws Native. Cloud Front. Inputs. Distribution Grpc Config 
- The gRPC configuration for your cache behavior.
- LambdaFunction List<Pulumi.Associations Aws Native. Cloud Front. Inputs. Distribution Lambda Function Association> 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- MaxTtl double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- MinTtl double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- OriginRequest stringPolicy Id 
- The unique identifier of the origin request policy that is attached to this cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- RealtimeLog stringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- ResponseHeaders stringPolicy Id 
- The identifier for a response headers policy.
- SmoothStreaming bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- TrustedKey List<string>Groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- TrustedSigners List<string>
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in the trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- PathPattern string
- The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. You can optionally include a slash (/) at the beginning of the path pattern. For example,/images/*.jpg. CloudFront behavior is the same with or without the leading/. The path pattern for the default cache behavior is*and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior. For more information, see Path Pattern in the Amazon CloudFront Developer Guide.
- TargetOrigin stringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they match this cache behavior.
- ViewerProtocol stringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- AllowedMethods []string
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- CachePolicy stringId 
- The unique identifier of the cache policy that is attached to this cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- CachedMethods []string
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- Compress bool
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- DefaultTtl float64
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- FieldLevel stringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for this cache behavior.
- ForwardedValues DistributionForwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- FunctionAssociations []DistributionFunction Association 
- A list of CloudFront functions that are associated with this cache behavior. CloudFront functions must be published to the LIVEstage to associate them with a cache behavior.
- GrpcConfig DistributionGrpc Config 
- The gRPC configuration for your cache behavior.
- LambdaFunction []DistributionAssociations Lambda Function Association 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- MaxTtl float64
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- MinTtl float64
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- OriginRequest stringPolicy Id 
- The unique identifier of the origin request policy that is attached to this cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- RealtimeLog stringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- ResponseHeaders stringPolicy Id 
- The identifier for a response headers policy.
- SmoothStreaming bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- TrustedKey []stringGroups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- TrustedSigners []string
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in the trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- pathPattern String
- The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. You can optionally include a slash (/) at the beginning of the path pattern. For example,/images/*.jpg. CloudFront behavior is the same with or without the leading/. The path pattern for the default cache behavior is*and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior. For more information, see Path Pattern in the Amazon CloudFront Developer Guide.
- targetOrigin StringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they match this cache behavior.
- viewerProtocol StringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- allowedMethods List<String>
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- cachePolicy StringId 
- The unique identifier of the cache policy that is attached to this cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- cachedMethods List<String>
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- compress Boolean
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- defaultTtl Double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- fieldLevel StringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for this cache behavior.
- forwardedValues DistributionForwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- functionAssociations List<DistributionFunction Association> 
- A list of CloudFront functions that are associated with this cache behavior. CloudFront functions must be published to the LIVEstage to associate them with a cache behavior.
- grpcConfig DistributionGrpc Config 
- The gRPC configuration for your cache behavior.
- lambdaFunction List<DistributionAssociations Lambda Function Association> 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- maxTtl Double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- minTtl Double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- originRequest StringPolicy Id 
- The unique identifier of the origin request policy that is attached to this cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- realtimeLog StringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- responseHeaders StringPolicy Id 
- The identifier for a response headers policy.
- smoothStreaming Boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- trustedKey List<String>Groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- trustedSigners List<String>
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in the trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- pathPattern string
- The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. You can optionally include a slash (/) at the beginning of the path pattern. For example,/images/*.jpg. CloudFront behavior is the same with or without the leading/. The path pattern for the default cache behavior is*and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior. For more information, see Path Pattern in the Amazon CloudFront Developer Guide.
- targetOrigin stringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they match this cache behavior.
- viewerProtocol stringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- allowedMethods string[]
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- cachePolicy stringId 
- The unique identifier of the cache policy that is attached to this cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- cachedMethods string[]
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- compress boolean
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- defaultTtl number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- fieldLevel stringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for this cache behavior.
- forwardedValues DistributionForwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- functionAssociations DistributionFunction Association[] 
- A list of CloudFront functions that are associated with this cache behavior. CloudFront functions must be published to the LIVEstage to associate them with a cache behavior.
- grpcConfig DistributionGrpc Config 
- The gRPC configuration for your cache behavior.
- lambdaFunction DistributionAssociations Lambda Function Association[] 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- maxTtl number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- minTtl number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- originRequest stringPolicy Id 
- The unique identifier of the origin request policy that is attached to this cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- realtimeLog stringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- responseHeaders stringPolicy Id 
- The identifier for a response headers policy.
- smoothStreaming boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- trustedKey string[]Groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- trustedSigners string[]
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in the trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- path_pattern str
- The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. You can optionally include a slash (/) at the beginning of the path pattern. For example,/images/*.jpg. CloudFront behavior is the same with or without the leading/. The path pattern for the default cache behavior is*and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior. For more information, see Path Pattern in the Amazon CloudFront Developer Guide.
- target_origin_ strid 
- The value of IDfor the origin that you want CloudFront to route requests to when they match this cache behavior.
- viewer_protocol_ strpolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- allowed_methods Sequence[str]
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- cache_policy_ strid 
- The unique identifier of the cache policy that is attached to this cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- cached_methods Sequence[str]
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- compress bool
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- default_ttl float
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- field_level_ strencryption_ id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for this cache behavior.
- forwarded_values DistributionForwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- function_associations Sequence[DistributionFunction Association] 
- A list of CloudFront functions that are associated with this cache behavior. CloudFront functions must be published to the LIVEstage to associate them with a cache behavior.
- grpc_config DistributionGrpc Config 
- The gRPC configuration for your cache behavior.
- lambda_function_ Sequence[Distributionassociations Lambda Function Association] 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- max_ttl float
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- min_ttl float
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- origin_request_ strpolicy_ id 
- The unique identifier of the origin request policy that is attached to this cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- realtime_log_ strconfig_ arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- response_headers_ strpolicy_ id 
- The identifier for a response headers policy.
- smooth_streaming bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- trusted_key_ Sequence[str]groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- trusted_signers Sequence[str]
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in the trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- pathPattern String
- The pattern (for example, images/*.jpg) that specifies which requests to apply the behavior to. When CloudFront receives a viewer request, the requested path is compared with path patterns in the order in which cache behaviors are listed in the distribution. You can optionally include a slash (/) at the beginning of the path pattern. For example,/images/*.jpg. CloudFront behavior is the same with or without the leading/. The path pattern for the default cache behavior is*and cannot be changed. If the request for an object does not match the path pattern for any cache behaviors, CloudFront applies the behavior in the default cache behavior. For more information, see Path Pattern in the Amazon CloudFront Developer Guide.
- targetOrigin StringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they match this cache behavior.
- viewerProtocol StringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- allowedMethods List<String>
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- cachePolicy StringId 
- The unique identifier of the cache policy that is attached to this cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- cachedMethods List<String>
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- compress Boolean
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specify false. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- defaultTtl Number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- fieldLevel StringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for this cache behavior.
- forwardedValues Property Map
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A CacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- functionAssociations List<Property Map>
- A list of CloudFront functions that are associated with this cache behavior. CloudFront functions must be published to the LIVEstage to associate them with a cache behavior.
- grpcConfig Property Map
- The gRPC configuration for your cache behavior.
- lambdaFunction List<Property Map>Associations 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- maxTtl Number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- minTtl Number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- originRequest StringPolicy Id 
- The unique identifier of the origin request policy that is attached to this cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- realtimeLog StringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- responseHeaders StringPolicy Id 
- The identifier for a response headers policy.
- smoothStreaming Boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- trustedKey List<String>Groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- trustedSigners List<String>
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in the trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
DistributionConfig, DistributionConfigArgs    
A distribution configuration.- DefaultCache Pulumi.Behavior Aws Native. Cloud Front. Inputs. Distribution Default Cache Behavior 
- A complex type that describes the default cache behavior if you don't specify a CacheBehaviorelement or if files don't match any of the values ofPathPatterninCacheBehaviorelements. You must create exactly one default cache behavior.
- Enabled bool
- From this field, you can enable or disable the selected distribution.
- Aliases List<string>
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
- AnycastIp stringList Id 
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. ID of the Anycast static IP list that is associated with the distribution.
- CacheBehaviors List<Pulumi.Aws Native. Cloud Front. Inputs. Distribution Cache Behavior> 
- A complex type that contains zero or more CacheBehaviorelements.
- Cnames List<string>
- An alias for the CF distribution's domain name. This property is legacy. We recommend that you use Aliases instead.
- Comment string
- A comment to describe the distribution. The comment cannot be longer than 128 characters.
- ConnectionMode Pulumi.Aws Native. Cloud Front. Distribution Connection Mode 
- This field specifies whether the connection mode is through a standard distribution (direct) or a multi-tenant distribution with distribution tenants (tenant-only).
- ContinuousDeployment stringPolicy Id 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
The identifier of a continuous deployment policy. For more information, see CreateContinuousDeploymentPolicy.
- CustomError List<Pulumi.Responses Aws Native. Cloud Front. Inputs. Distribution Custom Error Response> 
- A complex type that controls the following: - Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
- How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
 - For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide. 
- CustomOrigin Pulumi.Aws Native. Cloud Front. Inputs. Distribution Legacy Custom Origin 
- The user-defined HTTP server that serves as the origin for content that CF distributes. This property is legacy. We recommend that you use Origin instead.
- DefaultRoot stringObject 
- When a viewer requests the root URL for your distribution, the default root object is the object that you want CloudFront to request from your origin. For example, if your root URL is https://www.example.com, you can specify CloudFront to return theindex.htmlfile as the default root object. You can specify a default root object so that viewers see a specific file or object, instead of another object in your distribution (for example,https://www.example.com/product-description.html). A default root object avoids exposing the contents of your distribution. You can specify the object name or a path to the object name (for example,index.htmlorexampleFolderName/index.html). Your string can't begin with a forward slash (/). Only specify the object name or the path to the object. If you don't want to specify a default root object when you create a distribution, include an emptyDefaultRootObjectelement. To delete the default root object from an existing distribution, update the distribution configuration and include an emptyDefaultRootObjectelement. To replace the default root object, update the distribution configuration and specify the new object. For more information about the default root object, see Specify a default root object in the Amazon CloudFront Developer Guide.
- HttpVersion string
- (Optional) Specify the HTTP version(s) that you want viewers to use to communicate with CF. The default value for new distributions is http1.1. For viewers and CF to use HTTP/2, viewers must support TLSv1.2 or later, and must support Server Name Indication (SNI). For viewers and CF to use HTTP/3, viewers must support TLSv1.3 and Server Name Indication (SNI). CF supports HTTP/3 connection migration to allow the viewer to switch networks without losing connection. For more information about connection migration, see Connection Migration at RFC 9000. For more information about supported TLSv1.3 ciphers, see Supported protocols and ciphers between viewers and CloudFront.
- Ipv6Enabled bool
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify - true. If you specify- false, CloudFront responds to IPv6 DNS requests with the DNS response code- NOERRORand with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution. In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the- IpAddressparameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide. If you're using an R53AWSIntlong alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:- You enable IPv6 for the distribution
- You're using alternate domain names in the URLs for your objects
 - For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Developer Guide. If you created a CNAME resource record set, either with R53AWSIntlong or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request. 
- Logging
Pulumi.Aws Native. Cloud Front. Inputs. Distribution Logging 
- A complex type that controls whether access logs are written for the distribution. For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.
- OriginGroups Pulumi.Aws Native. Cloud Front. Inputs. Distribution Origin Groups 
- A complex type that contains information about origin groups for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- Origins
List<Pulumi.Aws Native. Cloud Front. Inputs. Distribution Origin> 
- A complex type that contains information about origins for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- PriceClass string
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
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 thanPriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance. For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes (such as Price Class 100) map to CloudFront regions, see Amazon CloudFront Pricing.
- Restrictions
Pulumi.Aws Native. Cloud Front. Inputs. Distribution Restrictions 
- A complex type that identifies ways in which you want to restrict distribution of your content.
- S3Origin
Pulumi.Aws Native. Cloud Front. Inputs. Distribution Legacy S3Origin 
- The origin as an S3 bucket. This property is legacy. We recommend that you use Origin instead.
- Staging bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value isfalse, this is not a staging distribution.
- TenantConfig Pulumi.Aws Native. Cloud Front. Inputs. Distribution Config Tenant Config Properties 
- This field only supports multi-tenant distributions. You can't specify this field for standard distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A distribution tenant configuration.
- ViewerCertificate Pulumi.Aws Native. Cloud Front. Inputs. Distribution Viewer Certificate 
- A complex type that determines the distribution's SSL/TLS configuration for communicating with viewers.
- WebAcl stringId 
- Multi-tenant distributions only support WAF V2 web ACLs.
A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. To specify a web ACL created using WAF Classic, use the ACL ID, for examplea1b2c3d4-5678-90ab-cdef-EXAMPLE11111. WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about WAF, see the Developer Guide.
- DefaultCache DistributionBehavior Default Cache Behavior 
- A complex type that describes the default cache behavior if you don't specify a CacheBehaviorelement or if files don't match any of the values ofPathPatterninCacheBehaviorelements. You must create exactly one default cache behavior.
- Enabled bool
- From this field, you can enable or disable the selected distribution.
- Aliases []string
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
- AnycastIp stringList Id 
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. ID of the Anycast static IP list that is associated with the distribution.
- CacheBehaviors []DistributionCache Behavior 
- A complex type that contains zero or more CacheBehaviorelements.
- Cnames []string
- An alias for the CF distribution's domain name. This property is legacy. We recommend that you use Aliases instead.
- Comment string
- A comment to describe the distribution. The comment cannot be longer than 128 characters.
- ConnectionMode DistributionConnection Mode 
- This field specifies whether the connection mode is through a standard distribution (direct) or a multi-tenant distribution with distribution tenants (tenant-only).
- ContinuousDeployment stringPolicy Id 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
The identifier of a continuous deployment policy. For more information, see CreateContinuousDeploymentPolicy.
- CustomError []DistributionResponses Custom Error Response 
- A complex type that controls the following: - Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
- How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
 - For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide. 
- CustomOrigin DistributionLegacy Custom Origin 
- The user-defined HTTP server that serves as the origin for content that CF distributes. This property is legacy. We recommend that you use Origin instead.
- DefaultRoot stringObject 
- When a viewer requests the root URL for your distribution, the default root object is the object that you want CloudFront to request from your origin. For example, if your root URL is https://www.example.com, you can specify CloudFront to return theindex.htmlfile as the default root object. You can specify a default root object so that viewers see a specific file or object, instead of another object in your distribution (for example,https://www.example.com/product-description.html). A default root object avoids exposing the contents of your distribution. You can specify the object name or a path to the object name (for example,index.htmlorexampleFolderName/index.html). Your string can't begin with a forward slash (/). Only specify the object name or the path to the object. If you don't want to specify a default root object when you create a distribution, include an emptyDefaultRootObjectelement. To delete the default root object from an existing distribution, update the distribution configuration and include an emptyDefaultRootObjectelement. To replace the default root object, update the distribution configuration and specify the new object. For more information about the default root object, see Specify a default root object in the Amazon CloudFront Developer Guide.
- HttpVersion string
- (Optional) Specify the HTTP version(s) that you want viewers to use to communicate with CF. The default value for new distributions is http1.1. For viewers and CF to use HTTP/2, viewers must support TLSv1.2 or later, and must support Server Name Indication (SNI). For viewers and CF to use HTTP/3, viewers must support TLSv1.3 and Server Name Indication (SNI). CF supports HTTP/3 connection migration to allow the viewer to switch networks without losing connection. For more information about connection migration, see Connection Migration at RFC 9000. For more information about supported TLSv1.3 ciphers, see Supported protocols and ciphers between viewers and CloudFront.
- Ipv6Enabled bool
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify - true. If you specify- false, CloudFront responds to IPv6 DNS requests with the DNS response code- NOERRORand with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution. In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the- IpAddressparameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide. If you're using an R53AWSIntlong alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:- You enable IPv6 for the distribution
- You're using alternate domain names in the URLs for your objects
 - For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Developer Guide. If you created a CNAME resource record set, either with R53AWSIntlong or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request. 
- Logging
DistributionLogging 
- A complex type that controls whether access logs are written for the distribution. For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.
- OriginGroups DistributionOrigin Groups 
- A complex type that contains information about origin groups for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- Origins
[]DistributionOrigin 
- A complex type that contains information about origins for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- PriceClass string
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
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 thanPriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance. For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes (such as Price Class 100) map to CloudFront regions, see Amazon CloudFront Pricing.
- Restrictions
DistributionRestrictions 
- A complex type that identifies ways in which you want to restrict distribution of your content.
- S3Origin
DistributionLegacy S3Origin 
- The origin as an S3 bucket. This property is legacy. We recommend that you use Origin instead.
- Staging bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value isfalse, this is not a staging distribution.
- TenantConfig DistributionConfig Tenant Config Properties 
- This field only supports multi-tenant distributions. You can't specify this field for standard distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A distribution tenant configuration.
- ViewerCertificate DistributionViewer Certificate 
- A complex type that determines the distribution's SSL/TLS configuration for communicating with viewers.
- WebAcl stringId 
- Multi-tenant distributions only support WAF V2 web ACLs.
A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. To specify a web ACL created using WAF Classic, use the ACL ID, for examplea1b2c3d4-5678-90ab-cdef-EXAMPLE11111. WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about WAF, see the Developer Guide.
- defaultCache DistributionBehavior Default Cache Behavior 
- A complex type that describes the default cache behavior if you don't specify a CacheBehaviorelement or if files don't match any of the values ofPathPatterninCacheBehaviorelements. You must create exactly one default cache behavior.
- enabled Boolean
- From this field, you can enable or disable the selected distribution.
- aliases List<String>
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
- anycastIp StringList Id 
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. ID of the Anycast static IP list that is associated with the distribution.
- cacheBehaviors List<DistributionCache Behavior> 
- A complex type that contains zero or more CacheBehaviorelements.
- cnames List<String>
- An alias for the CF distribution's domain name. This property is legacy. We recommend that you use Aliases instead.
- comment String
- A comment to describe the distribution. The comment cannot be longer than 128 characters.
- connectionMode DistributionConnection Mode 
- This field specifies whether the connection mode is through a standard distribution (direct) or a multi-tenant distribution with distribution tenants (tenant-only).
- continuousDeployment StringPolicy Id 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
The identifier of a continuous deployment policy. For more information, see CreateContinuousDeploymentPolicy.
- customError List<DistributionResponses Custom Error Response> 
- A complex type that controls the following: - Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
- How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
 - For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide. 
- customOrigin DistributionLegacy Custom Origin 
- The user-defined HTTP server that serves as the origin for content that CF distributes. This property is legacy. We recommend that you use Origin instead.
- defaultRoot StringObject 
- When a viewer requests the root URL for your distribution, the default root object is the object that you want CloudFront to request from your origin. For example, if your root URL is https://www.example.com, you can specify CloudFront to return theindex.htmlfile as the default root object. You can specify a default root object so that viewers see a specific file or object, instead of another object in your distribution (for example,https://www.example.com/product-description.html). A default root object avoids exposing the contents of your distribution. You can specify the object name or a path to the object name (for example,index.htmlorexampleFolderName/index.html). Your string can't begin with a forward slash (/). Only specify the object name or the path to the object. If you don't want to specify a default root object when you create a distribution, include an emptyDefaultRootObjectelement. To delete the default root object from an existing distribution, update the distribution configuration and include an emptyDefaultRootObjectelement. To replace the default root object, update the distribution configuration and specify the new object. For more information about the default root object, see Specify a default root object in the Amazon CloudFront Developer Guide.
- httpVersion String
- (Optional) Specify the HTTP version(s) that you want viewers to use to communicate with CF. The default value for new distributions is http1.1. For viewers and CF to use HTTP/2, viewers must support TLSv1.2 or later, and must support Server Name Indication (SNI). For viewers and CF to use HTTP/3, viewers must support TLSv1.3 and Server Name Indication (SNI). CF supports HTTP/3 connection migration to allow the viewer to switch networks without losing connection. For more information about connection migration, see Connection Migration at RFC 9000. For more information about supported TLSv1.3 ciphers, see Supported protocols and ciphers between viewers and CloudFront.
- ipv6Enabled Boolean
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify - true. If you specify- false, CloudFront responds to IPv6 DNS requests with the DNS response code- NOERRORand with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution. In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the- IpAddressparameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide. If you're using an R53AWSIntlong alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:- You enable IPv6 for the distribution
- You're using alternate domain names in the URLs for your objects
 - For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Developer Guide. If you created a CNAME resource record set, either with R53AWSIntlong or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request. 
- logging
DistributionLogging 
- A complex type that controls whether access logs are written for the distribution. For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.
- originGroups DistributionOrigin Groups 
- A complex type that contains information about origin groups for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- origins
List<DistributionOrigin> 
- A complex type that contains information about origins for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- priceClass String
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
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 thanPriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance. For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes (such as Price Class 100) map to CloudFront regions, see Amazon CloudFront Pricing.
- restrictions
DistributionRestrictions 
- A complex type that identifies ways in which you want to restrict distribution of your content.
- s3Origin
DistributionLegacy S3Origin 
- The origin as an S3 bucket. This property is legacy. We recommend that you use Origin instead.
- staging Boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value isfalse, this is not a staging distribution.
- tenantConfig DistributionConfig Tenant Config Properties 
- This field only supports multi-tenant distributions. You can't specify this field for standard distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A distribution tenant configuration.
- viewerCertificate DistributionViewer Certificate 
- A complex type that determines the distribution's SSL/TLS configuration for communicating with viewers.
- webAcl StringId 
- Multi-tenant distributions only support WAF V2 web ACLs.
A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. To specify a web ACL created using WAF Classic, use the ACL ID, for examplea1b2c3d4-5678-90ab-cdef-EXAMPLE11111. WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about WAF, see the Developer Guide.
- defaultCache DistributionBehavior Default Cache Behavior 
- A complex type that describes the default cache behavior if you don't specify a CacheBehaviorelement or if files don't match any of the values ofPathPatterninCacheBehaviorelements. You must create exactly one default cache behavior.
- enabled boolean
- From this field, you can enable or disable the selected distribution.
- aliases string[]
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
- anycastIp stringList Id 
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. ID of the Anycast static IP list that is associated with the distribution.
- cacheBehaviors DistributionCache Behavior[] 
- A complex type that contains zero or more CacheBehaviorelements.
- cnames string[]
- An alias for the CF distribution's domain name. This property is legacy. We recommend that you use Aliases instead.
- comment string
- A comment to describe the distribution. The comment cannot be longer than 128 characters.
- connectionMode DistributionConnection Mode 
- This field specifies whether the connection mode is through a standard distribution (direct) or a multi-tenant distribution with distribution tenants (tenant-only).
- continuousDeployment stringPolicy Id 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
The identifier of a continuous deployment policy. For more information, see CreateContinuousDeploymentPolicy.
- customError DistributionResponses Custom Error Response[] 
- A complex type that controls the following: - Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
- How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
 - For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide. 
- customOrigin DistributionLegacy Custom Origin 
- The user-defined HTTP server that serves as the origin for content that CF distributes. This property is legacy. We recommend that you use Origin instead.
- defaultRoot stringObject 
- When a viewer requests the root URL for your distribution, the default root object is the object that you want CloudFront to request from your origin. For example, if your root URL is https://www.example.com, you can specify CloudFront to return theindex.htmlfile as the default root object. You can specify a default root object so that viewers see a specific file or object, instead of another object in your distribution (for example,https://www.example.com/product-description.html). A default root object avoids exposing the contents of your distribution. You can specify the object name or a path to the object name (for example,index.htmlorexampleFolderName/index.html). Your string can't begin with a forward slash (/). Only specify the object name or the path to the object. If you don't want to specify a default root object when you create a distribution, include an emptyDefaultRootObjectelement. To delete the default root object from an existing distribution, update the distribution configuration and include an emptyDefaultRootObjectelement. To replace the default root object, update the distribution configuration and specify the new object. For more information about the default root object, see Specify a default root object in the Amazon CloudFront Developer Guide.
- httpVersion string
- (Optional) Specify the HTTP version(s) that you want viewers to use to communicate with CF. The default value for new distributions is http1.1. For viewers and CF to use HTTP/2, viewers must support TLSv1.2 or later, and must support Server Name Indication (SNI). For viewers and CF to use HTTP/3, viewers must support TLSv1.3 and Server Name Indication (SNI). CF supports HTTP/3 connection migration to allow the viewer to switch networks without losing connection. For more information about connection migration, see Connection Migration at RFC 9000. For more information about supported TLSv1.3 ciphers, see Supported protocols and ciphers between viewers and CloudFront.
- ipv6Enabled boolean
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify - true. If you specify- false, CloudFront responds to IPv6 DNS requests with the DNS response code- NOERRORand with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution. In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the- IpAddressparameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide. If you're using an R53AWSIntlong alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:- You enable IPv6 for the distribution
- You're using alternate domain names in the URLs for your objects
 - For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Developer Guide. If you created a CNAME resource record set, either with R53AWSIntlong or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request. 
- logging
DistributionLogging 
- A complex type that controls whether access logs are written for the distribution. For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.
- originGroups DistributionOrigin Groups 
- A complex type that contains information about origin groups for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- origins
DistributionOrigin[] 
- A complex type that contains information about origins for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- priceClass string
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
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 thanPriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance. For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes (such as Price Class 100) map to CloudFront regions, see Amazon CloudFront Pricing.
- restrictions
DistributionRestrictions 
- A complex type that identifies ways in which you want to restrict distribution of your content.
- s3Origin
DistributionLegacy S3Origin 
- The origin as an S3 bucket. This property is legacy. We recommend that you use Origin instead.
- staging boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value isfalse, this is not a staging distribution.
- tenantConfig DistributionConfig Tenant Config Properties 
- This field only supports multi-tenant distributions. You can't specify this field for standard distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A distribution tenant configuration.
- viewerCertificate DistributionViewer Certificate 
- A complex type that determines the distribution's SSL/TLS configuration for communicating with viewers.
- webAcl stringId 
- Multi-tenant distributions only support WAF V2 web ACLs.
A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. To specify a web ACL created using WAF Classic, use the ACL ID, for examplea1b2c3d4-5678-90ab-cdef-EXAMPLE11111. WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about WAF, see the Developer Guide.
- default_cache_ Distributionbehavior Default Cache Behavior 
- A complex type that describes the default cache behavior if you don't specify a CacheBehaviorelement or if files don't match any of the values ofPathPatterninCacheBehaviorelements. You must create exactly one default cache behavior.
- enabled bool
- From this field, you can enable or disable the selected distribution.
- aliases Sequence[str]
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
- anycast_ip_ strlist_ id 
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. ID of the Anycast static IP list that is associated with the distribution.
- cache_behaviors Sequence[DistributionCache Behavior] 
- A complex type that contains zero or more CacheBehaviorelements.
- cnames Sequence[str]
- An alias for the CF distribution's domain name. This property is legacy. We recommend that you use Aliases instead.
- comment str
- A comment to describe the distribution. The comment cannot be longer than 128 characters.
- connection_mode DistributionConnection Mode 
- This field specifies whether the connection mode is through a standard distribution (direct) or a multi-tenant distribution with distribution tenants (tenant-only).
- continuous_deployment_ strpolicy_ id 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
The identifier of a continuous deployment policy. For more information, see CreateContinuousDeploymentPolicy.
- custom_error_ Sequence[Distributionresponses Custom Error Response] 
- A complex type that controls the following: - Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
- How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
 - For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide. 
- custom_origin DistributionLegacy Custom Origin 
- The user-defined HTTP server that serves as the origin for content that CF distributes. This property is legacy. We recommend that you use Origin instead.
- default_root_ strobject 
- When a viewer requests the root URL for your distribution, the default root object is the object that you want CloudFront to request from your origin. For example, if your root URL is https://www.example.com, you can specify CloudFront to return theindex.htmlfile as the default root object. You can specify a default root object so that viewers see a specific file or object, instead of another object in your distribution (for example,https://www.example.com/product-description.html). A default root object avoids exposing the contents of your distribution. You can specify the object name or a path to the object name (for example,index.htmlorexampleFolderName/index.html). Your string can't begin with a forward slash (/). Only specify the object name or the path to the object. If you don't want to specify a default root object when you create a distribution, include an emptyDefaultRootObjectelement. To delete the default root object from an existing distribution, update the distribution configuration and include an emptyDefaultRootObjectelement. To replace the default root object, update the distribution configuration and specify the new object. For more information about the default root object, see Specify a default root object in the Amazon CloudFront Developer Guide.
- http_version str
- (Optional) Specify the HTTP version(s) that you want viewers to use to communicate with CF. The default value for new distributions is http1.1. For viewers and CF to use HTTP/2, viewers must support TLSv1.2 or later, and must support Server Name Indication (SNI). For viewers and CF to use HTTP/3, viewers must support TLSv1.3 and Server Name Indication (SNI). CF supports HTTP/3 connection migration to allow the viewer to switch networks without losing connection. For more information about connection migration, see Connection Migration at RFC 9000. For more information about supported TLSv1.3 ciphers, see Supported protocols and ciphers between viewers and CloudFront.
- ipv6_enabled bool
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify - true. If you specify- false, CloudFront responds to IPv6 DNS requests with the DNS response code- NOERRORand with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution. In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the- IpAddressparameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide. If you're using an R53AWSIntlong alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:- You enable IPv6 for the distribution
- You're using alternate domain names in the URLs for your objects
 - For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Developer Guide. If you created a CNAME resource record set, either with R53AWSIntlong or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request. 
- logging
DistributionLogging 
- A complex type that controls whether access logs are written for the distribution. For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.
- origin_groups DistributionOrigin Groups 
- A complex type that contains information about origin groups for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- origins
Sequence[DistributionOrigin] 
- A complex type that contains information about origins for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- price_class str
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
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 thanPriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance. For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes (such as Price Class 100) map to CloudFront regions, see Amazon CloudFront Pricing.
- restrictions
DistributionRestrictions 
- A complex type that identifies ways in which you want to restrict distribution of your content.
- s3_origin DistributionLegacy S3Origin 
- The origin as an S3 bucket. This property is legacy. We recommend that you use Origin instead.
- staging bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value isfalse, this is not a staging distribution.
- tenant_config DistributionConfig Tenant Config Properties 
- This field only supports multi-tenant distributions. You can't specify this field for standard distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A distribution tenant configuration.
- viewer_certificate DistributionViewer Certificate 
- A complex type that determines the distribution's SSL/TLS configuration for communicating with viewers.
- web_acl_ strid 
- Multi-tenant distributions only support WAF V2 web ACLs.
A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. To specify a web ACL created using WAF Classic, use the ACL ID, for examplea1b2c3d4-5678-90ab-cdef-EXAMPLE11111. WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about WAF, see the Developer Guide.
- defaultCache Property MapBehavior 
- A complex type that describes the default cache behavior if you don't specify a CacheBehaviorelement or if files don't match any of the values ofPathPatterninCacheBehaviorelements. You must create exactly one default cache behavior.
- enabled Boolean
- From this field, you can enable or disable the selected distribution.
- aliases List<String>
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.
- anycastIp StringList Id 
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. ID of the Anycast static IP list that is associated with the distribution.
- cacheBehaviors List<Property Map>
- A complex type that contains zero or more CacheBehaviorelements.
- cnames List<String>
- An alias for the CF distribution's domain name. This property is legacy. We recommend that you use Aliases instead.
- comment String
- A comment to describe the distribution. The comment cannot be longer than 128 characters.
- connectionMode "direct" | "tenant-only"
- This field specifies whether the connection mode is through a standard distribution (direct) or a multi-tenant distribution with distribution tenants (tenant-only).
- continuousDeployment StringPolicy Id 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
The identifier of a continuous deployment policy. For more information, see CreateContinuousDeploymentPolicy.
- customError List<Property Map>Responses 
- A complex type that controls the following: - Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
- How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
 - For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide. 
- customOrigin Property Map
- The user-defined HTTP server that serves as the origin for content that CF distributes. This property is legacy. We recommend that you use Origin instead.
- defaultRoot StringObject 
- When a viewer requests the root URL for your distribution, the default root object is the object that you want CloudFront to request from your origin. For example, if your root URL is https://www.example.com, you can specify CloudFront to return theindex.htmlfile as the default root object. You can specify a default root object so that viewers see a specific file or object, instead of another object in your distribution (for example,https://www.example.com/product-description.html). A default root object avoids exposing the contents of your distribution. You can specify the object name or a path to the object name (for example,index.htmlorexampleFolderName/index.html). Your string can't begin with a forward slash (/). Only specify the object name or the path to the object. If you don't want to specify a default root object when you create a distribution, include an emptyDefaultRootObjectelement. To delete the default root object from an existing distribution, update the distribution configuration and include an emptyDefaultRootObjectelement. To replace the default root object, update the distribution configuration and specify the new object. For more information about the default root object, see Specify a default root object in the Amazon CloudFront Developer Guide.
- httpVersion String
- (Optional) Specify the HTTP version(s) that you want viewers to use to communicate with CF. The default value for new distributions is http1.1. For viewers and CF to use HTTP/2, viewers must support TLSv1.2 or later, and must support Server Name Indication (SNI). For viewers and CF to use HTTP/3, viewers must support TLSv1.3 and Server Name Indication (SNI). CF supports HTTP/3 connection migration to allow the viewer to switch networks without losing connection. For more information about connection migration, see Connection Migration at RFC 9000. For more information about supported TLSv1.3 ciphers, see Supported protocols and ciphers between viewers and CloudFront.
- ipv6Enabled Boolean
- To use this field for a multi-tenant distribution, use a connection group instead. For more information, see ConnectionGroup. If you want CloudFront to respond to IPv6 DNS requests with an IPv6 address for your distribution, specify - true. If you specify- false, CloudFront responds to IPv6 DNS requests with the DNS response code- NOERRORand with no IP addresses. This allows viewers to submit a second request, for an IPv4 address for your distribution. In general, you should enable IPv6 if you have users on IPv6 networks who want to access your content. However, if you're using signed URLs or signed cookies to restrict access to your content, and if you're using a custom policy that includes the- IpAddressparameter to restrict the IP addresses that can access your content, don't enable IPv6. If you want to restrict access to some content by IP address and not restrict access to other content (or restrict access but not by IP address), you can create two distributions. For more information, see Creating a Signed URL Using a Custom Policy in the Amazon CloudFront Developer Guide. If you're using an R53AWSIntlong alias resource record set to route traffic to your CloudFront distribution, you need to create a second alias resource record set when both of the following are true:- You enable IPv6 for the distribution
- You're using alternate domain names in the URLs for your objects
 - For more information, see Routing Traffic to an Amazon CloudFront Web Distribution by Using Your Domain Name in the Developer Guide. If you created a CNAME resource record set, either with R53AWSIntlong or with another DNS service, you don't need to make any changes. A CNAME record will route traffic to your distribution regardless of the IP address format of the viewer request. 
- logging Property Map
- A complex type that controls whether access logs are written for the distribution. For more information about logging, see Access Logs in the Amazon CloudFront Developer Guide.
- originGroups Property Map
- A complex type that contains information about origin groups for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- origins List<Property Map>
- A complex type that contains information about origins for this distribution.
Specify a value for either the OriginsorOriginGroupsproperty.
- priceClass String
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
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 thanPriceClass_All, CloudFront serves your objects from the CloudFront edge location that has the lowest latency among the edge locations in your price class. Viewers who are in or near regions that are excluded from your specified price class may encounter slower performance. For more information about price classes, see Choosing the Price Class for a CloudFront Distribution in the Amazon CloudFront Developer Guide. For information about CloudFront pricing, including how price classes (such as Price Class 100) map to CloudFront regions, see Amazon CloudFront Pricing.
- restrictions Property Map
- A complex type that identifies ways in which you want to restrict distribution of your content.
- s3Origin Property Map
- The origin as an S3 bucket. This property is legacy. We recommend that you use Origin instead.
- staging Boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value isfalse, this is not a staging distribution.
- tenantConfig Property Map
- This field only supports multi-tenant distributions. You can't specify this field for standard distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A distribution tenant configuration.
- viewerCertificate Property Map
- A complex type that determines the distribution's SSL/TLS configuration for communicating with viewers.
- webAcl StringId 
- Multi-tenant distributions only support WAF V2 web ACLs.
A unique identifier that specifies the WAF web ACL, if any, to associate with this distribution. To specify a web ACL created using the latest version of WAF, use the ACL ARN, for example arn:aws:wafv2:us-east-1:123456789012:global/webacl/ExampleWebACL/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111. To specify a web ACL created using WAF Classic, use the ACL ID, for examplea1b2c3d4-5678-90ab-cdef-EXAMPLE11111. WAF is a web application firewall that lets you monitor the HTTP and HTTPS requests that are forwarded to CloudFront, and lets you control access to your content. Based on conditions that you specify, such as the IP addresses that requests originate from or the values of query strings, CloudFront responds to requests either with the requested content or with an HTTP 403 status code (Forbidden). You can also configure CloudFront to return a custom error page when a request is blocked. For more information about WAF, see the Developer Guide.
DistributionConfigTenantConfigProperties, DistributionConfigTenantConfigPropertiesArgs          
This field only supports multi-tenant distributions. You can't specify this field for standard distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
A distribution tenant configuration.DistributionConnectionMode, DistributionConnectionModeArgs      
- Direct
- direct
- TenantOnly 
- tenant-only
- DistributionConnection Mode Direct 
- direct
- DistributionConnection Mode Tenant Only 
- tenant-only
- Direct
- direct
- TenantOnly 
- tenant-only
- Direct
- direct
- TenantOnly 
- tenant-only
- DIRECT
- direct
- TENANT_ONLY
- tenant-only
- "direct"
- direct
- "tenant-only"
- tenant-only
DistributionCookies, DistributionCookiesArgs    
This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.- Forward string
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNamescomplex type. Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for theForwardelement.
- WhitelistedNames List<string>
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Required if you specify whitelistfor the value ofForward. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies. If you specifyallornonefor the value ofForward, omitWhitelistedNames. If you change the value ofForwardfromwhitelisttoallornoneand you don't delete theWhitelistedNameselement and its child elements, CloudFront deletes them automatically. For the current limit on the number of cookie names that you can whitelist for each cache behavior, see CloudFront Limits in the General Reference.
- Forward string
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNamescomplex type. Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for theForwardelement.
- WhitelistedNames []string
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Required if you specify whitelistfor the value ofForward. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies. If you specifyallornonefor the value ofForward, omitWhitelistedNames. If you change the value ofForwardfromwhitelisttoallornoneand you don't delete theWhitelistedNameselement and its child elements, CloudFront deletes them automatically. For the current limit on the number of cookie names that you can whitelist for each cache behavior, see CloudFront Limits in the General Reference.
- forward String
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNamescomplex type. Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for theForwardelement.
- whitelistedNames List<String>
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Required if you specify whitelistfor the value ofForward. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies. If you specifyallornonefor the value ofForward, omitWhitelistedNames. If you change the value ofForwardfromwhitelisttoallornoneand you don't delete theWhitelistedNameselement and its child elements, CloudFront deletes them automatically. For the current limit on the number of cookie names that you can whitelist for each cache behavior, see CloudFront Limits in the General Reference.
- forward string
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNamescomplex type. Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for theForwardelement.
- whitelistedNames string[]
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Required if you specify whitelistfor the value ofForward. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies. If you specifyallornonefor the value ofForward, omitWhitelistedNames. If you change the value ofForwardfromwhitelisttoallornoneand you don't delete theWhitelistedNameselement and its child elements, CloudFront deletes them automatically. For the current limit on the number of cookie names that you can whitelist for each cache behavior, see CloudFront Limits in the General Reference.
- forward str
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNamescomplex type. Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for theForwardelement.
- whitelisted_names Sequence[str]
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Required if you specify whitelistfor the value ofForward. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies. If you specifyallornonefor the value ofForward, omitWhitelistedNames. If you change the value ofForwardfromwhitelisttoallornoneand you don't delete theWhitelistedNameselement and its child elements, CloudFront deletes them automatically. For the current limit on the number of cookie names that you can whitelist for each cache behavior, see CloudFront Limits in the General Reference.
- forward String
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Specifies which cookies to forward to the origin for this cache behavior: all, none, or the list of cookies specified in the WhitelistedNamescomplex type. Amazon S3 doesn't process cookies. When the cache behavior is forwarding requests to an Amazon S3 origin, specify none for theForwardelement.
- whitelistedNames List<String>
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Required if you specify whitelistfor the value ofForward. A complex type that specifies how many different cookies you want CloudFront to forward to the origin for this cache behavior and, if you want to forward selected cookies, the names of those cookies. If you specifyallornonefor the value ofForward, omitWhitelistedNames. If you change the value ofForwardfromwhitelisttoallornoneand you don't delete theWhitelistedNameselement and its child elements, CloudFront deletes them automatically. For the current limit on the number of cookie names that you can whitelist for each cache behavior, see CloudFront Limits in the General Reference.
DistributionCustomErrorResponse, DistributionCustomErrorResponseArgs        
A complex type that controls:
- Whether CloudFront replaces HTTP status codes in the 4xx and 5xx range with custom error messages before returning the response to the viewer.
- How long CloudFront caches HTTP status codes in the 4xx and 5xx range.
For more information about custom error pages, see Customizing Error Responses in the Amazon CloudFront Developer Guide.
- ErrorCode int
- The HTTP status code for which you want to specify a custom error page and/or a caching duration.
- ErrorCaching doubleMin Ttl 
- The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available. For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.
- ResponseCode int
- The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example: - Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.
- If you don't care about distinguishing among different client errors or server errors, you can specify 400or500as theResponseCodefor all 4xx or 5xx errors.
- You might want to return a 200status code (OK) and static website so your customers don't know that your website is down.
 - If you specify a value for - ResponseCode, you must also specify a value for- ResponsePagePath.
- Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 
- ResponsePage stringPath 
- The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by - ErrorCode, for example,- /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:- The value of PathPatternmatches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named/4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example,/4xx-errors/*.
- The value of TargetOriginIdspecifies the value of theIDelement for the origin that contains your custom error pages.
 - If you specify a value for - ResponsePagePath, you must also specify a value for- ResponseCode. We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.
- The value of 
- ErrorCode int
- The HTTP status code for which you want to specify a custom error page and/or a caching duration.
- ErrorCaching float64Min Ttl 
- The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available. For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.
- ResponseCode int
- The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example: - Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.
- If you don't care about distinguishing among different client errors or server errors, you can specify 400or500as theResponseCodefor all 4xx or 5xx errors.
- You might want to return a 200status code (OK) and static website so your customers don't know that your website is down.
 - If you specify a value for - ResponseCode, you must also specify a value for- ResponsePagePath.
- Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 
- ResponsePage stringPath 
- The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by - ErrorCode, for example,- /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:- The value of PathPatternmatches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named/4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example,/4xx-errors/*.
- The value of TargetOriginIdspecifies the value of theIDelement for the origin that contains your custom error pages.
 - If you specify a value for - ResponsePagePath, you must also specify a value for- ResponseCode. We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.
- The value of 
- errorCode Integer
- The HTTP status code for which you want to specify a custom error page and/or a caching duration.
- errorCaching DoubleMin Ttl 
- The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available. For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.
- responseCode Integer
- The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example: - Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.
- If you don't care about distinguishing among different client errors or server errors, you can specify 400or500as theResponseCodefor all 4xx or 5xx errors.
- You might want to return a 200status code (OK) and static website so your customers don't know that your website is down.
 - If you specify a value for - ResponseCode, you must also specify a value for- ResponsePagePath.
- Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 
- responsePage StringPath 
- The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by - ErrorCode, for example,- /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:- The value of PathPatternmatches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named/4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example,/4xx-errors/*.
- The value of TargetOriginIdspecifies the value of theIDelement for the origin that contains your custom error pages.
 - If you specify a value for - ResponsePagePath, you must also specify a value for- ResponseCode. We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.
- The value of 
- errorCode number
- The HTTP status code for which you want to specify a custom error page and/or a caching duration.
- errorCaching numberMin Ttl 
- The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available. For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.
- responseCode number
- The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example: - Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.
- If you don't care about distinguishing among different client errors or server errors, you can specify 400or500as theResponseCodefor all 4xx or 5xx errors.
- You might want to return a 200status code (OK) and static website so your customers don't know that your website is down.
 - If you specify a value for - ResponseCode, you must also specify a value for- ResponsePagePath.
- Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 
- responsePage stringPath 
- The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by - ErrorCode, for example,- /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:- The value of PathPatternmatches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named/4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example,/4xx-errors/*.
- The value of TargetOriginIdspecifies the value of theIDelement for the origin that contains your custom error pages.
 - If you specify a value for - ResponsePagePath, you must also specify a value for- ResponseCode. We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.
- The value of 
- error_code int
- The HTTP status code for which you want to specify a custom error page and/or a caching duration.
- error_caching_ floatmin_ ttl 
- The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available. For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.
- response_code int
- The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example: - Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.
- If you don't care about distinguishing among different client errors or server errors, you can specify 400or500as theResponseCodefor all 4xx or 5xx errors.
- You might want to return a 200status code (OK) and static website so your customers don't know that your website is down.
 - If you specify a value for - ResponseCode, you must also specify a value for- ResponsePagePath.
- Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 
- response_page_ strpath 
- The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by - ErrorCode, for example,- /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:- The value of PathPatternmatches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named/4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example,/4xx-errors/*.
- The value of TargetOriginIdspecifies the value of theIDelement for the origin that contains your custom error pages.
 - If you specify a value for - ResponsePagePath, you must also specify a value for- ResponseCode. We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.
- The value of 
- errorCode Number
- The HTTP status code for which you want to specify a custom error page and/or a caching duration.
- errorCaching NumberMin Ttl 
- The minimum amount of time, in seconds, that you want CloudFront to cache the HTTP status code specified in ErrorCode. When this time period has elapsed, CloudFront queries your origin to see whether the problem that caused the error has been resolved and the requested object is now available. For more information, see Customizing Error Responses in the Amazon CloudFront Developer Guide.
- responseCode Number
- The HTTP status code that you want CloudFront to return to the viewer along with the custom error page. There are a variety of reasons that you might want CloudFront to return a status code different from the status code that your origin returned to CloudFront, for example: - Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 200, the response typically won't be intercepted.
- If you don't care about distinguishing among different client errors or server errors, you can specify 400or500as theResponseCodefor all 4xx or 5xx errors.
- You might want to return a 200status code (OK) and static website so your customers don't know that your website is down.
 - If you specify a value for - ResponseCode, you must also specify a value for- ResponsePagePath.
- Some Internet devices (some firewalls and corporate proxies, for example) intercept HTTP 4xx and 5xx and prevent the response from being returned to the viewer. If you substitute 
- responsePage StringPath 
- The path to the custom error page that you want CloudFront to return to a viewer when your origin returns the HTTP status code specified by - ErrorCode, for example,- /4xx-errors/403-forbidden.html. If you want to store your objects and your custom error pages in different locations, your distribution must include a cache behavior for which the following is true:- The value of PathPatternmatches the path to your custom error messages. For example, suppose you saved custom error pages for 4xx errors in an Amazon S3 bucket in a directory named/4xx-errors. Your distribution must include a cache behavior for which the path pattern routes requests for your custom error pages to that location, for example,/4xx-errors/*.
- The value of TargetOriginIdspecifies the value of theIDelement for the origin that contains your custom error pages.
 - If you specify a value for - ResponsePagePath, you must also specify a value for- ResponseCode. We recommend that you store custom error pages in an Amazon S3 bucket. If you store custom error pages on an HTTP server and the server starts to return 5xx errors, CloudFront can't get the files that you want to return to viewers because the origin server is unavailable.
- The value of 
DistributionCustomOriginConfig, DistributionCustomOriginConfigArgs        
A custom origin. A custom origin is any origin that is not an Amazon S3 bucket, with one exception. An Amazon S3 bucket that is configured with static website hostingis a custom origin.- OriginProtocol stringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. Valid values are:- http-only– CloudFront always uses HTTP to connect to the origin.
- match-viewer– CloudFront connects to the origin using the same protocol that the viewer used to connect to CloudFront.
- https-only– CloudFront always uses HTTPS to connect to the origin.
 
- HttpPort int
- The HTTP port that CloudFront uses to connect to the origin. Specify the HTTP port that the origin listens on.
- HttpsPort int
- The HTTPS port that CloudFront uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- IpAddress Pulumi.Type Aws Native. Cloud Front. Distribution Custom Origin Config Ip Address Type 
- Specifies which IP protocol CloudFront uses when connecting to your origin. If your origin uses both IPv4 and IPv6 protocols, you can choose dualstackto help optimize reliability.
- OriginKeepalive intTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- OriginRead intTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- OriginSsl List<string>Protocols 
- Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin over HTTPS. Valid values include SSLv3,TLSv1,TLSv1.1, andTLSv1.2. For more information, see Minimum Origin SSL Protocol in the Amazon CloudFront Developer Guide.
- OriginProtocol stringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. Valid values are:- http-only– CloudFront always uses HTTP to connect to the origin.
- match-viewer– CloudFront connects to the origin using the same protocol that the viewer used to connect to CloudFront.
- https-only– CloudFront always uses HTTPS to connect to the origin.
 
- HttpPort int
- The HTTP port that CloudFront uses to connect to the origin. Specify the HTTP port that the origin listens on.
- HttpsPort int
- The HTTPS port that CloudFront uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- IpAddress DistributionType Custom Origin Config Ip Address Type 
- Specifies which IP protocol CloudFront uses when connecting to your origin. If your origin uses both IPv4 and IPv6 protocols, you can choose dualstackto help optimize reliability.
- OriginKeepalive intTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- OriginRead intTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- OriginSsl []stringProtocols 
- Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin over HTTPS. Valid values include SSLv3,TLSv1,TLSv1.1, andTLSv1.2. For more information, see Minimum Origin SSL Protocol in the Amazon CloudFront Developer Guide.
- originProtocol StringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. Valid values are:- http-only– CloudFront always uses HTTP to connect to the origin.
- match-viewer– CloudFront connects to the origin using the same protocol that the viewer used to connect to CloudFront.
- https-only– CloudFront always uses HTTPS to connect to the origin.
 
- httpPort Integer
- The HTTP port that CloudFront uses to connect to the origin. Specify the HTTP port that the origin listens on.
- httpsPort Integer
- The HTTPS port that CloudFront uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- ipAddress DistributionType Custom Origin Config Ip Address Type 
- Specifies which IP protocol CloudFront uses when connecting to your origin. If your origin uses both IPv4 and IPv6 protocols, you can choose dualstackto help optimize reliability.
- originKeepalive IntegerTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- originRead IntegerTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- originSsl List<String>Protocols 
- Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin over HTTPS. Valid values include SSLv3,TLSv1,TLSv1.1, andTLSv1.2. For more information, see Minimum Origin SSL Protocol in the Amazon CloudFront Developer Guide.
- originProtocol stringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. Valid values are:- http-only– CloudFront always uses HTTP to connect to the origin.
- match-viewer– CloudFront connects to the origin using the same protocol that the viewer used to connect to CloudFront.
- https-only– CloudFront always uses HTTPS to connect to the origin.
 
- httpPort number
- The HTTP port that CloudFront uses to connect to the origin. Specify the HTTP port that the origin listens on.
- httpsPort number
- The HTTPS port that CloudFront uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- ipAddress DistributionType Custom Origin Config Ip Address Type 
- Specifies which IP protocol CloudFront uses when connecting to your origin. If your origin uses both IPv4 and IPv6 protocols, you can choose dualstackto help optimize reliability.
- originKeepalive numberTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- originRead numberTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- originSsl string[]Protocols 
- Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin over HTTPS. Valid values include SSLv3,TLSv1,TLSv1.1, andTLSv1.2. For more information, see Minimum Origin SSL Protocol in the Amazon CloudFront Developer Guide.
- origin_protocol_ strpolicy 
- Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. Valid values are:- http-only– CloudFront always uses HTTP to connect to the origin.
- match-viewer– CloudFront connects to the origin using the same protocol that the viewer used to connect to CloudFront.
- https-only– CloudFront always uses HTTPS to connect to the origin.
 
- http_port int
- The HTTP port that CloudFront uses to connect to the origin. Specify the HTTP port that the origin listens on.
- https_port int
- The HTTPS port that CloudFront uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- ip_address_ Distributiontype Custom Origin Config Ip Address Type 
- Specifies which IP protocol CloudFront uses when connecting to your origin. If your origin uses both IPv4 and IPv6 protocols, you can choose dualstackto help optimize reliability.
- origin_keepalive_ inttimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- origin_read_ inttimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- origin_ssl_ Sequence[str]protocols 
- Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin over HTTPS. Valid values include SSLv3,TLSv1,TLSv1.1, andTLSv1.2. For more information, see Minimum Origin SSL Protocol in the Amazon CloudFront Developer Guide.
- originProtocol StringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CloudFront uses to connect to the origin. Valid values are:- http-only– CloudFront always uses HTTP to connect to the origin.
- match-viewer– CloudFront connects to the origin using the same protocol that the viewer used to connect to CloudFront.
- https-only– CloudFront always uses HTTPS to connect to the origin.
 
- httpPort Number
- The HTTP port that CloudFront uses to connect to the origin. Specify the HTTP port that the origin listens on.
- httpsPort Number
- The HTTPS port that CloudFront uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- ipAddress "ipv4" | "ipv6" | "dualstack"Type 
- Specifies which IP protocol CloudFront uses when connecting to your origin. If your origin uses both IPv4 and IPv6 protocols, you can choose dualstackto help optimize reliability.
- originKeepalive NumberTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- originRead NumberTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- originSsl List<String>Protocols 
- Specifies the minimum SSL/TLS protocol that CloudFront uses when connecting to your origin over HTTPS. Valid values include SSLv3,TLSv1,TLSv1.1, andTLSv1.2. For more information, see Minimum Origin SSL Protocol in the Amazon CloudFront Developer Guide.
DistributionCustomOriginConfigIpAddressType, DistributionCustomOriginConfigIpAddressTypeArgs              
- Ipv4
- ipv4
- Ipv6
- ipv6
- Dualstack
- dualstack
- DistributionCustom Origin Config Ip Address Type Ipv4 
- ipv4
- DistributionCustom Origin Config Ip Address Type Ipv6 
- ipv6
- DistributionCustom Origin Config Ip Address Type Dualstack 
- dualstack
- Ipv4
- ipv4
- Ipv6
- ipv6
- Dualstack
- dualstack
- Ipv4
- ipv4
- Ipv6
- ipv6
- Dualstack
- dualstack
- IPV4
- ipv4
- IPV6
- ipv6
- DUALSTACK
- dualstack
- "ipv4"
- ipv4
- "ipv6"
- ipv6
- "dualstack"
- dualstack
DistributionDefaultCacheBehavior, DistributionDefaultCacheBehaviorArgs        
A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if request URLs don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.
If your minimum TTL is greater than 0, CloudFront will cache content for at least the duration specified in the cache policy's minimum TTL, even if the Cache-Control: no-cache, no-store, or private directives are present in the origin headers.- TargetOrigin stringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they use the default cache behavior.
- ViewerProtocol stringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- AllowedMethods List<string>
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- CachePolicy stringId 
- The unique identifier of the cache policy that is attached to the default cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- CachedMethods List<string>
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- Compress bool
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specifyfalse. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- DefaultTtl double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- FieldLevel stringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for the default cache behavior.
- ForwardedValues Pulumi.Aws Native. Cloud Front. Inputs. Distribution Forwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- FunctionAssociations List<Pulumi.Aws Native. Cloud Front. Inputs. Distribution Function Association> 
- A list of CloudFront functions that are associated with this cache behavior. Your functions must be published to the LIVEstage to associate them with a cache behavior.
- GrpcConfig Pulumi.Aws Native. Cloud Front. Inputs. Distribution Grpc Config 
- The gRPC configuration for your cache behavior.
- LambdaFunction List<Pulumi.Associations Aws Native. Cloud Front. Inputs. Distribution Lambda Function Association> 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- MaxTtl double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- MinTtl double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- OriginRequest stringPolicy Id 
- The unique identifier of the origin request policy that is attached to the default cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- RealtimeLog stringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- ResponseHeaders stringPolicy Id 
- The identifier for a response headers policy.
- SmoothStreaming bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- TrustedKey List<string>Groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- TrustedSigners List<string>
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in a trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- TargetOrigin stringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they use the default cache behavior.
- ViewerProtocol stringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- AllowedMethods []string
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- CachePolicy stringId 
- The unique identifier of the cache policy that is attached to the default cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- CachedMethods []string
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- Compress bool
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specifyfalse. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- DefaultTtl float64
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- FieldLevel stringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for the default cache behavior.
- ForwardedValues DistributionForwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- FunctionAssociations []DistributionFunction Association 
- A list of CloudFront functions that are associated with this cache behavior. Your functions must be published to the LIVEstage to associate them with a cache behavior.
- GrpcConfig DistributionGrpc Config 
- The gRPC configuration for your cache behavior.
- LambdaFunction []DistributionAssociations Lambda Function Association 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- MaxTtl float64
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- MinTtl float64
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- OriginRequest stringPolicy Id 
- The unique identifier of the origin request policy that is attached to the default cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- RealtimeLog stringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- ResponseHeaders stringPolicy Id 
- The identifier for a response headers policy.
- SmoothStreaming bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- TrustedKey []stringGroups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- TrustedSigners []string
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in a trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- targetOrigin StringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they use the default cache behavior.
- viewerProtocol StringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- allowedMethods List<String>
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- cachePolicy StringId 
- The unique identifier of the cache policy that is attached to the default cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- cachedMethods List<String>
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- compress Boolean
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specifyfalse. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- defaultTtl Double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- fieldLevel StringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for the default cache behavior.
- forwardedValues DistributionForwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- functionAssociations List<DistributionFunction Association> 
- A list of CloudFront functions that are associated with this cache behavior. Your functions must be published to the LIVEstage to associate them with a cache behavior.
- grpcConfig DistributionGrpc Config 
- The gRPC configuration for your cache behavior.
- lambdaFunction List<DistributionAssociations Lambda Function Association> 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- maxTtl Double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- minTtl Double
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- originRequest StringPolicy Id 
- The unique identifier of the origin request policy that is attached to the default cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- realtimeLog StringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- responseHeaders StringPolicy Id 
- The identifier for a response headers policy.
- smoothStreaming Boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- trustedKey List<String>Groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- trustedSigners List<String>
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in a trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- targetOrigin stringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they use the default cache behavior.
- viewerProtocol stringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- allowedMethods string[]
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- cachePolicy stringId 
- The unique identifier of the cache policy that is attached to the default cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- cachedMethods string[]
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- compress boolean
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specifyfalse. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- defaultTtl number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- fieldLevel stringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for the default cache behavior.
- forwardedValues DistributionForwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- functionAssociations DistributionFunction Association[] 
- A list of CloudFront functions that are associated with this cache behavior. Your functions must be published to the LIVEstage to associate them with a cache behavior.
- grpcConfig DistributionGrpc Config 
- The gRPC configuration for your cache behavior.
- lambdaFunction DistributionAssociations Lambda Function Association[] 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- maxTtl number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- minTtl number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- originRequest stringPolicy Id 
- The unique identifier of the origin request policy that is attached to the default cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- realtimeLog stringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- responseHeaders stringPolicy Id 
- The identifier for a response headers policy.
- smoothStreaming boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- trustedKey string[]Groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- trustedSigners string[]
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in a trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- target_origin_ strid 
- The value of IDfor the origin that you want CloudFront to route requests to when they use the default cache behavior.
- viewer_protocol_ strpolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- allowed_methods Sequence[str]
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- cache_policy_ strid 
- The unique identifier of the cache policy that is attached to the default cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- cached_methods Sequence[str]
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- compress bool
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specifyfalse. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- default_ttl float
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- field_level_ strencryption_ id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for the default cache behavior.
- forwarded_values DistributionForwarded Values 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- function_associations Sequence[DistributionFunction Association] 
- A list of CloudFront functions that are associated with this cache behavior. Your functions must be published to the LIVEstage to associate them with a cache behavior.
- grpc_config DistributionGrpc Config 
- The gRPC configuration for your cache behavior.
- lambda_function_ Sequence[Distributionassociations Lambda Function Association] 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- max_ttl float
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- min_ttl float
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- origin_request_ strpolicy_ id 
- The unique identifier of the origin request policy that is attached to the default cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- realtime_log_ strconfig_ arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- response_headers_ strpolicy_ id 
- The identifier for a response headers policy.
- smooth_streaming bool
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- trusted_key_ Sequence[str]groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- trusted_signers Sequence[str]
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in a trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- targetOrigin StringId 
- The value of IDfor the origin that you want CloudFront to route requests to when they use the default cache behavior.
- viewerProtocol StringPolicy 
- The protocol that viewers can use to access the files in the origin specified by - TargetOriginIdwhen a request matches the path pattern in- PathPattern. You can specify the following options:- allow-all: Viewers can use HTTP or HTTPS.
- redirect-to-https: If a viewer submits an HTTP request, CloudFront returns an HTTP status code of 301 (Moved Permanently) to the viewer along with the HTTPS URL. The viewer then resubmits the request using the new URL.
- https-only: If a viewer sends an HTTP request, CloudFront returns an HTTP status code of 403 (Forbidden).
 - For more information about requiring the HTTPS protocol, see Requiring HTTPS Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. The only way to guarantee that viewers retrieve an object that was fetched from the origin using HTTPS is never to use any other protocol to fetch the object. If you have recently changed from HTTP to HTTPS, we recommend that you clear your objects' cache because cached objects are protocol agnostic. That means that an edge location will return an object from the cache regardless of whether the current request protocol matches the protocol used previously. For more information, see Managing Cache Expiration in the Amazon CloudFront Developer Guide. 
- allowedMethods List<String>
- A complex type that controls which HTTP methods CloudFront processes and forwards to your Amazon S3 bucket or your custom origin. There are three choices: - CloudFront forwards only GETandHEADrequests.
- CloudFront forwards only GET,HEAD, andOPTIONSrequests.
- CloudFront forwards GET, HEAD, OPTIONS, PUT, PATCH, POST, andDELETErequests.
 - If you pick the third choice, you may need to restrict access to your Amazon S3 bucket or to your custom origin so users can't perform operations that you don't want them to. For example, you might not want users to have permissions to delete objects from your origin. 
- CloudFront forwards only 
- cachePolicy StringId 
- The unique identifier of the cache policy that is attached to the default cache behavior. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId.
- cachedMethods List<String>
- A complex type that controls whether CloudFront caches the response to requests using the specified HTTP methods. There are two choices: - CloudFront caches responses to GETandHEADrequests.
- CloudFront caches responses to GET,HEAD, andOPTIONSrequests.
 - If you pick the second choice for your Amazon S3 Origin, you may need to forward Access-Control-Request-Method, Access-Control-Request-Headers, and Origin headers for the responses to be cached correctly. 
- CloudFront caches responses to 
- compress Boolean
- Whether you want CloudFront to automatically compress certain files for this cache behavior. If so, specify true; if not, specifyfalse. For more information, see Serving Compressed Files in the Amazon CloudFront Developer Guide.
- defaultTtl Number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the DefaultTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The default amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin does not add HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- fieldLevel StringEncryption Id 
- The value of IDfor the field-level encryption configuration that you want CloudFront to use for encrypting specific fields of data for the default cache behavior.
- forwardedValues Property Map
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. For more information, see Working with policies in the Amazon CloudFront Developer Guide.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
A DefaultCacheBehaviormust include either aCachePolicyIdorForwardedValues. We recommend that you use aCachePolicyId. A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.
- functionAssociations List<Property Map>
- A list of CloudFront functions that are associated with this cache behavior. Your functions must be published to the LIVEstage to associate them with a cache behavior.
- grpcConfig Property Map
- The gRPC configuration for your cache behavior.
- lambdaFunction List<Property Map>Associations 
- A complex type that contains zero or more Lambda@Edge function associations for a cache behavior.
- maxTtl Number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MaxTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The maximum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. The value that you specify applies only when your origin adds HTTP headers such asCache-Control max-age,Cache-Control s-maxage, andExpiresto objects. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide.
- minTtl Number
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use the MinTTLfield in a cache policy instead of this field. For more information, see Creating cache policies or Using the managed cache policies in the Amazon CloudFront Developer Guide. The minimum amount of time that you want objects to stay in CloudFront caches before CloudFront forwards another request to your origin to determine whether the object has been updated. For more information, see Managing How Long Content Stays in an Edge Cache (Expiration) in the Amazon CloudFront Developer Guide. You must specify0forMinTTLif you configure CloudFront to forward all headers to your origin (underHeaders, if you specify1forQuantityand*forName).
- originRequest StringPolicy Id 
- The unique identifier of the origin request policy that is attached to the default cache behavior. For more information, see Creating origin request policies or Using the managed origin request policies in the Amazon CloudFront Developer Guide.
- realtimeLog StringConfig Arn 
- The Amazon Resource Name (ARN) of the real-time log configuration that is attached to this cache behavior. For more information, see Real-time logs in the Amazon CloudFront Developer Guide.
- responseHeaders StringPolicy Id 
- The identifier for a response headers policy.
- smoothStreaming Boolean
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
Indicates whether you want to distribute media files in the Microsoft Smooth Streaming format using the origin that is associated with this cache behavior. If so, specify true; if not, specifyfalse. If you specifytrueforSmoothStreaming, you can still distribute other content using this cache behavior if the content matches the value ofPathPattern.
- trustedKey List<String>Groups 
- A list of key groups that CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted key groups, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with a private key whose corresponding public key is in the key group. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
- trustedSigners List<String>
- We recommend using TrustedKeyGroupsinstead ofTrustedSigners. This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide. A list of AWS-account IDs whose public keys CloudFront can use to validate signed URLs or signed cookies. When a cache behavior contains trusted signers, CloudFront requires signed URLs or signed cookies for all requests that match the cache behavior. The URLs or cookies must be signed with the private key of a CloudFront key pair in a trusted signer's AWS-account. The signed URL or cookie contains information about which public key CloudFront should use to verify the signature. For more information, see Serving private content in the Amazon CloudFront Developer Guide.
DistributionForwardedValues, DistributionForwardedValuesArgs      
This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include values in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send values to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
A complex type that specifies how CloudFront handles query strings, cookies, and HTTP headers.- QueryString bool
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryStringand on the values that you specify forQueryStringCacheKeys, if any: If you specify true forQueryStringand you don't specify any values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin. If you specify true forQueryStringand you specify one or more values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify. If you specify false forQueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters. For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.
- 
Pulumi.Aws Native. Cloud Front. Inputs. Distribution Cookies 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.
- Headers List<string>
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include headers in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send headers to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
A complex type that specifies the Headers, if any, that you want CloudFront to forward to the origin for this cache behavior (whitelisted headers). For the headers that you specify, CloudFront also caches separate versions of a specified object that is based on the header values in viewer requests. For more information, see Caching Content Based on Request Headers in the Amazon CloudFront Developer Guide.
- QueryString List<string>Cache Keys 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.
- QueryString bool
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryStringand on the values that you specify forQueryStringCacheKeys, if any: If you specify true forQueryStringand you don't specify any values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin. If you specify true forQueryStringand you specify one or more values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify. If you specify false forQueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters. For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.
- 
DistributionCookies 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.
- Headers []string
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include headers in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send headers to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
A complex type that specifies the Headers, if any, that you want CloudFront to forward to the origin for this cache behavior (whitelisted headers). For the headers that you specify, CloudFront also caches separate versions of a specified object that is based on the header values in viewer requests. For more information, see Caching Content Based on Request Headers in the Amazon CloudFront Developer Guide.
- QueryString []stringCache Keys 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.
- queryString Boolean
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryStringand on the values that you specify forQueryStringCacheKeys, if any: If you specify true forQueryStringand you don't specify any values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin. If you specify true forQueryStringand you specify one or more values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify. If you specify false forQueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters. For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.
- 
DistributionCookies 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.
- headers List<String>
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include headers in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send headers to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
A complex type that specifies the Headers, if any, that you want CloudFront to forward to the origin for this cache behavior (whitelisted headers). For the headers that you specify, CloudFront also caches separate versions of a specified object that is based on the header values in viewer requests. For more information, see Caching Content Based on Request Headers in the Amazon CloudFront Developer Guide.
- queryString List<String>Cache Keys 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.
- queryString boolean
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryStringand on the values that you specify forQueryStringCacheKeys, if any: If you specify true forQueryStringand you don't specify any values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin. If you specify true forQueryStringand you specify one or more values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify. If you specify false forQueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters. For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.
- 
DistributionCookies 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.
- headers string[]
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include headers in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send headers to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
A complex type that specifies the Headers, if any, that you want CloudFront to forward to the origin for this cache behavior (whitelisted headers). For the headers that you specify, CloudFront also caches separate versions of a specified object that is based on the header values in viewer requests. For more information, see Caching Content Based on Request Headers in the Amazon CloudFront Developer Guide.
- queryString string[]Cache Keys 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.
- query_string bool
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryStringand on the values that you specify forQueryStringCacheKeys, if any: If you specify true forQueryStringand you don't specify any values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin. If you specify true forQueryStringand you specify one or more values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify. If you specify false forQueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters. For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.
- 
DistributionCookies 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.
- headers Sequence[str]
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include headers in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send headers to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
A complex type that specifies the Headers, if any, that you want CloudFront to forward to the origin for this cache behavior (whitelisted headers). For the headers that you specify, CloudFront also caches separate versions of a specified object that is based on the header values in viewer requests. For more information, see Caching Content Based on Request Headers in the Amazon CloudFront Developer Guide.
- query_string_ Sequence[str]cache_ keys 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.
- queryString Boolean
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
Indicates whether you want CloudFront to forward query strings to the origin that is associated with this cache behavior and cache based on the query string parameters. CloudFront behavior depends on the value of QueryStringand on the values that you specify forQueryStringCacheKeys, if any: If you specify true forQueryStringand you don't specify any values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin and caches based on all query string parameters. Depending on how many query string parameters and values you have, this can adversely affect performance because CloudFront must forward more requests to the origin. If you specify true forQueryStringand you specify one or more values forQueryStringCacheKeys, CloudFront forwards all query string parameters to the origin, but it only caches based on the query string parameters that you specify. If you specify false forQueryString, CloudFront doesn't forward any query string parameters to the origin, and doesn't cache based on query string parameters. For more information, see Configuring CloudFront to Cache Based on Query String Parameters in the Amazon CloudFront Developer Guide.
- Property Map
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include cookies in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send cookies to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that specifies whether you want CloudFront to forward cookies to the origin and, if so, which ones. For more information about forwarding cookies to the origin, see How CloudFront Forwards, Caches, and Logs Cookies in the Amazon CloudFront Developer Guide.
- headers List<String>
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field.
If you want to include headers in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide.
If you want to send headers to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide.
A complex type that specifies the Headers, if any, that you want CloudFront to forward to the origin for this cache behavior (whitelisted headers). For the headers that you specify, CloudFront also caches separate versions of a specified object that is based on the header values in viewer requests. For more information, see Caching Content Based on Request Headers in the Amazon CloudFront Developer Guide.
- queryString List<String>Cache Keys 
- This field is deprecated. We recommend that you use a cache policy or an origin request policy instead of this field. If you want to include query strings in the cache key, use a cache policy. For more information, see Creating cache policies in the Amazon CloudFront Developer Guide. If you want to send query strings to the origin but not include them in the cache key, use an origin request policy. For more information, see Creating origin request policies in the Amazon CloudFront Developer Guide. A complex type that contains information about the query string parameters that you want CloudFront to use for caching for this cache behavior.
DistributionFunctionAssociation, DistributionFunctionAssociationArgs      
A CloudFront function that is associated with a cache behavior in a CloudFront distribution.- EventType string
- The event type of the function, either viewer-requestorviewer-response. You cannot use origin-facing event types (origin-requestandorigin-response) with a CloudFront function.
- FunctionArn string
- The Amazon Resource Name (ARN) of the function.
- EventType string
- The event type of the function, either viewer-requestorviewer-response. You cannot use origin-facing event types (origin-requestandorigin-response) with a CloudFront function.
- FunctionArn string
- The Amazon Resource Name (ARN) of the function.
- eventType String
- The event type of the function, either viewer-requestorviewer-response. You cannot use origin-facing event types (origin-requestandorigin-response) with a CloudFront function.
- functionArn String
- The Amazon Resource Name (ARN) of the function.
- eventType string
- The event type of the function, either viewer-requestorviewer-response. You cannot use origin-facing event types (origin-requestandorigin-response) with a CloudFront function.
- functionArn string
- The Amazon Resource Name (ARN) of the function.
- event_type str
- The event type of the function, either viewer-requestorviewer-response. You cannot use origin-facing event types (origin-requestandorigin-response) with a CloudFront function.
- function_arn str
- The Amazon Resource Name (ARN) of the function.
- eventType String
- The event type of the function, either viewer-requestorviewer-response. You cannot use origin-facing event types (origin-requestandorigin-response) with a CloudFront function.
- functionArn String
- The Amazon Resource Name (ARN) of the function.
DistributionGeoRestriction, DistributionGeoRestrictionArgs      
A complex type that controls the countries in which your content is distributed. CF determines the location of your users using MaxMind GeoIP databases. To disable geo restriction, remove the Restrictions property from your stack template.- RestrictionType string
- The method that you want to use to restrict distribution of your content by country:- none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.
- blacklist: The- Locationelements specify the countries in which you don't want CloudFront to distribute your content.
- whitelist: The- Locationelements specify the countries in which you want CloudFront to distribute your content.
 
- Locations List<string>
- A complex type that contains a Locationelement for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). TheLocationelement is a two-letter, uppercase country code for a country that you want to include in yourblacklistorwhitelist. Include oneLocationelement for each country. CloudFront andMaxMindboth useISO 3166country codes. For the current list of countries and the corresponding codes, seeISO 3166-1-alpha-2code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.
- RestrictionType string
- The method that you want to use to restrict distribution of your content by country:- none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.
- blacklist: The- Locationelements specify the countries in which you don't want CloudFront to distribute your content.
- whitelist: The- Locationelements specify the countries in which you want CloudFront to distribute your content.
 
- Locations []string
- A complex type that contains a Locationelement for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). TheLocationelement is a two-letter, uppercase country code for a country that you want to include in yourblacklistorwhitelist. Include oneLocationelement for each country. CloudFront andMaxMindboth useISO 3166country codes. For the current list of countries and the corresponding codes, seeISO 3166-1-alpha-2code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.
- restrictionType String
- The method that you want to use to restrict distribution of your content by country:- none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.
- blacklist: The- Locationelements specify the countries in which you don't want CloudFront to distribute your content.
- whitelist: The- Locationelements specify the countries in which you want CloudFront to distribute your content.
 
- locations List<String>
- A complex type that contains a Locationelement for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). TheLocationelement is a two-letter, uppercase country code for a country that you want to include in yourblacklistorwhitelist. Include oneLocationelement for each country. CloudFront andMaxMindboth useISO 3166country codes. For the current list of countries and the corresponding codes, seeISO 3166-1-alpha-2code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.
- restrictionType string
- The method that you want to use to restrict distribution of your content by country:- none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.
- blacklist: The- Locationelements specify the countries in which you don't want CloudFront to distribute your content.
- whitelist: The- Locationelements specify the countries in which you want CloudFront to distribute your content.
 
- locations string[]
- A complex type that contains a Locationelement for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). TheLocationelement is a two-letter, uppercase country code for a country that you want to include in yourblacklistorwhitelist. Include oneLocationelement for each country. CloudFront andMaxMindboth useISO 3166country codes. For the current list of countries and the corresponding codes, seeISO 3166-1-alpha-2code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.
- restriction_type str
- The method that you want to use to restrict distribution of your content by country:- none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.
- blacklist: The- Locationelements specify the countries in which you don't want CloudFront to distribute your content.
- whitelist: The- Locationelements specify the countries in which you want CloudFront to distribute your content.
 
- locations Sequence[str]
- A complex type that contains a Locationelement for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). TheLocationelement is a two-letter, uppercase country code for a country that you want to include in yourblacklistorwhitelist. Include oneLocationelement for each country. CloudFront andMaxMindboth useISO 3166country codes. For the current list of countries and the corresponding codes, seeISO 3166-1-alpha-2code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.
- restrictionType String
- The method that you want to use to restrict distribution of your content by country:- none: No geo restriction is enabled, meaning access to content is not restricted by client geo location.
- blacklist: The- Locationelements specify the countries in which you don't want CloudFront to distribute your content.
- whitelist: The- Locationelements specify the countries in which you want CloudFront to distribute your content.
 
- locations List<String>
- A complex type that contains a Locationelement for each country in which you want CloudFront either to distribute your content (whitelist) or not distribute your content (blacklist). TheLocationelement is a two-letter, uppercase country code for a country that you want to include in yourblacklistorwhitelist. Include oneLocationelement for each country. CloudFront andMaxMindboth useISO 3166country codes. For the current list of countries and the corresponding codes, seeISO 3166-1-alpha-2code on the International Organization for Standardization website. You can also refer to the country list on the CloudFront console, which includes both country names and codes.
DistributionGrpcConfig, DistributionGrpcConfigArgs      
Amazon CloudFront supports gRPC, an open-source remote procedure call (RPC) framework built on HTTP/2. gRPC offers bi-directional streaming and binary protocol that buffers payloads, making it suitable for applications that require low latency communications.
To enable your distribution to handle gRPC requests, you must include HTTP/2 as one of the supported HTTP versions and allow HTTP methods, including POST.
For more information, see Using gRPC with CloudFront distributions in the Amazon CloudFront Developer Guide.- Enabled bool
- Enables your CloudFront distribution to receive gRPC requests and to proxy them directly to your origins.
- Enabled bool
- Enables your CloudFront distribution to receive gRPC requests and to proxy them directly to your origins.
- enabled Boolean
- Enables your CloudFront distribution to receive gRPC requests and to proxy them directly to your origins.
- enabled boolean
- Enables your CloudFront distribution to receive gRPC requests and to proxy them directly to your origins.
- enabled bool
- Enables your CloudFront distribution to receive gRPC requests and to proxy them directly to your origins.
- enabled Boolean
- Enables your CloudFront distribution to receive gRPC requests and to proxy them directly to your origins.
DistributionLambdaFunctionAssociation, DistributionLambdaFunctionAssociationArgs        
A complex type that contains a Lambda@Edge function association.- EventType string
- Specifies the event type that triggers a Lambda@Edge function invocation. You can specify the following values:- viewer-request: The function executes when CloudFront receives a request from a viewer and before it checks to see whether the requested object is in the edge cache.
- origin-request: The function executes only when CloudFront sends a request to your origin. When the requested object is in the edge cache, the function doesn't execute.
- origin-response: The function executes after CloudFront receives a response from the origin and before it caches the object in the response. When the requested object is in the edge cache, the function doesn't execute.
- viewer-response: The function executes before CloudFront returns the requested object to the viewer. The function executes regardless of whether the object was already in the edge cache. If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.
 
- IncludeBody bool
- A flag that allows a Lambda@Edge function to have read access to the body content. For more information, see Accessing the Request Body by Choosing the Include Body Option in the Amazon CloudFront Developer Guide.
- LambdaFunction stringArn 
- The ARN of the Lambda@Edge function. You must specify the ARN of a function version; you can't specify an alias or $LATEST.
- EventType string
- Specifies the event type that triggers a Lambda@Edge function invocation. You can specify the following values:- viewer-request: The function executes when CloudFront receives a request from a viewer and before it checks to see whether the requested object is in the edge cache.
- origin-request: The function executes only when CloudFront sends a request to your origin. When the requested object is in the edge cache, the function doesn't execute.
- origin-response: The function executes after CloudFront receives a response from the origin and before it caches the object in the response. When the requested object is in the edge cache, the function doesn't execute.
- viewer-response: The function executes before CloudFront returns the requested object to the viewer. The function executes regardless of whether the object was already in the edge cache. If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.
 
- IncludeBody bool
- A flag that allows a Lambda@Edge function to have read access to the body content. For more information, see Accessing the Request Body by Choosing the Include Body Option in the Amazon CloudFront Developer Guide.
- LambdaFunction stringArn 
- The ARN of the Lambda@Edge function. You must specify the ARN of a function version; you can't specify an alias or $LATEST.
- eventType String
- Specifies the event type that triggers a Lambda@Edge function invocation. You can specify the following values:- viewer-request: The function executes when CloudFront receives a request from a viewer and before it checks to see whether the requested object is in the edge cache.
- origin-request: The function executes only when CloudFront sends a request to your origin. When the requested object is in the edge cache, the function doesn't execute.
- origin-response: The function executes after CloudFront receives a response from the origin and before it caches the object in the response. When the requested object is in the edge cache, the function doesn't execute.
- viewer-response: The function executes before CloudFront returns the requested object to the viewer. The function executes regardless of whether the object was already in the edge cache. If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.
 
- includeBody Boolean
- A flag that allows a Lambda@Edge function to have read access to the body content. For more information, see Accessing the Request Body by Choosing the Include Body Option in the Amazon CloudFront Developer Guide.
- lambdaFunction StringArn 
- The ARN of the Lambda@Edge function. You must specify the ARN of a function version; you can't specify an alias or $LATEST.
- eventType string
- Specifies the event type that triggers a Lambda@Edge function invocation. You can specify the following values:- viewer-request: The function executes when CloudFront receives a request from a viewer and before it checks to see whether the requested object is in the edge cache.
- origin-request: The function executes only when CloudFront sends a request to your origin. When the requested object is in the edge cache, the function doesn't execute.
- origin-response: The function executes after CloudFront receives a response from the origin and before it caches the object in the response. When the requested object is in the edge cache, the function doesn't execute.
- viewer-response: The function executes before CloudFront returns the requested object to the viewer. The function executes regardless of whether the object was already in the edge cache. If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.
 
- includeBody boolean
- A flag that allows a Lambda@Edge function to have read access to the body content. For more information, see Accessing the Request Body by Choosing the Include Body Option in the Amazon CloudFront Developer Guide.
- lambdaFunction stringArn 
- The ARN of the Lambda@Edge function. You must specify the ARN of a function version; you can't specify an alias or $LATEST.
- event_type str
- Specifies the event type that triggers a Lambda@Edge function invocation. You can specify the following values:- viewer-request: The function executes when CloudFront receives a request from a viewer and before it checks to see whether the requested object is in the edge cache.
- origin-request: The function executes only when CloudFront sends a request to your origin. When the requested object is in the edge cache, the function doesn't execute.
- origin-response: The function executes after CloudFront receives a response from the origin and before it caches the object in the response. When the requested object is in the edge cache, the function doesn't execute.
- viewer-response: The function executes before CloudFront returns the requested object to the viewer. The function executes regardless of whether the object was already in the edge cache. If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.
 
- include_body bool
- A flag that allows a Lambda@Edge function to have read access to the body content. For more information, see Accessing the Request Body by Choosing the Include Body Option in the Amazon CloudFront Developer Guide.
- lambda_function_ strarn 
- The ARN of the Lambda@Edge function. You must specify the ARN of a function version; you can't specify an alias or $LATEST.
- eventType String
- Specifies the event type that triggers a Lambda@Edge function invocation. You can specify the following values:- viewer-request: The function executes when CloudFront receives a request from a viewer and before it checks to see whether the requested object is in the edge cache.
- origin-request: The function executes only when CloudFront sends a request to your origin. When the requested object is in the edge cache, the function doesn't execute.
- origin-response: The function executes after CloudFront receives a response from the origin and before it caches the object in the response. When the requested object is in the edge cache, the function doesn't execute.
- viewer-response: The function executes before CloudFront returns the requested object to the viewer. The function executes regardless of whether the object was already in the edge cache. If the origin returns an HTTP status code other than HTTP 200 (OK), the function doesn't execute.
 
- includeBody Boolean
- A flag that allows a Lambda@Edge function to have read access to the body content. For more information, see Accessing the Request Body by Choosing the Include Body Option in the Amazon CloudFront Developer Guide.
- lambdaFunction StringArn 
- The ARN of the Lambda@Edge function. You must specify the ARN of a function version; you can't specify an alias or $LATEST.
DistributionLegacyCustomOrigin, DistributionLegacyCustomOriginArgs        
A custom origin. A custom origin is any origin that is not an S3 bucket, with one exception. An S3 bucket that is configured with static website hostingis a custom origin.
This property is legacy. We recommend that you use Origin instead.- DnsName string
- The domain name assigned to your CF distribution.
- OriginProtocol stringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CF uses to connect to the origin.
- OriginSsl List<string>Protocols 
- The minimum SSL/TLS protocol version that CF uses when communicating with your origin server over HTTPs. For more information, see Minimum Origin SSL Protocol in the Developer Guide.
- HttpPort int
- The HTTP port that CF uses to connect to the origin. Specify the HTTP port that the origin listens on.
- HttpsPort int
- The HTTPS port that CF uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- DnsName string
- The domain name assigned to your CF distribution.
- OriginProtocol stringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CF uses to connect to the origin.
- OriginSsl []stringProtocols 
- The minimum SSL/TLS protocol version that CF uses when communicating with your origin server over HTTPs. For more information, see Minimum Origin SSL Protocol in the Developer Guide.
- HttpPort int
- The HTTP port that CF uses to connect to the origin. Specify the HTTP port that the origin listens on.
- HttpsPort int
- The HTTPS port that CF uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- dnsName String
- The domain name assigned to your CF distribution.
- originProtocol StringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CF uses to connect to the origin.
- originSsl List<String>Protocols 
- The minimum SSL/TLS protocol version that CF uses when communicating with your origin server over HTTPs. For more information, see Minimum Origin SSL Protocol in the Developer Guide.
- httpPort Integer
- The HTTP port that CF uses to connect to the origin. Specify the HTTP port that the origin listens on.
- httpsPort Integer
- The HTTPS port that CF uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- dnsName string
- The domain name assigned to your CF distribution.
- originProtocol stringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CF uses to connect to the origin.
- originSsl string[]Protocols 
- The minimum SSL/TLS protocol version that CF uses when communicating with your origin server over HTTPs. For more information, see Minimum Origin SSL Protocol in the Developer Guide.
- httpPort number
- The HTTP port that CF uses to connect to the origin. Specify the HTTP port that the origin listens on.
- httpsPort number
- The HTTPS port that CF uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- dns_name str
- The domain name assigned to your CF distribution.
- origin_protocol_ strpolicy 
- Specifies the protocol (HTTP or HTTPS) that CF uses to connect to the origin.
- origin_ssl_ Sequence[str]protocols 
- The minimum SSL/TLS protocol version that CF uses when communicating with your origin server over HTTPs. For more information, see Minimum Origin SSL Protocol in the Developer Guide.
- http_port int
- The HTTP port that CF uses to connect to the origin. Specify the HTTP port that the origin listens on.
- https_port int
- The HTTPS port that CF uses to connect to the origin. Specify the HTTPS port that the origin listens on.
- dnsName String
- The domain name assigned to your CF distribution.
- originProtocol StringPolicy 
- Specifies the protocol (HTTP or HTTPS) that CF uses to connect to the origin.
- originSsl List<String>Protocols 
- The minimum SSL/TLS protocol version that CF uses when communicating with your origin server over HTTPs. For more information, see Minimum Origin SSL Protocol in the Developer Guide.
- httpPort Number
- The HTTP port that CF uses to connect to the origin. Specify the HTTP port that the origin listens on.
- httpsPort Number
- The HTTPS port that CF uses to connect to the origin. Specify the HTTPS port that the origin listens on.
DistributionLegacyS3Origin, DistributionLegacyS3OriginArgs      
The origin as an S3 bucket.
This property is legacy. We recommend that you use Origin instead.- DnsName string
- The domain name assigned to your CF distribution.
- OriginAccess stringIdentity 
- The CF origin access identity to associate with the distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an S3 through CF. This property is legacy. We recommend that you use OriginAccessControl instead.
- DnsName string
- The domain name assigned to your CF distribution.
- OriginAccess stringIdentity 
- The CF origin access identity to associate with the distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an S3 through CF. This property is legacy. We recommend that you use OriginAccessControl instead.
- dnsName String
- The domain name assigned to your CF distribution.
- originAccess StringIdentity 
- The CF origin access identity to associate with the distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an S3 through CF. This property is legacy. We recommend that you use OriginAccessControl instead.
- dnsName string
- The domain name assigned to your CF distribution.
- originAccess stringIdentity 
- The CF origin access identity to associate with the distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an S3 through CF. This property is legacy. We recommend that you use OriginAccessControl instead.
- dns_name str
- The domain name assigned to your CF distribution.
- origin_access_ stridentity 
- The CF origin access identity to associate with the distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an S3 through CF. This property is legacy. We recommend that you use OriginAccessControl instead.
- dnsName String
- The domain name assigned to your CF distribution.
- originAccess StringIdentity 
- The CF origin access identity to associate with the distribution. Use an origin access identity to configure the distribution so that end users can only access objects in an S3 through CF. This property is legacy. We recommend that you use OriginAccessControl instead.
DistributionLogging, DistributionLoggingArgs    
A complex type that specifies whether access logs are written for the distribution.
If you already enabled standard logging (legacy) and you want to enable standard logging (v2) to send your access logs to Amazon S3, we recommend that you specify a different Amazon S3 bucket or use a separate path in the same bucket (for example, use a log prefix or partitioning). This helps you keep track of which log files are associated with which logging subscription and prevents log files from overwriting each other. For more information, see Standard logging (access logs) in the Amazon CloudFront Developer Guide.- Bucket string
- The Amazon S3 bucket to store the access logs in, for example, amzn-s3-demo-bucket.s3.amazonaws.com.
- bool
- Specifies whether you want CloudFront to include cookies in access logs, specify trueforIncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specifyfalseforIncludeCookies.
- Prefix string
- An optional string that you want CloudFront to prefix to the access log filenamesfor this distribution, for example,myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an emptyPrefixelement in theLoggingelement.
- Bucket string
- The Amazon S3 bucket to store the access logs in, for example, amzn-s3-demo-bucket.s3.amazonaws.com.
- bool
- Specifies whether you want CloudFront to include cookies in access logs, specify trueforIncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specifyfalseforIncludeCookies.
- Prefix string
- An optional string that you want CloudFront to prefix to the access log filenamesfor this distribution, for example,myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an emptyPrefixelement in theLoggingelement.
- bucket String
- The Amazon S3 bucket to store the access logs in, for example, amzn-s3-demo-bucket.s3.amazonaws.com.
- Boolean
- Specifies whether you want CloudFront to include cookies in access logs, specify trueforIncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specifyfalseforIncludeCookies.
- prefix String
- An optional string that you want CloudFront to prefix to the access log filenamesfor this distribution, for example,myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an emptyPrefixelement in theLoggingelement.
- bucket string
- The Amazon S3 bucket to store the access logs in, for example, amzn-s3-demo-bucket.s3.amazonaws.com.
- boolean
- Specifies whether you want CloudFront to include cookies in access logs, specify trueforIncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specifyfalseforIncludeCookies.
- prefix string
- An optional string that you want CloudFront to prefix to the access log filenamesfor this distribution, for example,myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an emptyPrefixelement in theLoggingelement.
- bucket str
- The Amazon S3 bucket to store the access logs in, for example, amzn-s3-demo-bucket.s3.amazonaws.com.
- bool
- Specifies whether you want CloudFront to include cookies in access logs, specify trueforIncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specifyfalseforIncludeCookies.
- prefix str
- An optional string that you want CloudFront to prefix to the access log filenamesfor this distribution, for example,myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an emptyPrefixelement in theLoggingelement.
- bucket String
- The Amazon S3 bucket to store the access logs in, for example, amzn-s3-demo-bucket.s3.amazonaws.com.
- Boolean
- Specifies whether you want CloudFront to include cookies in access logs, specify trueforIncludeCookies. If you choose to include cookies in logs, CloudFront logs all cookies regardless of how you configure the cache behaviors for this distribution. If you don't want to include cookies when you create a distribution or if you want to disable include cookies for an existing distribution, specifyfalseforIncludeCookies.
- prefix String
- An optional string that you want CloudFront to prefix to the access log filenamesfor this distribution, for example,myprefix/. If you want to enable logging, but you don't want to specify a prefix, you still must include an emptyPrefixelement in theLoggingelement.
DistributionOrigin, DistributionOriginArgs    
An origin. An origin is the location where content is stored, and from which CloudFront gets content to serve to viewers. To specify an origin:
- Use S3OriginConfigto specify an Amazon S3 bucket that is not configured with static website hosting.
- Use VpcOriginConfigto specify a VPC origin.
- Use CustomOriginConfigto specify all other kinds of origins, including:
- An Amazon S3 bucket that is configured with static website hosting
- An Elastic Load Balancing load balancer
- An EMPlong endpoint
- An EMSlong container
- Any other HTTP server, running on an Amazon EC2 instance or any other kind of host
For the current maximum number of origins that you can specify per distribution, see General Quotas on Web Distributions in the Amazon CloudFront Developer Guide (quotas were formerly referred to as limits).
- DomainName string
- The domain name for the origin. For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide.
- Id string
- A unique identifier for the origin. This value must be unique within the distribution.
Use this value to specify the TargetOriginIdin aCacheBehaviororDefaultCacheBehavior.
- ConnectionAttempts int
- The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3. For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout. For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.
- ConnectionTimeout int
- The number of seconds that CloudFront waits when trying to establish a connection to the origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don't specify otherwise) is 10 seconds. For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide.
- CustomOrigin Pulumi.Config Aws Native. Cloud Front. Inputs. Distribution Custom Origin Config 
- Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the S3OriginConfigtype instead.
- OriginAccess stringControl Id 
- The unique identifier of an origin access control for this origin. For more information, see Restricting access to an Amazon S3 origin in the Amazon CloudFront Developer Guide.
- OriginCustom List<Pulumi.Headers Aws Native. Cloud Front. Inputs. Distribution Origin Custom Header> 
- A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- OriginPath string
- An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin. For more information, see Origin Path in the Amazon CloudFront Developer Guide.
- OriginShield Pulumi.Aws Native. Cloud Front. Inputs. Distribution Origin Shield 
- CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin. For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
- ResponseCompletion intTimeout 
- The time (in seconds) that a request from CloudFront to the origin can stay open and wait for a response. If the complete response isn't received from the origin by this time, CloudFront ends the connection.
The value for ResponseCompletionTimeoutmust be equal to or greater than the value forOriginReadTimeout. If you don't set a value forResponseCompletionTimeout, CloudFront doesn't enforce a maximum value. For more information, see Response completion timeout in the Amazon CloudFront Developer Guide.
- S3OriginConfig Pulumi.Aws Native. Cloud Front. Inputs. Distribution S3Origin Config 
- Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the CustomOriginConfigtype instead.
- VpcOrigin Pulumi.Config Aws Native. Cloud Front. Inputs. Distribution Vpc Origin Config 
- The VPC origin configuration.
- DomainName string
- The domain name for the origin. For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide.
- Id string
- A unique identifier for the origin. This value must be unique within the distribution.
Use this value to specify the TargetOriginIdin aCacheBehaviororDefaultCacheBehavior.
- ConnectionAttempts int
- The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3. For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout. For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.
- ConnectionTimeout int
- The number of seconds that CloudFront waits when trying to establish a connection to the origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don't specify otherwise) is 10 seconds. For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide.
- CustomOrigin DistributionConfig Custom Origin Config 
- Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the S3OriginConfigtype instead.
- OriginAccess stringControl Id 
- The unique identifier of an origin access control for this origin. For more information, see Restricting access to an Amazon S3 origin in the Amazon CloudFront Developer Guide.
- OriginCustom []DistributionHeaders Origin Custom Header 
- A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- OriginPath string
- An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin. For more information, see Origin Path in the Amazon CloudFront Developer Guide.
- OriginShield DistributionOrigin Shield 
- CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin. For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
- ResponseCompletion intTimeout 
- The time (in seconds) that a request from CloudFront to the origin can stay open and wait for a response. If the complete response isn't received from the origin by this time, CloudFront ends the connection.
The value for ResponseCompletionTimeoutmust be equal to or greater than the value forOriginReadTimeout. If you don't set a value forResponseCompletionTimeout, CloudFront doesn't enforce a maximum value. For more information, see Response completion timeout in the Amazon CloudFront Developer Guide.
- S3OriginConfig DistributionS3Origin Config 
- Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the CustomOriginConfigtype instead.
- VpcOrigin DistributionConfig Vpc Origin Config 
- The VPC origin configuration.
- domainName String
- The domain name for the origin. For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide.
- id String
- A unique identifier for the origin. This value must be unique within the distribution.
Use this value to specify the TargetOriginIdin aCacheBehaviororDefaultCacheBehavior.
- connectionAttempts Integer
- The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3. For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout. For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.
- connectionTimeout Integer
- The number of seconds that CloudFront waits when trying to establish a connection to the origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don't specify otherwise) is 10 seconds. For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide.
- customOrigin DistributionConfig Custom Origin Config 
- Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the S3OriginConfigtype instead.
- originAccess StringControl Id 
- The unique identifier of an origin access control for this origin. For more information, see Restricting access to an Amazon S3 origin in the Amazon CloudFront Developer Guide.
- originCustom List<DistributionHeaders Origin Custom Header> 
- A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- originPath String
- An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin. For more information, see Origin Path in the Amazon CloudFront Developer Guide.
- originShield DistributionOrigin Shield 
- CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin. For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
- responseCompletion IntegerTimeout 
- The time (in seconds) that a request from CloudFront to the origin can stay open and wait for a response. If the complete response isn't received from the origin by this time, CloudFront ends the connection.
The value for ResponseCompletionTimeoutmust be equal to or greater than the value forOriginReadTimeout. If you don't set a value forResponseCompletionTimeout, CloudFront doesn't enforce a maximum value. For more information, see Response completion timeout in the Amazon CloudFront Developer Guide.
- s3OriginConfig DistributionS3Origin Config 
- Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the CustomOriginConfigtype instead.
- vpcOrigin DistributionConfig Vpc Origin Config 
- The VPC origin configuration.
- domainName string
- The domain name for the origin. For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide.
- id string
- A unique identifier for the origin. This value must be unique within the distribution.
Use this value to specify the TargetOriginIdin aCacheBehaviororDefaultCacheBehavior.
- connectionAttempts number
- The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3. For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout. For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.
- connectionTimeout number
- The number of seconds that CloudFront waits when trying to establish a connection to the origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don't specify otherwise) is 10 seconds. For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide.
- customOrigin DistributionConfig Custom Origin Config 
- Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the S3OriginConfigtype instead.
- originAccess stringControl Id 
- The unique identifier of an origin access control for this origin. For more information, see Restricting access to an Amazon S3 origin in the Amazon CloudFront Developer Guide.
- originCustom DistributionHeaders Origin Custom Header[] 
- A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- originPath string
- An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin. For more information, see Origin Path in the Amazon CloudFront Developer Guide.
- originShield DistributionOrigin Shield 
- CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin. For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
- responseCompletion numberTimeout 
- The time (in seconds) that a request from CloudFront to the origin can stay open and wait for a response. If the complete response isn't received from the origin by this time, CloudFront ends the connection.
The value for ResponseCompletionTimeoutmust be equal to or greater than the value forOriginReadTimeout. If you don't set a value forResponseCompletionTimeout, CloudFront doesn't enforce a maximum value. For more information, see Response completion timeout in the Amazon CloudFront Developer Guide.
- s3OriginConfig DistributionS3Origin Config 
- Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the CustomOriginConfigtype instead.
- vpcOrigin DistributionConfig Vpc Origin Config 
- The VPC origin configuration.
- domain_name str
- The domain name for the origin. For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide.
- id str
- A unique identifier for the origin. This value must be unique within the distribution.
Use this value to specify the TargetOriginIdin aCacheBehaviororDefaultCacheBehavior.
- connection_attempts int
- The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3. For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout. For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.
- connection_timeout int
- The number of seconds that CloudFront waits when trying to establish a connection to the origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don't specify otherwise) is 10 seconds. For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide.
- custom_origin_ Distributionconfig Custom Origin Config 
- Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the S3OriginConfigtype instead.
- origin_access_ strcontrol_ id 
- The unique identifier of an origin access control for this origin. For more information, see Restricting access to an Amazon S3 origin in the Amazon CloudFront Developer Guide.
- origin_custom_ Sequence[Distributionheaders Origin Custom Header] 
- A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- origin_path str
- An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin. For more information, see Origin Path in the Amazon CloudFront Developer Guide.
- origin_shield DistributionOrigin Shield 
- CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin. For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
- response_completion_ inttimeout 
- The time (in seconds) that a request from CloudFront to the origin can stay open and wait for a response. If the complete response isn't received from the origin by this time, CloudFront ends the connection.
The value for ResponseCompletionTimeoutmust be equal to or greater than the value forOriginReadTimeout. If you don't set a value forResponseCompletionTimeout, CloudFront doesn't enforce a maximum value. For more information, see Response completion timeout in the Amazon CloudFront Developer Guide.
- s3_origin_ Distributionconfig S3Origin Config 
- Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the CustomOriginConfigtype instead.
- vpc_origin_ Distributionconfig Vpc Origin Config 
- The VPC origin configuration.
- domainName String
- The domain name for the origin. For more information, see Origin Domain Name in the Amazon CloudFront Developer Guide.
- id String
- A unique identifier for the origin. This value must be unique within the distribution.
Use this value to specify the TargetOriginIdin aCacheBehaviororDefaultCacheBehavior.
- connectionAttempts Number
- The number of times that CloudFront attempts to connect to the origin. The minimum number is 1, the maximum is 3, and the default (if you don't specify otherwise) is 3. For a custom origin (including an Amazon S3 bucket that's configured with static website hosting), this value also specifies the number of times that CloudFront attempts to get a response from the origin, in the case of an Origin Response Timeout. For more information, see Origin Connection Attempts in the Amazon CloudFront Developer Guide.
- connectionTimeout Number
- The number of seconds that CloudFront waits when trying to establish a connection to the origin. The minimum timeout is 1 second, the maximum is 10 seconds, and the default (if you don't specify otherwise) is 10 seconds. For more information, see Origin Connection Timeout in the Amazon CloudFront Developer Guide.
- customOrigin Property MapConfig 
- Use this type to specify an origin that is not an Amazon S3 bucket, with one exception. If the Amazon S3 bucket is configured with static website hosting, use this type. If the Amazon S3 bucket is not configured with static website hosting, use the S3OriginConfigtype instead.
- originAccess StringControl Id 
- The unique identifier of an origin access control for this origin. For more information, see Restricting access to an Amazon S3 origin in the Amazon CloudFront Developer Guide.
- originCustom List<Property Map>Headers 
- A list of HTTP header names and values that CloudFront adds to the requests that it sends to the origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- originPath String
- An optional path that CloudFront appends to the origin domain name when CloudFront requests content from the origin. For more information, see Origin Path in the Amazon CloudFront Developer Guide.
- originShield Property Map
- CloudFront Origin Shield. Using Origin Shield can help reduce the load on your origin. For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.
- responseCompletion NumberTimeout 
- The time (in seconds) that a request from CloudFront to the origin can stay open and wait for a response. If the complete response isn't received from the origin by this time, CloudFront ends the connection.
The value for ResponseCompletionTimeoutmust be equal to or greater than the value forOriginReadTimeout. If you don't set a value forResponseCompletionTimeout, CloudFront doesn't enforce a maximum value. For more information, see Response completion timeout in the Amazon CloudFront Developer Guide.
- s3OriginConfig Property Map
- Use this type to specify an origin that is an Amazon S3 bucket that is not configured with static website hosting. To specify any other type of origin, including an Amazon S3 bucket that is configured with static website hosting, use the CustomOriginConfigtype instead.
- vpcOrigin Property MapConfig 
- The VPC origin configuration.
DistributionOriginCustomHeader, DistributionOriginCustomHeaderArgs        
A complex type that contains HeaderName and HeaderValue elements, if any, for this distribution.- HeaderName string
- The name of a header that you want CloudFront to send to your origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- HeaderValue string
- The value for the header that you specified in the HeaderNamefield.
- HeaderName string
- The name of a header that you want CloudFront to send to your origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- HeaderValue string
- The value for the header that you specified in the HeaderNamefield.
- headerName String
- The name of a header that you want CloudFront to send to your origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- headerValue String
- The value for the header that you specified in the HeaderNamefield.
- headerName string
- The name of a header that you want CloudFront to send to your origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- headerValue string
- The value for the header that you specified in the HeaderNamefield.
- header_name str
- The name of a header that you want CloudFront to send to your origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- header_value str
- The value for the header that you specified in the HeaderNamefield.
- headerName String
- The name of a header that you want CloudFront to send to your origin. For more information, see Adding Custom Headers to Origin Requests in the Amazon CloudFront Developer Guide.
- headerValue String
- The value for the header that you specified in the HeaderNamefield.
DistributionOriginGroup, DistributionOriginGroupArgs      
An origin group includes two origins (a primary origin and a secondary origin to failover to) and a failover criteria that you specify. You create an origin group to support origin failover in CloudFront. When you create or update a distribution, you can specify the origin group instead of a single origin, and CloudFront will failover from the primary origin to the secondary origin under the failover conditions that you've chosen.
Optionally, you can choose selection criteria for your origin group to specify how your origins are selected when your distribution routes viewer requests.- FailoverCriteria Pulumi.Aws Native. Cloud Front. Inputs. Distribution Origin Group Failover Criteria 
- A complex type that contains information about the failover criteria for an origin group.
- Id string
- The origin group's ID.
- Members
Pulumi.Aws Native. Cloud Front. Inputs. Distribution Origin Group Members 
- A complex type that contains information about the origins in an origin group.
- SelectionCriteria Pulumi.Aws Native. Cloud Front. Distribution Origin Group Selection Criteria 
- The selection criteria for the origin group. For more information, see Create an origin group in the Amazon CloudFront Developer Guide.
- FailoverCriteria DistributionOrigin Group Failover Criteria 
- A complex type that contains information about the failover criteria for an origin group.
- Id string
- The origin group's ID.
- Members
DistributionOrigin Group Members 
- A complex type that contains information about the origins in an origin group.
- SelectionCriteria DistributionOrigin Group Selection Criteria 
- The selection criteria for the origin group. For more information, see Create an origin group in the Amazon CloudFront Developer Guide.
- failoverCriteria DistributionOrigin Group Failover Criteria 
- A complex type that contains information about the failover criteria for an origin group.
- id String
- The origin group's ID.
- members
DistributionOrigin Group Members 
- A complex type that contains information about the origins in an origin group.
- selectionCriteria DistributionOrigin Group Selection Criteria 
- The selection criteria for the origin group. For more information, see Create an origin group in the Amazon CloudFront Developer Guide.
- failoverCriteria DistributionOrigin Group Failover Criteria 
- A complex type that contains information about the failover criteria for an origin group.
- id string
- The origin group's ID.
- members
DistributionOrigin Group Members 
- A complex type that contains information about the origins in an origin group.
- selectionCriteria DistributionOrigin Group Selection Criteria 
- The selection criteria for the origin group. For more information, see Create an origin group in the Amazon CloudFront Developer Guide.
- failover_criteria DistributionOrigin Group Failover Criteria 
- A complex type that contains information about the failover criteria for an origin group.
- id str
- The origin group's ID.
- members
DistributionOrigin Group Members 
- A complex type that contains information about the origins in an origin group.
- selection_criteria DistributionOrigin Group Selection Criteria 
- The selection criteria for the origin group. For more information, see Create an origin group in the Amazon CloudFront Developer Guide.
- failoverCriteria Property Map
- A complex type that contains information about the failover criteria for an origin group.
- id String
- The origin group's ID.
- members Property Map
- A complex type that contains information about the origins in an origin group.
- selectionCriteria "default" | "media-quality-based"
- The selection criteria for the origin group. For more information, see Create an origin group in the Amazon CloudFront Developer Guide.
DistributionOriginGroupFailoverCriteria, DistributionOriginGroupFailoverCriteriaArgs          
A complex data type that includes information about the failover criteria for an origin group, including the status codes for which CloudFront will failover from the primary origin to the second origin.- StatusCodes Pulumi.Aws Native. Cloud Front. Inputs. Distribution Status Codes 
- The status codes that, when returned from the primary origin, will trigger CloudFront to failover to the second origin.
- StatusCodes DistributionStatus Codes 
- The status codes that, when returned from the primary origin, will trigger CloudFront to failover to the second origin.
- statusCodes DistributionStatus Codes 
- The status codes that, when returned from the primary origin, will trigger CloudFront to failover to the second origin.
- statusCodes DistributionStatus Codes 
- The status codes that, when returned from the primary origin, will trigger CloudFront to failover to the second origin.
- status_codes DistributionStatus Codes 
- The status codes that, when returned from the primary origin, will trigger CloudFront to failover to the second origin.
- statusCodes Property Map
- The status codes that, when returned from the primary origin, will trigger CloudFront to failover to the second origin.
DistributionOriginGroupMember, DistributionOriginGroupMemberArgs        
An origin in an origin group.- OriginId string
- The ID for an origin in an origin group.
- OriginId string
- The ID for an origin in an origin group.
- originId String
- The ID for an origin in an origin group.
- originId string
- The ID for an origin in an origin group.
- origin_id str
- The ID for an origin in an origin group.
- originId String
- The ID for an origin in an origin group.
DistributionOriginGroupMembers, DistributionOriginGroupMembersArgs        
A complex data type for the origins included in an origin group.- Items
List<Pulumi.Aws Native. Cloud Front. Inputs. Distribution Origin Group Member> 
- Items (origins) in an origin group.
- Quantity int
- The number of origins in an origin group.
- Items
[]DistributionOrigin Group Member 
- Items (origins) in an origin group.
- Quantity int
- The number of origins in an origin group.
- items
List<DistributionOrigin Group Member> 
- Items (origins) in an origin group.
- quantity Integer
- The number of origins in an origin group.
- items
DistributionOrigin Group Member[] 
- Items (origins) in an origin group.
- quantity number
- The number of origins in an origin group.
- items
Sequence[DistributionOrigin Group Member] 
- Items (origins) in an origin group.
- quantity int
- The number of origins in an origin group.
- items List<Property Map>
- Items (origins) in an origin group.
- quantity Number
- The number of origins in an origin group.
DistributionOriginGroupSelectionCriteria, DistributionOriginGroupSelectionCriteriaArgs          
- Default
- default
- MediaQuality Based 
- media-quality-based
- DistributionOrigin Group Selection Criteria Default 
- default
- DistributionOrigin Group Selection Criteria Media Quality Based 
- media-quality-based
- Default
- default
- MediaQuality Based 
- media-quality-based
- Default
- default
- MediaQuality Based 
- media-quality-based
- DEFAULT
- default
- MEDIA_QUALITY_BASED
- media-quality-based
- "default"
- default
- "media-quality-based"
- media-quality-based
DistributionOriginGroups, DistributionOriginGroupsArgs      
A complex data type for the origin groups specified for a distribution.- Quantity int
- The number of origin groups.
- Items
List<Pulumi.Aws Native. Cloud Front. Inputs. Distribution Origin Group> 
- The items (origin groups) in a distribution.
- Quantity int
- The number of origin groups.
- Items
[]DistributionOrigin Group 
- The items (origin groups) in a distribution.
- quantity Integer
- The number of origin groups.
- items
List<DistributionOrigin Group> 
- The items (origin groups) in a distribution.
- quantity number
- The number of origin groups.
- items
DistributionOrigin Group[] 
- The items (origin groups) in a distribution.
- quantity int
- The number of origin groups.
- items
Sequence[DistributionOrigin Group] 
- The items (origin groups) in a distribution.
- quantity Number
- The number of origin groups.
- items List<Property Map>
- The items (origin groups) in a distribution.
DistributionOriginShield, DistributionOriginShieldArgs      
CloudFront Origin Shield.
Using Origin Shield can help reduce the load on your origin. For more information, see Using Origin Shield in the Amazon CloudFront Developer Guide.- Enabled bool
- A flag that specifies whether Origin Shield is enabled. When it's enabled, CloudFront routes all requests through Origin Shield, which can help protect your origin. When it's disabled, CloudFront might send requests directly to your origin from multiple edge locations or regional edge caches.
- OriginShield stringRegion 
- The AWS-Region for Origin Shield.
Specify the AWS-Region that has the lowest latency to your origin. To specify a region, use the region code, not the region name. For example, specify the US East (Ohio) region as us-east-2. When you enable CloudFront Origin Shield, you must specify the AWS-Region for Origin Shield. For the list of AWS-Regions that you can specify, and for help choosing the best Region for your origin, see Choosing the for Origin Shield in the Amazon CloudFront Developer Guide.
- Enabled bool
- A flag that specifies whether Origin Shield is enabled. When it's enabled, CloudFront routes all requests through Origin Shield, which can help protect your origin. When it's disabled, CloudFront might send requests directly to your origin from multiple edge locations or regional edge caches.
- OriginShield stringRegion 
- The AWS-Region for Origin Shield.
Specify the AWS-Region that has the lowest latency to your origin. To specify a region, use the region code, not the region name. For example, specify the US East (Ohio) region as us-east-2. When you enable CloudFront Origin Shield, you must specify the AWS-Region for Origin Shield. For the list of AWS-Regions that you can specify, and for help choosing the best Region for your origin, see Choosing the for Origin Shield in the Amazon CloudFront Developer Guide.
- enabled Boolean
- A flag that specifies whether Origin Shield is enabled. When it's enabled, CloudFront routes all requests through Origin Shield, which can help protect your origin. When it's disabled, CloudFront might send requests directly to your origin from multiple edge locations or regional edge caches.
- originShield StringRegion 
- The AWS-Region for Origin Shield.
Specify the AWS-Region that has the lowest latency to your origin. To specify a region, use the region code, not the region name. For example, specify the US East (Ohio) region as us-east-2. When you enable CloudFront Origin Shield, you must specify the AWS-Region for Origin Shield. For the list of AWS-Regions that you can specify, and for help choosing the best Region for your origin, see Choosing the for Origin Shield in the Amazon CloudFront Developer Guide.
- enabled boolean
- A flag that specifies whether Origin Shield is enabled. When it's enabled, CloudFront routes all requests through Origin Shield, which can help protect your origin. When it's disabled, CloudFront might send requests directly to your origin from multiple edge locations or regional edge caches.
- originShield stringRegion 
- The AWS-Region for Origin Shield.
Specify the AWS-Region that has the lowest latency to your origin. To specify a region, use the region code, not the region name. For example, specify the US East (Ohio) region as us-east-2. When you enable CloudFront Origin Shield, you must specify the AWS-Region for Origin Shield. For the list of AWS-Regions that you can specify, and for help choosing the best Region for your origin, see Choosing the for Origin Shield in the Amazon CloudFront Developer Guide.
- enabled bool
- A flag that specifies whether Origin Shield is enabled. When it's enabled, CloudFront routes all requests through Origin Shield, which can help protect your origin. When it's disabled, CloudFront might send requests directly to your origin from multiple edge locations or regional edge caches.
- origin_shield_ strregion 
- The AWS-Region for Origin Shield.
Specify the AWS-Region that has the lowest latency to your origin. To specify a region, use the region code, not the region name. For example, specify the US East (Ohio) region as us-east-2. When you enable CloudFront Origin Shield, you must specify the AWS-Region for Origin Shield. For the list of AWS-Regions that you can specify, and for help choosing the best Region for your origin, see Choosing the for Origin Shield in the Amazon CloudFront Developer Guide.
- enabled Boolean
- A flag that specifies whether Origin Shield is enabled. When it's enabled, CloudFront routes all requests through Origin Shield, which can help protect your origin. When it's disabled, CloudFront might send requests directly to your origin from multiple edge locations or regional edge caches.
- originShield StringRegion 
- The AWS-Region for Origin Shield.
Specify the AWS-Region that has the lowest latency to your origin. To specify a region, use the region code, not the region name. For example, specify the US East (Ohio) region as us-east-2. When you enable CloudFront Origin Shield, you must specify the AWS-Region for Origin Shield. For the list of AWS-Regions that you can specify, and for help choosing the best Region for your origin, see Choosing the for Origin Shield in the Amazon CloudFront Developer Guide.
DistributionParameterDefinition, DistributionParameterDefinitionArgs      
A list of parameter values to add to the resource. A parameter is specified as a key-value pair. A valid parameter value must exist for any parameter that is marked as required in the multi-tenant distribution.- Definition
Pulumi.Aws Native. Cloud Front. Inputs. Distribution Parameter Definition Definition Properties 
- The value that you assigned to the parameter.
- Name string
- The name of the parameter.
- Definition
DistributionParameter Definition Definition Properties 
- The value that you assigned to the parameter.
- Name string
- The name of the parameter.
- definition
DistributionParameter Definition Definition Properties 
- The value that you assigned to the parameter.
- name String
- The name of the parameter.
- definition
DistributionParameter Definition Definition Properties 
- The value that you assigned to the parameter.
- name string
- The name of the parameter.
- definition
DistributionParameter Definition Definition Properties 
- The value that you assigned to the parameter.
- name str
- The name of the parameter.
- definition Property Map
- The value that you assigned to the parameter.
- name String
- The name of the parameter.
DistributionParameterDefinitionDefinitionProperties, DistributionParameterDefinitionDefinitionPropertiesArgs          
The value that you assigned to the parameter.DistributionParameterDefinitionDefinitionPropertiesStringSchemaProperties, DistributionParameterDefinitionDefinitionPropertiesStringSchemaPropertiesArgs                
- Required bool
- Comment string
- DefaultValue string
- Required bool
- Comment string
- DefaultValue string
- required Boolean
- comment String
- defaultValue String
- required boolean
- comment string
- defaultValue string
- required bool
- comment str
- default_value str
- required Boolean
- comment String
- defaultValue String
DistributionRestrictions, DistributionRestrictionsArgs    
A complex type that identifies ways in which you want to restrict distribution of your content.- GeoRestriction Pulumi.Aws Native. Cloud Front. Inputs. Distribution Geo Restriction 
- A complex type that controls the countries in which your content is distributed. CF determines the location of your users using MaxMindGeoIP databases. To disable geo restriction, remove the Restrictions property from your stack template.
- GeoRestriction DistributionGeo Restriction 
- A complex type that controls the countries in which your content is distributed. CF determines the location of your users using MaxMindGeoIP databases. To disable geo restriction, remove the Restrictions property from your stack template.
- geoRestriction DistributionGeo Restriction 
- A complex type that controls the countries in which your content is distributed. CF determines the location of your users using MaxMindGeoIP databases. To disable geo restriction, remove the Restrictions property from your stack template.
- geoRestriction DistributionGeo Restriction 
- A complex type that controls the countries in which your content is distributed. CF determines the location of your users using MaxMindGeoIP databases. To disable geo restriction, remove the Restrictions property from your stack template.
- geo_restriction DistributionGeo Restriction 
- A complex type that controls the countries in which your content is distributed. CF determines the location of your users using MaxMindGeoIP databases. To disable geo restriction, remove the Restrictions property from your stack template.
- geoRestriction Property Map
- A complex type that controls the countries in which your content is distributed. CF determines the location of your users using MaxMindGeoIP databases. To disable geo restriction, remove the Restrictions property from your stack template.
DistributionS3OriginConfig, DistributionS3OriginConfigArgs      
A complex type that contains information about the Amazon S3 origin. If the origin is a custom origin or an S3 bucket that is configured as a website endpoint, use the CustomOriginConfig element instead.- OriginAccess stringIdentity 
- If you're using origin access control (OAC) instead of origin access identity, specify an empty OriginAccessIdentityelement. For more information, see Restricting access to an in the Amazon CloudFront Developer Guide. The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:origin-access-identity/cloudfront/ID-of-origin-access-identityTheID-of-origin-access-identityis the value that CloudFront returned in theIDelement when you created the origin access identity. If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an emptyOriginAccessIdentityelement. To delete the origin access identity from an existing distribution, update the distribution configuration and include an emptyOriginAccessIdentityelement. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
- OriginRead intTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- OriginAccess stringIdentity 
- If you're using origin access control (OAC) instead of origin access identity, specify an empty OriginAccessIdentityelement. For more information, see Restricting access to an in the Amazon CloudFront Developer Guide. The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:origin-access-identity/cloudfront/ID-of-origin-access-identityTheID-of-origin-access-identityis the value that CloudFront returned in theIDelement when you created the origin access identity. If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an emptyOriginAccessIdentityelement. To delete the origin access identity from an existing distribution, update the distribution configuration and include an emptyOriginAccessIdentityelement. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
- OriginRead intTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- originAccess StringIdentity 
- If you're using origin access control (OAC) instead of origin access identity, specify an empty OriginAccessIdentityelement. For more information, see Restricting access to an in the Amazon CloudFront Developer Guide. The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:origin-access-identity/cloudfront/ID-of-origin-access-identityTheID-of-origin-access-identityis the value that CloudFront returned in theIDelement when you created the origin access identity. If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an emptyOriginAccessIdentityelement. To delete the origin access identity from an existing distribution, update the distribution configuration and include an emptyOriginAccessIdentityelement. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
- originRead IntegerTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- originAccess stringIdentity 
- If you're using origin access control (OAC) instead of origin access identity, specify an empty OriginAccessIdentityelement. For more information, see Restricting access to an in the Amazon CloudFront Developer Guide. The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:origin-access-identity/cloudfront/ID-of-origin-access-identityTheID-of-origin-access-identityis the value that CloudFront returned in theIDelement when you created the origin access identity. If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an emptyOriginAccessIdentityelement. To delete the origin access identity from an existing distribution, update the distribution configuration and include an emptyOriginAccessIdentityelement. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
- originRead numberTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- origin_access_ stridentity 
- If you're using origin access control (OAC) instead of origin access identity, specify an empty OriginAccessIdentityelement. For more information, see Restricting access to an in the Amazon CloudFront Developer Guide. The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:origin-access-identity/cloudfront/ID-of-origin-access-identityTheID-of-origin-access-identityis the value that CloudFront returned in theIDelement when you created the origin access identity. If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an emptyOriginAccessIdentityelement. To delete the origin access identity from an existing distribution, update the distribution configuration and include an emptyOriginAccessIdentityelement. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
- origin_read_ inttimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- originAccess StringIdentity 
- If you're using origin access control (OAC) instead of origin access identity, specify an empty OriginAccessIdentityelement. For more information, see Restricting access to an in the Amazon CloudFront Developer Guide. The CloudFront origin access identity to associate with the origin. Use an origin access identity to configure the origin so that viewers can only access objects in an Amazon S3 bucket through CloudFront. The format of the value is:origin-access-identity/cloudfront/ID-of-origin-access-identityTheID-of-origin-access-identityis the value that CloudFront returned in theIDelement when you created the origin access identity. If you want viewers to be able to access objects using either the CloudFront URL or the Amazon S3 URL, specify an emptyOriginAccessIdentityelement. To delete the origin access identity from an existing distribution, update the distribution configuration and include an emptyOriginAccessIdentityelement. To replace the origin access identity, update the distribution configuration and specify the new origin access identity. For more information about the origin access identity, see Serving Private Content through CloudFront in the Amazon CloudFront Developer Guide.
- originRead NumberTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
DistributionStatusCodes, DistributionStatusCodesArgs      
A complex data type for the status codes that you specify that, when returned by a primary origin, trigger CloudFront to failover to a second origin.DistributionViewerCertificate, DistributionViewerCertificateArgs      
A complex type that determines the distribution's SSL/TLS configuration for communicating with viewers.
If the distribution doesn't use Aliases (also known as alternate domain names or CNAMEs)—that is, if the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net—set CloudFrontDefaultCertificate to true and leave all other fields empty.
If the distribution uses Aliases (alternate domain names or CNAMEs), use the fields in this type to specify the following settings:
- Which viewers the distribution accepts HTTPS connections from: only viewers that support server name indication (SNI) (recommended), or all viewers including those that don't support SNI. 
- To accept HTTPS connections from only viewers that support SNI, set - SSLSupportMethodto- sni-only. This is recommended. Most browsers and clients support SNI. (In CloudFormation, the field name is- SslSupportMethod. Note the different capitalization.)
- To accept HTTPS connections from all viewers, including those that don't support SNI, set - SSLSupportMethodto- vip. This is not recommended, and results in additional monthly charges from CloudFront. (In CloudFormation, the field name is- SslSupportMethod. Note the different capitalization.)
- The minimum SSL/TLS protocol version that the distribution can use to communicate with viewers. To specify a minimum version, choose a value for - MinimumProtocolVersion. For more information, see Security Policy in the Amazon CloudFront Developer Guide.
- The location of the SSL/TLS certificate, (ACM) (recommended) or (IAM). You specify the location by setting a value in one of the following fields (not both): 
- ACMCertificateArn(In CloudFormation, this field name is- AcmCertificateArn. Note the different capitalization.)
- IAMCertificateId(In CloudFormation, this field name is- IamCertificateId. Note the different capitalization.)
All distributions support HTTPS connections from viewers. To require viewers to use HTTPS only, or to redirect them from HTTP to HTTPS, use ViewerProtocolPolicy in the CacheBehavior or DefaultCacheBehavior. To specify how CloudFront should use SSL/TLS to communicate with your custom origin, use CustomOriginConfig.
For more information, see Using HTTPS with CloudFront and Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.
- AcmCertificate stringArn 
- In CloudFormation, this field name is AcmCertificateArn. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (ACM), provide the Amazon Resource Name (ARN) of the ACM certificate. CloudFront only supports ACM certificates in the US East (N. Virginia) Region (us-east-1). If you specify an ACM certificate ARN, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- CloudFront boolDefault Certificate 
- If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, set this field totrue. If the distribution usesAliases(alternate domain names or CNAMEs), omit this field and specify values for the following fields:- AcmCertificateArnor- IamCertificateId(specify a value for one, not both)
- MinimumProtocolVersion
- SslSupportMethod
 
- IamCertificate stringId 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
In CloudFormation, this field name is IamCertificateId. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (IAM), provide the ID of the IAM certificate. If you specify an IAM certificate ID, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- MinimumProtocol stringVersion 
- If the distribution uses - Aliases(alternate domain names or CNAMEs), specify the security policy that you want CloudFront to use for HTTPS connections with viewers. The security policy determines two settings:- The minimum SSL/TLS protocol that CloudFront can use to communicate with viewers.
- The ciphers that CloudFront can use to encrypt the content that it returns to viewers.
 - For more information, see Security Policy and Supported Protocols and Ciphers Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. On the CloudFront console, this setting is called Security Policy. When you're using SNI only (you set - SSLSupportMethodto- sni-only), you must specify- TLSv1or higher. (In CloudFormation, the field name is- SslSupportMethod. Note the different capitalization.) If the distribution uses the CloudFront domain name such as- d111111abcdef8.cloudfront.net(you set- CloudFrontDefaultCertificateto- true), CloudFront automatically sets the security policy to- TLSv1regardless of the value that you set here.
- SslSupport stringMethod 
- In CloudFormation, this field name is - SslSupportMethod. Note the different capitalization. If the distribution uses- Aliases(alternate domain names or CNAMEs), specify which viewers the distribution accepts HTTPS connections from.- sni-only– The distribution accepts HTTPS connections from only viewers that support server name indication (SNI). This is recommended. Most browsers and clients support SNI.
- vip– The distribution accepts HTTPS connections from all viewers including those that don't support SNI. This is not recommended, and results in additional monthly charges from CloudFront.
- static-ip- Do not specify this value unless your distribution has been enabled for this feature by the CloudFront team. If you have a use case that requires static IP addresses for a distribution, contact CloudFront through the Center.
 - If the distribution uses the CloudFront domain name such as - d111111abcdef8.cloudfront.net, don't set a value for this field.
- AcmCertificate stringArn 
- In CloudFormation, this field name is AcmCertificateArn. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (ACM), provide the Amazon Resource Name (ARN) of the ACM certificate. CloudFront only supports ACM certificates in the US East (N. Virginia) Region (us-east-1). If you specify an ACM certificate ARN, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- CloudFront boolDefault Certificate 
- If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, set this field totrue. If the distribution usesAliases(alternate domain names or CNAMEs), omit this field and specify values for the following fields:- AcmCertificateArnor- IamCertificateId(specify a value for one, not both)
- MinimumProtocolVersion
- SslSupportMethod
 
- IamCertificate stringId 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
In CloudFormation, this field name is IamCertificateId. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (IAM), provide the ID of the IAM certificate. If you specify an IAM certificate ID, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- MinimumProtocol stringVersion 
- If the distribution uses - Aliases(alternate domain names or CNAMEs), specify the security policy that you want CloudFront to use for HTTPS connections with viewers. The security policy determines two settings:- The minimum SSL/TLS protocol that CloudFront can use to communicate with viewers.
- The ciphers that CloudFront can use to encrypt the content that it returns to viewers.
 - For more information, see Security Policy and Supported Protocols and Ciphers Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. On the CloudFront console, this setting is called Security Policy. When you're using SNI only (you set - SSLSupportMethodto- sni-only), you must specify- TLSv1or higher. (In CloudFormation, the field name is- SslSupportMethod. Note the different capitalization.) If the distribution uses the CloudFront domain name such as- d111111abcdef8.cloudfront.net(you set- CloudFrontDefaultCertificateto- true), CloudFront automatically sets the security policy to- TLSv1regardless of the value that you set here.
- SslSupport stringMethod 
- In CloudFormation, this field name is - SslSupportMethod. Note the different capitalization. If the distribution uses- Aliases(alternate domain names or CNAMEs), specify which viewers the distribution accepts HTTPS connections from.- sni-only– The distribution accepts HTTPS connections from only viewers that support server name indication (SNI). This is recommended. Most browsers and clients support SNI.
- vip– The distribution accepts HTTPS connections from all viewers including those that don't support SNI. This is not recommended, and results in additional monthly charges from CloudFront.
- static-ip- Do not specify this value unless your distribution has been enabled for this feature by the CloudFront team. If you have a use case that requires static IP addresses for a distribution, contact CloudFront through the Center.
 - If the distribution uses the CloudFront domain name such as - d111111abcdef8.cloudfront.net, don't set a value for this field.
- acmCertificate StringArn 
- In CloudFormation, this field name is AcmCertificateArn. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (ACM), provide the Amazon Resource Name (ARN) of the ACM certificate. CloudFront only supports ACM certificates in the US East (N. Virginia) Region (us-east-1). If you specify an ACM certificate ARN, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- cloudFront BooleanDefault Certificate 
- If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, set this field totrue. If the distribution usesAliases(alternate domain names or CNAMEs), omit this field and specify values for the following fields:- AcmCertificateArnor- IamCertificateId(specify a value for one, not both)
- MinimumProtocolVersion
- SslSupportMethod
 
- iamCertificate StringId 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
In CloudFormation, this field name is IamCertificateId. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (IAM), provide the ID of the IAM certificate. If you specify an IAM certificate ID, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- minimumProtocol StringVersion 
- If the distribution uses - Aliases(alternate domain names or CNAMEs), specify the security policy that you want CloudFront to use for HTTPS connections with viewers. The security policy determines two settings:- The minimum SSL/TLS protocol that CloudFront can use to communicate with viewers.
- The ciphers that CloudFront can use to encrypt the content that it returns to viewers.
 - For more information, see Security Policy and Supported Protocols and Ciphers Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. On the CloudFront console, this setting is called Security Policy. When you're using SNI only (you set - SSLSupportMethodto- sni-only), you must specify- TLSv1or higher. (In CloudFormation, the field name is- SslSupportMethod. Note the different capitalization.) If the distribution uses the CloudFront domain name such as- d111111abcdef8.cloudfront.net(you set- CloudFrontDefaultCertificateto- true), CloudFront automatically sets the security policy to- TLSv1regardless of the value that you set here.
- sslSupport StringMethod 
- In CloudFormation, this field name is - SslSupportMethod. Note the different capitalization. If the distribution uses- Aliases(alternate domain names or CNAMEs), specify which viewers the distribution accepts HTTPS connections from.- sni-only– The distribution accepts HTTPS connections from only viewers that support server name indication (SNI). This is recommended. Most browsers and clients support SNI.
- vip– The distribution accepts HTTPS connections from all viewers including those that don't support SNI. This is not recommended, and results in additional monthly charges from CloudFront.
- static-ip- Do not specify this value unless your distribution has been enabled for this feature by the CloudFront team. If you have a use case that requires static IP addresses for a distribution, contact CloudFront through the Center.
 - If the distribution uses the CloudFront domain name such as - d111111abcdef8.cloudfront.net, don't set a value for this field.
- acmCertificate stringArn 
- In CloudFormation, this field name is AcmCertificateArn. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (ACM), provide the Amazon Resource Name (ARN) of the ACM certificate. CloudFront only supports ACM certificates in the US East (N. Virginia) Region (us-east-1). If you specify an ACM certificate ARN, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- cloudFront booleanDefault Certificate 
- If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, set this field totrue. If the distribution usesAliases(alternate domain names or CNAMEs), omit this field and specify values for the following fields:- AcmCertificateArnor- IamCertificateId(specify a value for one, not both)
- MinimumProtocolVersion
- SslSupportMethod
 
- iamCertificate stringId 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
In CloudFormation, this field name is IamCertificateId. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (IAM), provide the ID of the IAM certificate. If you specify an IAM certificate ID, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- minimumProtocol stringVersion 
- If the distribution uses - Aliases(alternate domain names or CNAMEs), specify the security policy that you want CloudFront to use for HTTPS connections with viewers. The security policy determines two settings:- The minimum SSL/TLS protocol that CloudFront can use to communicate with viewers.
- The ciphers that CloudFront can use to encrypt the content that it returns to viewers.
 - For more information, see Security Policy and Supported Protocols and Ciphers Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. On the CloudFront console, this setting is called Security Policy. When you're using SNI only (you set - SSLSupportMethodto- sni-only), you must specify- TLSv1or higher. (In CloudFormation, the field name is- SslSupportMethod. Note the different capitalization.) If the distribution uses the CloudFront domain name such as- d111111abcdef8.cloudfront.net(you set- CloudFrontDefaultCertificateto- true), CloudFront automatically sets the security policy to- TLSv1regardless of the value that you set here.
- sslSupport stringMethod 
- In CloudFormation, this field name is - SslSupportMethod. Note the different capitalization. If the distribution uses- Aliases(alternate domain names or CNAMEs), specify which viewers the distribution accepts HTTPS connections from.- sni-only– The distribution accepts HTTPS connections from only viewers that support server name indication (SNI). This is recommended. Most browsers and clients support SNI.
- vip– The distribution accepts HTTPS connections from all viewers including those that don't support SNI. This is not recommended, and results in additional monthly charges from CloudFront.
- static-ip- Do not specify this value unless your distribution has been enabled for this feature by the CloudFront team. If you have a use case that requires static IP addresses for a distribution, contact CloudFront through the Center.
 - If the distribution uses the CloudFront domain name such as - d111111abcdef8.cloudfront.net, don't set a value for this field.
- acm_certificate_ strarn 
- In CloudFormation, this field name is AcmCertificateArn. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (ACM), provide the Amazon Resource Name (ARN) of the ACM certificate. CloudFront only supports ACM certificates in the US East (N. Virginia) Region (us-east-1). If you specify an ACM certificate ARN, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- cloud_front_ booldefault_ certificate 
- If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, set this field totrue. If the distribution usesAliases(alternate domain names or CNAMEs), omit this field and specify values for the following fields:- AcmCertificateArnor- IamCertificateId(specify a value for one, not both)
- MinimumProtocolVersion
- SslSupportMethod
 
- iam_certificate_ strid 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
In CloudFormation, this field name is IamCertificateId. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (IAM), provide the ID of the IAM certificate. If you specify an IAM certificate ID, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- minimum_protocol_ strversion 
- If the distribution uses - Aliases(alternate domain names or CNAMEs), specify the security policy that you want CloudFront to use for HTTPS connections with viewers. The security policy determines two settings:- The minimum SSL/TLS protocol that CloudFront can use to communicate with viewers.
- The ciphers that CloudFront can use to encrypt the content that it returns to viewers.
 - For more information, see Security Policy and Supported Protocols and Ciphers Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. On the CloudFront console, this setting is called Security Policy. When you're using SNI only (you set - SSLSupportMethodto- sni-only), you must specify- TLSv1or higher. (In CloudFormation, the field name is- SslSupportMethod. Note the different capitalization.) If the distribution uses the CloudFront domain name such as- d111111abcdef8.cloudfront.net(you set- CloudFrontDefaultCertificateto- true), CloudFront automatically sets the security policy to- TLSv1regardless of the value that you set here.
- ssl_support_ strmethod 
- In CloudFormation, this field name is - SslSupportMethod. Note the different capitalization. If the distribution uses- Aliases(alternate domain names or CNAMEs), specify which viewers the distribution accepts HTTPS connections from.- sni-only– The distribution accepts HTTPS connections from only viewers that support server name indication (SNI). This is recommended. Most browsers and clients support SNI.
- vip– The distribution accepts HTTPS connections from all viewers including those that don't support SNI. This is not recommended, and results in additional monthly charges from CloudFront.
- static-ip- Do not specify this value unless your distribution has been enabled for this feature by the CloudFront team. If you have a use case that requires static IP addresses for a distribution, contact CloudFront through the Center.
 - If the distribution uses the CloudFront domain name such as - d111111abcdef8.cloudfront.net, don't set a value for this field.
- acmCertificate StringArn 
- In CloudFormation, this field name is AcmCertificateArn. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (ACM), provide the Amazon Resource Name (ARN) of the ACM certificate. CloudFront only supports ACM certificates in the US East (N. Virginia) Region (us-east-1). If you specify an ACM certificate ARN, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- cloudFront BooleanDefault Certificate 
- If the distribution uses the CloudFront domain name such as d111111abcdef8.cloudfront.net, set this field totrue. If the distribution usesAliases(alternate domain names or CNAMEs), omit this field and specify values for the following fields:- AcmCertificateArnor- IamCertificateId(specify a value for one, not both)
- MinimumProtocolVersion
- SslSupportMethod
 
- iamCertificate StringId 
- This field only supports standard distributions. You can't specify this field for multi-tenant distributions. For more information, see Unsupported features for SaaS Manager for Amazon CloudFront in the Amazon CloudFront Developer Guide.
In CloudFormation, this field name is IamCertificateId. Note the different capitalization. If the distribution usesAliases(alternate domain names or CNAMEs) and the SSL/TLS certificate is stored in (IAM), provide the ID of the IAM certificate. If you specify an IAM certificate ID, you must also specify values forMinimumProtocolVersionandSSLSupportMethod. (In CloudFormation, the field name isSslSupportMethod. Note the different capitalization.)
- minimumProtocol StringVersion 
- If the distribution uses - Aliases(alternate domain names or CNAMEs), specify the security policy that you want CloudFront to use for HTTPS connections with viewers. The security policy determines two settings:- The minimum SSL/TLS protocol that CloudFront can use to communicate with viewers.
- The ciphers that CloudFront can use to encrypt the content that it returns to viewers.
 - For more information, see Security Policy and Supported Protocols and Ciphers Between Viewers and CloudFront in the Amazon CloudFront Developer Guide. On the CloudFront console, this setting is called Security Policy. When you're using SNI only (you set - SSLSupportMethodto- sni-only), you must specify- TLSv1or higher. (In CloudFormation, the field name is- SslSupportMethod. Note the different capitalization.) If the distribution uses the CloudFront domain name such as- d111111abcdef8.cloudfront.net(you set- CloudFrontDefaultCertificateto- true), CloudFront automatically sets the security policy to- TLSv1regardless of the value that you set here.
- sslSupport StringMethod 
- In CloudFormation, this field name is - SslSupportMethod. Note the different capitalization. If the distribution uses- Aliases(alternate domain names or CNAMEs), specify which viewers the distribution accepts HTTPS connections from.- sni-only– The distribution accepts HTTPS connections from only viewers that support server name indication (SNI). This is recommended. Most browsers and clients support SNI.
- vip– The distribution accepts HTTPS connections from all viewers including those that don't support SNI. This is not recommended, and results in additional monthly charges from CloudFront.
- static-ip- Do not specify this value unless your distribution has been enabled for this feature by the CloudFront team. If you have a use case that requires static IP addresses for a distribution, contact CloudFront through the Center.
 - If the distribution uses the CloudFront domain name such as - d111111abcdef8.cloudfront.net, don't set a value for this field.
DistributionVpcOriginConfig, DistributionVpcOriginConfigArgs        
An Amazon CloudFront VPC origin configuration.- VpcOrigin stringId 
- The VPC origin ID.
- OriginKeepalive intTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- OriginRead intTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- VpcOrigin stringId 
- The VPC origin ID.
- OriginKeepalive intTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- OriginRead intTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- vpcOrigin StringId 
- The VPC origin ID.
- originKeepalive IntegerTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- originRead IntegerTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- vpcOrigin stringId 
- The VPC origin ID.
- originKeepalive numberTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- originRead numberTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- vpc_origin_ strid 
- The VPC origin ID.
- origin_keepalive_ inttimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- origin_read_ inttimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
- vpcOrigin StringId 
- The VPC origin ID.
- originKeepalive NumberTimeout 
- Specifies how long, in seconds, CloudFront persists its connection to the origin. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 5 seconds. For more information, see Keep-alive timeout (custom origins only) in the Amazon CloudFront Developer Guide.
- originRead NumberTimeout 
- Specifies how long, in seconds, CloudFront waits for a response from the origin. This is also known as the origin response timeout. The minimum timeout is 1 second, the maximum is 120 seconds, and the default (if you don't specify otherwise) is 30 seconds. For more information, see Response timeout in the Amazon CloudFront Developer Guide.
Tag, TagArgs  
A set of tags to apply to the resource.Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.
