Documentation

A distribution tells CloudFront where you want content to be delivered from, and the details about how to track and manage content delivery.

See: newDistribution smart constructor.

Create a value of Distribution 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:activeTrustedKeyGroups:Distribution', distribution_activeTrustedKeyGroups - CloudFront automatically adds this field to the response if you’ve configured a cache behavior in this distribution to serve private content using key groups. This field contains a list of key groups and the public keys in each key group that CloudFront can use to verify the signatures of signed URLs or signed cookies.

$sel:aliasICPRecordals:Distribution', distribution_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:activeTrustedSigners:Distribution', distribution_activeTrustedSigners - We recommend using TrustedKeyGroups instead of TrustedSigners.

CloudFront automatically adds this field to the response if you’ve configured a cache behavior in this distribution to serve private content using trusted signers. This field contains a list of account IDs and the active CloudFront key pairs in each account that CloudFront can use to verify the signatures of signed URLs or signed cookies.

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

$sel:arn:Distribution', distribution_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:Distribution', distribution_status - This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated to all CloudFront edge locations.

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

$sel:inProgressInvalidationBatches:Distribution', distribution_inProgressInvalidationBatches - The number of invalidation batches currently in progress.

$sel:domainName:Distribution', distribution_domainName - The domain name corresponding to the distribution, for example, d111111abcdef8.cloudfront.net.

$sel:distributionConfig:Distribution', distribution_distributionConfig - The current configuration information for the distribution. Send a GET request to the /CloudFront API version/distribution ID/config resource.

CloudFront automatically adds this field to the response if you’ve configured a cache behavior in this distribution to serve private content using key groups. This field contains a list of key groups and the public keys in each key group that CloudFront can use to verify the signatures of signed URLs or signed cookies.

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.

We recommend using TrustedKeyGroups instead of TrustedSigners.

CloudFront automatically adds this field to the response if you’ve configured a cache behavior in this distribution to serve private content using trusted signers. This field contains a list of account IDs and the active CloudFront key pairs in each account that CloudFront can use to verify the signatures of signed URLs or signed cookies.

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.

This response element indicates the current status of the distribution. When the status is Deployed, the distribution's information is fully propagated to all CloudFront edge locations.

The date and time the distribution was last modified.

The number of invalidation batches currently in progress.

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

The current configuration information for the distribution. Send a GET request to the /CloudFront API version/distribution ID/config resource.