aws-sdk-cloudfront 1.26.0 → 1.31.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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