You are viewing documentation for version 3 of the AWS SDK for Ruby. Version 2 documentation can be found here.

Class: Aws::CloudFront::Types::DistributionSummary

Inherits:
Struct
  • Object
show all
Defined in:
gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb

Overview

A summary of the information about a CloudFront distribution.

Instance Attribute Summary collapse

Instance Attribute Details

#aliasesTypes::Aliases

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

Returns:



3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#arnString

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

Returns:

  • (String)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#cache_behaviorsTypes::CacheBehaviors

A complex type that contains zero or more CacheBehavior elements.



3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#commentString

The comment originally specified when this distribution was created.

Returns:

  • (String)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#custom_error_responsesTypes::CustomErrorResponses

A complex type that contains zero or more CustomErrorResponses elements.



3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#default_cache_behaviorTypes::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.



3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#domain_nameString

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

Returns:

  • (String)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#enabledBoolean

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

Returns:

  • (Boolean)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#http_versionString

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.

Returns:

  • (String)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#idString

The identifier for the distribution. For example: EDFDVBD632BHDS5.

Returns:

  • (String)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#is_ipv6_enabledBoolean

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

Returns:

  • (Boolean)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#last_modified_timeTime

The date and time the distribution was last modified.

Returns:

  • (Time)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#originsTypes::Origins

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

Returns:



3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#price_classString

Returns:

  • (String)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#restrictionsTypes::Restrictions

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

Returns:



3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#statusString

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

Returns:

  • (String)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#viewer_certificateTypes::ViewerCertificate

A complex type that specifies the following:

  • Whether you want viewers to use HTTP or HTTPS to request your objects.

  • If you want viewers to use HTTPS, whether you're using an alternate domain name such as example.com or the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net.

  • If you're using an alternate domain name, whether AWS Certificate Manager (ACM) provided the certificate, or you purchased a certificate from a third-party certificate authority and imported it into ACM or uploaded it to the IAM certificate store.

You must specify only one of the following values:

  • ViewerCertificate$ACMCertificateArn

  • ViewerCertificate$IAMCertificateId

  • ViewerCertificate$CloudFrontDefaultCertificate

Don't specify false for CloudFrontDefaultCertificate.

If you want viewers to use HTTP instead of HTTPS to request your objects: Specify the following value:

<CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

In addition, specify allow-all for ViewerProtocolPolicy for all of your cache behaviors.

If you want viewers to use HTTPS to request your objects: Choose the type of certificate that you want to use based on whether you're using an alternate domain name for your objects or the CloudFront domain name:

  • If you're using an alternate domain name, such as example.com: Specify one of the following values, depending on whether ACM provided your certificate or you purchased your certificate from third-party certificate authority:

    • <ACMCertificateArn>ARN for ACM SSL/TLS certificate<ACMCertificateArn> where ARN for ACM SSL/TLS certificate is the ARN for the ACM SSL/TLS certificate that you want to use for this distribution.

    • <IAMCertificateId>IAM certificate ID<IAMCertificateId> where IAM certificate ID is the ID that IAM returned when you added the certificate to the IAM certificate store.

    If you specify ACMCertificateArn or IAMCertificateId, you must also specify a value for SSLSupportMethod.

    If you choose to use an ACM certificate or a certificate in the IAM certificate store, we recommend that you use only an alternate domain name in your object URLs (https://example.com/logo.jpg). If you use the domain name that is associated with your CloudFront distribution (such as https://d111111abcdef8.cloudfront.net/logo.jpg) and the viewer supports SNI, then CloudFront behaves normally. However, if the browser does not support SNI, the user's experience depends on the value that you choose for SSLSupportMethod:

    • vip: The viewer displays a warning because there is a mismatch between the CloudFront domain name and the domain name in your SSL/TLS certificate.

    • sni-only: CloudFront drops the connection with the browser without returning the object.

  • If you're using the CloudFront domain name for your distribution, such as d111111abcdef8.cloudfront.net : Specify the following value:

    <CloudFrontDefaultCertificate>true<CloudFrontDefaultCertificate>

If you want viewers to use HTTPS, you must also specify one of the following values in your cache behaviors:

  • <ViewerProtocolPolicy>https-only<ViewerProtocolPolicy>

  • <ViewerProtocolPolicy>redirect-to-https<ViewerProtocolPolicy>

You can also optionally require that CloudFront use HTTPS to communicate with your origin by specifying one of the following values for the applicable origins:

  • <OriginProtocolPolicy>https-only<OriginProtocolPolicy>

  • <OriginProtocolPolicy>match-viewer<OriginProtocolPolicy>

For more information, see Using Alternate Domain Names and HTTPS in the Amazon CloudFront Developer Guide.



3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end

#web_acl_idString

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

Returns:

  • (String)


3228
3229
3230
3231
3232
3233
3234
3235
3236
3237
3238
3239
3240
3241
3242
3243
3244
3245
3246
3247
3248
# File 'gems/aws-sdk-cloudfront/lib/aws-sdk-cloudfront/types.rb', line 3228

class DistributionSummary < Struct.new(
  :id,
  :arn,
  :status,
  :last_modified_time,
  :domain_name,
  :aliases,
  :origins,
  :default_cache_behavior,
  :cache_behaviors,
  :custom_error_responses,
  :comment,
  :price_class,
  :enabled,
  :viewer_certificate,
  :restrictions,
  :web_acl_id,
  :http_version,
  :is_ipv6_enabled)
  include Aws::Structure
end