aws-sdk-s3 1.92.0 → 1.95.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.
@@ -247,7 +247,7 @@ module Aws::S3
247
247
  # request. Bucket owners need not specify this parameter in their
248
248
  # requests. For information about downloading objects from requester
249
249
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
250
- # in the *Amazon S3 Developer Guide*.
250
+ # in the *Amazon S3 User Guide*.
251
251
  #
252
252
  #
253
253
  #
@@ -347,7 +347,7 @@ module Aws::S3
347
347
  # request. Bucket owners need not specify this parameter in their
348
348
  # requests. For information about downloading objects from requester
349
349
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
350
- # in the *Amazon S3 Developer Guide*.
350
+ # in the *Amazon S3 User Guide*.
351
351
  #
352
352
  #
353
353
  #
@@ -431,7 +431,7 @@ module Aws::S3
431
431
  # request. Bucket owners need not specify this parameter in their
432
432
  # requests. For information about downloading objects from requester
433
433
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
434
- # in the *Amazon S3 Developer Guide*.
434
+ # in the *Amazon S3 User Guide*.
435
435
  #
436
436
  #
437
437
  #
@@ -536,7 +536,7 @@ module Aws::S3
536
536
  # request. Bucket owners need not specify this parameter in their
537
537
  # requests. For information about downloading objects from requester
538
538
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
539
- # in the *Amazon S3 Developer Guide*.
539
+ # in the *Amazon S3 User Guide*.
540
540
  #
541
541
  #
542
542
  #
@@ -39,6 +39,7 @@ be made. Set to `false` to use the client's region instead.
39
39
  context.http_request.endpoint,
40
40
  context.metadata[:s3_arn][:arn],
41
41
  context.metadata[:s3_arn][:resolved_region],
42
+ context.metadata[:s3_arn][:fips],
42
43
  context.metadata[:s3_arn][:dualstack],
43
44
  # if regional_endpoint is false, a custom endpoint was provided
44
45
  # in this case, we want to prefix the endpoint using the ARN
@@ -63,9 +64,17 @@ be made. Set to `false` to use the client's region instead.
63
64
  if arn
64
65
  validate_config!(context, arn)
65
66
 
67
+ fips = false
68
+ if resolved_region.include?('fips')
69
+ fips = true
70
+ resolved_region = resolved_region.gsub('fips-', '')
71
+ .gsub('-fips', '')
72
+ end
73
+
66
74
  context.metadata[:s3_arn] = {
67
75
  arn: arn,
68
76
  resolved_region: resolved_region,
77
+ fips: fips,
69
78
  dualstack: extract_dualstack_config!(context)
70
79
  }
71
80
  end
@@ -118,7 +127,7 @@ be made. Set to `false` to use the client's region instead.
118
127
  s3_arn = resolve_arn_type!(arn)
119
128
  s3_arn.validate_arn!
120
129
  validate_region_config!(s3_arn, region, use_arn_region)
121
- region = s3_arn.region if use_arn_region
130
+ region = s3_arn.region if use_arn_region && !region.include?('fips')
122
131
  [region, s3_arn]
123
132
  else
124
133
  [region]
@@ -126,9 +135,9 @@ be made. Set to `false` to use the client's region instead.
126
135
  end
127
136
 
128
137
  # @api private
129
- def resolve_url!(url, arn, region, dualstack = false, has_custom_endpoint = false)
138
+ def resolve_url!(url, arn, region, fips = false, dualstack = false, has_custom_endpoint = false)
130
139
  custom_endpoint = url.host if has_custom_endpoint
131
- url.host = arn.host_url(region, dualstack, custom_endpoint)
140
+ url.host = arn.host_url(region, fips, dualstack, custom_endpoint)
132
141
  url.path = url_path(url.path, arn)
133
142
  url
134
143
  end
@@ -174,33 +183,40 @@ be made. Set to `false` to use the client's region instead.
174
183
  end
175
184
 
176
185
  def validate_region_config!(arn, region, use_arn_region)
177
- fips = arn.support_fips?
178
-
179
- # s3-external-1 is specific just to s3 and not part of partitions
180
- # aws-global is a partition region
181
- unless arn.partition == 'aws' &&
182
- (region == 's3-external-1' || region == 'aws-global')
183
- if !fips && arn.region.include?('fips')
184
- raise ArgumentError,
185
- 'FIPS region ARNs are not supported for this type of ARN.'
186
+ if ['s3-external-1', 'aws-global'].include?(region)
187
+ # These "regions" are not regional endpoints
188
+ unless use_arn_region
189
+ raise Aws::Errors::InvalidARNRegionError,
190
+ 'Configured client region is not a regional endpoint.'
186
191
  end
187
-
188
- if !fips && !use_arn_region && region.include?('fips')
189
- raise ArgumentError,
190
- 'FIPS client regions are not supported for this type of '\
191
- 'ARN without `:s3_use_arn_region`.'
192
+ # These "regions" are in the AWS partition
193
+ # Cannot use ARN region unless it's the same partition
194
+ unless arn.partition == 'aws'
195
+ raise Aws::Errors::InvalidARNPartitionError
192
196
  end
193
-
194
- # if it's a fips region, attempt to normalize it
195
- if fips || use_arn_region
197
+ else
198
+ if region.include?('fips')
199
+ # If ARN type doesn't support FIPS but the client region is FIPS
200
+ unless arn.support_fips?
201
+ raise ArgumentError,
202
+ 'FIPS client regions are not supported for this type '\
203
+ 'of ARN.'
204
+ end
205
+
206
+ fips = true
207
+ # Normalize the region so we can compare partition and regions
196
208
  region = region.gsub('fips-', '').gsub('-fips', '')
197
209
  end
210
+
211
+ # Raise if the ARN and client regions are in different partitions
198
212
  if use_arn_region &&
199
213
  !Aws::Partitions.partition(arn.partition).region?(region)
200
214
  raise Aws::Errors::InvalidARNPartitionError
201
215
  end
202
216
 
203
- if !use_arn_region && region != arn.region
217
+ # Raise if regions mismatch
218
+ # Either when it's a fips client or not using the ARN region
219
+ if (!use_arn_region || fips) && region != arn.region
204
220
  raise Aws::Errors::InvalidARNRegionError
205
221
  end
206
222
  end
@@ -138,6 +138,7 @@ module Aws
138
138
 
139
139
  req = @client.build_request(method, params)
140
140
  use_bucket_as_hostname(req) if virtual_host
141
+ handle_presigned_url_context(req)
141
142
 
