DistributionSummary - Amazon CloudFront
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

DistributionSummary

A summary of the information about a CloudFront distribution.

Contents

Aliases

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

Type: Aliases object

Required: Yes

ARN

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

Type: String

Required: Yes

CacheBehaviors

A complex type that contains zero or more CacheBehavior elements.

Type: CacheBehaviors object

Required: Yes

Comment

The comment originally specified when this distribution was created.

Type: String

Required: Yes

CustomErrorResponses

A complex type that contains zero or more CustomErrorResponses elements.

Type: CustomErrorResponses object

Required: Yes

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.

Type: DefaultCacheBehavior object

Required: Yes

DomainName

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

Type: String

Required: Yes

Enabled

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

Type: Boolean

Required: Yes

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.

Type: String

Valid Values: http1.1 | http2 | http3 | http2and3

Required: Yes

Id

The identifier for the distribution. For example: EDFDVBD632BHDS5.

Type: String

Required: Yes

IsIPV6Enabled

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

Type: Boolean

Required: Yes

LastModifiedTime

The date and time the distribution was last modified.

Type: Timestamp

Required: Yes

Origins

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

Type: Origins object

Required: Yes

PriceClass

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

Type: String

Valid Values: PriceClass_100 | PriceClass_200 | PriceClass_All

Required: Yes

Restrictions

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

Type: Restrictions object

Required: Yes

Staging

A Boolean that indicates whether this is a staging distribution. When this value is true, this is a staging distribution. When this value is false, this is not a staging distribution.

Type: Boolean

Required: Yes

Status

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

Type: String

Required: Yes

ViewerCertificate

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

Type: ViewerCertificate object

Required: Yes

WebACLId

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

Type: String

Required: Yes

AliasICPRecordals

Amazon 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 services in China.

Type: Array of AliasICPRecordal objects

Required: No

OriginGroups

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

Type: OriginGroups object

Required: No

See Also

For more information about using this API in one of the language-specific Amazon SDKs, see the following: