aws-sdk-cloudfront 1.26.0 → 1.31.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
- SHA1:
3
- metadata.gz: b377334a0c36a314560f12962831526e96258b7d
4
- data.tar.gz: fcd47dd54ef0430f24492dcc724f05b31446c327
2
+ SHA256:
3
+ metadata.gz: 0d5bfcbb5014d84e4fe6f24c55703688ffdecc558df6ac1105435330a8a70831
4
+ data.tar.gz: 4fc1509ee9ca9328e71c16aef5fdbf27dd9e987e52d70195cead27bcd4b1e987
5
5
  SHA512:
6
- metadata.gz: 6d4e1ee11180bc758447383709255bb9cf25d73bd65e4332957d15084c9036f6f99f99137cf38ea4e778b13d071c259a742a850397e81c7102fa18b6f2a9b6a5
7
- data.tar.gz: ce5429ab6a0cd7b9b3d36e16a07191c794483a7fd2d0ae26d41a9ca93a70ae20d9a49edc42cf7288b56dfcb6d6067498f75ac6859225460d1137b80b0e0f588e
6
+ metadata.gz: be37e4a45cd64f2e0103310d9a999fc23532aa568f9d7252afcc6afe346ec76bd1848068087d2e67dddf4484b22389c3a9d0bb2534fa3d8fb9f83e26417a8815
7
+ data.tar.gz: 20ed8e1b4f7b920a4b9d1bdf5097366510185cb784cfce89ca9ea0d892003c969cfb65a38ea9fdd45eabfb3c4d18a00c65f63ab18af0f80d273593e8c2d473ca
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -46,6 +48,6 @@ require_relative 'aws-sdk-cloudfront/customizations'
46
48
  # @service
47
49
  module Aws::CloudFront
48
50
 
49
- GEM_VERSION = '1.26.0'
51
+ GEM_VERSION = '1.31.0'
50
52
 
51
53
  end
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
24
26
  require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
25
27
  require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
26
28
  require 'aws-sdk-core/plugins/transfer_encoding.rb'
29
+ require 'aws-sdk-core/plugins/http_checksum.rb'
27
30
  require 'aws-sdk-core/plugins/signature_v4.rb'
28
31
  require 'aws-sdk-core/plugins/protocols/rest_xml.rb'
29
32
 
@@ -32,11 +35,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:cloudfront)
32
35
  module Aws::CloudFront
33
36
  # An API client for CloudFront. To construct a client, you need to configure a `:region` and `:credentials`.
34
37
  #
35
- # client = Aws::CloudFront::Client.new(
36
- # region: region_name,
37
- # credentials: credentials,
38
- # # ...
39
- # )
38
+ # client = Aws::CloudFront::Client.new(
39
+ # region: region_name,
40
+ # credentials: credentials,
41
+ # # ...
42
+ # )
40
43
  #
41
44
  # For details on configuring region and credentials see
42
45
  # the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
@@ -69,6 +72,7 @@ module Aws::CloudFront
69
72
  add_plugin(Aws::Plugins::ClientMetricsPlugin)
70
73
  add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
71
74
  add_plugin(Aws::Plugins::TransferEncoding)
75
+ add_plugin(Aws::Plugins::HttpChecksum)
72
76
  add_plugin(Aws::Plugins::SignatureV4)
73
77
  add_plugin(Aws::Plugins::Protocols::RestXml)
74
78
 
@@ -105,7 +109,7 @@ module Aws::CloudFront
105
109
  # @option options [required, String] :region
106
110
  # The AWS region to connect to. The configured `:region` is
107
111
  # used to determine the service `:endpoint`. When not passed,
108
- # a default `:region` is search for in the following locations:
112
+ # a default `:region` is searched for in the following locations:
109
113
  #
110
114
  # * `Aws.config[:region]`
111
115
  # * `ENV['AWS_REGION']`
@@ -161,7 +165,7 @@ module Aws::CloudFront
161
165
  # @option options [String] :endpoint
162
166
  # The client endpoint is normally constructed from the `:region`
163
167
  # option. You should only configure an `:endpoint` when connecting
164
- # to test endpoints. This should be avalid HTTP(S) URI.
168
+ # to test or custom endpoints. This should be a valid HTTP(S) URI.
165
169
  #
166
170
  # @option options [Integer] :endpoint_cache_max_entries (1000)
167
171
  # Used for the maximum size limit of the LRU cache storing endpoints data
@@ -176,7 +180,7 @@ module Aws::CloudFront
176
180
  # requests fetching endpoints information. Defaults to 60 sec.
177
181
  #
178
182
  # @option options [Boolean] :endpoint_discovery (false)
179
- # When set to `true`, endpoint discovery will be enabled for operations when available. Defaults to `false`.
183
+ # When set to `true`, endpoint discovery will be enabled for operations when available.
180
184
  #
181
185
  # @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
182
186
  # The log formatter.
@@ -229,15 +233,19 @@ module Aws::CloudFront
229
233
  #
230
234
  # @option options [String] :retry_mode ("legacy")
231
235
  # Specifies which retry algorithm to use. Values are:
232
- # * `legacy` - The pre-existing retry behavior. This is default value if
233
- # no retry mode is provided.
234
- # * `standard` - A standardized set of retry rules across the AWS SDKs.
235
- # This includes support for retry quotas, which limit the number of
236
- # unsuccessful retries a client can make.
237
- # * `adaptive` - An experimental retry mode that includes all the
238
- # functionality of `standard` mode along with automatic client side
239
- # throttling. This is a provisional mode that may change behavior
240
- # in the future.
236
+ #
237
+ # * `legacy` - The pre-existing retry behavior. This is default value if
238
+ # no retry mode is provided.
239
+ #
240
+ # * `standard` - A standardized set of retry rules across the AWS SDKs.
241
+ # This includes support for retry quotas, which limit the number of
242
+ # unsuccessful retries a client can make.
243
+ #
244
+ # * `adaptive` - An experimental retry mode that includes all the
245
+ # functionality of `standard` mode along with automatic client side
246
+ # throttling. This is a provisional mode that may change behavior
247
+ # in the future.
248
+ #
241
249
  #
242
250
  # @option options [String] :secret_access_key
243
251
  #
@@ -265,8 +273,7 @@ module Aws::CloudFront
265
273
  #
266
274
  # @option options [Integer] :http_read_timeout (60) The default
267
275
  # number of seconds to wait for response data. This value can
268
- # safely be set
269
- # per-request on the session yielded by {#session_for}.
276
+ # safely be set per-request on the session.
270
277
  #
271
278
  # @option options [Float] :http_idle_timeout (5) The number of
272
279
  # seconds a connection is allowed to sit idle before it is
@@ -278,7 +285,7 @@ module Aws::CloudFront
278
285
  # request body. This option has no effect unless the request has
279
286
  # "Expect" header set to "100-continue". Defaults to `nil` which
280
287
  # disables this behaviour. This value can safely be set per
281
- # request on the session yielded by {#session_for}.
288
+ # request on the session.
282
289
  #
283
290
  # @option options [Boolean] :http_wire_trace (false) When `true`,
284
291
  # HTTP debug output will be sent to the `:logger`.
@@ -421,6 +428,8 @@ module Aws::CloudFront
421
428
  # origin_read_timeout: 1,
422
429
  # origin_keepalive_timeout: 1,
423
430
  # },
431
+ # connection_attempts: 1,
432
+ # connection_timeout: 1,
424
433
  # },
425
434
  # ],
426
435
  # },
@@ -634,6 +643,8 @@ module Aws::CloudFront
634
643
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_ssl_protocols.items[0] #=> String, one of "SSLv3", "TLSv1", "TLSv1.1", "TLSv1.2"
635
644
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_read_timeout #=> Integer
636
645
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_keepalive_timeout #=> Integer
646
+ # resp.distribution.distribution_config.origins.items[0].connection_attempts #=> Integer
647
+ # resp.distribution.distribution_config.origins.items[0].connection_timeout #=> Integer
637
648
  # resp.distribution.distribution_config.origin_groups.quantity #=> Integer
638
649
  # resp.distribution.distribution_config.origin_groups.items #=> Array
639
650
  # resp.distribution.distribution_config.origin_groups.items[0].id #=> String
@@ -808,6 +819,8 @@ module Aws::CloudFront
808
819
  # origin_read_timeout: 1,
809
820
  # origin_keepalive_timeout: 1,
810
821
  # },
822
+ # connection_attempts: 1,
823
+ # connection_timeout: 1,
811
824
  # },
812
825
  # ],
813
826
  # },
@@ -1030,6 +1043,8 @@ module Aws::CloudFront
1030
1043
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_ssl_protocols.items[0] #=> String, one of "SSLv3", "TLSv1", "TLSv1.1", "TLSv1.2"
1031
1044
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_read_timeout #=> Integer
1032
1045
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_keepalive_timeout #=> Integer
1046
+ # resp.distribution.distribution_config.origins.items[0].connection_attempts #=> Integer
1047
+ # resp.distribution.distribution_config.origins.items[0].connection_timeout #=> Integer
1033
1048
  # resp.distribution.distribution_config.origin_groups.quantity #=> Integer
1034
1049
  # resp.distribution.distribution_config.origin_groups.items #=> Array
1035
1050
  # resp.distribution.distribution_config.origin_groups.items[0].id #=> String
@@ -1907,6 +1922,8 @@ module Aws::CloudFront
1907
1922
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_ssl_protocols.items[0] #=> String, one of "SSLv3", "TLSv1", "TLSv1.1", "TLSv1.2"
1908
1923
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_read_timeout #=> Integer
1909
1924
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_keepalive_timeout #=> Integer
1925
+ # resp.distribution.distribution_config.origins.items[0].connection_attempts #=> Integer
1926
+ # resp.distribution.distribution_config.origins.items[0].connection_timeout #=> Integer
1910
1927
  # resp.distribution.distribution_config.origin_groups.quantity #=> Integer
1911
1928
  # resp.distribution.distribution_config.origin_groups.items #=> Array
1912
1929
  # resp.distribution.distribution_config.origin_groups.items[0].id #=> String
@@ -2019,6 +2036,11 @@ module Aws::CloudFront
2019
2036
  # resp.distribution.alias_icp_recordals[0].icp_recordal_status #=> String, one of "APPROVED", "SUSPENDED", "PENDING"
2020
2037
  # resp.etag #=> String
2021
2038
  #
2039
+ #
2040
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
2041
+ #
2042
+ # * distribution_deployed
2043
+ #
2022
2044
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2019-03-26/GetDistribution2019_03_26 AWS API Documentation
2023
2045
  #
2024
2046
  # @overload get_distribution(params = {})
@@ -2070,6 +2092,8 @@ module Aws::CloudFront
2070
2092
  # resp.distribution_config.origins.items[0].custom_origin_config.origin_ssl_protocols.items[0] #=> String, one of "SSLv3", "TLSv1", "TLSv1.1", "TLSv1.2"
2071
2093
  # resp.distribution_config.origins.items[0].custom_origin_config.origin_read_timeout #=> Integer
2072
2094
  # resp.distribution_config.origins.items[0].custom_origin_config.origin_keepalive_timeout #=> Integer
2095
+ # resp.distribution_config.origins.items[0].connection_attempts #=> Integer
2096
+ # resp.distribution_config.origins.items[0].connection_timeout #=> Integer
2073
2097
  # resp.distribution_config.origin_groups.quantity #=> Integer
2074
2098
  # resp.distribution_config.origin_groups.items #=> Array
2075
2099
  # resp.distribution_config.origin_groups.items[0].id #=> String
@@ -2387,6 +2411,11 @@ module Aws::CloudFront
2387
2411
  # resp.invalidation.invalidation_batch.paths.items[0] #=> String
2388
2412
  # resp.invalidation.invalidation_batch.caller_reference #=> String
2389
2413
  #
2414
+ #
2415
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
2416
+ #
2417
+ # * invalidation_completed
2418
+ #
2390
2419
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2019-03-26/GetInvalidation2019_03_26 AWS API Documentation
2391
2420
  #
2392
2421
  # @overload get_invalidation(params = {})
@@ -2513,6 +2542,11 @@ module Aws::CloudFront
2513
2542
  # resp.streaming_distribution.streaming_distribution_config.enabled #=> Boolean
2514
2543
  # resp.etag #=> String
2515
2544
  #
2545
+ #
2546
+ # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
2547
+ #
2548
+ # * streaming_distribution_deployed
2549
+ #
2516
2550
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2019-03-26/GetStreamingDistribution2019_03_26 AWS API Documentation
2517
2551
  #
2518
2552
  # @overload get_streaming_distribution(params = {})
@@ -2585,6 +2619,8 @@ module Aws::CloudFront
2585
2619
  #
2586
2620
  # * {Types::ListCloudFrontOriginAccessIdentitiesResult#cloud_front_origin_access_identity_list #cloud_front_origin_access_identity_list} => Types::CloudFrontOriginAccessIdentityList
2587
2621
  #
2622
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2623
+ #
2588
2624
  # @example Request syntax with placeholder values
2589
2625
  #
2590
2626
  # resp = client.list_cloud_front_origin_access_identities({
@@ -2629,6 +2665,8 @@ module Aws::CloudFront
2629
2665
  #
2630
2666
  # * {Types::ListDistributionsResult#distribution_list #distribution_list} => Types::DistributionList
2631
2667
  #
2668
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
2669
+ #
2632
2670
  # @example Request syntax with placeholder values
2633
2671
  #
2634
2672
  # resp = client.list_distributions({
@@ -2670,6 +2708,8 @@ module Aws::CloudFront
2670
2708
  # resp.distribution_list.items[0].origins.items[0].custom_origin_config.origin_ssl_protocols.items[0] #=> String, one of "SSLv3", "TLSv1", "TLSv1.1", "TLSv1.2"
2671
2709
  # resp.distribution_list.items[0].origins.items[0].custom_origin_config.origin_read_timeout #=> Integer
2672
2710
  # resp.distribution_list.items[0].origins.items[0].custom_origin_config.origin_keepalive_timeout #=> Integer
2711
+ # resp.distribution_list.items[0].origins.items[0].connection_attempts #=> Integer
2712
+ # resp.distribution_list.items[0].origins.items[0].connection_timeout #=> Integer
2673
2713
  # resp.distribution_list.items[0].origin_groups.quantity #=> Integer
