---
# generated by https://github.com/hashicorp/terraform-plugin-docs
page_title: "awscc_cloudfront_distribution Resource - terraform-provider-awscc"
subcategory: ""
description: |-
  Resource Type definition for AWS::CloudFront::Distribution
---

# awscc_cloudfront_distribution (Resource)

Resource Type definition for AWS::CloudFront::Distribution



<!-- schema generated by tfplugindocs -->
## Schema

### Required

- `distribution_config` (Attributes) (see [below for nested schema](#nestedatt--distribution_config))

### Optional

- `tags` (Attributes List) (see [below for nested schema](#nestedatt--tags))

### Read-Only

- `domain_name` (String)
- `id` (String) The ID of this resource.

<a id="nestedatt--distribution_config"></a>
### Nested Schema for `distribution_config`

Required:

- `aliases` (List of String)
- `cache_behaviors` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--cache_behaviors))
- `cnames` (List of String)
- `comment` (String)
- `custom_error_responses` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--custom_error_responses))
- `custom_origin` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--custom_origin))
- `default_cache_behavior` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--default_cache_behavior))
- `default_root_object` (String)
- `enabled` (Boolean)
- `http_version` (String)
- `ipv6_enabled` (Boolean)
- `logging` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--logging))
- `origin_groups` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--origin_groups))
- `origins` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--origins))
- `price_class` (String)
- `restrictions` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--restrictions))
- `s3_origin` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--s3_origin))
- `viewer_certificate` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--viewer_certificate))
- `web_acl_id` (String)

<a id="nestedatt--distribution_config--cache_behaviors"></a>
### Nested Schema for `distribution_config.cache_behaviors`

Required:

- `allowed_methods` (List of String)
- `cache_policy_id` (String)
- `cached_methods` (List of String)
- `compress` (Boolean)
- `default_ttl` (Number)
- `field_level_encryption_id` (String)
- `forwarded_values` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--cache_behaviors--forwarded_values))
- `function_associations` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--cache_behaviors--function_associations))
- `lambda_function_associations` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--cache_behaviors--lambda_function_associations))
- `max_ttl` (Number)
- `min_ttl` (Number)
- `origin_request_policy_id` (String)
- `path_pattern` (String)
- `realtime_log_config_arn` (String)
- `response_headers_policy_id` (String)
- `smooth_streaming` (Boolean)
- `target_origin_id` (String)
- `trusted_key_groups` (List of String)
- `trusted_signers` (List of String)
- `viewer_protocol_policy` (String)

<a id="nestedatt--distribution_config--cache_behaviors--forwarded_values"></a>
### Nested Schema for `distribution_config.cache_behaviors.forwarded_values`

Required:

- `cookies` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--cache_behaviors--forwarded_values--cookies))
- `headers` (List of String)
- `query_string` (Boolean)
- `query_string_cache_keys` (List of String)

<a id="nestedatt--distribution_config--cache_behaviors--forwarded_values--cookies"></a>
### Nested Schema for `distribution_config.cache_behaviors.forwarded_values.query_string_cache_keys`

Required:

- `forward` (String)
- `whitelisted_names` (List of String)



<a id="nestedatt--distribution_config--cache_behaviors--function_associations"></a>
### Nested Schema for `distribution_config.cache_behaviors.function_associations`

Required:

- `event_type` (String)
- `function_arn` (String)


<a id="nestedatt--distribution_config--cache_behaviors--lambda_function_associations"></a>
### Nested Schema for `distribution_config.cache_behaviors.lambda_function_associations`

Required:

- `event_type` (String)
- `include_body` (Boolean)
- `lambda_function_arn` (String)



<a id="nestedatt--distribution_config--custom_error_responses"></a>
### Nested Schema for `distribution_config.custom_error_responses`

Required:

- `error_caching_min_ttl` (Number)
- `error_code` (Number)
- `response_code` (Number)
- `response_page_path` (String)


<a id="nestedatt--distribution_config--custom_origin"></a>
### Nested Schema for `distribution_config.custom_origin`

Required:

- `dns_name` (String)
- `http_port` (Number)
- `https_port` (Number)
- `origin_protocol_policy` (String)
- `origin_ssl_protocols` (List of String)


<a id="nestedatt--distribution_config--default_cache_behavior"></a>
### Nested Schema for `distribution_config.default_cache_behavior`

Required:

- `allowed_methods` (List of String)
- `cache_policy_id` (String)
- `cached_methods` (List of String)
- `compress` (Boolean)
- `default_ttl` (Number)
- `field_level_encryption_id` (String)
- `forwarded_values` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--default_cache_behavior--forwarded_values))
- `function_associations` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--default_cache_behavior--function_associations))
- `lambda_function_associations` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--default_cache_behavior--lambda_function_associations))
- `max_ttl` (Number)
- `min_ttl` (Number)
- `origin_request_policy_id` (String)
- `realtime_log_config_arn` (String)
- `response_headers_policy_id` (String)
- `smooth_streaming` (Boolean)
- `target_origin_id` (String)
- `trusted_key_groups` (List of String)
- `trusted_signers` (List of String)
- `viewer_protocol_policy` (String)

<a id="nestedatt--distribution_config--default_cache_behavior--forwarded_values"></a>
### Nested Schema for `distribution_config.default_cache_behavior.forwarded_values`

Required:

