aws-sdk-s3 1.91.0 → 1.94.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (36) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +29 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3.rb +1 -1
  5. data/lib/aws-sdk-s3/arn/access_point_arn.rb +4 -6
  6. data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +64 -0
  7. data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +4 -6
  8. data/lib/aws-sdk-s3/bucket.rb +6 -6
  9. data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
  10. data/lib/aws-sdk-s3/bucket_cors.rb +3 -4
  11. data/lib/aws-sdk-s3/bucket_lifecycle.rb +2 -2
  12. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +2 -2
  13. data/lib/aws-sdk-s3/bucket_logging.rb +1 -1
  14. data/lib/aws-sdk-s3/bucket_notification.rb +1 -1
  15. data/lib/aws-sdk-s3/bucket_policy.rb +2 -2
  16. data/lib/aws-sdk-s3/bucket_request_payment.rb +1 -1
  17. data/lib/aws-sdk-s3/bucket_tagging.rb +2 -2
  18. data/lib/aws-sdk-s3/bucket_versioning.rb +3 -3
  19. data/lib/aws-sdk-s3/bucket_website.rb +2 -2
  20. data/lib/aws-sdk-s3/client.rb +758 -482
  21. data/lib/aws-sdk-s3/client_api.rb +58 -0
  22. data/lib/aws-sdk-s3/customizations/object.rb +30 -11
  23. data/lib/aws-sdk-s3/file_uploader.rb +2 -2
  24. data/lib/aws-sdk-s3/multipart_upload.rb +3 -3
  25. data/lib/aws-sdk-s3/multipart_upload_part.rb +4 -4
  26. data/lib/aws-sdk-s3/object.rb +96 -10
  27. data/lib/aws-sdk-s3/object_acl.rb +1 -1
  28. data/lib/aws-sdk-s3/object_summary.rb +9 -9
  29. data/lib/aws-sdk-s3/object_version.rb +4 -4
  30. data/lib/aws-sdk-s3/plugins/arn.rb +57 -34
  31. data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +9 -9
  32. data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +25 -0
  33. data/lib/aws-sdk-s3/plugins/s3_signer.rb +6 -0
  34. data/lib/aws-sdk-s3/presigner.rb +12 -3
  35. data/lib/aws-sdk-s3/types.rb +567 -243
  36. metadata +7 -6
@@ -256,7 +256,7 @@ module Aws::S3
256
256
  # Indicates whether S3 Object Lock should bypass Governance-mode
257
257
  # restrictions to process this operation.
258
258
  # @option options [String] :expected_bucket_owner
259
- # The account id of the expected bucket owner. If the bucket is owned by
259
+ # The account ID of the expected bucket owner. If the bucket is owned by
260
260
  # a different account, the request will fail with an HTTP `403 (Access
261
261
  # Denied)` error.
262
262
  # @return [Types::DeleteObjectOutput]
@@ -358,7 +358,7 @@ module Aws::S3
358
358
  # for the part specified. Useful for downloading just a part of an
359
359
  # object.
360
360
  # @option options [String] :expected_bucket_owner
361
- # The account id of the expected bucket owner. If the bucket is owned by
361
+ # The account ID of the expected bucket owner. If the bucket is owned by
362
362
  # a different account, the request will fail with an HTTP `403 (Access
363
363
  # Denied)` error.
364
364
  # @return [Types::GetObjectOutput]
@@ -442,7 +442,7 @@ module Aws::S3
442
442
  # for the part specified. Useful querying about the size of the part and
443
443
  # the number of parts in this object.
444
444
  # @option options [String] :expected_bucket_owner
445
- # The account id of the expected bucket owner. If the bucket is owned by
445
+ # The account ID of the expected bucket owner. If the bucket is owned by
446
446
  # a different account, the request will fail with an HTTP `403 (Access
447
447
  # Denied)` error.
448
448
  # @return [Types::HeadObjectOutput]
@@ -546,7 +546,7 @@ module Aws::S3
546
546
  # Governance-type Object Lock in place. You must have sufficient
547
547
  # permissions to perform this operation.
548
548
  # @option options [String] :expected_bucket_owner
549
- # The account id of the expected bucket owner. If the bucket is owned by
549
+ # The account ID of the expected bucket owner. If the bucket is owned by
550
550
  # a different account, the request will fail with an HTTP `403 (Access
551
551
  # Denied)` error.
552
552
  # @return [void]
@@ -1,6 +1,7 @@
1
1
  # frozen_string_literal: true
2
2
 
3
3
  require_relative '../arn/access_point_arn'
4
+ require_relative '../arn/object_lambda_arn'
4
5
  require_relative '../arn/outpost_access_point_arn'
5
6
 
6
7
  module Aws
@@ -22,9 +23,9 @@ be made. Set to `false` to use the client's region instead.
22
23
  resolve_s3_use_arn_region(cfg)
23
24
  end
24
25
 
25
- # param validator is validate:50 (required to add account_id from arn)
26
+ # param validator is validate:50
26
27
  # endpoint is build:90 (populates the URI for the first time)
27
- # endpoint pattern is build:10 (prefix account id to host)
28
+ # endpoint pattern is build:10
28
29
  def add_handlers(handlers, _config)
29
30
  handlers.add(ARNHandler, step: :validate, priority: 75)
30
31
  handlers.add(UrlHandler)
@@ -38,6 +39,7 @@ be made. Set to `false` to use the client's region instead.
38
39
  context.http_request.endpoint,
39
40
  context.metadata[:s3_arn][:arn],
40
41
  context.metadata[:s3_arn][:resolved_region],
42
+ context.metadata[:s3_arn][:fips],
41
43
  context.metadata[:s3_arn][:dualstack],
42
44
  # if regional_endpoint is false, a custom endpoint was provided
43
45
  # in this case, we want to prefix the endpoint using the ARN
@@ -62,9 +64,17 @@ be made. Set to `false` to use the client's region instead.
62
64
  if arn
63
65
  validate_config!(context, arn)
64
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
+
65
74
  context.metadata[:s3_arn] = {
66
75
  arn: arn,
67
76
  resolved_region: resolved_region,
77
+ fips: fips,
68
78
  dualstack: extract_dualstack_config!(context)
69
79
  }
70
80
  end
@@ -114,18 +124,10 @@ be made. Set to `false` to use the client's region instead.
114
124
  def resolve_arn!(member_value, region, use_arn_region)
115
125
  if Aws::ARNParser.arn?(member_value)
116
126
  arn = Aws::ARNParser.parse(member_value)
117
- if arn.resource.start_with?('accesspoint')
118
- s3_arn = Aws::S3::AccessPointARN.new(arn.to_h)
119
- elsif arn.resource.start_with?('outpost')
120
- s3_arn = Aws::S3::OutpostAccessPointARN.new(arn.to_h)
121
- else
122
- raise ArgumentError,
123
- 'Only Access Point and Outpost Access Point type ARNs '\
124
- 'are currently supported.'
125
- end
127
+ s3_arn = resolve_arn_type!(arn)
126
128
  s3_arn.validate_arn!
127
129
  validate_region_config!(s3_arn, region, use_arn_region)
128
- region = s3_arn.region if use_arn_region
130
+ region = s3_arn.region if use_arn_region && !region.include?('fips')
129
131
  [region, s3_arn]
130
132
  else
131
133
  [region]
@@ -133,15 +135,30 @@ be made. Set to `false` to use the client's region instead.
133
135
  end
134
136
 
135
137
  # @api private
136
- 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)
137
139
  custom_endpoint = url.host if has_custom_endpoint
138
- url.host = arn.host_url(region, dualstack, custom_endpoint)
140
+ url.host = arn.host_url(region, fips, dualstack, custom_endpoint)
139
141
  url.path = url_path(url.path, arn)
140
142
  url
141
143
  end
142
144
 
143
145
  private
144
146
 
147
+ def resolve_arn_type!(arn)
148
+ case arn.service
149
+ when 's3'
150
+ Aws::S3::AccessPointARN.new(arn.to_h)
151
+ when 's3-outposts'
152
+ Aws::S3::OutpostAccessPointARN.new(arn.to_h)
153
+ when 's3-object-lambda'
154
+ Aws::S3::ObjectLambdaARN.new(arn.to_h)
155
+ else
156
+ raise ArgumentError,
157
+ 'Only Access Point, Outposts, and Object Lambdas ARNs '\
158
+ 'are currently supported.'
159
+ end
160
+ end
161
+
145
162
  def resolve_s3_use_arn_region(cfg)
146
163
  value = ENV['AWS_S3_USE_ARN_REGION'] ||
147
164
  Aws.shared_config.s3_use_arn_region(profile: cfg.profile) ||
@@ -157,8 +174,7 @@ be made. Set to `false` to use the client's region instead.
157
174
  value
158
175
  end
159
176
 
160
- # Remove ARN from the path since it was substituted already
161
- # This only works because accesspoints care about the URL
177
+ # Remove ARN from the path because we've already set the new host
162
178
  def url_path(path, arn)
163
179
  path = path.sub("/#{Seahorse::Util.uri_escape(arn.to_s)}", '')
164
180
  .sub("/#{arn}", '')
@@ -167,33 +183,40 @@ be made. Set to `false` to use the client's region instead.
167
183
  end
168
184
 
169
185
  def validate_region_config!(arn, region, use_arn_region)
170
- fips = arn.support_fips?
171
-
172
- # s3-external-1 is specific just to s3 and not part of partitions
173
- # aws-global is a partition region
174
- unless arn.partition == 'aws' &&
175
- (region == 's3-external-1' || region == 'aws-global')
176
- if !fips && arn.region.include?('fips')
177
- raise ArgumentError,
178
- '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.'
179
191
  end
180
-
181
- if !fips && !use_arn_region && region.include?('fips')
182
- raise ArgumentError,
183
- 'FIPS client regions are not supported for this type of '\
184
- '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
185
196
  end
186
-
187
- # if it's a fips region, attempt to normalize it
188
- 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
189
208
  region = region.gsub('fips-', '').gsub('-fips', '')
190
209
  end
210
+
211
+ # Raise if the ARN and client regions are in different partitions
191
212
  if use_arn_region &&
192
213
  !Aws::Partitions.partition(arn.partition).region?(region)
193
214
  raise Aws::Errors::InvalidARNPartitionError
194
215
  end
195
216
 
196
- 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
197
220
  raise Aws::Errors::InvalidARNRegionError
198
221
  end
199
222
  end
@@ -10,8 +10,8 @@ module Aws
10
10
  default: 'legacy',
11
11
  doc_type: String,
12
12
  docstring: <<-DOCS) do |cfg|
13
- Passing in `regional` to enable regional endpoint for S3's `us-east-1`
14
- region. Defaults to `legacy` mode using global endpoint.
13
+ Pass in `regional` to enable the `us-east-1` regional endpoint.
14
+ Defaults to `legacy` mode which uses the global endpoint.
15
15
  DOCS
16
16
  resolve_iad_regional_endpoint(cfg)
17
17
  end
@@ -27,14 +27,14 @@ region. Defaults to `legacy` mode using global endpoint.
27
27
  class Handler < Seahorse::Client::Handler
28
28
 
29
29
  def call(context)
30
- # keep legacy global endpoint pattern by default
31
- if context.config.s3_us_east_1_regional_endpoint == 'legacy'
30
+ # WriteGetObjectResponse does not have a global endpoint
31
+ # ARNs are regionalized, so don't touch those either.
32
+ if context.operation.name != 'WriteGetObjectResponse' &&
33
+ context.config.s3_us_east_1_regional_endpoint == 'legacy' &&
34
+ !context.metadata[:s3_arn]
32
35
  host = context.http_request.endpoint.host
33
- # if it's an ARN then don't touch the endpoint at all
34
- unless context.metadata[:s3_arn]
35
- legacy_host = IADRegionalEndpoint.legacy_host(host)
36
- context.http_request.endpoint.host = legacy_host
37
- end
36
+ legacy_host = IADRegionalEndpoint.legacy_host(host)
37
+ context.http_request.endpoint.host = legacy_host
38
38
  end
39
39
  @handler.call(context)
40
40
  end
@@ -0,0 +1,25 @@
1
+ # frozen_string_literal: true
2
+
3
+ module Aws
4
+ module S3
5
+ module Plugins
6
+ # WriteGetObjectResponse is called from Lambda after a data transform.
7
+ # If there is no custom endpoint, we change the endpoint from s3 to
8
+ # s3-object-lambda just for this operation.
9
+ class ObjectLambdaEndpoint < Seahorse::Client::Plugin
10
+ class Handler < Seahorse::Client::Handler
11
+ def call(context)
12
+ if context.config.regional_endpoint
13
+ host = context.http_request.endpoint.host
14
+ host = host.sub('s3.', 's3-object-lambda.')
15
+ context.http_request.endpoint.host = host
16
+ end
17
+ @handler.call(context)
18
+ end
19
+ end
20
+
21
+ handler(Handler, operations: [:write_get_object_response])
22
+ end
23
+ end
24
+ end
25
+ end
@@ -79,6 +79,12 @@ module Aws
79
79
  region: arn[:resolved_region],
80
80
  credentials: context.config.credentials
81
81
  )
82
+ elsif context.operation.name == 'WriteGetObjectResponse'
83
+ S3Signer.build_v4_signer(
84
+ service: 's3-object-lambda',
85
+ region: context.config.sigv4_region,
86
+ credentials: context.config.credentials
87
+ )
82
88
  else
83
89
  context.config.sigv4_signer
84
90
  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
@@ -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
  #
@@ -74,7 +74,7 @@ module Aws::S3
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
76
  # more information about access point ARNs, see [Using Access
77
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
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,12 +83,12 @@ 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
  #
90
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
91
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
90
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
91
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
92
92
  # @return [String]
93
93
  #
94
94
  # @!attribute [rw] key
@@ -112,7 +112,7 @@ module Aws::S3
112
112
  # @return [String]
113
113
  #