2674
2714
  # resp.distribution_list.items[0].origin_groups.items #=> Array
2675
2715
  # resp.distribution_list.items[0].origin_groups.items[0].id #=> String
@@ -2852,6 +2892,8 @@ module Aws::CloudFront
2852
2892
  # resp.distribution_list.items[0].origins.items[0].custom_origin_config.origin_ssl_protocols.items[0] #=> String, one of "SSLv3", "TLSv1", "TLSv1.1", "TLSv1.2"
2853
2893
  # resp.distribution_list.items[0].origins.items[0].custom_origin_config.origin_read_timeout #=> Integer
2854
2894
  # resp.distribution_list.items[0].origins.items[0].custom_origin_config.origin_keepalive_timeout #=> Integer
2895
+ # resp.distribution_list.items[0].origins.items[0].connection_attempts #=> Integer
2896
+ # resp.distribution_list.items[0].origins.items[0].connection_timeout #=> Integer
2855
2897
  # resp.distribution_list.items[0].origin_groups.quantity #=> Integer
2856
2898
  # resp.distribution_list.items[0].origin_groups.items #=> Array
2857
2899
  # resp.distribution_list.items[0].origin_groups.items[0].id #=> String
@@ -3099,6 +3141,8 @@ module Aws::CloudFront
3099
3141
  #
3100
3142
  # * {Types::ListInvalidationsResult#invalidation_list #invalidation_list} => Types::InvalidationList
3101
3143
  #
3144
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3145
+ #
3102
3146
  # @example Request syntax with placeholder values
3103
3147
  #
3104
3148
  # resp = client.list_invalidations({
@@ -3185,6 +3229,8 @@ module Aws::CloudFront
3185
3229
  #
3186
3230
  # * {Types::ListStreamingDistributionsResult#streaming_distribution_list #streaming_distribution_list} => Types::StreamingDistributionList
3187
3231
  #
3232
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
3233
+ #
3188
3234
  # @example Request syntax with placeholder values
3189
3235
  #
3190
3236
  # resp = client.list_streaming_distributions({
@@ -3495,6 +3541,8 @@ module Aws::CloudFront
3495
3541
  # origin_read_timeout: 1,
3496
3542
  # origin_keepalive_timeout: 1,
3497
3543
  # },
3544
+ # connection_attempts: 1,
3545
+ # connection_timeout: 1,
3498
3546
  # },
3499
3547
  # ],
3500
3548
  # },
@@ -3710,6 +3758,8 @@ module Aws::CloudFront
3710
3758
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_ssl_protocols.items[0] #=> String, one of "SSLv3", "TLSv1", "TLSv1.1", "TLSv1.2"
3711
3759
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_read_timeout #=> Integer
3712
3760
  # resp.distribution.distribution_config.origins.items[0].custom_origin_config.origin_keepalive_timeout #=> Integer
3761
+ # resp.distribution.distribution_config.origins.items[0].connection_attempts #=> Integer
3762
+ # resp.distribution.distribution_config.origins.items[0].connection_timeout #=> Integer
3713
3763
  # resp.distribution.distribution_config.origin_groups.quantity #=> Integer
3714
3764
  # resp.distribution.distribution_config.origin_groups.items #=> Array
3715
3765
  # resp.distribution.distribution_config.origin_groups.items[0].id #=> String
@@ -4132,7 +4182,7 @@ module Aws::CloudFront
4132
4182
  params: params,
4133
4183
  config: config)
4134
4184
  context[:gem_name] = 'aws-sdk-cloudfront'
4135
- context[:gem_version] = '1.26.0'
4185
+ context[:gem_version] = '1.31.0'
4136
4186
  Seahorse::Client::Request.new(handlers, context)
4137
4187
  end
4138
4188
 
@@ -4198,11 +4248,11 @@ module Aws::CloudFront
4198
4248
  # The following table lists the valid waiter names, the operations they call,
4199
4249
  # and the default `:delay` and `:max_attempts` values.
4200
4250
  #
4201
- # | waiter_name | params | :delay | :max_attempts |
4202
- # | ------------------------------- | ----------------------------- | -------- | ------------- |
4203
- # | distribution_deployed | {#get_distribution} | 60 | 35 |
4204
- # | invalidation_completed | {#get_invalidation} | 20 | 30 |
4205
- # | streaming_distribution_deployed | {#get_streaming_distribution} | 60 | 25 |
4251
+ # | waiter_name | params | :delay | :max_attempts |
4252
+ # | ------------------------------- | ----------------------------------- | -------- | ------------- |
4253
+ # | distribution_deployed | {Client#get_distribution} | 60 | 35 |
4254
+ # | invalidation_completed | {Client#get_invalidation} | 20 | 30 |
4255
+ # | streaming_distribution_deployed | {Client#get_streaming_distribution} | 60 | 25 |
4206
4256
  #
4207
4257
  # @raise [Errors::FailureStateError] Raised when the waiter terminates
4208
4258
  # because the waiter has entered a state that it will not transition
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -1138,6 +1140,8 @@ module Aws::CloudFront
1138
1140
  Origin.add_member(:custom_headers, Shapes::ShapeRef.new(shape: CustomHeaders, location_name: "CustomHeaders"))
1139
1141
  Origin.add_member(:s3_origin_config, Shapes::ShapeRef.new(shape: S3OriginConfig, location_name: "S3OriginConfig"))
1140
1142
  Origin.add_member(:custom_origin_config, Shapes::ShapeRef.new(shape: CustomOriginConfig, location_name: "CustomOriginConfig"))
1143
+ Origin.add_member(:connection_attempts, Shapes::ShapeRef.new(shape: integer, location_name: "ConnectionAttempts"))
1144
+ Origin.add_member(:connection_timeout, Shapes::ShapeRef.new(shape: integer, location_name: "ConnectionTimeout"))
1141
1145
  Origin.struct_class = Types::Origin
1142
1146
 
1143
1147
  OriginCustomHeader.add_member(:header_name, Shapes::ShapeRef.new(shape: string, required: true, location_name: "HeaderName"))
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -6,13 +8,7 @@
6
8
  # WARNING ABOUT GENERATED CODE
7
9
 
8
10
  module Aws::CloudFront
9
- # This class provides a resource oriented interface for CloudFront.
10
- # To create a resource object:
11
- # resource = Aws::CloudFront::Resource.new(region: 'us-west-2')
12
- # You can supply a client object with custom configuration that will be used for all resource operations.
13
- # If you do not pass +:client+, a default client will be constructed.
14
- # client = Aws::CloudFront::Client.new(region: 'us-west-2')
15
- # resource = Aws::CloudFront::Resource.new(client: client)
11
+
16
12
  class Resource
17
13
 
18
14
  # @param options ({})
@@ -20,7 +20,7 @@ module Aws
20
20
  private
21
21
 
22
22
  def scheme_and_uri(url)
23
- url_sections = url.split('://')
23
+ url_sections = url.split('://', 2)
24
24
  if url_sections.length < 2
25
25
  raise ArgumentError, "Invalid URL:#{url}"
26
26
  end
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -236,19 +238,19 @@ module Aws::CloudFront
236
238
  #
237
239
  # You must create at least as many cache behaviors (including the
238
240
  # default cache behavior) as you have origins if you want CloudFront to
239
- # distribute objects from all of the origins. Each cache behavior
240
- # specifies the one origin from which you want CloudFront to get
241
- # objects. If you have two origins and only the default cache behavior,
242
- # the default cache behavior will cause CloudFront to get objects from
243
- # one of the origins, but the other origin is never used.
244
- #
245
- # For the current limit on the number of cache behaviors that you can
246
- # add to a distribution, see [Amazon CloudFront Limits][1] in the *AWS
247
- # General Reference*.
241
+ # serve objects from all of the origins. Each cache behavior specifies
242
+ # the one origin from which you want CloudFront to get objects. If you
243
+ # have two origins and only the default cache behavior, the default
244
+ # cache behavior will cause CloudFront to get objects from one of the
245
+ # origins, but the other origin is never used.
246
+ #
247
+ # For the current quota (formerly known as limit) on the number of cache
248
+ # behaviors that you can add to a distribution, see [Quotas][1] in the
249
+ # *Amazon CloudFront Developer Guide*.
248
250
  #
249
- # If you don't want to specify any cache behaviors, include only an
250
- # empty `CacheBehaviors` element. Don't include an empty
251
- # `CacheBehavior` element, or CloudFront returns a `MalformedXML` error.
251
+ # If you dont want to specify any cache behaviors, include only an
252
+ # empty `CacheBehaviors` element. Dont include an empty `CacheBehavior`
253
+ # element because this is invalid.
252
254
  #
253
255
  # To delete all cache behaviors in an existing distribution, update the
254
256
  # distribution configuration and include only an empty `CacheBehaviors`
@@ -258,12 +260,12 @@ module Aws::CloudFront
258
260
  # distribution configuration and specify all of the cache behaviors that
259
261
  # you want to include in the updated distribution.
260
262
  #
261
- # For more information about cache behaviors, see [Cache Behaviors][2]
262
- # in the *Amazon CloudFront Developer Guide*.
263
+ # For more information about cache behaviors, see [Cache Behavior
264
+ # Settings][2] in the *Amazon CloudFront Developer Guide*.
263
265
  #
264
266
  #
265
267
  #
266
- # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_cloudfront
268
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html
267
269
  # [2]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesCacheBehavior
268
270
  #
269
271
  # @note When making an API call, you may pass CacheBehavior
@@ -349,9 +351,7 @@ module Aws::CloudFront
349
351
  #
350
352
  # @!attribute [rw] target_origin_id
351
353
  # The value of `ID` for the origin that you want CloudFront to route
352
- # requests to when a request matches the path pattern either for a
353
- # cache behavior or for the default cache behavior in your
354
- # distribution.
354
+ # requests to when they match this cache behavior.
355
355
  # @return [String]
356
356
  #
357
357
  # @!attribute [rw] forwarded_values
@@ -367,15 +367,15 @@ module Aws::CloudFront
367
367
  # target origin that match the `PathPattern` for this cache behavior,
368
368
  # specify `true` for `Enabled`, and specify the applicable values for
369
369
  # `Quantity` and `Items`. For more information, see [Serving Private
370
- # Content through CloudFront][1] in the *Amazon CloudFront Developer
371
- # Guide*.
370
+ # Content with Signed URLs and Signed Cookies][1] in the *Amazon
371
+ # CloudFront Developer Guide*.
372
372
  #
373
- # If you don't want to require signed URLs in requests for objects
373
+ # If you dont want to require signed URLs in requests for objects
374
374
  # that match `PathPattern`, specify `false` for `Enabled` and `0` for
375
375
  # `Quantity`. Omit `Items`.
376
376
  #
377
377
  # To add, change, or remove one or more trusted signers, change
378
- # `Enabled` to `true` (if it's currently `false`), change `Quantity`
378
+ # `Enabled` to `true` (if its currently `false`), change `Quantity`
379
379
  # as applicable, and specify all of the trusted signers that you want
380
380
  # to include in the updated distribution.
381
381
  #
@@ -399,26 +399,25 @@ module Aws::CloudFront
399
399
  # * `https-only`\: If a viewer sends an HTTP request, CloudFront
400
400
  # returns an HTTP status code of 403 (Forbidden).
401
401
  #
402
- # For more information about requiring the HTTPS protocol, see [Using
403
- # an HTTPS Connection to Access Your Objects][1] in the *Amazon
402
+ # For more information about requiring the HTTPS protocol, see
403
+ # [Requiring HTTPS Between Viewers and CloudFront][1] in the *Amazon
404
404
  # CloudFront Developer Guide*.
405
405
  #
406
406
  # <note markdown="1"> The only way to guarantee that viewers retrieve an object that was
407
407
  # fetched from the origin using HTTPS is never to use any other
408
408
  # protocol to fetch the object. If you have recently changed from HTTP
409
- # to HTTPS, we recommend that you clear your objects' cache because
409
+ # to HTTPS, we recommend that you clear your objects cache because
410
410
  # cached objects are protocol agnostic. That means that an edge
411
411
  # location will return an object from the cache regardless of whether
412
412
  # the current request protocol matches the protocol used previously.
413
- # For more information, see [Managing How Long Content Stays in an
414
- # Edge Cache (Expiration)][2] in the *Amazon CloudFront Developer
415
- # Guide*.
413
+ # For more information, see [Managing Cache Expiration][2] in the
414
+ # *Amazon CloudFront Developer Guide*.
416
415
  #
417
416
  # </note>
418
417
  #
419
418
  #
420
419
  #
421
- # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html
420
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-https-viewers-to-cloudfront.html
422
421
  # [2]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html
423
422
  # @return [String]
424
423
  #
@@ -515,8 +514,7 @@ module Aws::CloudFront
515
514
  # @!attribute [rw] field_level_encryption_id
516
515
  # The value of `ID` for the field-level encryption configuration that
517
516
  # you want CloudFront to use for encrypting specific fields of data
518
- # for a cache behavior or for the default cache behavior in your
519
- # distribution.
517
+ # for this cache behavior.
520
518
  # @return [String]
521
519
  #
522
520
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2019-03-26/CacheBehavior AWS API Documentation
@@ -1164,6 +1162,8 @@ module Aws::CloudFront
1164
1162
  # origin_read_timeout: 1,
1165
1163
  # origin_keepalive_timeout: 1,
1166
1164
  # },
1165
+ # connection_attempts: 1,
1166
+ # connection_timeout: 1,
1167
1167
  # },
1168
1168
  # ],
1169
1169
  # },
@@ -1419,6 +1419,8 @@ module Aws::CloudFront
1419
1419
  # origin_read_timeout: 1,
1420
1420
  # origin_keepalive_timeout: 1,
1421
1421
  # },
1422
+ # connection_attempts: 1,
1423
+ # connection_timeout: 1,
1422
1424
  # },
1423
1425
  # ],
1424
1426
  # },
@@ -2204,8 +2206,13 @@ module Aws::CloudFront
2204
2206
  include Aws::Structure
2205
2207
  end
2206
2208
 