- `cookies` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--default_cache_behavior--forwarded_values--cookies))
- `headers` (List of String)
- `query_string` (Boolean)
- `query_string_cache_keys` (List of String)

<a id="nestedatt--distribution_config--default_cache_behavior--forwarded_values--cookies"></a>
### Nested Schema for `distribution_config.default_cache_behavior.forwarded_values.query_string_cache_keys`

Required:

- `forward` (String)
- `whitelisted_names` (List of String)



<a id="nestedatt--distribution_config--default_cache_behavior--function_associations"></a>
### Nested Schema for `distribution_config.default_cache_behavior.function_associations`

Required:

- `event_type` (String)
- `function_arn` (String)


<a id="nestedatt--distribution_config--default_cache_behavior--lambda_function_associations"></a>
### Nested Schema for `distribution_config.default_cache_behavior.lambda_function_associations`

Required:

- `event_type` (String)
- `include_body` (Boolean)
- `lambda_function_arn` (String)



<a id="nestedatt--distribution_config--logging"></a>
### Nested Schema for `distribution_config.logging`

Required:

- `bucket` (String)
- `include_cookies` (Boolean)
- `prefix` (String)


<a id="nestedatt--distribution_config--origin_groups"></a>
### Nested Schema for `distribution_config.origin_groups`

Required:

- `items` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--origin_groups--items))
- `quantity` (Number)

<a id="nestedatt--distribution_config--origin_groups--items"></a>
### Nested Schema for `distribution_config.origin_groups.items`

Required:

- `failover_criteria` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--origin_groups--items--failover_criteria))
- `id` (String) The ID of this resource.
- `members` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--origin_groups--items--members))

<a id="nestedatt--distribution_config--origin_groups--items--failover_criteria"></a>
### Nested Schema for `distribution_config.origin_groups.items.members`

Required:

- `status_codes` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--origin_groups--items--members--status_codes))

<a id="nestedatt--distribution_config--origin_groups--items--members--status_codes"></a>
### Nested Schema for `distribution_config.origin_groups.items.members.status_codes`

Required:

- `items` (List of Number)
- `quantity` (Number)



<a id="nestedatt--distribution_config--origin_groups--items--members"></a>
### Nested Schema for `distribution_config.origin_groups.items.members`

Required:

- `items` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--origin_groups--items--members--items))
- `quantity` (Number)

<a id="nestedatt--distribution_config--origin_groups--items--members--items"></a>
### Nested Schema for `distribution_config.origin_groups.items.members.items`

Required:

- `origin_id` (String)





<a id="nestedatt--distribution_config--origins"></a>
### Nested Schema for `distribution_config.origins`

Required:

- `connection_attempts` (Number)
- `connection_timeout` (Number)
- `custom_origin_config` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--origins--custom_origin_config))
- `domain_name` (String)
- `id` (String) The ID of this resource.
- `origin_custom_headers` (Attributes List) (see [below for nested schema](#nestedatt--distribution_config--origins--origin_custom_headers))
- `origin_path` (String)
- `origin_shield` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--origins--origin_shield))
- `s3_origin_config` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--origins--s3_origin_config))

<a id="nestedatt--distribution_config--origins--custom_origin_config"></a>
### Nested Schema for `distribution_config.origins.custom_origin_config`

Required:

- `http_port` (Number)
- `https_port` (Number)
- `origin_keepalive_timeout` (Number)
- `origin_protocol_policy` (String)
- `origin_read_timeout` (Number)
- `origin_ssl_protocols` (List of String)


<a id="nestedatt--distribution_config--origins--origin_custom_headers"></a>
### Nested Schema for `distribution_config.origins.origin_custom_headers`

Required:

- `header_name` (String)
- `header_value` (String)


<a id="nestedatt--distribution_config--origins--origin_shield"></a>
### Nested Schema for `distribution_config.origins.origin_shield`

Required:

- `enabled` (Boolean)
- `origin_shield_region` (String)


<a id="nestedatt--distribution_config--origins--s3_origin_config"></a>
### Nested Schema for `distribution_config.origins.s3_origin_config`

Required:

- `origin_access_identity` (String)



<a id="nestedatt--distribution_config--restrictions"></a>
### Nested Schema for `distribution_config.restrictions`

Required:

- `geo_restriction` (Attributes) (see [below for nested schema](#nestedatt--distribution_config--restrictions--geo_restriction))

<a id="nestedatt--distribution_config--restrictions--geo_restriction"></a>
### Nested Schema for `distribution_config.restrictions.geo_restriction`

Required:

- `locations` (List of String)
- `restriction_type` (String)



<a id="nestedatt--distribution_config--s3_origin"></a>
### Nested Schema for `distribution_config.s3_origin`

Required:

- `dns_name` (String)
- `origin_access_identity` (String)


<a id="nestedatt--distribution_config--viewer_certificate"></a>
### Nested Schema for `distribution_config.viewer_certificate`

Required:

- `acm_certificate_arn` (String)
- `cloudfront_default_certificate` (Boolean)
- `iam_certificate_id` (String)
- `minimum_protocol_version` (String)
- `ssl_support_method` (String)



<a id="nestedatt--tags"></a>
### Nested Schema for `tags`

Optional:

- `key` (String)
- `value` (String)

## Import

Import is supported using the following syntax:

```shell
$ terraform import awscc_cloudfront_distribution.example <resource ID>
```