114
114
  # @!attribute [rw] expected_bucket_owner
115
- # The account id of the expected bucket owner. If the bucket is owned
115
+ # The account ID of the expected bucket owner. If the bucket is owned
116
116
  # by a different account, the request will fail with an HTTP `403
117
117
  # (Access Denied)` error.
118
118
  # @return [String]
@@ -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
  #
@@ -492,7 +492,7 @@ module Aws::S3
492
492
 
493
493
  # Specifies the lifecycle configuration for objects in an Amazon S3
494
494
  # bucket. For more information, see [Object Lifecycle Management][1] in
495
- # the *Amazon Simple Storage Service Developer Guide*.
495
+ # the *Amazon S3 User Guide*.
496
496
  #
497
497
  #
498
498
  #
@@ -608,8 +608,7 @@ module Aws::S3
608
608
 
609
609
  # Describes the cross-origin access configuration for objects in an
610
610
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
611
- # Resource Sharing][1] in the *Amazon Simple Storage Service Developer
612
- # Guide*.
611
+ # Resource Sharing][1] in the *Amazon S3 User Guide*.
613
612
  #
614
613
  #
615
614
  #
@@ -926,7 +925,7 @@ module Aws::S3
926
925
  # When using this action with an access point through the AWS SDKs,
927
926
  # you provide the access point ARN in place of the bucket name. For
928
927
  # more information about access point ARNs, see [Using Access
929
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
928
+ # Points][1] in the *Amazon S3 User Guide*.
930
929
  #
931
930
  # When using this action with Amazon S3 on Outposts, you must direct
932
931
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -935,12 +934,12 @@ module Aws::S3
935
934
  # When using this action using S3 on Outposts through the AWS SDKs,
936
935
  # you provide the Outposts bucket ARN in place of the bucket name. For
937
936
  # more information about S3 on Outposts ARNs, see [Using S3 on
938
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
937
+ # Outposts][2] in the *Amazon S3 User Guide*.
939
938
  #
940
939
  #
941
940
  #
942
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
943
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
941
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
942
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
944
943
  # @return [String]
945
944
  #
946
945
  # @!attribute [rw] key
@@ -1057,7 +1056,7 @@ module Aws::S3
1057
1056
  # @return [String]
1058
1057
  #
1059
1058
  # @!attribute [rw] expected_bucket_owner
1060
- # The account id of the expected bucket owner. If the bucket is owned
1059
+ # The account ID of the expected bucket owner. If the bucket is owned
1061
1060
  # by a different account, the request will fail with an HTTP `403
1062
1061
  # (Access Denied)` error.
1063
1062
  # @return [String]
@@ -1328,7 +1327,7 @@ module Aws::S3
1328
1327
  # When using this action with an access point through the AWS SDKs,
1329
1328
  # you provide the access point ARN in place of the bucket name. For
1330
1329
  # more information about access point ARNs, see [Using Access
1331
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
1330
+ # Points][1] in the *Amazon S3 User Guide*.
1332
1331
  #
1333
1332
  # When using this action with Amazon S3 on Outposts, you must direct
1334
1333
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -1337,12 +1336,12 @@ module Aws::S3
1337
1336
  # When using this action using S3 on Outposts through the AWS SDKs,
1338
1337
  # you provide the Outposts bucket ARN in place of the bucket name. For
1339
1338
  # more information about S3 on Outposts ARNs, see [Using S3 on
1340
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
1339
+ # Outposts][2] in the *Amazon S3 User Guide*.
1341
1340
  #
1342
1341
  #
1343
1342
  #
1344
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
1345
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
1343
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
1344
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
1346
1345
  # @return [String]
1347
1346
  #
1348
1347
  # @!attribute [rw] cache_control
@@ -1411,7 +1410,7 @@ module Aws::S3
1411
1410
  #
1412
1411
  #
1413
1412
  #
1414
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
1413
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html
1415
1414
  # @return [String]
1416
1415
  #
1417
1416
  # @!attribute [rw] copy_source_if_match
@@ -1603,13 +1602,13 @@ module Aws::S3
1603
1602
  # @return [String]
1604
1603
  #
1605
1604
  # @!attribute [rw] expected_bucket_owner
1606
- # The account id of the expected destination bucket owner. If the
1605
+ # The account ID of the expected destination bucket owner. If the
1607
1606
  # destination bucket is owned by a different account, the request will
1608
1607
  # fail with an HTTP `403 (Access Denied)` error.
1609
1608
  # @return [String]
1610
1609
  #
1611
1610
  # @!attribute [rw] expected_source_bucket_owner
1612
- # The account id of the expected source bucket owner. If the source
1611
+ # The account ID of the expected source bucket owner. If the source
1613
1612
  # bucket is owned by a different account, the request will fail with
1614
1613
  # an HTTP `403 (Access Denied)` error.
1615
1614
  # @return [String]
@@ -1845,7 +1844,7 @@ module Aws::S3
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
1846
  # more information about access point ARNs, see [Using Access
1848
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
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,12 +1853,12 @@ 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
  #
1861
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
1862
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
1860
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
1861
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
1863
1862
  # @return [String]
1864
1863
  #
1865
1864
  # @!attribute [rw] key
@@ -1983,7 +1982,7 @@ module Aws::S3
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
1984
  # more information about access point ARNs, see [Using Access
1986
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
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,12 +1991,12 @@ 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
  #
1999
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2000
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
1998
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
1999
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2001
2000
  # @return [String]
2002
2001
  #
2003
2002
  # @!attribute [rw] cache_control
@@ -2165,7 +2164,7 @@ module Aws::S3
2165
2164
  # @return [String]
2166
2165
  #
2167
2166
  # @!attribute [rw] expected_bucket_owner
2168
- # The account id of the expected bucket owner. If the bucket is owned
2167
+ # The account ID of the expected bucket owner. If the bucket is owned
2169
2168
  # by a different account, the request will fail with an HTTP `403
2170
2169
  # (Access Denied)` error.
2171
2170
  # @return [String]
@@ -2209,6 +2208,14 @@ module Aws::S3
2209
2208
  # The container element for specifying the default Object Lock retention
2210
2209
  # settings for new objects placed in the specified bucket.
2211
2210
  #
2211
+ # <note markdown="1"> * The `DefaultRetention` settings require both a mode and a period.
2212
+ #
2213
+ # * The `DefaultRetention` period can be either `Days` or `Years` but
2214
+ # you must select one. You cannot specify `Days` and `Years` at the
2215
+ # same time.
2216
+ #
2217
+ # </note>
2218
+ #
2212
2219
  # @note When making an API call, you may pass DefaultRetention
2213
2220
  # data as a hash:
2214
2221
  #
@@ -2220,17 +2227,18 @@ module Aws::S3
2220
2227
  #
2221
2228
  # @!attribute [rw] mode
2222
2229
  # The default Object Lock retention mode you want to apply to new
2223
- # objects placed in the specified bucket.
2230
+ # objects placed in the specified bucket. Must be used with either
2231
+ # `Days` or `Years`.
2224
2232
  # @return [String]
2225
2233
  #
2226
2234
  # @!attribute [rw] days
2227
2235
  # The number of days that you want to specify for the default
2228
- # retention period.
2236
+ # retention period. Must be used with `Mode`.
2229
2237
  # @return [Integer]
2230
2238
  #
2231
2239
  # @!attribute [rw] years
2232
2240
  # The number of years that you want to specify for the default
2233
- # retention period.
2241
+ # retention period. Must be used with `Mode`.
2234
2242
  # @return [Integer]
2235
2243
  #
2236
2244
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DefaultRetention AWS API Documentation
@@ -2295,7 +2303,7 @@ module Aws::S3
2295
2303
  # @return [String]
2296
2304
  #
2297
2305
  # @!attribute [rw] expected_bucket_owner
2298
- # The account id of the expected bucket owner. If the bucket is owned
2306
+ # The account ID of the expected bucket owner. If the bucket is owned
2299
2307
  # by a different account, the request will fail with an HTTP `403
2300
2308
  # (Access Denied)` error.
2301
2309
  # @return [String]
@@ -2323,7 +2331,7 @@ module Aws::S3
2323
2331
  # @return [String]
2324
2332
  #
2325
2333
  # @!attribute [rw] expected_bucket_owner
2326
- # The account id of the expected bucket owner. If the bucket is owned
2334
+ # The account ID of the expected bucket owner. If the bucket is owned
2327
2335
  # by a different account, the request will fail with an HTTP `403
2328
2336
  # (Access Denied)` error.
2329
2337
  # @return [String]
@@ -2351,7 +2359,7 @@ module Aws::S3
2351
2359
  # @return [String]
2352
2360
  #
2353
2361
  # @!attribute [rw] expected_bucket_owner
2354
- # The account id of the expected bucket owner. If the bucket is owned
2362
+ # The account ID of the expected bucket owner. If the bucket is owned
2355
2363
  # by a different account, the request will fail with an HTTP `403
2356
2364
  # (Access Denied)` error.
2357
2365
  # @return [String]
@@ -2410,7 +2418,7 @@ module Aws::S3
2410
2418
  # @return [String]
2411
2419
  #
2412
2420
  # @!attribute [rw] expected_bucket_owner
2413
- # The account id of the expected bucket owner. If the bucket is owned
2421
+ # The account ID of the expected bucket owner. If the bucket is owned
2414
2422
  # by a different account, the request will fail with an HTTP `403
2415
2423
  # (Access Denied)` error.
2416
2424
  # @return [String]
@@ -2438,7 +2446,7 @@ module Aws::S3
2438
2446
  # @return [String]
2439
2447
  #
2440
2448
  # @!attribute [rw] expected_bucket_owner
2441
- # The account id of the expected bucket owner. If the bucket is owned
2449
+ # The account ID of the expected bucket owner. If the bucket is owned
2442
2450
  # by a different account, the request will fail with an HTTP `403
2443
2451
  # (Access Denied)` error.
2444
2452
  # @return [String]
@@ -2471,7 +2479,7 @@ module Aws::S3
2471
2479
  # @return [String]
2472
2480
  #
2473
2481
  # @!attribute [rw] expected_bucket_owner
2474
- # The account id of the expected bucket owner. If the bucket is owned
2482
+ # The account ID of the expected bucket owner. If the bucket is owned
2475
2483
  # by a different account, the request will fail with an HTTP `403
2476
2484
  # (Access Denied)` error.
2477
2485
  # @return [String]
@@ -2499,7 +2507,7 @@ module Aws::S3
2499
2507
  # @return [String]
2500
2508
  #
2501
2509
  # @!attribute [rw] expected_bucket_owner
2502
- # The account id of the expected bucket owner. If the bucket is owned
2510
+ # The account ID of the expected bucket owner. If the bucket is owned
2503
2511
  # by a different account, the request will fail with an HTTP `403
2504
2512
  # (Access Denied)` error.
2505
2513
  # @return [String]
@@ -2526,7 +2534,7 @@ module Aws::S3
2526
2534
  # @return [String]
2527
2535
  #
2528
2536
  # @!attribute [rw] expected_bucket_owner
2529
- # The account id of the expected bucket owner. If the bucket is owned
2537
+ # The account ID of the expected bucket owner. If the bucket is owned
2530
2538
  # by a different account, the request will fail with an HTTP `403
2531
2539
  # (Access Denied)` error.
2532
2540
  # @return [String]
@@ -2553,7 +2561,7 @@ module Aws::S3
2553
2561
  # @return [String]
2554
2562
  #
2555
2563
  # @!attribute [rw] expected_bucket_owner
2556
- # The account id of the expected bucket owner. If the bucket is owned
2564
+ # The account ID of the expected bucket owner. If the bucket is owned
2557
2565
  # by a different account, the request will fail with an HTTP `403
2558
2566
  # (Access Denied)` error.
2559
2567
  # @return [String]
@@ -2580,7 +2588,7 @@ module Aws::S3
2580
2588
  # @return [String]
2581
2589
  #
2582
2590
  # @!attribute [rw] expected_bucket_owner
2583
- # The account id of the expected bucket owner. If the bucket is owned
2591
+ # The account ID of the expected bucket owner. If the bucket is owned
2584
2592
  # by a different account, the request will fail with an HTTP `403
2585
2593
  # (Access Denied)` error.
2586
2594
  # @return [String]
@@ -2607,7 +2615,7 @@ module Aws::S3
2607
2615
  # @return [String]
2608
2616
  #
2609
2617
  # @!attribute [rw] expected_bucket_owner
2610
- # The account id of the expected bucket owner. If the bucket is owned
2618
+ # The account ID of the expected bucket owner. If the bucket is owned
2611
2619
  # by a different account, the request will fail with an HTTP `403
2612
2620
  # (Access Denied)` error.
2613
2621
  # @return [String]
@@ -2635,7 +2643,7 @@ module Aws::S3
2635
2643
  # @return [String]
2636
2644
  #
2637
2645
  # @!attribute [rw] expected_bucket_owner
2638
- # The account id of the expected bucket owner. If the bucket is owned
2646
+ # The account ID of the expected bucket owner. If the bucket is owned
2639
2647
  # by a different account, the request will fail with an HTTP `403
2640
2648
  # (Access Denied)` error.
2641
2649
  # @return [String]
@@ -2778,7 +2786,7 @@ module Aws::S3
2778
2786
  # When using this action with an access point through the AWS SDKs,
2779
2787
  # you provide the access point ARN in place of the bucket name. For
2780
2788
  # more information about access point ARNs, see [Using Access
2781
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
2789
+ # Points][1] in the *Amazon S3 User Guide*.
2782
2790
  #
2783
2791
  # When using this action with Amazon S3 on Outposts, you must direct
2784
2792
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2787,12 +2795,12 @@ module Aws::S3
2787
2795
  # When using this action using S3 on Outposts through the AWS SDKs,
2788
2796
  # you provide the Outposts bucket ARN in place of the bucket name. For
2789
2797
  # more information about S3 on Outposts ARNs, see [Using S3 on
