Documentation

A summary of the information about a CloudFront distribution.

See: newDistributionSummary smart constructor.

Create a value of DistributionSummary with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:originGroups:DistributionSummary', distributionSummary_originGroups - A complex type that contains information about origin groups for this distribution.

$sel:aliasICPRecordals:DistributionSummary', distributionSummary_aliasICPRecordals - Amazon Web Services services in China customers must file for an Internet Content Provider (ICP) recordal if they want to serve content publicly on an alternate domain name, also known as a CNAME, that they've added to CloudFront. AliasICPRecordal provides the ICP recordal status for CNAMEs associated with distributions.

For more information about ICP recordals, see Signup, Accounts, and Credentials in Getting Started with Amazon Web Services services in China.

$sel:id:DistributionSummary', distributionSummary_id - The identifier for the distribution. For example: EDFDVBD632BHDS5.

$sel:arn:DistributionSummary', distributionSummary_arn - The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your account ID.

$sel:status:DistributionSummary', distributionSummary_status - The current status of the distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

$sel:lastModifiedTime:DistributionSummary', distributionSummary_lastModifiedTime - The date and time the distribution was last modified.

$sel:domainName:DistributionSummary', distributionSummary_domainName - The domain name that corresponds to the distribution, for example, d111111abcdef8.cloudfront.net.

$sel:aliases:DistributionSummary', distributionSummary_aliases - A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

$sel:origins:DistributionSummary', distributionSummary_origins - A complex type that contains information about origins for this distribution.

$sel:defaultCacheBehavior:DistributionSummary', distributionSummary_defaultCacheBehavior - A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

$sel:cacheBehaviors:DistributionSummary', distributionSummary_cacheBehaviors - A complex type that contains zero or more CacheBehavior elements.

$sel:customErrorResponses:DistributionSummary', distributionSummary_customErrorResponses - A complex type that contains zero or more CustomErrorResponses elements.

$sel:comment:DistributionSummary', distributionSummary_comment - The comment originally specified when this distribution was created.

$sel:priceClass:DistributionSummary', distributionSummary_priceClass - A complex type that contains information about price class for this streaming distribution.

$sel:enabled:DistributionSummary', distributionSummary_enabled - Whether the distribution is enabled to accept user requests for content.

$sel:viewerCertificate:DistributionSummary', distributionSummary_viewerCertificate - A complex type that determines the distribution’s SSL/TLS configuration for communicating with viewers.

$sel:restrictions:DistributionSummary', distributionSummary_restrictions - A complex type that identifies ways in which you want to restrict distribution of your content.

$sel:webACLId:DistributionSummary', distributionSummary_webACLId - The Web ACL Id (if any) associated with the distribution.

$sel:httpVersion:DistributionSummary', distributionSummary_httpVersion - Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 will automatically use an earlier version.

$sel:isIPV6Enabled:DistributionSummary', distributionSummary_isIPV6Enabled - Whether CloudFront responds to IPv6 DNS requests with an IPv6 address for your distribution.

A complex type that contains information about origin groups for this distribution.

Amazon Web Services services in China customers must file for an Internet Content Provider (ICP) recordal if they want to serve content publicly on an alternate domain name, also known as a CNAME, that they've added to CloudFront. AliasICPRecordal provides the ICP recordal status for CNAMEs associated with distributions.

For more information about ICP recordals, see Signup, Accounts, and Credentials in Getting Started with Amazon Web Services services in China.

The identifier for the distribution. For example: EDFDVBD632BHDS5.

The ARN (Amazon Resource Name) for the distribution. For example: arn:aws:cloudfront::123456789012:distribution/EDFDVBD632BHDS5, where 123456789012 is your account ID.

The current status of the distribution. When the status is Deployed, the distribution's information is propagated to all CloudFront edge locations.

The date and time the distribution was last modified.

The domain name that corresponds to the distribution, for example, d111111abcdef8.cloudfront.net.

A complex type that contains information about CNAMEs (alternate domain names), if any, for this distribution.

A complex type that contains information about origins for this distribution.

A complex type that describes the default cache behavior if you don't specify a CacheBehavior element or if files don't match any of the values of PathPattern in CacheBehavior elements. You must create exactly one default cache behavior.

A complex type that contains zero or more CacheBehavior elements.

A complex type that contains zero or more CustomErrorResponses elements.

The comment originally specified when this distribution was created.

A complex type that contains information about price class for this streaming distribution.

Whether the distribution is enabled to accept user requests for content.

A complex type that determines the distribution’s SSL/TLS configuration for communicating with viewers.

A complex type that identifies ways in which you want to restrict distribution of your content.

The Web ACL Id (if any) associated with the distribution.

Specify the maximum HTTP version that you want viewers to use to communicate with CloudFront. The default value for new web distributions is http2. Viewers that don't support HTTP/2 will automatically use an earlier version.

Whether CloudFront responds to IPv6 DNS requests with an IPv6 address for your distribution.