142
143
  x_amz_headers = sign_but_dont_send(
143
144
  req, expires_in, scheme, time, unsigned_headers, hoist
@@ -183,6 +184,17 @@ module Aws
183
184
  end
184
185
  end
185
186
 
187
+ # Used for excluding presigned_urls from API request count.
188
+ #
189
+ # Store context information as early as possible, to allow
190
+ # handlers to perform decisions based on this flag if need.
191
+ def handle_presigned_url_context(req)
192
+ req.handle(step: :initialize, priority: 98) do |context|
193
+ context[:presigned_url] = true
194
+ @handler.call(context)
195
+ end
196
+ end
197
+
186
198
  # @param [Seahorse::Client::Request] req
187
199
  def sign_but_dont_send(
188
200
  req, expires_in, scheme, time, unsigned_headers, hoist = true
@@ -242,9 +254,6 @@ module Aws
242
254
  time: time
243
255
  ).to_s
244
256
 
245
- # Used for excluding presigned_urls from API request count
246
- context[:presigned_url] = true
247
-
248
257
  Seahorse::Client::Response.new(context: context, data: url)
249
258
  end
250
259
  # Return the headers
@@ -65,8 +65,10 @@ module Aws::S3
65
65
  # @option options [String] :grant_read_acp
66
66
  # Allows grantee to read the bucket ACL.
67
67
  # @option options [String] :grant_write
68
- # Allows grantee to create, overwrite, and delete any object in the
69
- # bucket.
68
+ # Allows grantee to create new objects in the bucket.
69
+ #
70
+ # For the bucket and object owners of existing objects, also allows
71
+ # deletions and overwrites of those objects.
70
72
  # @option options [String] :grant_write_acp
71
73
  # Allows grantee to write the ACL for the applicable bucket.
72
74
  # @option options [Boolean] :object_lock_enabled_for_bucket
@@ -14,7 +14,7 @@ module Aws::S3
14
14
  # upload that Amazon S3 will wait before permanently removing all parts
15
15
  # of the upload. For more information, see [ Aborting Incomplete
16
16
  # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
17
- # Simple Storage Service Developer Guide*.
17
+ # S3 User Guide*.
18
18
  #
19
19
  #
20
20
  #
@@ -73,8 +73,8 @@ module Aws::S3
73
73
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
74
74
  # When using this action with an access point through the AWS SDKs,
75
75
  # you provide the access point ARN in place of the bucket name. For
76
- # more information about access point ARNs, see [Using Access
77
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
76
+ # more information about access point ARNs, see [Using access
77
+ # points][1] in the *Amazon S3 User Guide*.
78
78
  #
79
79
  # When using this action with Amazon S3 on Outposts, you must direct
80
80
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -83,7 +83,7 @@ module Aws::S3
83
83
  # When using this action using S3 on Outposts through the AWS SDKs,
84
84
  # you provide the Outposts bucket ARN in place of the bucket name. For
85
85
  # more information about S3 on Outposts ARNs, see [Using S3 on
86
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
86
+ # Outposts][2] in the *Amazon S3 User Guide*.
87
87
  #
88
88
  #
89
89
  #
@@ -104,7 +104,7 @@ module Aws::S3
104
104
  # request. Bucket owners need not specify this parameter in their
105
105
  # requests. For information about downloading objects from requester
106
106
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
107
- # in the *Amazon S3 Developer Guide*.
107
+ # in the *Amazon S3 User Guide*.
108
108
  #
109
109
  #
110
110
  #
@@ -131,7 +131,7 @@ module Aws::S3
131
131
 
132
132
  # Configures the transfer acceleration state for an Amazon S3 bucket.
133
133
  # For more information, see [Amazon S3 Transfer Acceleration][1] in the
134
- # *Amazon Simple Storage Service Developer Guide*.
134
+ # *Amazon S3 User Guide*.
135
135
  #
136
136
  #
137
137
  #
@@ -209,8 +209,7 @@ module Aws::S3
209
209
  #
210
210
  # @!attribute [rw] owner
211
211
  # Specifies the replica ownership. For default and valid values, see
212
- # [PUT bucket replication][1] in the *Amazon Simple Storage Service
213
- # API Reference*.
212
+ # [PUT bucket replication][1] in the *Amazon S3 API Reference*.
214
213
  #
215
214
  #
216
215
  #
@@ -492,7 +491,7 @@ module Aws::S3
492
491
 
493
492
  # Specifies the lifecycle configuration for objects in an Amazon S3
494
493
  # bucket. For more information, see [Object Lifecycle Management][1] in
495
- # the *Amazon Simple Storage Service Developer Guide*.
494
+ # the *Amazon S3 User Guide*.
496
495
  #
497
496
  #
498
497
  #
@@ -590,8 +589,7 @@ module Aws::S3
590
589
  # @!attribute [rw] logging_enabled
591
590
  # Describes where logs are stored and the prefix that Amazon S3
592
591
  # assigns to all log object keys for a bucket. For more information,
593
- # see [PUT Bucket logging][1] in the *Amazon Simple Storage Service
594
- # API Reference*.
592
+ # see [PUT Bucket logging][1] in the *Amazon S3 API Reference*.
595
593
  #
596
594
  #
597
595
  #
@@ -608,8 +606,7 @@ module Aws::S3
608
606
 
609
607
  # Describes the cross-origin access configuration for objects in an
610
608
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
611
- # Resource Sharing][1] in the *Amazon Simple Storage Service Developer
612
- # Guide*.
609
+ # Resource Sharing][1] in the *Amazon S3 User Guide*.
613
610
  #
614
611
  #
615
612
  #
@@ -925,8 +922,8 @@ module Aws::S3
925
922
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
926
923
  # When using this action with an access point through the AWS SDKs,
927
924
  # you provide the access point ARN in place of the bucket name. For
928
- # more information about access point ARNs, see [Using Access
929
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
925
+ # more information about access point ARNs, see [Using access
926
+ # points][1] in the *Amazon S3 User Guide*.
930
927
  #
931
928
  # When using this action with Amazon S3 on Outposts, you must direct
932
929
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -935,7 +932,7 @@ module Aws::S3
935
932
  # When using this action using S3 on Outposts through the AWS SDKs,
936
933
  # you provide the Outposts bucket ARN in place of the bucket name. For
937
934
  # more information about S3 on Outposts ARNs, see [Using S3 on
938
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
935
+ # Outposts][2] in the *Amazon S3 User Guide*.
939
936
  #
940
937
  #
941
938
  #
@@ -1049,7 +1046,7 @@ module Aws::S3
1049
1046
  # request. Bucket owners need not specify this parameter in their
1050
1047
  # requests. For information about downloading objects from requester
1051
1048
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
1052
- # in the *Amazon S3 Developer Guide*.
1049
+ # in the *Amazon S3 User Guide*.
1053
1050
  #
1054
1051
  #
1055
1052
  #
@@ -1327,8 +1324,8 @@ module Aws::S3
1327
1324
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
1328
1325
  # When using this action with an access point through the AWS SDKs,
1329
1326
  # you provide the access point ARN in place of the bucket name. For
1330
- # more information about access point ARNs, see [Using Access
1331
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
1327
+ # more information about access point ARNs, see [Using access
1328
+ # points][1] in the *Amazon S3 User Guide*.
1332
1329
  #
1333
1330
  # When using this action with Amazon S3 on Outposts, you must direct
1334
1331
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -1337,7 +1334,7 @@ module Aws::S3
1337
1334
  # When using this action using S3 on Outposts through the AWS SDKs,
1338
1335
  # you provide the Outposts bucket ARN in place of the bucket name. For
1339
1336
  # more information about S3 on Outposts ARNs, see [Using S3 on
1340
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
1337
+ # Outposts][2] in the *Amazon S3 User Guide*.
1341
1338
  #
1342
1339
  #
1343
1340
  #
@@ -1491,7 +1488,7 @@ module Aws::S3
1491
1488
  # and high availability. Depending on performance needs, you can
1492
1489
  # specify a different Storage Class. Amazon S3 on Outposts only uses
1493
1490
  # the OUTPOSTS Storage Class. For more information, see [Storage
1494
- # Classes][1] in the *Amazon S3 Service Developer Guide*.
1491
+ # Classes][1] in the *Amazon S3 User Guide*.
1495
1492
  #
1496
1493
  #
1497
1494
  #
@@ -1530,7 +1527,7 @@ module Aws::S3
1530
1527
  # made via SSL or using SigV4. For information about configuring using
1531
1528
  # any of the officially supported AWS SDKs and AWS CLI, see
1532
1529
  # [Specifying the Signature Version in Request Authentication][1] in
1533
- # the *Amazon S3 Developer Guide*.
1530
+ # the *Amazon S3 User Guide*.
1534
1531
  #
1535
1532
  #
1536
1533
  #
@@ -1575,7 +1572,7 @@ module Aws::S3
1575
1572
  # request. Bucket owners need not specify this parameter in their
1576
1573
  # requests. For information about downloading objects from requester
1577
1574
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
1578
- # in the *Amazon S3 Developer Guide*.
1575
+ # in the *Amazon S3 User Guide*.
1579
1576
  #
1580
1577
  #
1581
1578
  #
@@ -1782,8 +1779,10 @@ module Aws::S3
1782
1779
  # @return [String]
1783
1780
  #
1784
1781
  # @!attribute [rw] grant_write
1785
- # Allows grantee to create, overwrite, and delete any object in the
1786
- # bucket.
1782
+ # Allows grantee to create new objects in the bucket.
1783
+ #
1784
+ # For the bucket and object owners of existing objects, also allows
1785
+ # deletions and overwrites of those objects.
1787
1786
  # @return [String]
1788
1787
  #
1789
1788
  # @!attribute [rw] grant_write_acp
@@ -1844,8 +1843,8 @@ module Aws::S3
1844
1843
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
1845
1844
  # When using this action with an access point through the AWS SDKs,
1846
1845
  # you provide the access point ARN in place of the bucket name. For
1847
- # more information about access point ARNs, see [Using Access
1848
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
1846
+ # more information about access point ARNs, see [Using access
1847
+ # points][1] in the *Amazon S3 User Guide*.
1849
1848
  #
1850
1849
  # When using this action with Amazon S3 on Outposts, you must direct
1851
1850
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -1854,7 +1853,7 @@ module Aws::S3
1854
1853
  # When using this action using S3 on Outposts through the AWS SDKs,
1855
1854
  # you provide the Outposts bucket ARN in place of the bucket name. For
1856
1855
  # more information about S3 on Outposts ARNs, see [Using S3 on
1857
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
1856
+ # Outposts][2] in the *Amazon S3 User Guide*.
1858
1857
  #
1859
1858
  #
1860
1859
  #
@@ -1982,8 +1981,8 @@ module Aws::S3
1982
1981
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
1983
1982
  # When using this action with an access point through the AWS SDKs,
1984
1983
  # you provide the access point ARN in place of the bucket name. For
1985
- # more information about access point ARNs, see [Using Access
1986
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
1984
+ # more information about access point ARNs, see [Using access
1985
+ # points][1] in the *Amazon S3 User Guide*.
1987
1986
  #
1988
1987
  # When using this action with Amazon S3 on Outposts, you must direct
1989
1988
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -1992,7 +1991,7 @@ module Aws::S3
1992
1991
  # When using this action using S3 on Outposts through the AWS SDKs,
1993
1992
  # you provide the Outposts bucket ARN in place of the bucket name. For
1994
1993
  # more information about S3 on Outposts ARNs, see [Using S3 on
1995
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
1994
+ # Outposts][2] in the *Amazon S3 User Guide*.
1996
1995
  #
1997
1996
  #
1998
1997
  #
@@ -2070,7 +2069,7 @@ module Aws::S3
2070
2069
  # and high availability. Depending on performance needs, you can
2071
2070
  # specify a different Storage Class. Amazon S3 on Outposts only uses
2072
2071
  # the OUTPOSTS Storage Class. For more information, see [Storage
2073
- # Classes][1] in the *Amazon S3 Service Developer Guide*.
2072
+ # Classes][1] in the *Amazon S3 User Guide*.
2074
2073
  #
2075
2074
  #
2076
2075
  #
@@ -2109,8 +2108,7 @@ module Aws::S3
2109
2108
  # protected by AWS KMS will fail if not made via SSL or using SigV4.
2110
2109
  # For information about configuring using any of the officially
2111
2110
  # supported AWS SDKs and AWS CLI, see [Specifying the Signature
2112
- # Version in Request Authentication][1] in the *Amazon S3 Developer
2113
- # Guide*.
2111
+ # Version in Request Authentication][1] in the *Amazon S3 User Guide*.
2114
2112
  #
2115
2113
  #
2116
2114
  #
@@ -2138,7 +2136,7 @@ module Aws::S3
2138
2136
  # request. Bucket owners need not specify this parameter in their
2139
2137
  # requests. For information about downloading objects from requester
2140
2138
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
2141
- # in the *Amazon S3 Developer Guide*.
2139
+ # in the *Amazon S3 User Guide*.
2142
2140
  #
2143
2141
  #
2144
2142
  #
@@ -2209,6 +2207,14 @@ module Aws::S3
2209
2207
  # The container element for specifying the default Object Lock retention
2210
2208
  # settings for new objects placed in the specified bucket.
2211
2209
  #
2210
+ # <note markdown="1"> * The `DefaultRetention` settings require both a mode and a period.
2211
+ #
2212
+ # * The `DefaultRetention` period can be either `Days` or `Years` but
2213
+ # you must select one. You cannot specify `Days` and `Years` at the
2214
+ # same time.
2215
+ #
2216
+ # </note>
2217
+ #
2212
2218
  # @note When making an API call, you may pass DefaultRetention
2213
2219
  # data as a hash:
2214
2220
  #
@@ -2220,17 +2226,18 @@ module Aws::S3
2220
2226
  #
2221
2227
  # @!attribute [rw] mode
2222
2228
  # The default Object Lock retention mode you want to apply to new
2223
- # objects placed in the specified bucket.
2229
+ # objects placed in the specified bucket. Must be used with either
2230
+ # `Days` or `Years`.
2224
2231
  # @return [String]
2225
2232
  #
2226
2233
  # @!attribute [rw] days
2227
2234
  # The number of days that you want to specify for the default
2228
- # retention period.
2235
+ # retention period. Must be used with `Mode`.
2229
2236
  # @return [Integer]
2230
2237
  #
2231
2238
  # @!attribute [rw] years
2232
2239
  # The number of years that you want to specify for the default
2233
- # retention period.
2240
+ # retention period. Must be used with `Mode`.
2234
2241
  # @return [Integer]
2235
2242
  #
2236
2243
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DefaultRetention AWS API Documentation
@@ -2777,8 +2784,8 @@ module Aws::S3
2777
2784
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
2778
2785
  # When using this action with an access point through the AWS SDKs,
2779
2786
  # you provide the access point ARN in place of the bucket name. For
2780
- # more information about access point ARNs, see [Using Access
2781
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
2787
+ # more information about access point ARNs, see [Using access
2788
+ # points][1] in the *Amazon S3 User Guide*.
2782
2789
  #
2783
2790
  # When using this action with Amazon S3 on Outposts, you must direct
2784
2791
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2787,7 +2794,7 @@ module Aws::S3
2787
2794
  # When using this action using S3 on Outposts through the AWS SDKs,
2788
2795
  # you provide the Outposts bucket ARN in place of the bucket name. For
2789
2796
  # more information about S3 on Outposts ARNs, see [Using S3 on
2790
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
2797
+ # Outposts][2] in the *Amazon S3 User Guide*.
2791
2798
  #
2792
2799
  #
2793
2800
  #
@@ -2815,7 +2822,7 @@ module Aws::S3
2815
2822
  # request. Bucket owners need not specify this parameter in their
2816
2823
  # requests. For information about downloading objects from requester
2817
2824
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
2818
- # in the *Amazon S3 Developer Guide*.
2825
+ # in the *Amazon S3 User Guide*.
2819
2826
  #
2820
2827
  #
2821
2828
  #
@@ -2879,8 +2886,8 @@ module Aws::S3
2879
2886
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
2880
2887
  # When using this action with an access point through the AWS SDKs,
2881
2888
  # you provide the access point ARN in place of the bucket name. For
2882
- # more information about access point ARNs, see [Using Access
2883
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
2889
+ # more information about access point ARNs, see [Using access
2890
+ # points][1] in the *Amazon S3 User Guide*.
2884
2891
  #
2885
2892
  # When using this action with Amazon S3 on Outposts, you must direct
2886
2893
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2889,7 +2896,7 @@ module Aws::S3
2889
2896
  # When using this action using S3 on Outposts through the AWS SDKs,
2890
2897
  # you provide the Outposts bucket ARN in place of the bucket name. For
2891
2898
  # more information about S3 on Outposts ARNs, see [Using S3 on
2892
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
2899
+ # Outposts][2] in the *Amazon S3 User Guide*.
2893
2900
  #
2894
2901
  #
2895
2902
  #
@@ -2977,8 +2984,8 @@ module Aws::S3
2977
2984
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
2978
2985
  # When using this action with an access point through the AWS SDKs,
2979
2986
  # you provide the access point ARN in place of the bucket name. For
2980
- # more information about access point ARNs, see [Using Access
2981
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
2987
+ # more information about access point ARNs, see [Using access
2988
+ # points][1] in the *Amazon S3 User Guide*.
2982
2989
  #
2983
2990
  # When using this action with Amazon S3 on Outposts, you must direct
2984
2991
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2987,7 +2994,7 @@ module Aws::S3
2987
2994
  # When using this action using S3 on Outposts through the AWS SDKs,
2988
2995
  # you provide the Outposts bucket ARN in place of the bucket name. For
2989
2996
  # more information about S3 on Outposts ARNs, see [Using S3 on
2990
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
2997
+ # Outposts][2] in the *Amazon S3 User Guide*.
2991
2998
  #
2992
2999
  #
2993
3000
  #
@@ -3011,7 +3018,7 @@ module Aws::S3
3011
3018
  # request. Bucket owners need not specify this parameter in their
3012
3019
  # requests. For information about downloading objects from requester
3013
3020
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
3014
- # in the *Amazon S3 Developer Guide*.
3021
+ # in the *Amazon S3 User Guide*.
3015
3022
  #
3016
3023
  #
3017
3024
  #
@@ -3149,7 +3156,7 @@ module Aws::S3
3149
3156
  # `AccessControlTranslation` property, this is the account ID of the
3150
3157
  # destination bucket owner. For more information, see [Replication
3151
3158
  # Additional Configuration: Changing the Replica Owner][1] in the
3152
- # *Amazon Simple Storage Service Developer Guide*.
3159
+ # *Amazon S3 User Guide*.
3153
3160
  #
3154
3161
  #
3155
3162
  #
@@ -3162,8 +3169,7 @@ module Aws::S3
3162
3169
  # storage class of the source object to create the object replica.
3163
3170
  #
3164
3171
  # For valid values, see the `StorageClass` element of the [PUT Bucket
3165
- # replication][1] action in the *Amazon Simple Storage Service API
3166
- # Reference*.
3172
+ # replication][1] action in the *Amazon S3 API Reference*.
3167
3173
  #
3168
3174
  #
3169
3175
  #
@@ -3231,7 +3237,7 @@ module Aws::S3
3231
3237
  # If the encryption type is `aws:kms`, this optional value specifies
3232
3238
  # the ID of the symmetric customer managed AWS KMS CMK to use for
3233
3239
  # encryption of job results. Amazon S3 only supports symmetric CMKs.
3234
- # For more information, see [Using Symmetric and Asymmetric Keys][1]
3240
+ # For more information, see [Using symmetric and asymmetric keys][1]
3235
3241
  # in the *AWS Key Management Service Developer Guide*.
3236
3242
  #
3237
3243
  #
@@ -3265,12 +3271,12 @@ module Aws::S3
3265
3271
  # }
3266
3272
  #
3267
3273
  # @!attribute [rw] replica_kms_key_id
3268
- # Specifies the ID (Key ARN or Alias ARN) of the customer managed
3269
- # customer master key (CMK) stored in AWS Key Management Service (KMS)
3270
- # for the destination bucket. Amazon S3 uses this key to encrypt
3271
- # replica objects. Amazon S3 only supports symmetric customer managed
3272
- # CMKs. For more information, see [Using Symmetric and Asymmetric
3273
- # Keys][1] in the *AWS Key Management Service Developer Guide*.
3274
+ # Specifies the ID (Key ARN or Alias ARN) of the customer managed AWS
3275
+ # KMS key stored in AWS Key Management Service (KMS) for the
3276
+ # destination bucket. Amazon S3 uses this key to encrypt replica
3277
+ # objects. Amazon S3 only supports symmetric, customer managed KMS
3278
+ # keys. For more information, see [Using symmetric and asymmetric
3279
+ # keys][1] in the *AWS Key Management Service Developer Guide*.
3274
3280
  #
3275
3281
  #
3276
3282
  #
@@ -4158,7 +4164,7 @@ module Aws::S3
4158
4164
 
4159
4165
  # Optional configuration to replicate existing source bucket objects.
4160
4166
  # For more information, see [Replicating Existing Objects][1] in the
4161
- # *Amazon S3 Developer Guide*.
4167
+ # *Amazon S3 User Guide*.
4162
4168
  #
4163
4169
  #
4164
4170
  #
@@ -4198,7 +4204,7 @@ module Aws::S3
4198
4204
  # to which the filtering rule applies. The maximum length is 1,024
4199
4205
  # characters. Overlapping prefixes and suffixes are not supported. For
4200
4206
  # more information, see [Configuring Event Notifications][1] in the
4201
- # *Amazon Simple Storage Service Developer Guide*.
4207
+ # *Amazon S3 User Guide*.
4202
4208
  #
4203
4209
  #
4204
4210
  #
@@ -4639,8 +4645,7 @@ module Aws::S3
4639
4645
  # @!attribute [rw] logging_enabled
4640
4646
  # Describes where logs are stored and the prefix that Amazon S3
4641
4647
  # assigns to all log object keys for a bucket. For more information,
4642
- # see [PUT Bucket logging][1] in the *Amazon Simple Storage Service
4643
- # API Reference*.
4648
+ # see [PUT Bucket logging][1] in the *Amazon S3 API Reference*.
4644
4649
  #
4645
4650
  #
4646
4651
  #
@@ -5144,8 +5149,8 @@ module Aws::S3
5144
5149
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5145
5150
  # When using this action with an access point through the AWS SDKs,
5146
5151
  # you provide the access point ARN in place of the bucket name. For
5147
- # more information about access point ARNs, see [Using Access
5148
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5152
+ # more information about access point ARNs, see [Using access
5153
+ # points][1] in the *Amazon S3 User Guide*.
5149
5154
  #
5150
5155
  #
5151
5156
  #
@@ -5165,7 +5170,7 @@ module Aws::S3
5165
5170
  # request. Bucket owners need not specify this parameter in their
5166
5171
  # requests. For information about downloading objects from requester
5167
5172
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
5168
- # in the *Amazon S3 Developer Guide*.
5173
+ # in the *Amazon S3 User Guide*.
5169
5174
  #
5170
5175
  #
5171
5176
  #
@@ -5223,8 +5228,8 @@ module Aws::S3
5223
5228
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5224
5229
  # When using this action with an access point through the AWS SDKs,
5225
5230
  # you provide the access point ARN in place of the bucket name. For
5226
- # more information about access point ARNs, see [Using Access
5227
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5231
+ # more information about access point ARNs, see [Using access
5232
+ # points][1] in the *Amazon S3 User Guide*.
5228
5233
  #
5229
5234
  #
5230
5235
  #
@@ -5246,7 +5251,7 @@ module Aws::S3
5246
5251
  # request. Bucket owners need not specify this parameter in their
5247
5252
  # requests. For information about downloading objects from requester
5248
5253
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
5249
- # in the *Amazon S3 Developer Guide*.
5254
+ # in the *Amazon S3 User Guide*.
5250
5255
  #
5251
5256
  #
5252
5257
  #
@@ -5300,8 +5305,8 @@ module Aws::S3
5300
5305
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5301
5306
  # When using this action with an access point through the AWS SDKs,
5302
5307
  # you provide the access point ARN in place of the bucket name. For
5303
- # more information about access point ARNs, see [Using Access
5304
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5308
+ # more information about access point ARNs, see [Using access
5309
+ # points][1] in the *Amazon S3 User Guide*.
5305
5310
  #
5306
5311
  #
5307
5312
  #
@@ -5560,8 +5565,8 @@ module Aws::S3
5560
5565
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5561
5566
  # When using this action with an access point through the AWS SDKs,
5562
5567
  # you provide the access point ARN in place of the bucket name. For
5563
- # more information about access point ARNs, see [Using Access
5564
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5568
+ # more information about access point ARNs, see [Using access
5569
+ # points][1] in the *Amazon S3 User Guide*.
5565
5570
  #
5566
5571
  # When using this action with Amazon S3 on Outposts, you must direct
5567
5572
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5570,7 +5575,7 @@ module Aws::S3
5570
5575
  # When using this action using S3 on Outposts through the AWS SDKs,
5571
5576
  # you provide the Outposts bucket ARN in place of the bucket name. For
5572
5577
  # more information about S3 on Outposts ARNs, see [Using S3 on
5573
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
5578
+ # Outposts][2] in the *Amazon S3 User Guide*.
5574
5579
  #
5575
5580
  #
5576
5581
  #
@@ -5669,7 +5674,7 @@ module Aws::S3
5669
5674
  # request. Bucket owners need not specify this parameter in their
5670
5675
  # requests. For information about downloading objects from requester
5671
5676
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
5672
- # in the *Amazon S3 Developer Guide*.
5677
+ # in the *Amazon S3 User Guide*.
5673
5678
  #
5674
5679
  #
5675
5680
  #
@@ -5749,8 +5754,8 @@ module Aws::S3
5749
5754
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5750
5755
  # When using this action with an access point through the AWS SDKs,
5751
5756
  # you provide the access point ARN in place of the bucket name. For
5752
- # more information about access point ARNs, see [Using Access
5753
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5757
+ # more information about access point ARNs, see [Using access
5758
+ # points][1] in the *Amazon S3 User Guide*.
5754
5759
  #
5755
5760
  #
5756
5761
  #
@@ -5772,7 +5777,7 @@ module Aws::S3
5772
5777
  # request. Bucket owners need not specify this parameter in their
5773
5778
  # requests. For information about downloading objects from requester
5774
5779
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
5775
- # in the *Amazon S3 Developer Guide*.
5780
+ # in the *Amazon S3 User Guide*.
5776
5781
  #
5777
5782
  #
5778
5783
  #
@@ -5836,8 +5841,8 @@ module Aws::S3
5836
5841
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
5837
5842
  # When using this action with an access point through the AWS SDKs,
5838
5843
  # you provide the access point ARN in place of the bucket name. For
5839
- # more information about access point ARNs, see [Using Access
5840
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5844
+ # more information about access point ARNs, see [Using access
5845
+ # points][1] in the *Amazon S3 User Guide*.
5841
5846
  #
5842
5847
  # When using this action with Amazon S3 on Outposts, you must direct
5843
5848
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5846,7 +5851,7 @@ module Aws::S3
5846
5851
  # When using this action using S3 on Outposts through the AWS SDKs,
5847
5852
  # you provide the Outposts bucket ARN in place of the bucket name. For
5848
5853
  # more information about S3 on Outposts ARNs, see [Using S3 on
5849
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
5854
+ # Outposts][2] in the *Amazon S3 User Guide*.
5850
5855
  #
5851
5856
  #
5852
5857
  #
@@ -5874,7 +5879,7 @@ module Aws::S3
5874
5879
  # request. Bucket owners need not specify this parameter in their
5875
5880
  # requests. For information about downloading objects from requester
5876
5881
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
5877
- # in the *Amazon S3 Developer Guide*.
5882
+ # in the *Amazon S3 User Guide*.
5878
5883
  #
5879
5884
  #
5880
5885
  #
@@ -5935,7 +5940,7 @@ module Aws::S3
5935
5940
  # request. Bucket owners need not specify this parameter in their
5936
5941
  # requests. For information about downloading objects from requester
5937
5942
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
5938
- # in the *Amazon S3 Developer Guide*.
5943
+ # in the *Amazon S3 User Guide*.
5939
5944
  #
5940
5945
  #
5941
5946
  #
@@ -6144,8 +6149,8 @@ module Aws::S3
6144
6149
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
6145
6150
  # When using this action with an access point through the AWS SDKs,
6146
6151
  # you provide the access point ARN in place of the bucket name. For
6147
- # more information about access point ARNs, see [Using Access
6148
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
6152
+ # more information about access point ARNs, see [Using access
6153
+ # points][1] in the *Amazon S3 User Guide*.
6149
6154
  #
6150
6155
  # When using this action with Amazon S3 on Outposts, you must direct
6151
6156
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6154,7 +6159,7 @@ module Aws::S3
6154
6159
  # When using this action using S3 on Outposts through the AWS SDKs,
6155
6160
  # you provide the Outposts bucket ARN in place of the bucket name. For
6156
6161
  # more information about S3 on Outposts ARNs, see [Using S3 on
6157
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
6162
+ # Outposts][2] in the *Amazon S3 User Guide*.
6158
6163
  #
6159
6164
  #
6160
6165
  #
@@ -6203,7 +6208,7 @@ module Aws::S3
6203
6208
  # If an archive copy is already restored, the header value indicates
6204
6209
  # when Amazon S3 is scheduled to delete the object copy. For example:
6205
6210
  #
6206
- # `x-amz-restore: ongoing-request="false", expiry-date="Fri, 23 Dec
6211
+ # `x-amz-restore: ongoing-request="false", expiry-date="Fri, 21 Dec
6207
6212
  # 2012 00:00:00 GMT"`
6208
6213
  #
6209
6214
  # If the object restoration is in progress, the header returns the
@@ -6480,8 +6485,8 @@ module Aws::S3
6480
6485
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
6481
6486
  # When using this action with an access point through the AWS SDKs,
6482
6487
  # you provide the access point ARN in place of the bucket name. For
6483
- # more information about access point ARNs, see [Using Access
6484
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
6488
+ # more information about access point ARNs, see [Using access
6489
+ # points][1] in the *Amazon S3 User Guide*.
6485
6490
  #
6486
6491
  # When using this action with Amazon S3 on Outposts, you must direct
6487
6492
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6490,7 +6495,7 @@ module Aws::S3
6490
6495
  # When using this action using S3 on Outposts through the AWS SDKs,
6491
6496
  # you provide the Outposts bucket ARN in place of the bucket name. For
6492
6497
  # more information about S3 on Outposts ARNs, see [Using S3 on
6493
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
6498
+ # Outposts][2] in the *Amazon S3 User Guide*.
6494
6499
  #
6495
6500
  #
6496
6501
  #
@@ -6565,7 +6570,7 @@ module Aws::S3
6565
6570
  # request. Bucket owners need not specify this parameter in their
6566
6571
  # requests. For information about downloading objects from requester
6567
6572
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
6568
- # in the *Amazon S3 Developer Guide*.
6573
+ # in the *Amazon S3 User Guide*.
6569
6574
  #
6570
6575
  #
6571
6576
  #
@@ -6890,8 +6895,8 @@ module Aws::S3
6890
6895
  end
6891
6896
 
6892
6897
  # Specifies the inventory configuration for an Amazon S3 bucket. For
6893
- # more information, see [GET Bucket inventory][1] in the *Amazon Simple
6894
- # Storage Service API Reference*.
6898
+ # more information, see [GET Bucket inventory][1] in the *Amazon S3 API
6899
+ # Reference*.
6895
6900
  #
6896
6901
  #
6897
6902
  #
@@ -7227,7 +7232,7 @@ module Aws::S3
7227
7232
  # @!attribute [rw] events
7228
7233
  # The Amazon S3 bucket event for which to invoke the AWS Lambda
7229
7234
  # function. For more information, see [Supported Event Types][1] in
7230
- # the *Amazon Simple Storage Service Developer Guide*.
7235
+ # the *Amazon S3 User Guide*.
7231
7236
  #
7232
7237
  #
7233
7238
  #
@@ -7237,7 +7242,7 @@ module Aws::S3
7237
7242
  # @!attribute [rw] filter
7238
7243
  # Specifies object key name filtering rules. For information about key
7239
7244
  # name filtering, see [Configuring Event Notifications][1] in the
7240
- # *Amazon Simple Storage Service Developer Guide*.
7245
+ # *Amazon S3 User Guide*.
7241
7246
  #
7242
7247
  #
7243
7248
  #
@@ -7403,7 +7408,7 @@ module Aws::S3
7403
7408
  #
7404
7409
  # @!attribute [rw] prefix
7405
7410
  # Prefix identifying one or more objects to which the rule applies.
7406
- # This is No longer used; use `Filter` instead.
7411
+ # This is no longer used; use `Filter` instead.
7407
7412
  #
7408
7413
  # Replacement must be made for object keys containing special
7409
7414
  # characters (such as carriage returns) when using XML requests. For
@@ -7417,7 +7422,8 @@ module Aws::S3
7417
7422
  # @!attribute [rw] filter
7418
7423
  # The `Filter` is used to identify objects that a Lifecycle Rule
7419
7424
  # applies to. A `Filter` must have exactly one of `Prefix`, `Tag`, or
7420
- # `And` specified.
7425
+ # `And` specified. `Filter` is required if the `LifecycleRule` does
7426
+ # not containt a `Prefix` element.
7421
7427
  # @return [Types::LifecycleRuleFilter]
7422
7428
  #
7423
7429
  # @!attribute [rw] status
@@ -7453,7 +7459,7 @@ module Aws::S3
7453
7459
  # upload that Amazon S3 will wait before permanently removing all
7454
7460
  # parts of the upload. For more information, see [ Aborting Incomplete
7455
7461
  # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
7456
- # Simple Storage Service Developer Guide*.
7462
+ # S3 User Guide*.
7457
7463
  #
7458
7464
  #
7459
7465
  #
@@ -7971,8 +7977,8 @@ module Aws::S3
7971
7977
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7972
7978
  # When using this action with an access point through the AWS SDKs,
7973
7979
  # you provide the access point ARN in place of the bucket name. For
7974
- # more information about access point ARNs, see [Using Access
7975
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
7980
+ # more information about access point ARNs, see [Using access
7981
+ # points][1] in the *Amazon S3 User Guide*.
7976
7982
  #
7977
7983
  # When using this action with Amazon S3 on Outposts, you must direct
7978
7984
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7981,7 +7987,7 @@ module Aws::S3
7981
7987
  # When using this action using S3 on Outposts through the AWS SDKs,
7982
7988
  # you provide the Outposts bucket ARN in place of the bucket name. For
7983
7989
  # more information about S3 on Outposts ARNs, see [Using S3 on
7984
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
7990
+ # Outposts][2] in the *Amazon S3 User Guide*.
7985
7991
  #
7986
7992
  #
7987
7993
  #
@@ -8356,8 +8362,8 @@ module Aws::S3
8356
8362
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8357
8363
  # When using this action with an access point through the AWS SDKs,
8358
8364
  # you provide the access point ARN in place of the bucket name. For
8359
- # more information about access point ARNs, see [Using Access
8360
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
8365
+ # more information about access point ARNs, see [Using access
8366
+ # points][1] in the *Amazon S3 User Guide*.
8361
8367
  #
8362
8368
  # When using this action with Amazon S3 on Outposts, you must direct
8363
8369
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -8366,7 +8372,7 @@ module Aws::S3
8366
8372
  # When using this action using S3 on Outposts through the AWS SDKs,
8367
8373
  # you provide the Outposts bucket ARN in place of the bucket name. For
8368
8374
  # more information about S3 on Outposts ARNs, see [Using S3 on
8369
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
8375
+ # Outposts][2] in the *Amazon S3 User Guide*.
8370
8376
  #
8371
8377
  #
8372
8378
  #
@@ -8447,8 +8453,8 @@ module Aws::S3
8447
8453
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8448
8454
  # When using this action with an access point through the AWS SDKs,
8449
8455
  # you provide the access point ARN in place of the bucket name. For
8450
- # more information about access point ARNs, see [Using Access
8451
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
8456
+ # more information about access point ARNs, see [Using access
8457
+ # points][1] in the *Amazon S3 User Guide*.
8452
8458
  #
8453
8459
  # When using this action with Amazon S3 on Outposts, you must direct
8454
8460
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -8457,7 +8463,7 @@ module Aws::S3
8457
8463
  # When using this action using S3 on Outposts through the AWS SDKs,
8458
8464
  # you provide the Outposts bucket ARN in place of the bucket name. For
8459
8465
  # more information about S3 on Outposts ARNs, see [Using S3 on
8460
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
8466
+ # Outposts][2] in the *Amazon S3 User Guide*.
8461
8467
  #
8462
8468
  #
8463
8469
  #
@@ -8582,8 +8588,8 @@ module Aws::S3
8582
8588
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8583
8589
  # When using this action with an access point through the AWS SDKs,
8584
8590
  # you provide the access point ARN in place of the bucket name. For
8585
- # more information about access point ARNs, see [Using Access
8586
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
8591
+ # more information about access point ARNs, see [Using access
8592
+ # points][1] in the *Amazon S3 User Guide*.
8587
8593
  #
8588
8594
  # When using this action with Amazon S3 on Outposts, you must direct
8589
8595
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -8592,7 +8598,7 @@ module Aws::S3
8592
8598
  # When using this action using S3 on Outposts through the AWS SDKs,
8593
8599
  # you provide the Outposts bucket ARN in place of the bucket name. For
8594
8600
  # more information about S3 on Outposts ARNs, see [Using S3 on
8595
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
8601
+ # Outposts][2] in the *Amazon S3 User Guide*.
8596
8602
  #
8597
8603
  #
8598
8604
  #
@@ -8797,8 +8803,8 @@ module Aws::S3
8797
8803
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8798
8804
  # When using this action with an access point through the AWS SDKs,
8799
8805
  # you provide the access point ARN in place of the bucket name. For
8800
- # more information about access point ARNs, see [Using Access
8801
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
8806
+ # more information about access point ARNs, see [Using access
8807
+ # points][1] in the *Amazon S3 User Guide*.
8802
8808
  #
8803
8809
  # When using this action with Amazon S3 on Outposts, you must direct
8804
8810
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -8807,7 +8813,7 @@ module Aws::S3
8807
8813
  # When using this action using S3 on Outposts through the AWS SDKs,
8808
8814
  # you provide the Outposts bucket ARN in place of the bucket name. For
8809
8815
  # more information about S3 on Outposts ARNs, see [Using S3 on
8810
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
8816
+ # Outposts][2] in the *Amazon S3 User Guide*.
8811
8817
  #
8812
8818
  #
8813
8819
  #
@@ -8838,7 +8844,7 @@ module Aws::S3
8838
8844
  # request. Bucket owners need not specify this parameter in their
8839
8845
  # requests. For information about downloading objects from requester
8840
8846
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
8841
- # in the *Amazon S3 Developer Guide*.
8847
+ # in the *Amazon S3 User Guide*.
8842
8848
  #
8843
8849
  #
8844
8850
  #
@@ -8867,8 +8873,7 @@ module Aws::S3
8867
8873
 
8868
8874
  # Describes where logs are stored and the prefix that Amazon S3 assigns
8869
8875
  # to all log object keys for a bucket. For more information, see [PUT
8870
- # Bucket logging][1] in the *Amazon Simple Storage Service API
8871
- # Reference*.
8876
+ # Bucket logging][1] in the *Amazon S3 API Reference*.
8872
8877
  #
8873
8878
  #
8874
8879
  #
@@ -9022,8 +9027,8 @@ module Aws::S3
9022
9027
  # If you're updating an existing metrics configuration, note that this
9023
9028
  # is a full replacement of the existing metrics configuration. If you
9024
9029
  # don't include the elements you want to keep, they are erased. For
9025
- # more information, see [ PUT Bucket metrics][1] in the *Amazon Simple
9026
- # Storage Service API Reference*.
9030
+ # more information, see [ PUT Bucket metrics][1] in the *Amazon S3 API
9031
+ # Reference*.
9027
9032
  #
9028
9033
  #
9029
9034
  #
@@ -9195,8 +9200,7 @@ module Aws::S3
9195
9200
  # Specifies the number of days an object is noncurrent before Amazon
9196
9201
  # S3 can perform the associated action. For information about the
9197
9202
  # noncurrent days calculations, see [How Amazon S3 Calculates When an
9198
- # Object Became Noncurrent][1] in the *Amazon Simple Storage Service
9199
- # Developer Guide*.
9203
+ # Object Became Noncurrent][1] in the *Amazon S3 User Guide*.
9200
9204
  #
9201
9205
  #
9202
9206
  #
@@ -9232,8 +9236,7 @@ module Aws::S3
9232
9236
  # Specifies the number of days an object is noncurrent before Amazon
9233
9237
  # S3 can perform the associated action. For information about the
9234
9238
  # noncurrent days calculations, see [How Amazon S3 Calculates How Long
9235
- # an Object Has Been Noncurrent][1] in the *Amazon Simple Storage
9236
- # Service Developer Guide*.
9239
+ # an Object Has Been Noncurrent][1] in the *Amazon S3 User Guide*.
9237
9240
  #
9238
9241
  #
9239
9242
  #
@@ -9393,7 +9396,7 @@ module Aws::S3
9393
9396
 
9394
9397
  # Specifies object key name filtering rules. For information about key
9395
9398
  # name filtering, see [Configuring Event Notifications][1] in the
9396
- # *Amazon Simple Storage Service Developer Guide*.
9399
+ # *Amazon S3 User Guide*.
9397
9400
  #
9398
9401
  #
9399
9402
  #
@@ -9542,11 +9545,16 @@ module Aws::S3
9542
9545
  #
9543
9546
  # @!attribute [rw] object_lock_enabled
9544
9547
  # Indicates whether this bucket has an Object Lock configuration
9545
- # enabled.
9548
+ # enabled. Enable `ObjectLockEnabled` when you apply
9549
+ # `ObjectLockConfiguration` to a bucket.
9546
9550
  # @return [String]
9547
9551
  #
9548
9552
  # @!attribute [rw] rule
9549
- # The Object Lock rule in place for the specified object.
9553
+ # Specifies the Object Lock rule for the specified object. Enable the
9554
+ # this rule when you apply `ObjectLockConfiguration` to a bucket.
9555
+ # Bucket settings require both a mode and a period. The period can be
9556
+ # either `Days` or `Years` but you must select one. You cannot specify
9557
+ # `Days` and `Years` at the same time.
9550
9558
  # @return [Types::ObjectLockRule]
9551
9559
  #
9552
9560
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectLockConfiguration AWS API Documentation
@@ -9620,8 +9628,11 @@ module Aws::S3
9620
9628
  # }
9621
9629
  #
9622
9630
  # @!attribute [rw] default_retention
9623
- # The default retention period that you want to apply to new objects
9624
- # placed in the specified bucket.
9631
+ # The default Object Lock retention mode and period that you want to
9632
+ # apply to new objects placed in the specified bucket. Bucket settings
9633
+ # require both a mode and a period. The period can be either `Days` or
9634
+ # `Years` but you must select one. You cannot specify `Days` and
9635
+ # `Years` at the same time.
9625
9636
  # @return [Types::DefaultRetention]
9626
9637
  #
9627
9638
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectLockRule AWS API Documentation
@@ -10143,8 +10154,10 @@ module Aws::S3
10143
10154
  # @return [String]
10144
10155
  #
10145
10156
  # @!attribute [rw] grant_write
10146
- # Allows grantee to create, overwrite, and delete any object in the
10147
- # bucket.
10157
+ # Allows grantee to create new objects in the bucket.
10158
+ #
10159
+ # For the bucket and object owners of existing objects, also allows
10160
+ # deletions and overwrites of those objects.
10148
10161
  # @return [String]
10149
10162
  #
10150
10163
  # @!attribute [rw] grant_write_acp
@@ -10336,8 +10349,7 @@ module Aws::S3
10336
10349
  # encryption with Amazon S3-managed keys (SSE-S3) or customer master
10337
10350
  # keys stored in AWS KMS (SSE-KMS). For information about the Amazon
10338
10351
  # S3 default encryption feature, see [Amazon S3 Default Bucket
10339
- # Encryption][1] in the *Amazon Simple Storage Service Developer
10340
- # Guide*.
10352
+ # Encryption][1] in the *Amazon S3 User Guide*.
10341
10353
  #
10342
10354
  #
10343
10355
  #
@@ -11441,8 +11453,8 @@ module Aws::S3
11441
11453
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11442
11454
  # When using this action with an access point through the AWS SDKs,
11443
11455
  # you provide the access point ARN in place of the bucket name. For
11444
- # more information about access point ARNs, see [Using Access
11445
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
11456
+ # more information about access point ARNs, see [Using access
11457
+ # points][1] in the *Amazon S3 User Guide*.
11446
11458
  #
11447
11459
  #
11448
11460
  #
@@ -11483,8 +11495,10 @@ module Aws::S3
11483
11495
  # @return [String]
11484
11496
  #
11485
11497
  # @!attribute [rw] grant_write
11486
- # Allows grantee to create, overwrite, and delete any object in the
11487
- # bucket.
11498
+ # Allows grantee to create new objects in the bucket.
11499
+ #
11500
+ # For the bucket and object owners of existing objects, also allows
11501
+ # deletions and overwrites of those objects.
11488
11502
  # @return [String]
11489
11503
  #
11490
11504
  # @!attribute [rw] grant_write_acp
@@ -11502,8 +11516,8 @@ module Aws::S3
11502
11516
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11503
11517
  # When using this action with an access point through the AWS SDKs,
11504
11518
  # you provide the access point ARN in place of the bucket name. For
11505
- # more information about access point ARNs, see [Using Access
11506
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
11519
+ # more information about access point ARNs, see [Using access
11520
+ # points][1] in the *Amazon S3 User Guide*.
11507
11521
  #
11508
11522
  # When using this action with Amazon S3 on Outposts, you must direct
11509
11523
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11512,7 +11526,7 @@ module Aws::S3
11512
11526
  # When using this action using S3 on Outposts through the AWS SDKs,
11513
11527
  # you provide the Outposts bucket ARN in place of the bucket name. For
11514
11528
  # more information about S3 on Outposts ARNs, see [Using S3 on
11515
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
11529
+ # Outposts][2] in the *Amazon S3 User Guide*.
11516
11530
  #
11517
11531
  #
11518
11532
  #
@@ -11525,7 +11539,7 @@ module Aws::S3
11525
11539
  # request. Bucket owners need not specify this parameter in their
11526
11540
  # requests. For information about downloading objects from requester
11527
11541
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
11528
- # in the *Amazon S3 Developer Guide*.
11542
+ # in the *Amazon S3 User Guide*.
11529
11543
  #
11530
11544
  #
11531
11545
  #
@@ -11600,8 +11614,8 @@ module Aws::S3
11600
11614
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11601
11615
  # When using this action with an access point through the AWS SDKs,
11602
11616
  # you provide the access point ARN in place of the bucket name. For
11603
- # more information about access point ARNs, see [Using Access
11604
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
11617
+ # more information about access point ARNs, see [Using access
11618
+ # points][1] in the *Amazon S3 User Guide*.
11605
11619
  #
11606
11620
  #
11607
11621
  #
@@ -11622,7 +11636,7 @@ module Aws::S3
11622
11636
  # request. Bucket owners need not specify this parameter in their
11623
11637
  # requests. For information about downloading objects from requester
11624
11638
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
11625
- # in the *Amazon S3 Developer Guide*.
11639
+ # in the *Amazon S3 User Guide*.
11626
11640
  #
11627
11641
  #
11628
11642
  #
@@ -11709,7 +11723,7 @@ module Aws::S3
11709
11723
  # request. Bucket owners need not specify this parameter in their
11710
11724
  # requests. For information about downloading objects from requester
11711
11725
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
11712
- # in the *Amazon S3 Developer Guide*.
11726
+ # in the *Amazon S3 User Guide*.
11713
11727
  #
11714
11728
  #
11715
11729
  #
@@ -11891,8 +11905,8 @@ module Aws::S3
11891
11905
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11892
11906
  # When using this action with an access point through the AWS SDKs,
11893
11907
  # you provide the access point ARN in place of the bucket name. For
11894
- # more information about access point ARNs, see [Using Access
11895
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
11908
+ # more information about access point ARNs, see [Using access
11909
+ # points][1] in the *Amazon S3 User Guide*.
11896
11910
  #
11897
11911
  # When using this action with Amazon S3 on Outposts, you must direct
11898
11912
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11901,7 +11915,7 @@ module Aws::S3
11901
11915
  # When using this action using S3 on Outposts through the AWS SDKs,
11902
11916
  # you provide the Outposts bucket ARN in place of the bucket name. For
11903
11917
  # more information about S3 on Outposts ARNs, see [Using S3 on
11904
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
11918
+ # Outposts][2] in the *Amazon S3 User Guide*.
11905
11919
  #
11906
11920
  #
11907
11921
  #
@@ -12034,7 +12048,7 @@ module Aws::S3
12034
12048
  # and high availability. Depending on performance needs, you can
12035
12049
  # specify a different Storage Class. Amazon S3 on Outposts only uses
12036
12050
  # the OUTPOSTS Storage Class. For more information, see [Storage
12037
- # Classes][1] in the *Amazon S3 Service Developer Guide*.
12051
+ # Classes][1] in the *Amazon S3 User Guide*.
12038
12052
  #
12039
12053
  #
12040
12054
  #
@@ -12092,14 +12106,12 @@ module Aws::S3
12092
12106
  # If `x-amz-server-side-encryption` is present and has the value of
12093
12107
  # `aws:kms`, this header specifies the ID of the AWS Key Management
12094
12108
  # Service (AWS KMS) symmetrical customer managed customer master key
12095
- # (CMK) that was used for the object.
12096
- #
12097
- # If the value of `x-amz-server-side-encryption` is `aws:kms`, this
12098
- # header specifies the ID of the symmetric customer managed AWS KMS
12099
- # CMK that will be used for the object. If you specify
12109
+ # (CMK) that was used for the object. If you specify
12100
12110
  # `x-amz-server-side-encryption:aws:kms`, but do not provide`
12101
12111
  # x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the AWS
12102
- # managed CMK in AWS to protect the data.
12112
+ # managed CMK in AWS to protect the data. If the KMS key does not
12113
+ # exist in the same account issuing the command, you must use the full
12114
+ # ARN and not just the ID.
12103
12115
  # @return [String]
12104
12116
  #
12105
12117
  # @!attribute [rw] ssekms_encryption_context
@@ -12123,7 +12135,7 @@ module Aws::S3
12123
12135
  # request. Bucket owners need not specify this parameter in their
12124
12136
  # requests. For information about downloading objects from requester
12125
12137
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
12126
- # in the *Amazon S3 Developer Guide*.
12138
+ # in the *Amazon S3 User Guide*.
12127
12139
  #
12128
12140
  #
12129
12141
  #
@@ -12238,8 +12250,8 @@ module Aws::S3
12238
12250
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
12239
12251
  # When using this action with an access point through the AWS SDKs,
12240
12252
  # you provide the access point ARN in place of the bucket name. For
12241
- # more information about access point ARNs, see [Using Access
12242
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
12253
+ # more information about access point ARNs, see [Using access
12254
+ # points][1] in the *Amazon S3 User Guide*.
12243
12255
  #
12244
12256
  #
12245
12257
  #
@@ -12260,7 +12272,7 @@ module Aws::S3
12260
12272
  # request. Bucket owners need not specify this parameter in their
12261
12273
  # requests. For information about downloading objects from requester
12262
12274
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
12263
- # in the *Amazon S3 Developer Guide*.
12275
+ # in the *Amazon S3 User Guide*.
12264
12276
  #
12265
12277
  #
12266
12278
  #
@@ -12346,8 +12358,8 @@ module Aws::S3
12346
12358
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
12347
12359
  # When using this action with an access point through the AWS SDKs,
12348
12360
  # you provide the access point ARN in place of the bucket name. For
12349
- # more information about access point ARNs, see [Using Access
12350
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
12361
+ # more information about access point ARNs, see [Using access
12362
+ # points][1] in the *Amazon S3 User Guide*.
12351
12363
  #
12352
12364
  # When using this action with Amazon S3 on Outposts, you must direct
12353
12365
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -12356,7 +12368,7 @@ module Aws::S3
12356
12368
  # When using this action using S3 on Outposts through the AWS SDKs,
12357
12369
  # you provide the Outposts bucket ARN in place of the bucket name. For
12358
12370
  # more information about S3 on Outposts ARNs, see [Using S3 on
12359
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
12371
+ # Outposts][2] in the *Amazon S3 User Guide*.
12360
12372
  #
12361
12373
  #
12362
12374
  #
@@ -12394,7 +12406,7 @@ module Aws::S3
12394
12406
  # request. Bucket owners need not specify this parameter in their
12395
12407
  # requests. For information about downloading objects from requester
12396
12408
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
12397
- # in the *Amazon S3 Developer Guide*.
12409
+ # in the *Amazon S3 User Guide*.
12398
12410
  #
12399
12411
  #
12400
12412
  #
@@ -12447,7 +12459,7 @@ module Aws::S3
12447
12459
  # Amazon S3 bucket. You can enable the configuration options in any
12448
12460
  # combination. For more information about when Amazon S3 considers a
12449
12461
  # bucket or object public, see [The Meaning of "Public"][1] in the
12450
- # *Amazon Simple Storage Service Developer Guide*.
12462
+ # *Amazon S3 User Guide*.
12451
12463
  #
12452
12464
  #
12453
12465
  #
@@ -12513,7 +12525,7 @@ module Aws::S3
12513
12525
  # @!attribute [rw] filter
12514
12526
  # Specifies object key name filtering rules. For information about key
12515
12527
  # name filtering, see [Configuring Event Notifications][1] in the
12516
- # *Amazon Simple Storage Service Developer Guide*.
12528
+ # *Amazon S3 User Guide*.
12517
12529
  #
12518
12530
  #
12519
12531
  #
@@ -12804,7 +12816,7 @@ module Aws::S3
12804
12816
  # The Amazon Resource Name (ARN) of the AWS Identity and Access
12805
12817
  # Management (IAM) role that Amazon S3 assumes when replicating
12806
12818
  # objects. For more information, see [How to Set Up Replication][1] in
12807
- # the *Amazon Simple Storage Service Developer Guide*.
12819
+ # the *Amazon S3 User Guide*.
12808
12820
  #
12809
12821
  #
12810
12822
  #
@@ -12905,8 +12917,8 @@ module Aws::S3
12905
12917
  # will be replicated according to the rule with the highest priority.
12906
12918
  # The higher the number, the higher the priority.
12907
12919
  #
12908
- # For more information, see [Replication][1] in the *Amazon Simple
12909
- # Storage Service Developer Guide*.
12920
+ # For more information, see [Replication][1] in the *Amazon S3 User
12921
+ # Guide*.
12910
12922
  #
12911
12923
  #
12912
12924
  #
@@ -13326,8 +13338,8 @@ module Aws::S3
13326
13338
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
13327
13339
  # When using this action with an access point through the AWS SDKs,
13328
13340
  # you provide the access point ARN in place of the bucket name. For
13329
- # more information about access point ARNs, see [Using Access
13330
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
13341
+ # more information about access point ARNs, see [Using access
13342
+ # points][1] in the *Amazon S3 User Guide*.
13331
13343
  #
13332
13344
  # When using this action with Amazon S3 on Outposts, you must direct
13333
13345
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -13336,7 +13348,7 @@ module Aws::S3
13336
13348
  # When using this action using S3 on Outposts through the AWS SDKs,
13337
13349
  # you provide the Outposts bucket ARN in place of the bucket name. For
13338
13350
  # more information about S3 on Outposts ARNs, see [Using S3 on
13339
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
13351
+ # Outposts][2] in the *Amazon S3 User Guide*.
13340
13352
  #
13341
13353
  #
13342
13354
  #
@@ -13361,7 +13373,7 @@ module Aws::S3
13361
13373
  # request. Bucket owners need not specify this parameter in their
13362
13374
  # requests. For information about downloading objects from requester
13363
13375
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
13364
- # in the *Amazon S3 Developer Guide*.
13376
+ # in the *Amazon S3 User Guide*.
13365
13377
  #
13366
13378
  #
13367
13379
  #
@@ -13571,8 +13583,8 @@ module Aws::S3
13571
13583
 
13572
13584
  # Specifies lifecycle rules for an Amazon S3 bucket. For more
13573
13585
  # information, see [Put Bucket Lifecycle Configuration][1] in the
13574
- # *Amazon Simple Storage Service API Reference*. For examples, see [Put
13575
- # Bucket Lifecycle Configuration Examples][2].
13586
+ # *Amazon S3 API Reference*. For examples, see [Put Bucket Lifecycle
13587
+ # Configuration Examples][2].
13576
13588
  #
13577
13589
  #
13578
13590
  #
@@ -13671,7 +13683,7 @@ module Aws::S3
13671
13683
  # upload that Amazon S3 will wait before permanently removing all
13672
13684
  # parts of the upload. For more information, see [ Aborting Incomplete
13673
13685
  # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
13674
- # Simple Storage Service Developer Guide*.
13686
+ # S3 User Guide*.
13675
13687
  #
13676
13688
  #
13677
13689
  #
@@ -14131,8 +14143,8 @@ module Aws::S3
14131
14143
  # Describes the default server-side encryption to apply to new objects
14132
14144
  # in the bucket. If a PUT Object request doesn't specify any
14133
14145
  # server-side encryption, this default encryption will be applied. For
14134
- # more information, see [PUT Bucket encryption][1] in the *Amazon Simple
14135
- # Storage Service API Reference*.
14146
+ # more information, see [PUT Bucket encryption][1] in the *Amazon S3 API
14147
+ # Reference*.
14136
14148
  #
14137
14149
  #
14138
14150
  #
@@ -14151,13 +14163,13 @@ module Aws::S3
14151
14163
  # @return [String]
14152
14164
  #
14153
14165
  # @!attribute [rw] kms_master_key_id
14154
- # AWS Key Management Service (KMS) customer master key ID to use for
14166
+ # AWS Key Management Service (KMS) customer AWS KMS key ID to use for
14155
14167
  # the default encryption. This parameter is allowed if and only if
14156
14168
  # `SSEAlgorithm` is set to `aws:kms`.
14157
14169
  #
14158
14170
  # You can specify the key ID or the Amazon Resource Name (ARN) of the
14159
- # CMK. However, if you are using encryption with cross-account
14160
- # operations, you must use a fully qualified CMK ARN. For more
14171
+ # KMS key. However, if you are using encryption with cross-account
14172
+ # operations, you must use a fully qualified KMS key ARN. For more
14161
14173
  # information, see [Using encryption for cross-account operations][1].
14162
14174
  #
14163
14175
  # **For example:**
@@ -14167,9 +14179,9 @@ module Aws::S3
14167
14179
  # * Key ARN:
14168
14180
  # `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
14169
14181
  #
14170
- # Amazon S3 only supports symmetric CMKs and not asymmetric CMKs. For
14171
- # more information, see [Using Symmetric and Asymmetric Keys][2] in
14172
- # the *AWS Key Management Service Developer Guide*.
14182
+ # Amazon S3 only supports symmetric KMS keys and not asymmetric KMS
14183
+ # keys. For more information, see [Using symmetric and asymmetric
14184
+ # keys][2] in the *AWS Key Management Service Developer Guide*.
14173
14185
  #
14174
14186
  #
14175
14187
  #
@@ -14320,8 +14332,8 @@ module Aws::S3
14320
14332
  #
14321
14333
  # @!attribute [rw] status
14322
14334
  # Specifies whether Amazon S3 replicates objects created with
14323
- # server-side encryption using a customer master key (CMK) stored in
14324
- # AWS Key Management Service.
14335
+ # server-side encryption using an AWS KMS key stored in AWS Key
14336
+ # Management Service.
14325
14337
  # @return [String]
14326
14338
  #
14327
14339
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SseKmsEncryptedObjects AWS API Documentation
@@ -14615,7 +14627,7 @@ module Aws::S3
14615
14627
  # @!attribute [rw] filter
14616
14628
  # Specifies object key name filtering rules. For information about key
14617
14629
  # name filtering, see [Configuring Event Notifications][1] in the
14618
- # *Amazon Simple Storage Service Developer Guide*.
14630
+ # *Amazon S3 User Guide*.
14619
14631
  #
14620
14632
  #
14621
14633
  #
@@ -14818,8 +14830,8 @@ module Aws::S3
14818
14830
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
14819
14831
  # When using this action with an access point through the AWS SDKs,
14820
14832
  # you provide the access point ARN in place of the bucket name. For
14821
- # more information about access point ARNs, see [Using Access
14822
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
14833
+ # more information about access point ARNs, see [Using access
14834
+ # points][1] in the *Amazon S3 User Guide*.
14823
14835
  #
14824
14836
  # When using this action with Amazon S3 on Outposts, you must direct
14825
14837
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -14828,7 +14840,7 @@ module Aws::S3
14828
14840
  # When using this action using S3 on Outposts through the AWS SDKs,
14829
14841
  # you provide the Outposts bucket ARN in place of the bucket name. For
14830
14842
  # more information about S3 on Outposts ARNs, see [Using S3 on
14831
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
14843
+ # Outposts][2] in the *Amazon S3 User Guide*.
14832
14844
  #
14833
14845
  #
14834
14846
  #
@@ -14967,7 +14979,7 @@ module Aws::S3
14967
14979
  # request. Bucket owners need not specify this parameter in their
14968
14980
  # requests. For information about downloading objects from requester
14969
14981
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
14970
- # in the *Amazon S3 Developer Guide*.
14982
+ # in the *Amazon S3 User Guide*.
14971
14983
  #
14972
14984
  #
14973
14985
  #
@@ -15095,8 +15107,8 @@ module Aws::S3
15095
15107
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
15096
15108
  # When using this action with an access point through the AWS SDKs,
15097
15109
  # you provide the access point ARN in place of the bucket name. For
15098
- # more information about access point ARNs, see [Using Access
15099
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
15110
+ # more information about access point ARNs, see [Using access
15111
+ # points][1] in the *Amazon S3 User Guide*.
15100
15112
  #
15101
15113
  # When using this action with Amazon S3 on Outposts, you must direct
15102
15114
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -15105,7 +15117,7 @@ module Aws::S3
15105
15117
  # When using this action using S3 on Outposts through the AWS SDKs,
15106
15118
  # you provide the Outposts bucket ARN in place of the bucket name. For
15107
15119
  # more information about S3 on Outposts ARNs, see [Using S3 on
15108
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
15120
+ # Outposts][2] in the *Amazon S3 User Guide*.
15109
15121
  #
15110
15122
  #
15111
15123
  #
@@ -15164,7 +15176,7 @@ module Aws::S3
15164
15176
  # request. Bucket owners need not specify this parameter in their
15165
15177
  # requests. For information about downloading objects from requester
15166
15178
  # pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
15167
- # in the *Amazon S3 Developer Guide*.
15179
+ # in the *Amazon S3 User Guide*.
15168
15180
  #
15169
15181
  #
15170
15182
  #
@@ -15197,8 +15209,8 @@ module Aws::S3
15197
15209
  end
15198
15210
 
15199
15211
  # Describes the versioning state of an Amazon S3 bucket. For more
15200
- # information, see [PUT Bucket versioning][1] in the *Amazon Simple
15201
- # Storage Service API Reference*.
15212
+ # information, see [PUT Bucket versioning][1] in the *Amazon S3 API
15213
+ # Reference*.
15202
15214
  #
15203
15215
  #
15204
15216
  #
@@ -15392,7 +15404,9 @@ module Aws::S3
15392
15404
  # A string that uniquely identifies an error condition. Returned in
15393
15405
  # the &lt;Code&gt; tag of the error XML response for a corresponding
15394
15406
  # `GetObject` call. Cannot be used with a successful `StatusCode`
15395
- # header or when the transformed object is provided in the body.
15407
+ # header or when the transformed object is provided in the body. All
15408
+ # error codes from S3 are sentence-cased. Regex value is
15409
+ # "^\[A-Z\]\[a-zA-Z\]+$".
15396
15410
  # @return [String]
15397
15411
  #
15398
15412
  # @!attribute [rw] error_message