2790
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
2798
+ # Outposts][2] in the *Amazon S3 User Guide*.
2791
2799
  #
2792
2800
  #
2793
2801
  #
2794
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2795
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2802
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
2803
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2796
2804
  # @return [String]
2797
2805
  #
2798
2806
  # @!attribute [rw] key
@@ -2828,7 +2836,7 @@ module Aws::S3
2828
2836
  # @return [Boolean]
2829
2837
  #
2830
2838
  # @!attribute [rw] expected_bucket_owner
2831
- # The account id of the expected bucket owner. If the bucket is owned
2839
+ # The account ID of the expected bucket owner. If the bucket is owned
2832
2840
  # by a different account, the request will fail with an HTTP `403
2833
2841
  # (Access Denied)` error.
2834
2842
  # @return [String]
@@ -2880,7 +2888,7 @@ module Aws::S3
2880
2888
  # When using this action with an access point through the AWS SDKs,
2881
2889
  # you provide the access point ARN in place of the bucket name. For
2882
2890
  # more information about access point ARNs, see [Using Access
2883
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
2891
+ # Points][1] in the *Amazon S3 User Guide*.
2884
2892
  #
2885
2893
  # When using this action with Amazon S3 on Outposts, you must direct
2886
2894
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2889,12 +2897,12 @@ module Aws::S3
2889
2897
  # When using this action using S3 on Outposts through the AWS SDKs,
2890
2898
  # you provide the Outposts bucket ARN in place of the bucket name. For
2891
2899
  # more information about S3 on Outposts ARNs, see [Using S3 on
2892
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
2900
+ # Outposts][2] in the *Amazon S3 User Guide*.
2893
2901
  #
2894
2902
  #
2895
2903
  #
2896
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2897
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2904
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
2905
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2898
2906
  # @return [String]
2899
2907
  #
2900
2908
  # @!attribute [rw] key
@@ -2907,7 +2915,7 @@ module Aws::S3
2907
2915
  # @return [String]
2908
2916
  #
2909
2917
  # @!attribute [rw] expected_bucket_owner
2910
- # The account id of the expected bucket owner. If the bucket is owned
2918
+ # The account ID of the expected bucket owner. If the bucket is owned
2911
2919
  # by a different account, the request will fail with an HTTP `403
2912
2920
  # (Access Denied)` error.
2913
2921
  # @return [String]
@@ -2978,7 +2986,7 @@ module Aws::S3
2978
2986
  # When using this action with an access point through the AWS SDKs,
2979
2987
  # you provide the access point ARN in place of the bucket name. For
2980
2988
  # more information about access point ARNs, see [Using Access
2981
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
2989
+ # Points][1] in the *Amazon S3 User Guide*.
2982
2990
  #
2983
2991
  # When using this action with Amazon S3 on Outposts, you must direct
2984
2992
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2987,12 +2995,12 @@ module Aws::S3
2987
2995
  # When using this action using S3 on Outposts through the AWS SDKs,
2988
2996
  # you provide the Outposts bucket ARN in place of the bucket name. For
2989
2997
  # more information about S3 on Outposts ARNs, see [Using S3 on
2990
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
2998
+ # Outposts][2] in the *Amazon S3 User Guide*.
2991
2999
  #
2992
3000
  #
2993
3001
  #
2994
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2995
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
3002
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
3003
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2996
3004
  # @return [String]
2997
3005
  #
2998
3006
  # @!attribute [rw] delete
@@ -3025,7 +3033,7 @@ module Aws::S3
3025
3033
  # @return [Boolean]
3026
3034
  #
3027
3035
  # @!attribute [rw] expected_bucket_owner
3028
- # The account id of the expected bucket owner. If the bucket is owned
3036
+ # The account ID of the expected bucket owner. If the bucket is owned
3029
3037
  # by a different account, the request will fail with an HTTP `403
3030
3038
  # (Access Denied)` error.
3031
3039
  # @return [String]
@@ -3057,7 +3065,7 @@ module Aws::S3
3057
3065
  # @return [String]
3058
3066
  #
3059
3067
  # @!attribute [rw] expected_bucket_owner
3060
- # The account id of the expected bucket owner. If the bucket is owned
3068
+ # The account ID of the expected bucket owner. If the bucket is owned
3061
3069
  # by a different account, the request will fail with an HTTP `403
3062
3070
  # (Access Denied)` error.
3063
3071
  # @return [String]
@@ -4198,7 +4206,7 @@ module Aws::S3
4198
4206
  # to which the filtering rule applies. The maximum length is 1,024
4199
4207
  # characters. Overlapping prefixes and suffixes are not supported. For
4200
4208
  # more information, see [Configuring Event Notifications][1] in the
4201
- # *Amazon Simple Storage Service Developer Guide*.
4209
+ # *Amazon S3 User Guide*.
4202
4210
  #
4203
4211
  #
4204
4212
  #
@@ -4244,7 +4252,7 @@ module Aws::S3
4244
4252
  # @return [String]
4245
4253
  #
4246
4254
  # @!attribute [rw] expected_bucket_owner
4247
- # The account id of the expected bucket owner. If the bucket is owned
4255
+ # The account ID of the expected bucket owner. If the bucket is owned
4248
4256
  # by a different account, the request will fail with an HTTP `403
4249
4257
  # (Access Denied)` error.
4250
4258
  # @return [String]
@@ -4288,7 +4296,7 @@ module Aws::S3
4288
4296
  # @return [String]
4289
4297
  #
4290
4298
  # @!attribute [rw] expected_bucket_owner
4291
- # The account id of the expected bucket owner. If the bucket is owned
4299
+ # The account ID of the expected bucket owner. If the bucket is owned
4292
4300
  # by a different account, the request will fail with an HTTP `403
4293
4301
  # (Access Denied)` error.
4294
4302
  # @return [String]
@@ -4333,7 +4341,7 @@ module Aws::S3
4333
4341
  # @return [String]
4334
4342
  #
4335
4343
  # @!attribute [rw] expected_bucket_owner
4336
- # The account id of the expected bucket owner. If the bucket is owned
4344
+ # The account ID of the expected bucket owner. If the bucket is owned
4337
4345
  # by a different account, the request will fail with an HTTP `403
4338
4346
  # (Access Denied)` error.
4339
4347
  # @return [String]
@@ -4374,7 +4382,7 @@ module Aws::S3
4374
4382
  # @return [String]
4375
4383
  #
4376
4384
  # @!attribute [rw] expected_bucket_owner
4377
- # The account id of the expected bucket owner. If the bucket is owned
4385
+ # The account ID of the expected bucket owner. If the bucket is owned
4378
4386
  # by a different account, the request will fail with an HTTP `403
4379
4387
  # (Access Denied)` error.
4380
4388
  # @return [String]
@@ -4414,7 +4422,7 @@ module Aws::S3
4414
4422
  # @return [String]
4415
4423
  #
4416
4424
  # @!attribute [rw] expected_bucket_owner
4417
- # The account id of the expected bucket owner. If the bucket is owned
4425
+ # The account ID of the expected bucket owner. If the bucket is owned
4418
4426
  # by a different account, the request will fail with an HTTP `403
4419
4427
  # (Access Denied)` error.
4420
4428
  # @return [String]
@@ -4497,7 +4505,7 @@ module Aws::S3
4497
4505
  # @return [String]
4498
4506
  #
4499
4507
  # @!attribute [rw] expected_bucket_owner
4500
- # The account id of the expected bucket owner. If the bucket is owned
4508
+ # The account ID of the expected bucket owner. If the bucket is owned
4501
4509
  # by a different account, the request will fail with an HTTP `403
4502
4510
  # (Access Denied)` error.
4503
4511
  # @return [String]
@@ -4537,7 +4545,7 @@ module Aws::S3
4537
4545
  # @return [String]
4538
4546
  #
4539
4547
  # @!attribute [rw] expected_bucket_owner
4540
- # The account id of the expected bucket owner. If the bucket is owned
4548
+ # The account ID of the expected bucket owner. If the bucket is owned
4541
4549
  # by a different account, the request will fail with an HTTP `403
4542
4550
  # (Access Denied)` error.
4543
4551
  # @return [String]
@@ -4576,7 +4584,7 @@ module Aws::S3
4576
4584
  # @return [String]
4577
4585
  #
4578
4586
  # @!attribute [rw] expected_bucket_owner
4579
- # The account id of the expected bucket owner. If the bucket is owned
4587
+ # The account ID of the expected bucket owner. If the bucket is owned
4580
4588
  # by a different account, the request will fail with an HTTP `403
4581
4589
  # (Access Denied)` error.
4582
4590
  # @return [String]
@@ -4622,7 +4630,7 @@ module Aws::S3
4622
4630
  # @return [String]
4623
4631
  #
4624
4632
  # @!attribute [rw] expected_bucket_owner
4625
- # The account id of the expected bucket owner. If the bucket is owned
4633
+ # The account ID of the expected bucket owner. If the bucket is owned
4626
4634
  # by a different account, the request will fail with an HTTP `403
4627
4635
  # (Access Denied)` error.
4628
4636
  # @return [String]
@@ -4668,7 +4676,7 @@ module Aws::S3
4668
4676
  # @return [String]
4669
4677
  #
4670
4678
  # @!attribute [rw] expected_bucket_owner
4671
- # The account id of the expected bucket owner. If the bucket is owned
4679
+ # The account ID of the expected bucket owner. If the bucket is owned
4672
4680
  # by a different account, the request will fail with an HTTP `403
4673
4681
  # (Access Denied)` error.
4674
4682
  # @return [String]
@@ -4713,7 +4721,7 @@ module Aws::S3
4713
4721
  # @return [String]
4714
4722
  #
4715
4723
  # @!attribute [rw] expected_bucket_owner
4716
- # The account id of the expected bucket owner. If the bucket is owned
4724
+ # The account ID of the expected bucket owner. If the bucket is owned
4717
4725
  # by a different account, the request will fail with an HTTP `403
4718
4726
  # (Access Denied)` error.
4719
4727
  # @return [String]
@@ -4742,7 +4750,7 @@ module Aws::S3
4742
4750
  # @return [String]
4743
4751
  #
4744
4752
  # @!attribute [rw] expected_bucket_owner
4745
- # The account id of the expected bucket owner. If the bucket is owned
4753
+ # The account ID of the expected bucket owner. If the bucket is owned
4746
4754
  # by a different account, the request will fail with an HTTP `403
4747
4755
  # (Access Denied)` error.
4748
4756
  # @return [String]
@@ -4783,7 +4791,7 @@ module Aws::S3
4783
4791
  # @return [String]
4784
4792
  #
4785
4793
  # @!attribute [rw] expected_bucket_owner
4786
- # The account id of the expected bucket owner. If the bucket is owned
4794
+ # The account ID of the expected bucket owner. If the bucket is owned
4787
4795
  # by a different account, the request will fail with an HTTP `403
4788
4796
  # (Access Denied)` error.
4789
4797
  # @return [String]
@@ -4822,7 +4830,7 @@ module Aws::S3
4822
4830
  # @return [String]
4823
4831
  #
4824
4832
  # @!attribute [rw] expected_bucket_owner
4825
- # The account id of the expected bucket owner. If the bucket is owned
4833
+ # The account ID of the expected bucket owner. If the bucket is owned
4826
4834
  # by a different account, the request will fail with an HTTP `403
4827
4835
  # (Access Denied)` error.
4828
4836
  # @return [String]
@@ -4862,7 +4870,7 @@ module Aws::S3
4862
4870
  # @return [String]
4863
4871
  #
4864
4872
  # @!attribute [rw] expected_bucket_owner
4865
- # The account id of the expected bucket owner. If the bucket is owned
4873
+ # The account ID of the expected bucket owner. If the bucket is owned
4866
4874
  # by a different account, the request will fail with an HTTP `403
4867
4875
  # (Access Denied)` error.
4868
4876
  # @return [String]
@@ -4902,7 +4910,7 @@ module Aws::S3
4902
4910
  # @return [String]
4903
4911
  #
4904
4912
  # @!attribute [rw] expected_bucket_owner
4905
- # The account id of the expected bucket owner. If the bucket is owned
4913
+ # The account ID of the expected bucket owner. If the bucket is owned
4906
4914
  # by a different account, the request will fail with an HTTP `403
4907
4915
  # (Access Denied)` error.
4908
4916
  # @return [String]
@@ -4942,7 +4950,7 @@ module Aws::S3
4942
4950
  # @return [String]
4943
4951
  #
4944
4952
  # @!attribute [rw] expected_bucket_owner
4945
- # The account id of the expected bucket owner. If the bucket is owned
4953
+ # The account ID of the expected bucket owner. If the bucket is owned
4946
4954
  # by a different account, the request will fail with an HTTP `403
4947
4955
  # (Access Denied)` error.
4948
4956
  # @return [String]
@@ -4981,7 +4989,7 @@ module Aws::S3
4981
4989
  # @return [String]
4982
4990
  #
4983
4991
  # @!attribute [rw] expected_bucket_owner
4984
- # The account id of the expected bucket owner. If the bucket is owned
4992
+ # The account ID of the expected bucket owner. If the bucket is owned
4985
4993
  # by a different account, the request will fail with an HTTP `403
4986
4994
  # (Access Denied)` error.
4987
4995
  # @return [String]
@@ -5028,7 +5036,7 @@ module Aws::S3
5028
5036
  # @return [String]
5029
5037
  #
5030
5038
  # @!attribute [rw] expected_bucket_owner
5031
- # The account id of the expected bucket owner. If the bucket is owned
5039
+ # The account ID of the expected bucket owner. If the bucket is owned
5032
5040
  # by a different account, the request will fail with an HTTP `403
5033
5041
  # (Access Denied)` error.
5034
5042
  # @return [String]
@@ -5086,7 +5094,7 @@ module Aws::S3
5086
5094
  # @return [String]
5087
5095
  #
5088
5096
  # @!attribute [rw] expected_bucket_owner