2207
- # A custom origin or an Amazon S3 bucket configured as a website
2208
- # endpoint.
2209
+ # A custom origin. A custom origin is any origin that is *not* an Amazon
2210
+ # S3 bucket, with one exception. An Amazon S3 bucket that is [configured
2211
+ # with static website hosting][1] *is* a custom origin.
2212
+ #
2213
+ #
2214
+ #
2215
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
2209
2216
  #
2210
2217
  # @note When making an API call, you may pass CustomOriginConfig
2211
2218
  # data as a hash:
@@ -2223,48 +2230,68 @@ module Aws::CloudFront
2223
2230
  # }
2224
2231
  #
2225
2232
  # @!attribute [rw] http_port
2226
- # The HTTP port the custom origin listens on.
2233
+ # The HTTP port that CloudFront uses to connect to the origin. Specify
2234
+ # the HTTP port that the origin listens on.
2227
2235
  # @return [Integer]
2228
2236
  #
2229
2237
  # @!attribute [rw] https_port
2230
- # The HTTPS port the custom origin listens on.
2238
+ # The HTTPS port that CloudFront uses to connect to the origin.
2239
+ # Specify the HTTPS port that the origin listens on.
2231
2240
  # @return [Integer]
2232
2241
  #
2233
2242
  # @!attribute [rw] origin_protocol_policy
2234
- # The origin protocol policy to apply to your origin.
2243
+ # Specifies the protocol (HTTP or HTTPS) that CloudFront uses to
2244
+ # connect to the origin. Valid values are:
2245
+ #
2246
+ # * `http-only` – CloudFront always uses HTTP to connect to the
2247
+ # origin.
2248
+ #
2249
+ # * `match-viewer` – CloudFront connects to the origin using the same
2250
+ # protocol that the viewer used to connect to CloudFront.
2251
+ #
2252
+ # * `https-only` – CloudFront always uses HTTPS to connect to the
2253
+ # origin.
2235
2254
  # @return [String]
2236
2255
  #
2237
2256
  # @!attribute [rw] origin_ssl_protocols
2238
- # The SSL/TLS protocols that you want CloudFront to use when
2239
- # communicating with your origin over HTTPS.
2257
+ # Specifies the minimum SSL/TLS protocol that CloudFront uses when
2258
+ # connecting to your origin over HTTPS. Valid values include `SSLv3`,
2259
+ # `TLSv1`, `TLSv1.1`, and `TLSv1.2`.
2260
+ #
2261
+ # For more information, see [Minimum Origin SSL Protocol][1] in the
2262
+ # *Amazon CloudFront Developer Guide*.
2263
+ #
2264
+ #
2265
+ #
2266
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginSSLProtocols
2240
2267
  # @return [Types::OriginSslProtocols]
2241
2268
  #
2242
2269
  # @!attribute [rw] origin_read_timeout
2243
- # You can create a custom origin read timeout. All timeout units are
2244
- # in seconds. The default origin read timeout is 30 seconds, but you
2245
- # can configure custom timeout lengths using the CloudFront API. The
2246
- # minimum timeout length is 4 seconds; the maximum is 60 seconds.
2270
+ # Specifies how long, in seconds, CloudFront waits for a response from
2271
+ # the origin. This is also known as the *origin response timeout*. The
2272
+ # minimum timeout is 1 second, the maximum is 60 seconds, and the
2273
+ # default (if you don’t specify otherwise) is 30 seconds.
2247
2274
  #
2248
- # If you need to increase the maximum time limit, contact the [AWS
2249
- # Support Center][1].
2275
+ # For more information, see [Origin Response Timeout][1] in the
2276
+ # *Amazon CloudFront Developer Guide*.
2250
2277
  #
2251
2278
  #
2252
2279
  #
2253
- # [1]: https://console.aws.amazon.com/support/home#/
2280
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginResponseTimeout
2254
2281
  # @return [Integer]
2255
2282
  #
2256
2283
  # @!attribute [rw] origin_keepalive_timeout
2257
- # You can create a custom keep-alive timeout. All timeout units are in
2258
- # seconds. The default keep-alive timeout is 5 seconds, but you can
2259
- # configure custom timeout lengths using the CloudFront API. The
2260
- # minimum timeout length is 1 second; the maximum is 60 seconds.
2284
+ # Specifies how long, in seconds, CloudFront persists its connection
2285
+ # to the origin. The minimum timeout is 1 second, the maximum is 60
2286
+ # seconds, and the default (if you don’t specify otherwise) is 5
2287
+ # seconds.
2261
2288
  #
2262
- # If you need to increase the maximum time limit, contact the [AWS
2263
- # Support Center][1].
2289
+ # For more information, see [Origin Keep-alive Timeout][1] in the
2290
+ # *Amazon CloudFront Developer Guide*.
2264
2291
  #
2265
2292
  #
2266
2293
  #
2267
- # [1]: https://console.aws.amazon.com/support/home#/
2294
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginKeepaliveTimeout
2268
2295
  # @return [Integer]
2269
2296
  #
2270
2297
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2019-03-26/CustomOriginConfig AWS API Documentation
@@ -2279,10 +2306,10 @@ module Aws::CloudFront
2279
2306
  include Aws::Structure
2280
2307
  end
2281
2308
 
2282
- # A complex type that describes the default cache behavior if you don't
2283
- # specify a `CacheBehavior` element or if files don't match any of the
2284
- # values of `PathPattern` in `CacheBehavior` elements. You must create
2285
- # exactly one default cache behavior.
2309
+ # A complex type that describes the default cache behavior if you dont
2310
+ # specify a `CacheBehavior` element or if request URLs dont match any
2311
+ # of the values of `PathPattern` in `CacheBehavior` elements. You must
2312
+ # create exactly one default cache behavior.
2286
2313
  #
2287
2314
  # @note When making an API call, you may pass DefaultCacheBehavior
2288
2315
  # data as a hash:
@@ -2341,9 +2368,7 @@ module Aws::CloudFront
2341
2368
  #
2342
2369
  # @!attribute [rw] target_origin_id
2343
2370
  # The value of `ID` for the origin that you want CloudFront to route
2344
- # requests to when a request matches the path pattern either for a
2345
- # cache behavior or for the default cache behavior in your
2346
- # distribution.
2371
+ # requests to when they use the default cache behavior.
2347
2372
  # @return [String]
2348
2373
  #
2349
2374
  # @!attribute [rw] forwarded_values
@@ -2359,15 +2384,15 @@ module Aws::CloudFront
2359
2384
  # target origin that match the `PathPattern` for this cache behavior,
2360
2385
  # specify `true` for `Enabled`, and specify the applicable values for
2361
2386
  # `Quantity` and `Items`. For more information, see [Serving Private
2362
- # Content through CloudFront][1] in the <i> Amazon CloudFront
2363
- # Developer Guide</i>.
2387
+ # Content with Signed URLs and Signed Cookies][1] in the *Amazon
2388
+ # CloudFront Developer Guide*.
2364
2389
  #
2365
- # If you don't want to require signed URLs in requests for objects
2390
+ # If you dont want to require signed URLs in requests for objects
2366
2391
  # that match `PathPattern`, specify `false` for `Enabled` and `0` for
2367
2392
  # `Quantity`. Omit `Items`.
2368
2393
  #