5089
- # The account id of the expected bucket owner. If the bucket is owned
5097
+ # The account ID of the expected bucket owner. If the bucket is owned
5090
5098
  # by a different account, the request will fail with an HTTP `403
5091
5099
  # (Access Denied)` error.
5092
5100
  # @return [String]
@@ -5145,11 +5153,11 @@ module Aws::S3
5145
5153
  # When using this action with an access point through the AWS SDKs,
5146
5154
  # you provide the access point ARN in place of the bucket name. For
5147
5155
  # more information about access point ARNs, see [Using Access
5148
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5156
+ # Points][1] in the *Amazon S3 User Guide*.
5149
5157
  #
5150
5158
  #
5151
5159
  #
5152
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5160
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5153
5161
  # @return [String]
5154
5162
  #
5155
5163
  # @!attribute [rw] key
@@ -5173,7 +5181,7 @@ module Aws::S3
5173
5181
  # @return [String]
5174
5182
  #
5175
5183
  # @!attribute [rw] expected_bucket_owner
5176
- # The account id of the expected bucket owner. If the bucket is owned
5184
+ # The account ID of the expected bucket owner. If the bucket is owned
5177
5185
  # by a different account, the request will fail with an HTTP `403
5178
5186
  # (Access Denied)` error.
5179
5187
  # @return [String]
@@ -5224,11 +5232,11 @@ module Aws::S3
5224
5232
  # When using this action with an access point through the AWS SDKs,
5225
5233
  # you provide the access point ARN in place of the bucket name. For
5226
5234
  # more information about access point ARNs, see [Using Access
5227
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5235
+ # Points][1] in the *Amazon S3 User Guide*.
5228
5236
  #
5229
5237
  #
5230
5238
  #
5231
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5239
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5232
5240
  # @return [String]
5233
5241
  #
5234
5242
  # @!attribute [rw] key
@@ -5254,7 +5262,7 @@ module Aws::S3
5254
5262
  # @return [String]
5255
5263
  #
5256
5264
  # @!attribute [rw] expected_bucket_owner
5257
- # The account id of the expected bucket owner. If the bucket is owned
5265
+ # The account ID of the expected bucket owner. If the bucket is owned
5258
5266
  # by a different account, the request will fail with an HTTP `403
5259
5267
  # (Access Denied)` error.
5260
5268
  # @return [String]
@@ -5301,15 +5309,15 @@ module Aws::S3
5301
5309
  # When using this action with an access point through the AWS SDKs,
5302
5310
  # you provide the access point ARN in place of the bucket name. For
5303
5311
  # more information about access point ARNs, see [Using Access
5304
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5312
+ # Points][1] in the *Amazon S3 User Guide*.
5305
5313
  #
5306
5314
  #
5307
5315
  #
5308
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5316
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5309
5317
  # @return [String]
5310
5318
  #
5311
5319
  # @!attribute [rw] expected_bucket_owner
5312
- # The account id of the expected bucket owner. If the bucket is owned
5320
+ # The account ID of the expected bucket owner. If the bucket is owned
5313
5321
  # by a different account, the request will fail with an HTTP `403
5314
5322
  # (Access Denied)` error.
5315
5323
  # @return [String]
@@ -5561,7 +5569,7 @@ module Aws::S3
5561
5569
  # When using this action with an access point through the AWS SDKs,
5562
5570
  # you provide the access point ARN in place of the bucket name. For
5563
5571
  # more information about access point ARNs, see [Using Access
5564
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5572
+ # Points][1] in the *Amazon S3 User Guide*.
5565
5573
  #
5566
5574
  # When using this action with Amazon S3 on Outposts, you must direct
5567
5575
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5570,12 +5578,12 @@ module Aws::S3
5570
5578
  # When using this action using S3 on Outposts through the AWS SDKs,
5571
5579
  # you provide the Outposts bucket ARN in place of the bucket name. For
5572
5580
  # more information about S3 on Outposts ARNs, see [Using S3 on
5573
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
5581
+ # Outposts][2] in the *Amazon S3 User Guide*.
5574
5582
  #
5575
5583
  #
5576
5584
  #
5577
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5578
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
5585
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5586
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5579
5587
  # @return [String]
5580
5588
  #
5581
5589
  # @!attribute [rw] if_match
@@ -5684,7 +5692,7 @@ module Aws::S3
5684
5692
  # @return [Integer]
5685
5693
  #
5686
5694
  # @!attribute [rw] expected_bucket_owner
5687
- # The account id of the expected bucket owner. If the bucket is owned
5695
+ # The account ID of the expected bucket owner. If the bucket is owned
5688
5696
  # by a different account, the request will fail with an HTTP `403
5689
5697
  # (Access Denied)` error.
5690
5698
  # @return [String]
@@ -5750,11 +5758,11 @@ module Aws::S3
5750
5758
  # When using this action with an access point through the AWS SDKs,
5751
5759
  # you provide the access point ARN in place of the bucket name. For
5752
5760
  # more information about access point ARNs, see [Using Access
5753
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5761
+ # Points][1] in the *Amazon S3 User Guide*.
5754
5762
  #
5755
5763
  #
5756
5764
  #
5757
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5765
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5758
5766
  # @return [String]
5759
5767
  #
5760
5768
  # @!attribute [rw] key
@@ -5780,7 +5788,7 @@ module Aws::S3
5780
5788
  # @return [String]
5781
5789
  #
5782
5790
  # @!attribute [rw] expected_bucket_owner
5783
- # The account id of the expected bucket owner. If the bucket is owned
5791
+ # The account ID of the expected bucket owner. If the bucket is owned
5784
5792
  # by a different account, the request will fail with an HTTP `403
5785
5793
  # (Access Denied)` error.
5786
5794
  # @return [String]
@@ -5837,7 +5845,7 @@ module Aws::S3
5837
5845
  # When using this action with an access point through the AWS SDKs,
5838
5846
  # you provide the access point ARN in place of the bucket name. For
5839
5847
  # more information about access point ARNs, see [Using Access
5840
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
5848
+ # Points][1] in the *Amazon S3 User Guide*.
5841
5849
  #
5842
5850
  # When using this action with Amazon S3 on Outposts, you must direct
5843
5851
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5846,12 +5854,12 @@ module Aws::S3
5846
5854
  # When using this action using S3 on Outposts through the AWS SDKs,
5847
5855
  # you provide the Outposts bucket ARN in place of the bucket name. For
5848
5856
  # more information about S3 on Outposts ARNs, see [Using S3 on
5849
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
5857
+ # Outposts][2] in the *Amazon S3 User Guide*.
5850
5858
  #
5851
5859
  #
5852
5860
  #
5853
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5854
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
5861
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5862
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5855
5863
  # @return [String]
5856
5864
  #
5857
5865
  # @!attribute [rw] key
@@ -5864,7 +5872,7 @@ module Aws::S3
5864
5872
  # @return [String]
5865
5873
  #
5866
5874
  # @!attribute [rw] expected_bucket_owner
5867
- # The account id of the expected bucket owner. If the bucket is owned
5875
+ # The account ID of the expected bucket owner. If the bucket is owned
5868
5876
  # by a different account, the request will fail with an HTTP `403
5869
5877
  # (Access Denied)` error.
5870
5878
  # @return [String]
@@ -5943,7 +5951,7 @@ module Aws::S3
5943
5951
  # @return [String]
5944
5952
  #
5945
5953
  # @!attribute [rw] expected_bucket_owner
5946
- # The account id of the expected bucket owner. If the bucket is owned
5954
+ # The account ID of the expected bucket owner. If the bucket is owned
5947
5955
  # by a different account, the request will fail with an HTTP `403
5948
5956
  # (Access Denied)` error.
5949
5957
  # @return [String]
@@ -5986,7 +5994,7 @@ module Aws::S3
5986
5994
  # @return [String]
5987
5995
  #
5988
5996
  # @!attribute [rw] expected_bucket_owner
5989
- # The account id of the expected bucket owner. If the bucket is owned
5997
+ # The account ID of the expected bucket owner. If the bucket is owned
5990
5998
  # by a different account, the request will fail with an HTTP `403
5991
5999
  # (Access Denied)` error.
5992
6000
  # @return [String]
@@ -6145,7 +6153,7 @@ module Aws::S3
6145
6153
  # When using this action with an access point through the AWS SDKs,
6146
6154
  # you provide the access point ARN in place of the bucket name. For
6147
6155
  # more information about access point ARNs, see [Using Access
6148
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
6156
+ # Points][1] in the *Amazon S3 User Guide*.
6149
6157
  #
6150
6158
  # When using this action with Amazon S3 on Outposts, you must direct
6151
6159
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6154,16 +6162,16 @@ module Aws::S3
6154
6162
  # When using this action using S3 on Outposts through the AWS SDKs,
6155
6163
  # you provide the Outposts bucket ARN in place of the bucket name. For
6156
6164
  # more information about S3 on Outposts ARNs, see [Using S3 on
6157
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
6165
+ # Outposts][2] in the *Amazon S3 User Guide*.
6158
6166
  #
6159
6167
  #
6160
6168
  #
6161
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
6162
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
6169
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
6170
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6163
6171
  # @return [String]
6164
6172
  #
6165
6173
  # @!attribute [rw] expected_bucket_owner
6166
- # The account id of the expected bucket owner. If the bucket is owned
6174
+ # The account ID of the expected bucket owner. If the bucket is owned
6167
6175
  # by a different account, the request will fail with an HTTP `403
6168
6176
  # (Access Denied)` error.
6169
6177
  # @return [String]
@@ -6203,7 +6211,7 @@ module Aws::S3
6203
6211
  # If an archive copy is already restored, the header value indicates
6204
6212
  # when Amazon S3 is scheduled to delete the object copy. For example:
6205
6213
  #
6206
- # `x-amz-restore: ongoing-request="false", expiry-date="Fri, 23 Dec
6214
+ # `x-amz-restore: ongoing-request="false", expiry-date="Fri, 21 Dec
6207
6215
  # 2012 00:00:00 GMT"`
6208
6216
  #
6209
6217
  # If the object restoration is in progress, the header returns the
@@ -6481,7 +6489,7 @@ module Aws::S3
6481
6489
  # When using this action with an access point through the AWS SDKs,
6482
6490
  # you provide the access point ARN in place of the bucket name. For
6483
6491
  # more information about access point ARNs, see [Using Access
6484
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
6492
+ # Points][1] in the *Amazon S3 User Guide*.
6485
6493
  #
6486
6494
  # When using this action with Amazon S3 on Outposts, you must direct
6487
6495
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6490,12 +6498,12 @@ module Aws::S3
6490
6498
  # When using this action using S3 on Outposts through the AWS SDKs,
6491
6499
  # you provide the Outposts bucket ARN in place of the bucket name. For
6492
6500
  # more information about S3 on Outposts ARNs, see [Using S3 on
6493
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
6501
+ # Outposts][2] in the *Amazon S3 User Guide*.
6494
6502
  #
6495
6503
  #
6496
6504
  #
6497
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
6498
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
6505
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
6506
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6499
6507
  # @return [String]
6500
6508
  #
6501
6509
  # @!attribute [rw] if_match
@@ -6580,7 +6588,7 @@ module Aws::S3
6580
6588
  # @return [Integer]
6581
6589
  #
6582
6590
  # @!attribute [rw] expected_bucket_owner
6583
- # The account id of the expected bucket owner. If the bucket is owned
6591
+ # The account ID of the expected bucket owner. If the bucket is owned
6584
6592
  # by a different account, the request will fail with an HTTP `403
6585
6593
  # (Access Denied)` error.
6586
6594
  # @return [String]
@@ -7227,7 +7235,7 @@ module Aws::S3
7227
7235
  # @!attribute [rw] events
7228
7236
  # The Amazon S3 bucket event for which to invoke the AWS Lambda
7229
7237
  # function. For more information, see [Supported Event Types][1] in
7230
- # the *Amazon Simple Storage Service Developer Guide*.
7238
+ # the *Amazon S3 User Guide*.
7231
7239
  #
7232
7240
  #
7233
7241
  #
@@ -7237,7 +7245,7 @@ module Aws::S3
7237
7245
  # @!attribute [rw] filter
7238
7246
  # Specifies object key name filtering rules. For information about key
7239
7247
  # name filtering, see [Configuring Event Notifications][1] in the
7240
- # *Amazon Simple Storage Service Developer Guide*.
7248
+ # *Amazon S3 User Guide*.
7241
7249
  #
7242
7250
  #
7243
7251
  #
@@ -7403,7 +7411,7 @@ module Aws::S3
7403
7411
  #
7404
7412
  # @!attribute [rw] prefix
7405
7413
  # Prefix identifying one or more objects to which the rule applies.
7406
- # This is No longer used; use `Filter` instead.
7414
+ # This is no longer used; use `Filter` instead.
7407
7415
  #
7408
7416
  # Replacement must be made for object keys containing special
7409
7417
  # characters (such as carriage returns) when using XML requests. For
@@ -7417,7 +7425,8 @@ module Aws::S3
7417
7425
  # @!attribute [rw] filter
7418
7426
  # The `Filter` is used to identify objects that a Lifecycle Rule
7419
7427
  # applies to. A `Filter` must have exactly one of `Prefix`, `Tag`, or
7420
- # `And` specified.
7428
+ # `And` specified. `Filter` is required if the `LifecycleRule` does
7429
+ # not containt a `Prefix` element.
7421
7430
  # @return [Types::LifecycleRuleFilter]
7422
7431
  #
7423
7432
  # @!attribute [rw] status
@@ -7453,7 +7462,7 @@ module Aws::S3
7453
7462
  # upload that Amazon S3 will wait before permanently removing all
7454
7463
  # parts of the upload. For more information, see [ Aborting Incomplete
7455
7464
  # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
7456
- # Simple Storage Service Developer Guide*.
7465
+ # S3 User Guide*.
7457
7466
  #
7458
7467
  #
7459
7468
  #
@@ -7623,7 +7632,7 @@ module Aws::S3
7623
7632
  # @return [String]
7624
7633
  #
7625
7634
  # @!attribute [rw] expected_bucket_owner
7626
- # The account id of the expected bucket owner. If the bucket is owned
7635
+ # The account ID of the expected bucket owner. If the bucket is owned
7627
7636
  # by a different account, the request will fail with an HTTP `403
7628
7637
  # (Access Denied)` error.
7629
7638
  # @return [String]
@@ -7754,7 +7763,7 @@ module Aws::S3
7754
7763
  # @return [String]
7755
7764
  #
7756
7765
  # @!attribute [rw] expected_bucket_owner
7757
- # The account id of the expected bucket owner. If the bucket is owned
7766
+ # The account ID of the expected bucket owner. If the bucket is owned
7758
7767
  # by a different account, the request will fail with an HTTP `403
7759
7768
  # (Access Denied)` error.
7760
7769
  # @return [String]
@@ -7826,7 +7835,7 @@ module Aws::S3
7826
7835
  # @return [String]
7827
7836
  #
7828
7837
  # @!attribute [rw] expected_bucket_owner
7829
- # The account id of the expected bucket owner. If the bucket is owned
7838
+ # The account ID of the expected bucket owner. If the bucket is owned
7830
7839
  # by a different account, the request will fail with an HTTP `403
7831
7840
  # (Access Denied)` error.
7832
7841
  # @return [String]
@@ -7972,7 +7981,7 @@ module Aws::S3
7972
7981
  # When using this action with an access point through the AWS SDKs,
7973
7982
  # you provide the access point ARN in place of the bucket name. For
7974
7983
  # more information about access point ARNs, see [Using Access
7975
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
7984
+ # Points][1] in the *Amazon S3 User Guide*.
7976
7985
  #
7977
7986
  # When using this action with Amazon S3 on Outposts, you must direct
7978
7987
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7981,12 +7990,12 @@ module Aws::S3
7981
7990
  # When using this action using S3 on Outposts through the AWS SDKs,
7982
7991
  # you provide the Outposts bucket ARN in place of the bucket name. For
7983
7992
  # more information about S3 on Outposts ARNs, see [Using S3 on
7984
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
7993
+ # Outposts][2] in the *Amazon S3 User Guide*.
7985
7994
  #
7986
7995
  #
7987
7996
  #
7988
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7989
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7997
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7998
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7990
7999
  # @return [String]
7991
8000
  #
7992
8001
  # @!attribute [rw] delimiter
@@ -8047,7 +8056,7 @@ module Aws::S3
8047
8056
  # @return [String]
8048
8057
  #
8049
8058
  # @!attribute [rw] expected_bucket_owner
8050
- # The account id of the expected bucket owner. If the bucket is owned
8059
+ # The account ID of the expected bucket owner. If the bucket is owned
8051
8060
  # by a different account, the request will fail with an HTTP `403
8052
8061
  # (Access Denied)` error.
8053
8062
  # @return [String]
@@ -8227,7 +8236,7 @@ module Aws::S3
8227
8236
  # @return [String]
8228
8237
  #
8229
8238
  # @!attribute [rw] expected_bucket_owner
8230
- # The account id of the expected bucket owner. If the bucket is owned
8239
+ # The account ID of the expected bucket owner. If the bucket is owned
8231
8240
  # by a different account, the request will fail with an HTTP `403
8232
8241
  # (Access Denied)` error.
8233
8242
  # @return [String]
@@ -8357,7 +8366,7 @@ module Aws::S3
8357
8366
  # When using this action with an access point through the AWS SDKs,
8358
8367
  # you provide the access point ARN in place of the bucket name. For
8359
8368
  # more information about access point ARNs, see [Using Access
8360
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
8369
+ # Points][1] in the *Amazon S3 User Guide*.
8361
8370
  #
8362
8371
  # When using this action with Amazon S3 on Outposts, you must direct
8363
8372
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -8366,12 +8375,12 @@ module Aws::S3
8366
8375
  # When using this action using S3 on Outposts through the AWS SDKs,
8367
8376
  # you provide the Outposts bucket ARN in place of the bucket name. For
8368
8377
  # more information about S3 on Outposts ARNs, see [Using S3 on
8369
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
8378
+ # Outposts][2] in the *Amazon S3 User Guide*.
8370
8379
  #
8371
8380
  #
8372
8381
  #
8373
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
8374
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
8382
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
8383
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
8375
8384
  # @return [String]
8376
8385
  #
8377
8386
  # @!attribute [rw] delimiter
@@ -8408,7 +8417,7 @@ module Aws::S3
8408
8417
  # @return [String]
8409
8418
  #
8410
8419
  # @!attribute [rw] expected_bucket_owner
8411
- # The account id of the expected bucket owner. If the bucket is owned
8420
+ # The account ID of the expected bucket owner. If the bucket is owned
8412
8421
  # by a different account, the request will fail with an HTTP `403
8413
8422
  # (Access Denied)` error.
8414
8423
  # @return [String]
@@ -8448,7 +8457,7 @@ module Aws::S3
8448
8457
  # When using this action with an access point through the AWS SDKs,
8449
8458
  # you provide the access point ARN in place of the bucket name. For
8450
8459
  # more information about access point ARNs, see [Using Access
8451
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
8460
+ # Points][1] in the *Amazon S3 User Guide*.
8452
8461
  #
8453
8462
  # When using this action with Amazon S3 on Outposts, you must direct
8454
8463
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -8457,12 +8466,12 @@ module Aws::S3
8457
8466
  # When using this action using S3 on Outposts through the AWS SDKs,
8458
8467
  # you provide the Outposts bucket ARN in place of the bucket name. For
8459
8468
  # more information about S3 on Outposts ARNs, see [Using S3 on
8460
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
8469
+ # Outposts][2] in the *Amazon S3 User Guide*.
8461
8470
  #
8462
8471
  #
8463
8472
  #
8464
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
8465
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
8473
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
8474
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
8466
8475
  # @return [String]
8467
8476
  #
8468
8477
  # @!attribute [rw] prefix
@@ -8583,7 +8592,7 @@ module Aws::S3
8583
8592
  # When using this action with an access point through the AWS SDKs,
8584
8593
  # you provide the access point ARN in place of the bucket name. For
8585
8594
  # more information about access point ARNs, see [Using Access
8586
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
8595
+ # Points][1] in the *Amazon S3 User Guide*.
8587
8596
  #
8588
8597
  # When using this action with Amazon S3 on Outposts, you must direct
8589
8598
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -8592,12 +8601,12 @@ module Aws::S3
8592
8601
  # When using this action using S3 on Outposts through the AWS SDKs,
8593
8602
  # you provide the Outposts bucket ARN in place of the bucket name. For
8594
8603
  # more information about S3 on Outposts ARNs, see [Using S3 on
8595
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
8604
+ # Outposts][2] in the *Amazon S3 User Guide*.
8596
8605
  #
8597
8606
  #
8598
8607
  #
8599
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
8600
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
8608
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
8609
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
8601
8610
  # @return [String]
8602
8611
  #
8603
8612
  # @!attribute [rw] delimiter
@@ -8644,7 +8653,7 @@ module Aws::S3
8644
8653
  # @return [String]
8645
8654
  #
8646
8655
  # @!attribute [rw] expected_bucket_owner
8647
- # The account id of the expected bucket owner. If the bucket is owned
8656
+ # The account ID of the expected bucket owner. If the bucket is owned
8648
8657
  # by a different account, the request will fail with an HTTP `403
8649
8658
  # (Access Denied)` error.
8650
8659
  # @return [String]
@@ -8798,7 +8807,7 @@ module Aws::S3
8798
8807
  # When using this action with an access point through the AWS SDKs,
8799
8808
  # you provide the access point ARN in place of the bucket name. For
8800
8809
  # more information about access point ARNs, see [Using Access
8801
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
8810
+ # Points][1] in the *Amazon S3 User Guide*.
8802
8811
  #
8803
8812
  # When using this action with Amazon S3 on Outposts, you must direct
8804
8813
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -8807,12 +8816,12 @@ module Aws::S3
8807
8816
  # When using this action using S3 on Outposts through the AWS SDKs,
8808
8817
  # you provide the Outposts bucket ARN in place of the bucket name. For
8809
8818
  # more information about S3 on Outposts ARNs, see [Using S3 on
8810
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
8819
+ # Outposts][2] in the *Amazon S3 User Guide*.
8811
8820
  #
8812
8821
  #
8813
8822
  #
8814
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
8815
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
8823
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
8824
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
8816
8825
  # @return [String]
8817
8826
  #
8818
8827
  # @!attribute [rw] key
@@ -8846,7 +8855,7 @@ module Aws::S3
8846
8855
  # @return [String]
8847
8856
  #
8848
8857
  # @!attribute [rw] expected_bucket_owner
8849
- # The account id of the expected bucket owner. If the bucket is owned
8858
+ # The account ID of the expected bucket owner. If the bucket is owned
8850
8859
  # by a different account, the request will fail with an HTTP `403
8851
8860
  # (Access Denied)` error.
8852
8861
  # @return [String]
@@ -9232,8 +9241,7 @@ module Aws::S3
9232
9241
  # Specifies the number of days an object is noncurrent before Amazon
9233
9242
  # S3 can perform the associated action. For information about the
9234
9243
  # 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*.
9244
+ # an Object Has Been Noncurrent][1] in the *Amazon S3 User Guide*.
9237
9245
  #
9238
9246
  #
9239
9247
  #
@@ -9393,7 +9401,7 @@ module Aws::S3
9393
9401
 
9394
9402
  # Specifies object key name filtering rules. For information about key
9395
9403
  # name filtering, see [Configuring Event Notifications][1] in the
9396
- # *Amazon Simple Storage Service Developer Guide*.
9404
+ # *Amazon S3 User Guide*.
9397
9405
  #
9398
9406
  #
9399
9407
  #
@@ -9542,11 +9550,16 @@ module Aws::S3
9542
9550
  #
9543
9551
  # @!attribute [rw] object_lock_enabled
9544
9552
  # Indicates whether this bucket has an Object Lock configuration
9545
- # enabled.
9553
+ # enabled. Enable `ObjectLockEnabled` when you apply
9554
+ # `ObjectLockConfiguration` to a bucket.
9546
9555
  # @return [String]
9547
9556
  #
9548
9557
  # @!attribute [rw] rule
9549
- # The Object Lock rule in place for the specified object.
9558
+ # Specifies the Object Lock rule for the specified object. Enable the
9559
+ # this rule when you apply `ObjectLockConfiguration` to a bucket.
9560
+ # Bucket settings require both a mode and a period. The period can be
9561
+ # either `Days` or `Years` but you must select one. You cannot specify
9562
+ # `Days` and `Years` at the same time.
9550
9563
  # @return [Types::ObjectLockRule]
9551
9564
  #
9552
9565
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectLockConfiguration AWS API Documentation
@@ -9620,8 +9633,11 @@ module Aws::S3
9620
9633
  # }
9621
9634
  #
9622
9635
  # @!attribute [rw] default_retention
9623
- # The default retention period that you want to apply to new objects
9624
- # placed in the specified bucket.
9636
+ # The default Object Lock retention mode and period that you want to
9637
+ # apply to new objects placed in the specified bucket. Bucket settings
9638
+ # require both a mode and a period. The period can be either `Days` or
9639
+ # `Years` but you must select one. You cannot specify `Days` and
9640
+ # `Years` at the same time.
9625
9641
  # @return [Types::DefaultRetention]
9626
9642
  #
9627
9643
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectLockRule AWS API Documentation
@@ -9960,7 +9976,7 @@ module Aws::S3
9960
9976
  # Amazon S3 bucket. You can enable the configuration options in any
9961
9977
  # combination. For more information about when Amazon S3 considers a
9962
9978
  # bucket or object public, see [The Meaning of "Public"][1] in the
9963
- # *Amazon Simple Storage Service User Guide*.
9979
+ # *Amazon S3 User Guide*.
9964
9980
  #
9965
9981
  #
9966
9982
  #
@@ -10054,7 +10070,7 @@ module Aws::S3
10054
10070
  # @return [Types::AccelerateConfiguration]
10055
10071
  #
10056
10072
  # @!attribute [rw] expected_bucket_owner
10057
- # The account id of the expected bucket owner. If the bucket is owned
10073
+ # The account ID of the expected bucket owner. If the bucket is owned
10058
10074
  # by a different account, the request will fail with an HTTP `403
10059
10075
  # (Access Denied)` error.
10060
10076
  # @return [String]
@@ -10152,7 +10168,7 @@ module Aws::S3
10152
10168
  # @return [String]
10153
10169
  #
10154
10170
  # @!attribute [rw] expected_bucket_owner
10155
- # The account id of the expected bucket owner. If the bucket is owned
10171
+ # The account ID of the expected bucket owner. If the bucket is owned
10156
10172
  # by a different account, the request will fail with an HTTP `403
10157
10173
  # (Access Denied)` error.
10158
10174
  # @return [String]
@@ -10229,7 +10245,7 @@ module Aws::S3
10229
10245
  # @return [Types::AnalyticsConfiguration]
10230
10246
  #
10231
10247
  # @!attribute [rw] expected_bucket_owner
10232
- # The account id of the expected bucket owner. If the bucket is owned
10248
+ # The account ID of the expected bucket owner. If the bucket is owned
10233
10249
  # by a different account, the request will fail with an HTTP `403
10234
10250
  # (Access Denied)` error.
10235
10251
  # @return [String]
@@ -10273,8 +10289,7 @@ module Aws::S3
10273
10289
  # @!attribute [rw] cors_configuration
10274
10290
  # Describes the cross-origin access configuration for objects in an
10275
10291
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
10276
- # Resource Sharing][1] in the *Amazon Simple Storage Service User
10277
- # Guide*.
10292
+ # Resource Sharing][1] in the *Amazon S3 User Guide*.
10278
10293
  #