2369
2394
  # To add, change, or remove one or more trusted signers, change
2370
- # `Enabled` to `true` (if it's currently `false`), change `Quantity`
2395
+ # `Enabled` to `true` (if its currently `false`), change `Quantity`
2371
2396
  # as applicable, and specify all of the trusted signers that you want
2372
2397
  # to include in the updated distribution.
2373
2398
  #
@@ -2391,26 +2416,25 @@ module Aws::CloudFront
2391
2416
  # * `https-only`\: If a viewer sends an HTTP request, CloudFront
2392
2417
  # returns an HTTP status code of 403 (Forbidden).
2393
2418
  #
2394
- # For more information about requiring the HTTPS protocol, see [Using
2395
- # an HTTPS Connection to Access Your Objects][1] in the *Amazon
2419
+ # For more information about requiring the HTTPS protocol, see
2420
+ # [Requiring HTTPS Between Viewers and CloudFront][1] in the *Amazon
2396
2421
  # CloudFront Developer Guide*.
2397
2422
  #
2398
2423
  # <note markdown="1"> The only way to guarantee that viewers retrieve an object that was
2399
2424
  # fetched from the origin using HTTPS is never to use any other
2400
2425
  # protocol to fetch the object. If you have recently changed from HTTP
2401
- # to HTTPS, we recommend that you clear your objects' cache because
2426
+ # to HTTPS, we recommend that you clear your objects cache because
2402
2427
  # cached objects are protocol agnostic. That means that an edge
2403
2428
  # location will return an object from the cache regardless of whether
2404
2429
  # the current request protocol matches the protocol used previously.
2405
- # For more information, see [Managing How Long Content Stays in an
2406
- # Edge Cache (Expiration)][2] in the *Amazon CloudFront Developer
2407
- # Guide*.
2430
+ # For more information, see [Managing Cache Expiration][2] in the
2431
+ # *Amazon CloudFront Developer Guide*.
2408
2432
  #
2409
2433
  # </note>
2410
2434
  #
2411
2435
  #
2412
2436
  #
2413
- # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/SecureConnections.html
2437
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/using-https-viewers-to-cloudfront.html
2414
2438
  # [2]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/Expiration.html
2415
2439
  # @return [String]
2416
2440
  #
@@ -2507,8 +2531,7 @@ module Aws::CloudFront
2507
2531
  # @!attribute [rw] field_level_encryption_id
2508
2532
  # The value of `ID` for the field-level encryption configuration that
2509
2533
  # you want CloudFront to use for encrypting specific fields of data
2510
- # for a cache behavior or for the default cache behavior in your
2511
- # distribution.
2534
+ # for the default cache behavior.
2512
2535
  # @return [String]
2513
2536
  #
2514
2537
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2019-03-26/DefaultCacheBehavior AWS API Documentation
@@ -2862,6 +2885,8 @@ module Aws::CloudFront
2862
2885
  # origin_read_timeout: 1,
2863
2886
  # origin_keepalive_timeout: 1,
2864
2887
  # },
2888
+ # connection_attempts: 1,
2889
+ # connection_timeout: 1,
2865
2890
  # },
2866
2891
  # ],
2867
2892
  # },
@@ -3336,6 +3361,8 @@ module Aws::CloudFront
3336
3361
  # origin_read_timeout: 1,
3337
3362
  # origin_keepalive_timeout: 1,
3338
3363
  # },
3364
+ # connection_attempts: 1,
3365
+ # connection_timeout: 1,
3339
3366
  # },
3340
3367
  # ],
3341
3368
  # },
@@ -4976,7 +5003,7 @@ module Aws::CloudFront
4976
5003
  include Aws::Structure
4977
5004
  end
4978
5005
 
4979
- # The argument is invalid.
5006
+ # An argument is invalid.
4980
5007
  #
4981
5008
  # @!attribute [rw] message
4982
5009
  # @return [String]
@@ -6140,19 +6167,36 @@ module Aws::CloudFront
6140
6167
  include Aws::Structure
6141
6168
  end
6142
6169
 
6143
- # A complex type that describes the Amazon S3 bucket, HTTP server (for
6144
- # example, a web server), Amazon MediaStore, or other server from which
6145
- # CloudFront gets your files. This can also be an origin group, if
6146
- # you've created an origin group. You must specify at least one origin
6147
- # or origin group.
6170
+ # An origin.
6171
+ #
6172
+ # An origin is the location where content is stored, and from which
6173
+ # CloudFront gets content to serve to viewers. To specify an origin:
6174
+ #
6175
+ # * Use the `S3OriginConfig` type to specify an Amazon S3 bucket that is
6176
+ # <i> <b>not</b> </i> configured with static website hosting.
6177
+ #
6178
+ # * Use the `CustomOriginConfig` type to specify various other kinds of
6179
+ # content containers or HTTP servers, including:
6180
+ #
6181
+ # * An Amazon S3 bucket that is configured with static website hosting
6182
+ #
6183
+ # * An Elastic Load Balancing load balancer
6184
+ #
6185
+ # * An AWS Elemental MediaPackage origin
6186
+ #
6187
+ # * An AWS Elemental MediaStore container
6148
6188
  #
6149
- # For the current limit on the number of origins or origin groups that
6150
- # you can specify for a distribution, see [Amazon CloudFront Limits][1]
6151
- # in the *AWS General Reference*.
6189
+ # * Any other HTTP server, running on an Amazon EC2 instance or any
6190
+ # other kind of host
6152
6191
  #
6192
+ # For the current maximum number of origins that you can specify per
6193
+ # distribution, see [General Quotas on Web Distributions][1] in the
6194
+ # *Amazon CloudFront Developer Guide* (quotas were formerly referred to
6195
+ # as limits).
6153
6196
  #
6154
6197
  #
6155
- # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_service_limits.html#limits_cloudfront
6198
+ #
6199
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/cloudfront-limits.html#limits-web-distributions
6156
6200
  #
6157
6201
  # @note When making an API call, you may pass Origin
6158
6202
  # data as a hash:
@@ -6184,108 +6228,101 @@ module Aws::CloudFront
6184
6228
  # origin_read_timeout: 1,
6185
6229
  # origin_keepalive_timeout: 1,
6186
6230
  # },
6231
+ # connection_attempts: 1,
6232
+ # connection_timeout: 1,
6187
6233
  # }
6188
6234
  #
6189
6235
  # @!attribute [rw] id
6190
- # A unique identifier for the origin or origin group. The value of
6191
- # `Id` must be unique within the distribution.
6192
- #
6193
- # When you specify the value of `TargetOriginId` for the default cache
6194
- # behavior or for another cache behavior, you indicate the origin to
6195
- # which you want the cache behavior to route requests by specifying
6196
- # the value of the `Id` element for that origin. When a request
6197
- # matches the path pattern for that cache behavior, CloudFront routes
6198
- # the request to the specified origin. For more information, see
6199
- # [Cache Behavior Settings][1] in the *Amazon CloudFront Developer
6200
- # Guide*.
6236
+ # A unique identifier for the origin. This value must be unique within
6237
+ # the distribution.
6201
6238
  #
6239
+ # Use this value to specify the `TargetOriginId` in a `CacheBehavior`
6240
+ # or `DefaultCacheBehavior`.
6241
+ # @return [String]
6202
6242
  #