10279
10294
  #
10280
10295
  #
@@ -10296,7 +10311,7 @@ module Aws::S3
10296
10311
  # @return [String]
10297
10312
  #
10298
10313
  # @!attribute [rw] expected_bucket_owner
10299
- # The account id of the expected bucket owner. If the bucket is owned
10314
+ # The account ID of the expected bucket owner. If the bucket is owned
10300
10315
  # by a different account, the request will fail with an HTTP `403
10301
10316
  # (Access Denied)` error.
10302
10317
  # @return [String]
@@ -10337,8 +10352,7 @@ module Aws::S3
10337
10352
  # encryption with Amazon S3-managed keys (SSE-S3) or customer master
10338
10353
  # keys stored in AWS KMS (SSE-KMS). For information about the Amazon
10339
10354
  # S3 default encryption feature, see [Amazon S3 Default Bucket
10340
- # Encryption][1] in the *Amazon Simple Storage Service Developer
10341
- # Guide*.
10355
+ # Encryption][1] in the *Amazon S3 User Guide*.
10342
10356
  #
10343
10357
  #
10344
10358
  #
@@ -10358,7 +10372,7 @@ module Aws::S3
10358
10372
  # @return [Types::ServerSideEncryptionConfiguration]
10359
10373
  #
10360
10374
  # @!attribute [rw] expected_bucket_owner
10361
- # The account id of the expected bucket owner. If the bucket is owned
10375
+ # The account ID of the expected bucket owner. If the bucket is owned
10362
10376
  # by a different account, the request will fail with an HTTP `403
10363
10377
  # (Access Denied)` error.
10364
10378
  # @return [String]
@@ -10481,7 +10495,7 @@ module Aws::S3
10481
10495
  # @return [Types::InventoryConfiguration]
10482
10496
  #
10483
10497
  # @!attribute [rw] expected_bucket_owner
10484
- # The account id of the expected bucket owner. If the bucket is owned
10498
+ # The account ID of the expected bucket owner. If the bucket is owned
10485
10499
  # by a different account, the request will fail with an HTTP `403
10486
10500
  # (Access Denied)` error.
10487
10501
  # @return [String]
@@ -10563,7 +10577,7 @@ module Aws::S3
10563
10577
  # @return [Types::BucketLifecycleConfiguration]
10564
10578
  #
10565
10579
  # @!attribute [rw] expected_bucket_owner
10566
- # The account id of the expected bucket owner. If the bucket is owned
10580
+ # The account ID of the expected bucket owner. If the bucket is owned
10567
10581
  # by a different account, the request will fail with an HTTP `403
10568
10582
  # (Access Denied)` error.
10569
10583
  # @return [String]
@@ -10628,7 +10642,7 @@ module Aws::S3
10628
10642
  # @return [Types::LifecycleConfiguration]
10629
10643
  #
10630
10644
  # @!attribute [rw] expected_bucket_owner
10631
- # The account id of the expected bucket owner. If the bucket is owned
10645
+ # The account ID of the expected bucket owner. If the bucket is owned
10632
10646
  # by a different account, the request will fail with an HTTP `403
10633
10647
  # (Access Denied)` error.
10634
10648
  # @return [String]
@@ -10687,7 +10701,7 @@ module Aws::S3
10687
10701
  # @return [String]
10688
10702
  #
10689
10703
  # @!attribute [rw] expected_bucket_owner
10690
- # The account id of the expected bucket owner. If the bucket is owned
10704
+ # The account ID of the expected bucket owner. If the bucket is owned
10691
10705
  # by a different account, the request will fail with an HTTP `403
10692
10706
  # (Access Denied)` error.
10693
10707
  # @return [String]
@@ -10744,7 +10758,7 @@ module Aws::S3
10744
10758
  # @return [Types::MetricsConfiguration]
10745
10759
  #
10746
10760
  # @!attribute [rw] expected_bucket_owner
10747
- # The account id of the expected bucket owner. If the bucket is owned
10761
+ # The account ID of the expected bucket owner. If the bucket is owned
10748
10762
  # by a different account, the request will fail with an HTTP `403
10749
10763
  # (Access Denied)` error.
10750
10764
  # @return [String]
@@ -10832,7 +10846,7 @@ module Aws::S3
10832
10846
  # @return [Types::NotificationConfiguration]
10833
10847
  #
10834
10848
  # @!attribute [rw] expected_bucket_owner
10835
- # The account id of the expected bucket owner. If the bucket is owned
10849
+ # The account ID of the expected bucket owner. If the bucket is owned
10836
10850
  # by a different account, the request will fail with an HTTP `403
10837
10851
  # (Access Denied)` error.
10838
10852
  # @return [String]
@@ -10893,7 +10907,7 @@ module Aws::S3
10893
10907
  # @return [Types::NotificationConfigurationDeprecated]
10894
10908
  #
10895
10909
  # @!attribute [rw] expected_bucket_owner
10896
- # The account id of the expected bucket owner. If the bucket is owned
10910
+ # The account ID of the expected bucket owner. If the bucket is owned
10897
10911
  # by a different account, the request will fail with an HTTP `403
10898
10912
  # (Access Denied)` error.
10899
10913
  # @return [String]
@@ -10938,7 +10952,7 @@ module Aws::S3
10938
10952
  # @return [String]
10939
10953
  #
10940
10954
  # @!attribute [rw] expected_bucket_owner
10941
- # The account id of the expected bucket owner. If the bucket is owned
10955
+ # The account ID of the expected bucket owner. If the bucket is owned
10942
10956
  # by a different account, the request will fail with an HTTP `403
10943
10957
  # (Access Denied)` error.
10944
10958
  # @return [String]
@@ -10991,7 +11005,7 @@ module Aws::S3
10991
11005
  # @return [String]
10992
11006
  #
10993
11007
  # @!attribute [rw] expected_bucket_owner
10994
- # The account id of the expected bucket owner. If the bucket is owned
11008
+ # The account ID of the expected bucket owner. If the bucket is owned
10995
11009
  # by a different account, the request will fail with an HTTP `403
10996
11010
  # (Access Denied)` error.
10997
11011
  # @return [String]
@@ -11110,7 +11124,7 @@ module Aws::S3
11110
11124
  # @return [String]
11111
11125
  #
11112
11126
  # @!attribute [rw] expected_bucket_owner
11113
- # The account id of the expected bucket owner. If the bucket is owned
11127
+ # The account ID of the expected bucket owner. If the bucket is owned
11114
11128
  # by a different account, the request will fail with an HTTP `403
11115
11129
  # (Access Denied)` error.
11116
11130
  # @return [String]
@@ -11162,7 +11176,7 @@ module Aws::S3
11162
11176
  # @return [Types::RequestPaymentConfiguration]
11163
11177
  #
11164
11178
  # @!attribute [rw] expected_bucket_owner
11165
- # The account id of the expected bucket owner. If the bucket is owned
11179
+ # The account ID of the expected bucket owner. If the bucket is owned
11166
11180
  # by a different account, the request will fail with an HTTP `403
11167
11181
  # (Access Denied)` error.
11168
11182
  # @return [String]
@@ -11218,7 +11232,7 @@ module Aws::S3
11218
11232
  # @return [Types::Tagging]
11219
11233
  #
11220
11234
  # @!attribute [rw] expected_bucket_owner
11221
- # The account id of the expected bucket owner. If the bucket is owned
11235
+ # The account ID of the expected bucket owner. If the bucket is owned
11222
11236
  # by a different account, the request will fail with an HTTP `403
11223
11237
  # (Access Denied)` error.
11224
11238
  # @return [String]
@@ -11277,7 +11291,7 @@ module Aws::S3
11277
11291
  # @return [Types::VersioningConfiguration]
11278
11292
  #
11279
11293
  # @!attribute [rw] expected_bucket_owner
11280
- # The account id of the expected bucket owner. If the bucket is owned
11294
+ # The account ID of the expected bucket owner. If the bucket is owned
11281
11295
  # by a different account, the request will fail with an HTTP `403
11282
11296
  # (Access Denied)` error.
11283
11297
  # @return [String]
@@ -11353,7 +11367,7 @@ module Aws::S3
11353
11367
  # @return [Types::WebsiteConfiguration]
11354
11368
  #
11355
11369
  # @!attribute [rw] expected_bucket_owner
11356
- # The account id of the expected bucket owner. If the bucket is owned
11370
+ # The account ID of the expected bucket owner. If the bucket is owned
11357
11371
  # by a different account, the request will fail with an HTTP `403
11358
11372
  # (Access Denied)` error.
11359
11373
  # @return [String]
@@ -11443,11 +11457,11 @@ module Aws::S3
11443
11457
  # When using this action with an access point through the AWS SDKs,
11444
11458
  # you provide the access point ARN in place of the bucket name. For
11445
11459
  # more information about access point ARNs, see [Using Access
11446
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
11460
+ # Points][1] in the *Amazon S3 User Guide*.
11447
11461
  #
11448
11462
  #
11449
11463
  #
11450
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11464
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11451
11465
  # @return [String]
11452
11466
  #
11453
11467
  # @!attribute [rw] content_md5
@@ -11504,7 +11518,7 @@ module Aws::S3
11504
11518
  # When using this action with an access point through the AWS SDKs,
11505
11519
  # you provide the access point ARN in place of the bucket name. For
11506
11520
  # more information about access point ARNs, see [Using Access
11507
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
11521
+ # Points][1] in the *Amazon S3 User Guide*.
11508
11522
  #
11509
11523
  # When using this action with Amazon S3 on Outposts, you must direct
11510
11524
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11513,12 +11527,12 @@ module Aws::S3
11513
11527
  # When using this action using S3 on Outposts through the AWS SDKs,
11514
11528
  # you provide the Outposts bucket ARN in place of the bucket name. For
11515
11529
  # more information about S3 on Outposts ARNs, see [Using S3 on
11516
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
11530
+ # Outposts][2] in the *Amazon S3 User Guide*.
11517
11531
  #
11518
11532
  #
11519
11533
  #
11520
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11521
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
11534
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11535
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
11522
11536
  # @return [String]
11523
11537
  #
11524
11538
  # @!attribute [rw] request_payer
@@ -11538,7 +11552,7 @@ module Aws::S3
11538
11552
  # @return [String]
11539
11553
  #
11540
11554
  # @!attribute [rw] expected_bucket_owner
11541
- # The account id of the expected bucket owner. If the bucket is owned
11555
+ # The account ID of the expected bucket owner. If the bucket is owned
11542
11556
  # by a different account, the request will fail with an HTTP `403
11543
11557
  # (Access Denied)` error.
11544
11558
  # @return [String]
@@ -11602,11 +11616,11 @@ module Aws::S3
11602
11616
  # When using this action with an access point through the AWS SDKs,
11603
11617
  # you provide the access point ARN in place of the bucket name. For
11604
11618
  # more information about access point ARNs, see [Using Access
11605
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
11619
+ # Points][1] in the *Amazon S3 User Guide*.
11606
11620
  #
11607
11621
  #
11608
11622
  #
11609
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11623
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11610
11624
  # @return [String]
11611
11625
  #
11612
11626
  # @!attribute [rw] key
@@ -11642,7 +11656,7 @@ module Aws::S3
11642
11656
  # @return [String]
11643
11657
  #
11644
11658
  # @!attribute [rw] expected_bucket_owner
11645
- # The account id of the expected bucket owner. If the bucket is owned
11659
+ # The account ID of the expected bucket owner. If the bucket is owned
11646
11660
  # by a different account, the request will fail with an HTTP `403
11647
11661
  # (Access Denied)` error.
11648
11662
  # @return [String]
@@ -11729,7 +11743,7 @@ module Aws::S3
11729
11743
  # @return [String]
11730
11744
  #
11731
11745
  # @!attribute [rw] expected_bucket_owner
11732
- # The account id of the expected bucket owner. If the bucket is owned
11746
+ # The account ID of the expected bucket owner. If the bucket is owned
11733
11747
  # by a different account, the request will fail with an HTTP `403
11734
11748
  # (Access Denied)` error.
11735
11749
  # @return [String]
@@ -11893,7 +11907,7 @@ module Aws::S3
11893
11907
  # When using this action with an access point through the AWS SDKs,
11894
11908
  # you provide the access point ARN in place of the bucket name. For
11895
11909
  # more information about access point ARNs, see [Using Access
11896
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
11910
+ # Points][1] in the *Amazon S3 User Guide*.
11897
11911
  #
11898
11912
  # When using this action with Amazon S3 on Outposts, you must direct
11899
11913
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11902,12 +11916,12 @@ module Aws::S3
11902
11916
  # When using this action using S3 on Outposts through the AWS SDKs,
11903
11917
  # you provide the Outposts bucket ARN in place of the bucket name. For
11904
11918
  # more information about S3 on Outposts ARNs, see [Using S3 on
11905
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
11919
+ # Outposts][2] in the *Amazon S3 User Guide*.
11906
11920
  #
11907
11921
  #
11908
11922
  #
11909
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11910
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
11923
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11924
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
11911
11925
  # @return [String]
11912
11926
  #
11913
11927
  # @!attribute [rw] cache_control
@@ -12155,7 +12169,7 @@ module Aws::S3
12155
12169
  # @return [String]
12156
12170
  #
12157
12171
  # @!attribute [rw] expected_bucket_owner
12158
- # The account id of the expected bucket owner. If the bucket is owned
12172
+ # The account ID of the expected bucket owner. If the bucket is owned
12159
12173
  # by a different account, the request will fail with an HTTP `403
12160
12174
  # (Access Denied)` error.
12161
12175
  # @return [String]
@@ -12240,11 +12254,11 @@ module Aws::S3
12240
12254
  # When using this action with an access point through the AWS SDKs,
12241
12255
  # you provide the access point ARN in place of the bucket name. For
12242
12256
  # more information about access point ARNs, see [Using Access
12243
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
12257
+ # Points][1] in the *Amazon S3 User Guide*.
12244
12258
  #
12245
12259
  #
12246
12260
  #
12247
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
12261
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
12248
12262
  # @return [String]
12249
12263
  #
12250
12264
  # @!attribute [rw] key
@@ -12286,7 +12300,7 @@ module Aws::S3
12286
12300
  # @return [String]
12287
12301
  #
12288
12302
  # @!attribute [rw] expected_bucket_owner
12289
- # The account id of the expected bucket owner. If the bucket is owned
12303
+ # The account ID of the expected bucket owner. If the bucket is owned
12290
12304
  # by a different account, the request will fail with an HTTP `403
12291
12305
  # (Access Denied)` error.
12292
12306
  # @return [String]
@@ -12348,7 +12362,7 @@ module Aws::S3
12348
12362
  # When using this action with an access point through the AWS SDKs,
12349
12363
  # you provide the access point ARN in place of the bucket name. For
12350
12364
  # more information about access point ARNs, see [Using Access
12351
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
12365
+ # Points][1] in the *Amazon S3 User Guide*.
12352
12366
  #
12353
12367
  # When using this action with Amazon S3 on Outposts, you must direct
12354
12368
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -12357,12 +12371,12 @@ module Aws::S3
12357
12371
  # When using this action using S3 on Outposts through the AWS SDKs,
12358
12372
  # you provide the Outposts bucket ARN in place of the bucket name. For
12359
12373
  # more information about S3 on Outposts ARNs, see [Using S3 on
12360
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
12374
+ # Outposts][2] in the *Amazon S3 User Guide*.
12361
12375
  #
12362
12376
  #
12363
12377
  #
12364
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
12365
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
12378
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
12379
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
12366
12380
  # @return [String]
12367
12381
  #
12368
12382
  # @!attribute [rw] key
@@ -12385,7 +12399,7 @@ module Aws::S3
12385
12399
  # @return [Types::Tagging]
12386
12400
  #
12387
12401
  # @!attribute [rw] expected_bucket_owner
12388
- # The account id of the expected bucket owner. If the bucket is owned
12402
+ # The account ID of the expected bucket owner. If the bucket is owned
12389
12403
  # by a different account, the request will fail with an HTTP `403
12390
12404
  # (Access Denied)` error.
12391
12405
  # @return [String]
@@ -12448,7 +12462,7 @@ module Aws::S3
12448
12462
  # Amazon S3 bucket. You can enable the configuration options in any
12449
12463
  # combination. For more information about when Amazon S3 considers a
12450
12464
  # bucket or object public, see [The Meaning of "Public"][1] in the
12451
- # *Amazon Simple Storage Service Developer Guide*.
12465
+ # *Amazon S3 User Guide*.
12452
12466
  #
12453
12467
  #
12454
12468
  #
@@ -12456,7 +12470,7 @@ module Aws::S3
12456
12470
  # @return [Types::PublicAccessBlockConfiguration]
12457
12471
  #
12458
12472
  # @!attribute [rw] expected_bucket_owner
12459
- # The account id of the expected bucket owner. If the bucket is owned
12473
+ # The account ID of the expected bucket owner. If the bucket is owned
12460
12474
  # by a different account, the request will fail with an HTTP `403
12461
12475
  # (Access Denied)` error.
12462
12476
  # @return [String]
@@ -12514,7 +12528,7 @@ module Aws::S3
12514
12528
  # @!attribute [rw] filter
12515
12529
  # Specifies object key name filtering rules. For information about key
12516
12530
  # name filtering, see [Configuring Event Notifications][1] in the
12517
- # *Amazon Simple Storage Service Developer Guide*.
12531
+ # *Amazon S3 User Guide*.
12518
12532
  #
12519
12533
  #
12520
12534
  #
@@ -12562,7 +12576,7 @@ module Aws::S3
12562
12576
  # @return [String]
12563
12577
  #
12564
12578
  # @!attribute [rw] events
12565
- # A collection of bucket events for which to send notifications
12579
+ # A collection of bucket events for which to send notifications.
12566
12580
  # @return [Array<String>]
12567
12581
  #
12568
12582
  # @!attribute [rw] queue
@@ -12805,7 +12819,7 @@ module Aws::S3
12805
12819
  # The Amazon Resource Name (ARN) of the AWS Identity and Access
12806
12820
  # Management (IAM) role that Amazon S3 assumes when replicating
12807
12821
  # objects. For more information, see [How to Set Up Replication][1] in
12808
- # the *Amazon Simple Storage Service Developer Guide*.
12822
+ # the *Amazon S3 User Guide*.
12809
12823
  #
12810
12824
  #
12811
12825
  #
@@ -12906,8 +12920,8 @@ module Aws::S3
12906
12920
  # will be replicated according to the rule with the highest priority.
12907
12921
  # The higher the number, the higher the priority.
12908
12922
  #
12909
- # For more information, see [Replication][1] in the *Amazon Simple
12910
- # Storage Service Developer Guide*.
12923
+ # For more information, see [Replication][1] in the *Amazon S3 User
12924
+ # Guide*.
12911
12925
  #
12912
12926
  #
12913
12927
  #
@@ -13008,7 +13022,7 @@ module Aws::S3
13008
13022
  # filters in an `And` tag.
13009
13023
  #
13010
13024
  # * If you specify a filter based on multiple tags, wrap the `Tag`
13011
- # elements in an `And` tag
13025
+ # elements in an `And` tag.
13012
13026
  #
13013
13027
  # @note When making an API call, you may pass ReplicationRuleAndOperator
13014
13028
  # data as a hash:
@@ -13328,7 +13342,7 @@ module Aws::S3
13328
13342
  # When using this action with an access point through the AWS SDKs,
13329
13343
  # you provide the access point ARN in place of the bucket name. For
13330
13344
  # more information about access point ARNs, see [Using Access
13331
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
13345
+ # Points][1] in the *Amazon S3 User Guide*.
13332
13346
  #
13333
13347
  # When using this action with Amazon S3 on Outposts, you must direct
13334
13348
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -13337,12 +13351,12 @@ module Aws::S3
13337
13351
  # When using this action using S3 on Outposts through the AWS SDKs,
13338
13352
  # you provide the Outposts bucket ARN in place of the bucket name. For
13339
13353
  # more information about S3 on Outposts ARNs, see [Using S3 on
13340
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
13354
+ # Outposts][2] in the *Amazon S3 User Guide*.
13341
13355
  #
13342
13356
  #
13343
13357
  #
13344
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
13345
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
13358
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
13359
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
13346
13360
  # @return [String]
13347
13361
  #
13348
13362
  # @!attribute [rw] key
@@ -13370,7 +13384,7 @@ module Aws::S3
13370
13384
  # @return [String]
13371
13385
  #
13372
13386
  # @!attribute [rw] expected_bucket_owner
13373
- # The account id of the expected bucket owner. If the bucket is owned
13387
+ # The account ID of the expected bucket owner. If the bucket is owned
13374
13388
  # by a different account, the request will fail with an HTTP `403
13375
13389
  # (Access Denied)` error.
13376
13390
  # @return [String]
@@ -13524,8 +13538,7 @@ module Aws::S3
13524
13538
 
13525
13539
  # Specifies the redirect behavior and when a redirect is applied. For
13526
13540
  # more information about routing rules, see [Configuring advanced
13527
- # conditional redirects][1] in the *Amazon Simple Storage Service User
13528
- # Guide*.
13541
+ # conditional redirects][1] in the *Amazon S3 User Guide*.
13529
13542
  #
13530
13543
  #
13531
13544
  #
@@ -13574,7 +13587,7 @@ module Aws::S3
13574
13587
  # Specifies lifecycle rules for an Amazon S3 bucket. For more
13575
13588
  # information, see [Put Bucket Lifecycle Configuration][1] in the
13576
13589
  # *Amazon Simple Storage Service API Reference*. For examples, see [Put
13577
- # Bucket Lifecycle Configuration Examples][2]
13590
+ # Bucket Lifecycle Configuration Examples][2].
13578
13591
  #
13579
13592
  #
13580
13593
  #
@@ -13641,7 +13654,7 @@ module Aws::S3
13641
13654
  # Specifies when an object transitions to a specified storage class.
13642
13655
  # For more information about Amazon S3 lifecycle configuration rules,
13643
13656
  # see [Transitioning Objects Using Amazon S3 Lifecycle][1] in the
13644
- # *Amazon Simple Storage Service User Guide*.
13657
+ # *Amazon S3 User Guide*.
13645
13658
  #
13646
13659
  #
13647
13660
  #
@@ -13673,7 +13686,7 @@ module Aws::S3
13673
13686
  # upload that Amazon S3 will wait before permanently removing all
13674
13687
  # parts of the upload. For more information, see [ Aborting Incomplete
13675
13688
  # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
13676
- # Simple Storage Service Developer Guide*.
13689
+ # S3 User Guide*.
13677
13690
  #
13678
13691
  #
13679
13692
  #
@@ -14040,7 +14053,7 @@ module Aws::S3
14040
14053
  # @return [Types::ScanRange]
14041
14054
  #
14042
14055
  # @!attribute [rw] expected_bucket_owner
14043
- # The account id of the expected bucket owner. If the bucket is owned
14056
+ # The account ID of the expected bucket owner. If the bucket is owned
14044
14057
  # by a different account, the request will fail with an HTTP `403
14045
14058
  # (Access Denied)` error.
14046
14059
  # @return [String]
@@ -14245,7 +14258,7 @@ module Aws::S3
14245
14258
  # Bucket Key. By default, S3 Bucket Key is not enabled.
14246
14259
  #
14247
14260
  # For more information, see [Amazon S3 Bucket Keys][1] in the *Amazon
14248
- # Simple Storage Service User Guide*.
14261
+ # S3 User Guide*.
14249
14262
  #
14250
14263
  #
14251
14264
  #
@@ -14606,8 +14619,8 @@ module Aws::S3
14606
14619
  #
14607
14620
  # @!attribute [rw] events
14608
14621
  # The Amazon S3 bucket event about which to send notifications. For
14609
- # more information, see [Supported Event Types][1] in the *Amazon
14610
- # Simple Storage Service User Guide*.
14622
+ # more information, see [Supported Event Types][1] in the *Amazon S3
14623
+ # User Guide*.
14611
14624
  #
14612
14625
  #
14613
14626
  #
@@ -14617,7 +14630,7 @@ module Aws::S3
14617
14630
  # @!attribute [rw] filter
14618
14631
  # Specifies object key name filtering rules. For information about key
14619
14632
  # name filtering, see [Configuring Event Notifications][1] in the
14620
- # *Amazon Simple Storage Service Developer Guide*.
14633
+ # *Amazon S3 User Guide*.
14621
14634
  #
14622
14635
  #
14623
14636
  #
@@ -14686,8 +14699,8 @@ module Aws::S3
14686
14699
 
14687
14700
  # Specifies when an object transitions to a specified storage class. For
14688
14701
  # more information about Amazon S3 lifecycle configuration rules, see
14689
- # [Transitioning Objects Using Amazon S3 Lifecycle][1] in the *Amazon
14690
- # Simple Storage Service User Guide*.
14702
+ # [Transitioning Objects Using Amazon S3 Lifecycle][1] in the *Amazon S3
14703
+ # User Guide*.
14691
14704
  #
14692
14705
  #
14693
14706
  #
@@ -14821,7 +14834,7 @@ module Aws::S3
14821
14834
  # When using this action with an access point through the AWS SDKs,
14822
14835
  # you provide the access point ARN in place of the bucket name. For
14823
14836
  # more information about access point ARNs, see [Using Access
14824
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
14837
+ # Points][1] in the *Amazon S3 User Guide*.
14825
14838
  #
14826
14839
  # When using this action with Amazon S3 on Outposts, you must direct
14827
14840
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -14830,12 +14843,12 @@ module Aws::S3
14830
14843
  # When using this action using S3 on Outposts through the AWS SDKs,
14831
14844
  # you provide the Outposts bucket ARN in place of the bucket name. For
14832
14845
  # more information about S3 on Outposts ARNs, see [Using S3 on
14833
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
14846
+ # Outposts][2] in the *Amazon S3 User Guide*.
14834
14847
  #
14835
14848
  #
14836
14849
  #
14837
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
14838
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
14850
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
14851
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
14839
14852
  # @return [String]
14840
14853
  #
14841
14854
  # @!attribute [rw] copy_source
@@ -14882,7 +14895,7 @@ module Aws::S3
14882
14895
  #
14883
14896
  #
14884
14897
  #
14885
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
14898
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html
14886
14899
  # @return [String]
14887
14900
  #
14888
14901
  # @!attribute [rw] copy_source_if_match
@@ -14977,13 +14990,13 @@ module Aws::S3
14977
14990
  # @return [String]
14978
14991
  #
14979
14992
  # @!attribute [rw] expected_bucket_owner
14980
- # The account id of the expected destination bucket owner. If the
14993
+ # The account ID of the expected destination bucket owner. If the
14981
14994
  # destination bucket is owned by a different account, the request will
14982
14995
  # fail with an HTTP `403 (Access Denied)` error.
14983
14996
  # @return [String]
14984
14997
  #
14985
14998
  # @!attribute [rw] expected_source_bucket_owner
14986
- # The account id of the expected source bucket owner. If the source
14999
+ # The account ID of the expected source bucket owner. If the source
14987
15000
  # bucket is owned by a different account, the request will fail with
14988
15001
  # an HTTP `403 (Access Denied)` error.
14989
15002
  # @return [String]
@@ -15098,7 +15111,7 @@ module Aws::S3
15098
15111
  # When using this action with an access point through the AWS SDKs,
15099
15112
  # you provide the access point ARN in place of the bucket name. For
15100
15113
  # more information about access point ARNs, see [Using Access
15101
- # Points][1] in the *Amazon Simple Storage Service Developer Guide*.
15114
+ # Points][1] in the *Amazon S3 User Guide*.
15102
15115
  #
15103
15116
  # When using this action with Amazon S3 on Outposts, you must direct