6243
+ # @!attribute [rw] domain_name
6244
+ # The domain name for the origin.
6203
6245
  #
6204
- # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesCacheBehavior
6246
+ # For more information, see [Origin Domain Name][1] in the *Amazon
6247
+ # CloudFront Developer Guide*.
6248
+ #
6249
+ #
6250
+ #
6251
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesDomainName
6205
6252
  # @return [String]
6206
6253
  #
6207
- # @!attribute [rw] domain_name
6208
- # **Amazon S3 origins**\: The DNS name of the Amazon S3 bucket from
6209
- # which you want CloudFront to get objects for this origin, for
6210
- # example, `myawsbucket.s3.amazonaws.com`. If you set up your bucket
6211
- # to be configured as a website endpoint, enter the Amazon S3 static
6212
- # website hosting endpoint for the bucket.
6213
- #
6214
- # For more information about specifying this value for different types
6215
- # of origins, see [Origin Domain Name][1] in the *Amazon CloudFront
6216
- # Developer Guide*.
6254
+ # @!attribute [rw] origin_path
6255
+ # An optional path that CloudFront appends to the origin domain name
6256
+ # when CloudFront requests content from the origin.
6217
6257
  #
6218
- # Constraints for Amazon S3 origins:
6258
+ # For more information, see [Origin Path][1] in the *Amazon CloudFront
6259
+ # Developer Guide*.
6219
6260
  #
6220
- # * If you configured Amazon S3 Transfer Acceleration for your bucket,
6221
- # don't specify the `s3-accelerate` endpoint for `DomainName`.
6222
6261
  #
6223
- # * The bucket name must be between 3 and 63 characters long
6224
- # (inclusive).
6225
6262
  #
6226
- # * The bucket name must contain only lowercase characters, numbers,
6227
- # periods, underscores, and dashes.
6263
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginPath
6264
+ # @return [String]
6228
6265
  #
6229
- # * The bucket name must not contain adjacent periods.
6266
+ # @!attribute [rw] custom_headers
6267
+ # A list of HTTP header names and values that CloudFront adds to
6268
+ # requests it sends to the origin.
6230
6269
  #
6231
- # **Custom Origins**\: The DNS domain name for the HTTP server from
6232
- # which you want CloudFront to get objects for this origin, for
6233
- # example, `www.example.com`.
6270
+ # For more information, see [Adding Custom Headers to Origin
6271
+ # Requests][1] in the *Amazon CloudFront Developer Guide*.
6234
6272
  #
6235
- # Constraints for custom origins:
6236
6273
  #
6237
- # * `DomainName` must be a valid DNS name that contains only a-z, A-Z,
6238
- # 0-9, dot (.), hyphen (-), or underscore (\_) characters.
6239
6274
  #
6240
- # * The name cannot exceed 128 characters.
6275
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/add-origin-custom-headers.html
6276
+ # @return [Types::CustomHeaders]
6241
6277
  #
6278
+ # @!attribute [rw] s3_origin_config
6279
+ # Use this type to specify an origin that is an Amazon S3 bucket that
6280
+ # is <i> <b>not</b> </i> configured with static website hosting. To
6281
+ # specify any other type of origin, including an Amazon S3 bucket that
6282
+ # is configured with static website hosting, use the
6283
+ # `CustomOriginConfig` type instead.
6284
+ # @return [Types::S3OriginConfig]
6242
6285
  #
6286
+ # @!attribute [rw] custom_origin_config
6287
+ # Use this type to specify an origin that is a content container or
6288
+ # HTTP server, including an Amazon S3 bucket that is configured with
6289
+ # static website hosting. To specify an Amazon S3 bucket that is <i>
6290
+ # <b>not</b> </i> configured with static website hosting, use the
6291
+ # `S3OriginConfig` type instead.
6292
+ # @return [Types::CustomOriginConfig]
6243
6293
  #
6244
- # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesDomainName
6245
- # @return [String]
6294
+ # @!attribute [rw] connection_attempts
6295
+ # The number of times that CloudFront attempts to connect to the
6296
+ # origin. The minimum number is 1, the maximum is 3, and the default
6297
+ # (if you don’t specify otherwise) is 3.
6246
6298
  #
6247
- # @!attribute [rw] origin_path
6248
- # An optional element that causes CloudFront to request your content
6249
- # from a directory in your Amazon S3 bucket or your custom origin.
6250
- # When you include the `OriginPath` element, specify the directory
6251
- # name, beginning with a `/`. CloudFront appends the directory name to
6252
- # the value of `DomainName`, for example, `example.com/production`. Do
6253
- # not include a `/` at the end of the directory name.
6299
+ # For a custom origin (including an Amazon S3 bucket that’s configured
6300
+ # with static website hosting), this value also specifies the number
6301
+ # of times that CloudFront attempts to get a response from the origin,
6302
+ # in the case of an [Origin Response Timeout][1].
6254
6303
  #
6255
- # For example, suppose you've specified the following values for your
6256
- # distribution:
6304
+ # For more information, see [Origin Connection Attempts][2] in the
6305
+ # *Amazon CloudFront Developer Guide*.
6257
6306
  #
6258
- # * `DomainName`\: An Amazon S3 bucket named `myawsbucket`.
6259
6307
  #
6260
- # * `OriginPath`\: `/production`
6261
6308
  #
6262
- # * `CNAME`\: `example.com`
6309
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#DownloadDistValuesOriginResponseTimeout
6310
+ # [2]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#origin-connection-attempts
6311
+ # @return [Integer]
6263
6312
  #
6264
- # When a user enters `example.com/index.html` in a browser, CloudFront
6265
- # sends a request to Amazon S3 for
6266
- # `myawsbucket/production/index.html`.
6313
+ # @!attribute [rw] connection_timeout
6314
+ # The number of seconds that CloudFront waits when trying to establish
6315
+ # a connection to the origin. The minimum timeout is 1 second, the
6316
+ # maximum is 10 seconds, and the default (if you don’t specify
6317
+ # otherwise) is 10 seconds.
6267
6318
  #
6268
- # When a user enters `example.com/acme/index.html` in a browser,
6269
- # CloudFront sends a request to Amazon S3 for
6270
- # `myawsbucket/production/acme/index.html`.
6271
- # @return [String]
6319
+ # For more information, see [Origin Connection Timeout][1] in the
6320
+ # *Amazon CloudFront Developer Guide*.
6272
6321
  #
6273
- # @!attribute [rw] custom_headers
6274
- # A complex type that contains names and values for the custom headers
6275
- # that you want.
6276
- # @return [Types::CustomHeaders]
6277
6322
  #
6278
- # @!attribute [rw] s3_origin_config
6279
- # A complex type that contains information about the Amazon S3 origin.
6280
- # If the origin is a custom origin, use the `CustomOriginConfig`
6281
- # element instead.
6282
- # @return [Types::S3OriginConfig]
6283
6323
  #