15104
15117
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -15107,12 +15120,12 @@ module Aws::S3
15107
15120
  # When using this action using S3 on Outposts through the AWS SDKs,
15108
15121
  # you provide the Outposts bucket ARN in place of the bucket name. For
15109
15122
  # more information about S3 on Outposts ARNs, see [Using S3 on
15110
- # Outposts][2] in the *Amazon Simple Storage Service Developer Guide*.
15123
+ # Outposts][2] in the *Amazon S3 User Guide*.
15111
15124
  #
15112
15125
  #
15113
15126
  #
15114
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
15115
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
15127
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
15128
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
15116
15129
  # @return [String]
15117
15130
  #
15118
15131
  # @!attribute [rw] content_length
@@ -15174,7 +15187,7 @@ module Aws::S3
15174
15187
  # @return [String]
15175
15188
  #
15176
15189
  # @!attribute [rw] expected_bucket_owner
15177
- # The account id of the expected bucket owner. If the bucket is owned
15190
+ # The account ID of the expected bucket owner. If the bucket is owned
15178
15191
  # by a different account, the request will fail with an HTTP `403
15179
15192
  # (Access Denied)` error.
15180
15193
  # @return [String]
@@ -15298,6 +15311,317 @@ module Aws::S3
15298
15311
  include Aws::Structure
15299
15312
  end
15300
15313
 
15314
+ # @note When making an API call, you may pass WriteGetObjectResponseRequest
15315
+ # data as a hash:
15316
+ #
15317
+ # {
15318
+ # request_route: "RequestRoute", # required
15319
+ # request_token: "RequestToken", # required
15320
+ # body: source_file,
15321
+ # status_code: 1,
15322
+ # error_code: "ErrorCode",
15323
+ # error_message: "ErrorMessage",
15324
+ # accept_ranges: "AcceptRanges",
15325
+ # cache_control: "CacheControl",
15326
+ # content_disposition: "ContentDisposition",
15327
+ # content_encoding: "ContentEncoding",
15328
+ # content_language: "ContentLanguage",
15329
+ # content_length: 1,
15330
+ # content_range: "ContentRange",
15331
+ # content_type: "ContentType",
15332
+ # delete_marker: false,
15333
+ # etag: "ETag",
15334
+ # expires: Time.now,
15335
+ # expiration: "Expiration",
15336
+ # last_modified: Time.now,
15337
+ # missing_meta: 1,
15338
+ # metadata: {
15339
+ # "MetadataKey" => "MetadataValue",
15340
+ # },
15341
+ # object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
15342
+ # object_lock_legal_hold_status: "ON", # accepts ON, OFF
15343
+ # object_lock_retain_until_date: Time.now,
15344
+ # parts_count: 1,
15345
+ # replication_status: "COMPLETE", # accepts COMPLETE, PENDING, FAILED, REPLICA
15346
+ # request_charged: "requester", # accepts requester
15347
+ # restore: "Restore",
15348
+ # server_side_encryption: "AES256", # accepts AES256, aws:kms
15349
+ # sse_customer_algorithm: "SSECustomerAlgorithm",
15350
+ # ssekms_key_id: "SSEKMSKeyId",
15351
+ # sse_customer_key_md5: "SSECustomerKeyMD5",
15352
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
15353
+ # tag_count: 1,
15354
+ # version_id: "ObjectVersionId",
15355
+ # bucket_key_enabled: false,
15356
+ # }
15357
+ #
15358
+ # @!attribute [rw] request_route
15359
+ # Route prefix to the HTTP URL generated.
15360
+ # @return [String]
15361
+ #
15362
+ # @!attribute [rw] request_token
15363
+ # A single use encrypted token that maps `WriteGetObjectResponse` to
15364
+ # the end user `GetObject` request.
15365
+ # @return [String]
15366
+ #
15367
+ # @!attribute [rw] body
15368
+ # The object data.
15369
+ # @return [IO]
15370
+ #
15371
+ # @!attribute [rw] status_code
15372
+ # The integer status code for an HTTP response of a corresponding
15373
+ # `GetObject` request.
15374
+ #
15375
+ # **Status Codes**
15376
+ #
15377
+ # * *200 - OK*
15378
+ #
15379
+ # * *206 - Partial Content*
15380
+ #
15381
+ # * *304 - Not Modified*
15382
+ #
15383
+ # * *400 - Bad Request*
15384
+ #
15385
+ # * *401 - Unauthorized*
15386
+ #
15387
+ # * *403 - Forbidden*
15388
+ #
15389
+ # * *404 - Not Found*
15390
+ #
15391
+ # * *405 - Method Not Allowed*
15392
+ #
15393
+ # * *409 - Conflict*
15394
+ #
15395
+ # * *411 - Length Required*
15396
+ #
15397
+ # * *412 - Precondition Failed*
15398
+ #
15399
+ # * *416 - Range Not Satisfiable*
15400
+ #
15401
+ # * *500 - Internal Server Error*
15402
+ #
15403
+ # * *503 - Service Unavailable*
15404
+ # @return [Integer]
15405
+ #
15406
+ # @!attribute [rw] error_code
15407
+ # A string that uniquely identifies an error condition. Returned in
15408
+ # the &lt;Code&gt; tag of the error XML response for a corresponding
15409
+ # `GetObject` call. Cannot be used with a successful `StatusCode`
15410
+ # header or when the transformed object is provided in the body. All
15411
+ # error codes from S3 are sentence-cased. Regex value is
15412
+ # "^\[A-Z\]\[a-zA-Z\]+$".
15413
+ # @return [String]
15414
+ #
15415
+ # @!attribute [rw] error_message
15416
+ # Contains a generic description of the error condition. Returned in
15417
+ # the &lt;Message&gt; tag of the error XML response for a
15418
+ # corresponding `GetObject` call. Cannot be used with a successful
15419
+ # `StatusCode` header or when the transformed object is provided in
15420
+ # body.
15421
+ # @return [String]
15422
+ #
15423
+ # @!attribute [rw] accept_ranges
15424
+ # Indicates that a range of bytes was specified.
15425
+ # @return [String]
15426
+ #
15427
+ # @!attribute [rw] cache_control
15428
+ # Specifies caching behavior along the request/reply chain.
15429
+ # @return [String]
15430
+ #
15431
+ # @!attribute [rw] content_disposition
15432
+ # Specifies presentational information for the object.
15433
+ # @return [String]
15434
+ #
15435
+ # @!attribute [rw] content_encoding
15436
+ # Specifies what content encodings have been applied to the object and
15437
+ # thus what decoding mechanisms must be applied to obtain the
15438
+ # media-type referenced by the Content-Type header field.
15439
+ # @return [String]
15440
+ #
15441
+ # @!attribute [rw] content_language
15442
+ # The language the content is in.
15443
+ # @return [String]
15444
+ #
15445
+ # @!attribute [rw] content_length
15446
+ # The size of the content body in bytes.
15447
+ # @return [Integer]
15448
+ #
15449
+ # @!attribute [rw] content_range
15450
+ # The portion of the object returned in the response.
15451
+ # @return [String]
15452
+ #
15453
+ # @!attribute [rw] content_type
15454
+ # A standard MIME type describing the format of the object data.
15455
+ # @return [String]
15456
+ #
15457
+ # @!attribute [rw] delete_marker
15458
+ # Specifies whether an object stored in Amazon S3 is (`true`) or is
15459
+ # not (`false`) a delete marker.
15460
+ # @return [Boolean]
15461
+ #
15462
+ # @!attribute [rw] etag
15463
+ # An opaque identifier assigned by a web server to a specific version
15464
+ # of a resource found at a URL.
15465
+ # @return [String]
15466
+ #
15467
+ # @!attribute [rw] expires
15468
+ # The date and time at which the object is no longer cacheable.
15469
+ # @return [Time]
15470
+ #
15471
+ # @!attribute [rw] expiration
15472
+ # If object stored in Amazon S3 expiration is configured (see PUT
15473
+ # Bucket lifecycle) it includes expiry-date and rule-id key-value
15474
+ # pairs providing object expiration information. The value of the
15475
+ # rule-id is URL encoded.
15476
+ # @return [String]
15477
+ #
15478
+ # @!attribute [rw] last_modified
15479
+ # The date and time that the object was last modified.
15480
+ # @return [Time]
15481
+ #
15482
+ # @!attribute [rw] missing_meta
15483
+ # Set to the number of metadata entries not returned in `x-amz-meta`
15484
+ # headers. This can happen if you create metadata using an API like
15485
+ # SOAP that supports more flexible metadata than the REST API. For
15486
+ # example, using SOAP, you can create metadata whose values are not
15487
+ # legal HTTP headers.
15488
+ # @return [Integer]
15489
+ #
15490
+ # @!attribute [rw] metadata
15491
+ # A map of metadata to store with the object in S3.
15492
+ # @return [Hash<String,String>]
15493
+ #
15494
+ # @!attribute [rw] object_lock_mode
15495
+ # Indicates whether an object stored in Amazon S3 has Object Lock
15496
+ # enabled. For more information about S3 Object Lock, see [Object
15497
+ # Lock][1].
15498
+ #
15499
+ #
15500
+ #
15501
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
15502
+ # @return [String]
15503
+ #
15504
+ # @!attribute [rw] object_lock_legal_hold_status
15505
+ # Indicates whether an object stored in Amazon S3 has an active legal
15506
+ # hold.
15507
+ # @return [String]
15508
+ #
15509
+ # @!attribute [rw] object_lock_retain_until_date
15510
+ # The date and time when Object Lock is configured to expire.
15511
+ # @return [Time]
15512
+ #
15513
+ # @!attribute [rw] parts_count
15514
+ # The count of parts this object has.
15515
+ # @return [Integer]
15516
+ #
15517
+ # @!attribute [rw] replication_status
15518
+ # Indicates if request involves bucket that is either a source or
15519
+ # destination in a Replication rule. For more information about S3
15520
+ # Replication, see [Replication][1].
15521
+ #
15522
+ #
15523
+ #
15524
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication.html
15525
+ # @return [String]
15526
+ #
15527
+ # @!attribute [rw] request_charged
15528
+ # If present, indicates that the requester was successfully charged
15529
+ # for the request.
15530
+ # @return [String]
15531
+ #
15532
+ # @!attribute [rw] restore
15533
+ # Provides information about object restoration operation and
15534
+ # expiration time of the restored object copy.
15535
+ # @return [String]
15536
+ #
15537
+ # @!attribute [rw] server_side_encryption
15538
+ # The server-side encryption algorithm used when storing requested
15539
+ # object in Amazon S3 (for example, AES256, aws:kms).
15540
+ # @return [String]
15541
+ #
15542
+ # @!attribute [rw] sse_customer_algorithm
15543
+ # Encryption algorithm used if server-side encryption with a
15544
+ # customer-provided encryption key was specified for object stored in
15545
+ # Amazon S3.
15546
+ # @return [String]
15547
+ #
15548
+ # @!attribute [rw] ssekms_key_id
15549
+ # If present, specifies the ID of the AWS Key Management Service (AWS
15550
+ # KMS) symmetric customer managed customer master key (CMK) that was
15551
+ # used for stored in Amazon S3 object.
15552
+ # @return [String]
15553
+ #
15554
+ # @!attribute [rw] sse_customer_key_md5
15555
+ # 128-bit MD5 digest of customer-provided encryption key used in
15556
+ # Amazon S3 to encrypt data stored in S3. For more information, see
15557
+ # [Protecting data using server-side encryption with customer-provided
15558
+ # encryption keys (SSE-C)][1].
15559
+ #
15560
+ #
15561
+ #
15562
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
15563
+ # @return [String]
15564
+ #
15565
+ # @!attribute [rw] storage_class
15566
+ # The class of storage used to store object in Amazon S3.
15567
+ # @return [String]
15568
+ #
15569
+ # @!attribute [rw] tag_count
15570
+ # The number of tags, if any, on the object.
15571
+ # @return [Integer]
15572
+ #
15573
+ # @!attribute [rw] version_id
15574
+ # An ID used to reference a specific version of the object.
15575
+ # @return [String]
15576
+ #
15577
+ # @!attribute [rw] bucket_key_enabled
15578
+ # Indicates whether the object stored in Amazon S3 uses an S3 bucket
15579
+ # key for server-side encryption with AWS KMS (SSE-KMS).
15580
+ # @return [Boolean]
15581
+ #
15582
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/WriteGetObjectResponseRequest AWS API Documentation
15583
+ #
15584
+ class WriteGetObjectResponseRequest < Struct.new(
15585
+ :request_route,
15586
+ :request_token,
15587
+ :body,
15588
+ :status_code,
15589
+ :error_code,
15590
+ :error_message,
15591
+ :accept_ranges,
15592
+ :cache_control,
15593
+ :content_disposition,
15594
+ :content_encoding,
15595
+ :content_language,
15596
+ :content_length,
15597
+ :content_range,
15598
+ :content_type,
15599
+ :delete_marker,
15600
+ :etag,
15601
+ :expires,
15602
+ :expiration,
15603
+ :last_modified,
15604
+ :missing_meta,
15605
+ :metadata,
15606
+ :object_lock_mode,
15607
+ :object_lock_legal_hold_status,
15608
+ :object_lock_retain_until_date,
15609
+ :parts_count,
15610
+ :replication_status,
15611
+ :request_charged,
15612
+ :restore,
15613
+ :server_side_encryption,
15614
+ :sse_customer_algorithm,
15615
+ :ssekms_key_id,
15616
+ :sse_customer_key_md5,
15617
+ :storage_class,
15618
+ :tag_count,
15619
+ :version_id,
15620
+ :bucket_key_enabled)
15621
+ SENSITIVE = [:ssekms_key_id]
15622
+ include Aws::Structure
15623
+ end
15624
+
15301
15625
  # The container for selecting objects from a content event stream.
15302
15626
  #
15303
15627
  # EventStream is an Enumerator of Events.