6284
- # @!attribute [rw] custom_origin_config
6285
- # A complex type that contains information about a custom origin. If
6286
- # the origin is an Amazon S3 bucket, use the `S3OriginConfig` element
6287
- # instead.
6288
- # @return [Types::CustomOriginConfig]
6324
+ # [1]: https://docs.aws.amazon.com/AmazonCloudFront/latest/DeveloperGuide/distribution-web-values-specify.html#origin-connection-timeout
6325
+ # @return [Integer]
6289
6326
  #
6290
6327
  # @see http://docs.aws.amazon.com/goto/WebAPI/cloudfront-2019-03-26/Origin AWS API Documentation
6291
6328
  #
@@ -6295,7 +6332,9 @@ module Aws::CloudFront
6295
6332
  :origin_path,
6296
6333
  :custom_headers,
6297
6334
  :s3_origin_config,
6298
- :custom_origin_config)
6335
+ :custom_origin_config,
6336
+ :connection_attempts,
6337
+ :connection_timeout)
6299
6338
  include Aws::Structure
6300
6339
  end
6301
6340
 
@@ -6573,6 +6612,8 @@ module Aws::CloudFront
6573
6612
  # origin_read_timeout: 1,
6574
6613
  # origin_keepalive_timeout: 1,
6575
6614
  # },
6615
+ # connection_attempts: 1,
6616
+ # connection_timeout: 1,
6576
6617
  # },
6577
6618
  # ],
6578
6619
  # }
@@ -6628,7 +6669,7 @@ module Aws::CloudFront
6628
6669
  include Aws::Structure
6629
6670
  end
6630
6671
 
6631
- # The precondition given in one or more of the request-header fields
6672
+ # The precondition given in one or more of the request header fields
6632
6673
  # evaluated to `false`.
6633
6674
  #
6634
6675
  # @!attribute [rw] message
@@ -7017,8 +7058,8 @@ module Aws::CloudFront
7017
7058
  end
7018
7059
 
7019
7060
  # A complex type that contains information about the Amazon S3 origin.
7020
- # If the origin is a custom origin, use the `CustomOriginConfig` element
7021
- # instead.
7061
+ # If the origin is a custom origin or an S3 bucket that is configured as
7062
+ # a website endpoint, use the `CustomOriginConfig` element instead.
7022
7063
  #
7023
7064
  # @note When making an API call, you may pass S3OriginConfig
7024
7065
  # data as a hash:
@@ -8180,6 +8221,8 @@ module Aws::CloudFront
8180
8221
  # origin_read_timeout: 1,
8181
8222
  # origin_keepalive_timeout: 1,
8182
8223
  # },
8224
+ # connection_attempts: 1,
8225
+ # connection_timeout: 1,
8183
8226
  # },
8184
8227
  # ],
8185
8228
  # },
@@ -1,3 +1,5 @@
1
+ # frozen_string_literal: true
2
+
1
3
  # WARNING ABOUT GENERATED CODE
2
4
  #
3
5
  # This file is generated. See the contributing guide for more information:
@@ -8,6 +10,69 @@
8
10
  require 'aws-sdk-core/waiters'
9
11
 
10
12
  module Aws::CloudFront
13
+ # Waiters are utility methods that poll for a particular state to occur
14
+ # on a client. Waiters can fail after a number of attempts at a polling
15
+ # interval defined for the service client.
16
+ #
17
+ # For a list of operations that can be waited for and the
18
+ # client methods called for each operation, see the table below or the
19
+ # {Client#wait_until} field documentation for the {Client}.
20
+ #
21
+ # # Invoking a Waiter
22
+ # To invoke a waiter, call #wait_until on a {Client}. The first parameter
23
+ # is the waiter name, which is specific to the service client and indicates
24
+ # which operation is being waited for. The second parameter is a hash of
25
+ # parameters that are passed to the client method called by the waiter,
26
+ # which varies according to the waiter name.
27
+ #
28
+ # # Wait Failures
29
+ # To catch errors in a waiter, use WaiterFailed,
30
+ # as shown in the following example.
31
+ #
32
+ # rescue rescue Aws::Waiters::Errors::WaiterFailed => error
33
+ # puts "failed waiting for instance running: #{error.message}
34
+ # end
35
+ #
36
+ # # Configuring a Waiter
37
+ # Each waiter has a default polling interval and a maximum number of
38
+ # attempts it will make before returning control to your program.
39
+ # To set these values, use the `max_attempts` and `delay` parameters
40
+ # in your `#wait_until` call.
41
+ # The following example waits for up to 25 seconds, polling every five seconds.
42
+ #
43
+ # client.wait_until(...) do |w|
44
+ # w.max_attempts = 5
45
+ # w.delay = 5
46
+ # end
47
+ #
48
+ # To disable wait failures, set the value of either of these parameters
49
+ # to `nil`.
50
+ #
51
+ # # Extending a Waiter
52
+ # To modify the behavior of waiters, you can register callbacks that are
53
+ # triggered before each polling attempt and before waiting.
54
+ #
55
+ # The following example implements an exponential backoff in a waiter
56
+ # by doubling the amount of time to wait on every attempt.
57
+ #
58
+ # client.wait_until(...) do |w|
59
+ # w.interval = 0 # disable normal sleep
60
+ # w.before_wait do |n, resp|
61
+ # sleep(n ** 2)
62
+ # end
63
+ # end
64
+ #
65
+ # # Available Waiters
66
+ #
67
+ # The following table lists the valid waiter names, the operations they call,
68
+ # and the default `:delay` and `:max_attempts` values.
69
+ #
70
+ # | waiter_name | params | :delay | :max_attempts |
71
+ # | ------------------------------- | ----------------------------------- | -------- | ------------- |
72
+ # | distribution_deployed | {Client#get_distribution} | 60 | 35 |
73
+ # | invalidation_completed | {Client#get_invalidation} | 20 | 30 |
74
+ # | streaming_distribution_deployed | {Client#get_streaming_distribution} | 60 | 25 |
75
+ #
11
76
  module Waiters
12
77
 
13
78
  # Wait until a distribution is deployed.
metadata CHANGED
@@ -1,14 +1,14 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-cloudfront
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.26.0
4
+ version: 1.31.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services
8
8
  autorequire:
9
9
  bindir: bin
10
10
  cert_chain: []
11
- date: 2020-03-09 00:00:00.000000000 Z
11
+ date: 2020-06-16 00:00:00.000000000 Z
12
12
  dependencies:
13
13
  - !ruby/object:Gem::Dependency
14
14
  name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
19
19
  version: '3'
20
20
  - - ">="
21
21
  - !ruby/object:Gem::Version
22
- version: 3.71.0
22
+ version: 3.99.0
23
23
  type: :runtime
24
24
  prerelease: false
25
25
  version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
29
29
  version: '3'
30
30
  - - ">="
31
31
  - !ruby/object:Gem::Version
32
- version: 3.71.0
32
+ version: 3.99.0
33
33
  - !ruby/object:Gem::Dependency
34
34
  name: aws-sigv4
35
35
  requirement: !ruby/object:Gem::Requirement
@@ -85,7 +85,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
85
85
  version: '0'
86
86
  requirements: []
87
87
  rubyforge_project:
88
- rubygems_version: 2.5.2.3
88
+ rubygems_version: 2.7.6.2
89
89
  signing_key:
90
90
  specification_version: 4
91
91
  summary: AWS SDK for Ruby - CloudFront