aws-sdk-s3 1.61.2 → 1.83.1
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +5 -5
- data/lib/aws-sdk-s3.rb +5 -2
- data/lib/aws-sdk-s3/arn/access_point_arn.rb +62 -0
- data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +71 -0
- data/lib/aws-sdk-s3/bucket.rb +61 -10
- data/lib/aws-sdk-s3/bucket_acl.rb +7 -0
- data/lib/aws-sdk-s3/bucket_cors.rb +15 -2
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +14 -1
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +14 -1
- data/lib/aws-sdk-s3/bucket_logging.rb +7 -0
- data/lib/aws-sdk-s3/bucket_notification.rb +7 -0
- data/lib/aws-sdk-s3/bucket_policy.rb +14 -1
- data/lib/aws-sdk-s3/bucket_region_cache.rb +2 -0
- data/lib/aws-sdk-s3/bucket_request_payment.rb +7 -0
- data/lib/aws-sdk-s3/bucket_tagging.rb +14 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +17 -0
- data/lib/aws-sdk-s3/bucket_website.rb +18 -3
- data/lib/aws-sdk-s3/client.rb +2521 -1187
- data/lib/aws-sdk-s3/client_api.rb +188 -18
- data/lib/aws-sdk-s3/customizations.rb +3 -0
- data/lib/aws-sdk-s3/customizations/bucket.rb +11 -4
- data/lib/aws-sdk-s3/customizations/multipart_upload.rb +2 -0
- data/lib/aws-sdk-s3/customizations/object.rb +23 -5
- data/lib/aws-sdk-s3/customizations/object_summary.rb +5 -0
- data/lib/aws-sdk-s3/customizations/types/list_object_versions_output.rb +2 -0
- data/lib/aws-sdk-s3/encryption.rb +4 -0
- data/lib/aws-sdk-s3/encryption/client.rb +18 -5
- data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +72 -26
- data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +43 -5
- data/lib/aws-sdk-s3/encryption/default_key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +13 -2
- data/lib/aws-sdk-s3/encryption/errors.rb +2 -0
- data/lib/aws-sdk-s3/encryption/io_auth_decrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryption/io_decrypter.rb +11 -3
- data/lib/aws-sdk-s3/encryption/io_encrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryption/key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +34 -3
- data/lib/aws-sdk-s3/encryption/materials.rb +8 -6
- data/lib/aws-sdk-s3/encryption/utils.rb +25 -0
- data/lib/aws-sdk-s3/encryptionV2/client.rb +566 -0
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +226 -0
- data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +170 -0
- data/lib/aws-sdk-s3/encryptionV2/default_key_provider.rb +40 -0
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +69 -0
- data/lib/aws-sdk-s3/encryptionV2/errors.rb +37 -0
- data/lib/aws-sdk-s3/encryptionV2/io_auth_decrypter.rb +58 -0
- data/lib/aws-sdk-s3/encryptionV2/io_decrypter.rb +37 -0
- data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +73 -0
- data/lib/aws-sdk-s3/encryptionV2/key_provider.rb +31 -0
- data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +169 -0
- data/lib/aws-sdk-s3/encryptionV2/materials.rb +60 -0
- data/lib/aws-sdk-s3/encryptionV2/utils.rb +103 -0
- data/lib/aws-sdk-s3/encryption_v2.rb +23 -0
- data/lib/aws-sdk-s3/errors.rb +2 -0
- data/lib/aws-sdk-s3/event_streams.rb +7 -0
- data/lib/aws-sdk-s3/file_downloader.rb +10 -8
- data/lib/aws-sdk-s3/file_part.rb +2 -0
- data/lib/aws-sdk-s3/file_uploader.rb +14 -1
- data/lib/aws-sdk-s3/legacy_signer.rb +2 -0
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +39 -2
- data/lib/aws-sdk-s3/multipart_stream_uploader.rb +3 -1
- data/lib/aws-sdk-s3/multipart_upload.rb +18 -1
- data/lib/aws-sdk-s3/multipart_upload_error.rb +2 -0
- data/lib/aws-sdk-s3/multipart_upload_part.rb +66 -7
- data/lib/aws-sdk-s3/object.rb +174 -23
- data/lib/aws-sdk-s3/object_acl.rb +15 -0
- data/lib/aws-sdk-s3/object_copier.rb +2 -0
- data/lib/aws-sdk-s3/object_multipart_copier.rb +2 -0
- data/lib/aws-sdk-s3/object_summary.rb +185 -20
- data/lib/aws-sdk-s3/object_version.rb +44 -4
- data/lib/aws-sdk-s3/plugins/accelerate.rb +29 -38
- data/lib/aws-sdk-s3/plugins/arn.rb +187 -0
- data/lib/aws-sdk-s3/plugins/bucket_dns.rb +2 -2
- data/lib/aws-sdk-s3/plugins/bucket_name_restrictions.rb +3 -1
- data/lib/aws-sdk-s3/plugins/dualstack.rb +5 -1
- data/lib/aws-sdk-s3/plugins/expect_100_continue.rb +3 -4
- data/lib/aws-sdk-s3/plugins/get_bucket_location_fix.rb +2 -0
- data/lib/aws-sdk-s3/plugins/http_200_errors.rb +11 -3
- data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +3 -1
- data/lib/aws-sdk-s3/plugins/location_constraint.rb +2 -0
- data/lib/aws-sdk-s3/plugins/md5s.rb +26 -25
- data/lib/aws-sdk-s3/plugins/redirects.rb +2 -0
- data/lib/aws-sdk-s3/plugins/s3_host_id.rb +2 -0
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +31 -7
- data/lib/aws-sdk-s3/plugins/sse_cpk.rb +3 -1
- data/lib/aws-sdk-s3/plugins/streaming_retry.rb +118 -0
- data/lib/aws-sdk-s3/plugins/url_encoded_keys.rb +2 -0
- data/lib/aws-sdk-s3/presigned_post.rb +68 -32
- data/lib/aws-sdk-s3/presigner.rb +102 -34
- data/lib/aws-sdk-s3/resource.rb +4 -2
- data/lib/aws-sdk-s3/types.rb +2016 -256
- data/lib/aws-sdk-s3/waiters.rb +2 -0
- metadata +23 -6
- data/lib/aws-sdk-s3/plugins/bucket_arn.rb +0 -211
@@ -1,3 +1,5 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
# WARNING ABOUT GENERATED CODE
|
2
4
|
#
|
3
5
|
# This file is generated. See the contributing guide for more information:
|
@@ -226,6 +228,7 @@ module Aws::S3
|
|
226
228
|
# grant_write_acp: "GrantWriteACP",
|
227
229
|
# request_payer: "requester", # accepts requester
|
228
230
|
# version_id: "ObjectVersionId",
|
231
|
+
# expected_bucket_owner: "AccountId",
|
229
232
|
# })
|
230
233
|
# @param [Hash] options ({})
|
231
234
|
# @option options [String] :acl
|
@@ -250,15 +253,23 @@ module Aws::S3
|
|
250
253
|
# @option options [String] :grant_full_control
|
251
254
|
# Allows grantee the read, write, read ACP, and write ACP permissions on
|
252
255
|
# the bucket.
|
256
|
+
#
|
257
|
+
# This action is not supported by Amazon S3 on Outposts.
|
253
258
|
# @option options [String] :grant_read
|
254
259
|
# Allows grantee to list the objects in the bucket.
|
260
|
+
#
|
261
|
+
# This action is not supported by Amazon S3 on Outposts.
|
255
262
|
# @option options [String] :grant_read_acp
|
256
263
|
# Allows grantee to read the bucket ACL.
|
264
|
+
#
|
265
|
+
# This action is not supported by Amazon S3 on Outposts.
|
257
266
|
# @option options [String] :grant_write
|
258
267
|
# Allows grantee to create, overwrite, and delete any object in the
|
259
268
|
# bucket.
|
260
269
|
# @option options [String] :grant_write_acp
|
261
270
|
# Allows grantee to write the ACL for the applicable bucket.
|
271
|
+
#
|
272
|
+
# This action is not supported by Amazon S3 on Outposts.
|
262
273
|
# @option options [String] :request_payer
|
263
274
|
# Confirms that the requester knows that they will be charged for the
|
264
275
|
# request. Bucket owners need not specify this parameter in their
|
@@ -271,6 +282,10 @@ module Aws::S3
|
|
271
282
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
272
283
|
# @option options [String] :version_id
|
273
284
|
# VersionId used to reference a specific version of the object.
|
285
|
+
# @option options [String] :expected_bucket_owner
|
286
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
287
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
288
|
+
# Denied)` error.
|
274
289
|
# @return [Types::PutObjectAclOutput]
|
275
290
|
def put(options = {})
|
276
291
|
options = options.merge(
|
@@ -1,3 +1,5 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
# WARNING ABOUT GENERATED CODE
|
2
4
|
#
|
3
5
|
# This file is generated. See the contributing guide for more information:
|
@@ -46,8 +48,24 @@ module Aws::S3
|
|
46
48
|
data[:last_modified]
|
47
49
|
end
|
48
50
|
|
49
|
-
# The entity tag is
|
50
|
-
#
|
51
|
+
# The entity tag is a hash of the object. The ETag reflects changes only
|
52
|
+
# to the contents of an object, not its metadata. The ETag may or may
|
53
|
+
# not be an MD5 digest of the object data. Whether or not it is depends
|
54
|
+
# on how the object was created and how it is encrypted as described
|
55
|
+
# below:
|
56
|
+
#
|
57
|
+
# * Objects created by the PUT Object, POST Object, or Copy operation,
|
58
|
+
# or through the AWS Management Console, and are encrypted by SSE-S3
|
59
|
+
# or plaintext, have ETags that are an MD5 digest of their object
|
60
|
+
# data.
|
61
|
+
#
|
62
|
+
# * Objects created by the PUT Object, POST Object, or Copy operation,
|
63
|
+
# or through the AWS Management Console, and are encrypted by SSE-C or
|
64
|
+
# SSE-KMS, have ETags that are not an MD5 digest of their object data.
|
65
|
+
#
|
66
|
+
# * If an object is created by either the Multipart Upload or Part Copy
|
67
|
+
# operation, the ETag is not an MD5 digest, regardless of the method
|
68
|
+
# of encryption.
|
51
69
|
# @return [String]
|
52
70
|
def etag
|
53
71
|
data[:etag]
|
@@ -277,7 +295,7 @@ module Aws::S3
|
|
277
295
|
# metadata_directive: "COPY", # accepts COPY, REPLACE
|
278
296
|
# tagging_directive: "COPY", # accepts COPY, REPLACE
|
279
297
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
280
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
|
298
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
281
299
|
# website_redirect_location: "WebsiteRedirectLocation",
|
282
300
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
283
301
|
# sse_customer_key: "SSECustomerKey",
|
@@ -292,10 +310,14 @@ module Aws::S3
|
|
292
310
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
293
311
|
# object_lock_retain_until_date: Time.now,
|
294
312
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
313
|
+
# expected_bucket_owner: "AccountId",
|
314
|
+
# expected_source_bucket_owner: "AccountId",
|
295
315
|
# })
|
296
316
|
# @param [Hash] options ({})
|
297
317
|
# @option options [String] :acl
|
298
318
|
# The canned ACL to apply to the object.
|
319
|
+
#
|
320
|
+
# This action is not supported by Amazon S3 on Outposts.
|
299
321
|
# @option options [String] :cache_control
|
300
322
|
# Specifies caching behavior along the request/reply chain.
|
301
323
|
# @option options [String] :content_disposition
|
@@ -309,8 +331,50 @@ module Aws::S3
|
|
309
331
|
# @option options [String] :content_type
|
310
332
|
# A standard MIME type describing the format of the object data.
|
311
333
|
# @option options [required, String] :copy_source
|
312
|
-
#
|
313
|
-
#
|
334
|
+
# Specifies the source object for the copy operation. You specify the
|
335
|
+
# value in one of two formats, depending on whether you want to access
|
336
|
+
# the source object through an [access point][1]\:
|
337
|
+
#
|
338
|
+
# * For objects not accessed through an access point, specify the name
|
339
|
+
# of the source bucket and the key of the source object, separated by
|
340
|
+
# a slash (/). For example, to copy the object `reports/january.pdf`
|
341
|
+
# from the bucket `awsexamplebucket`, use
|
342
|
+
# `awsexamplebucket/reports/january.pdf`. The value must be URL
|
343
|
+
# encoded.
|
344
|
+
#
|
345
|
+
# * For objects accessed through access points, specify the Amazon
|
346
|
+
# Resource Name (ARN) of the object as accessed through the access
|
347
|
+
# point, in the format
|
348
|
+
# `arn:aws:s3:<Region>:<account-id>:accesspoint/<access-point-name>/object/<key>`.
|
349
|
+
# For example, to copy the object `reports/january.pdf` through access
|
350
|
+
# point `my-access-point` owned by account `123456789012` in Region
|
351
|
+
# `us-west-2`, use the URL encoding of
|
352
|
+
# `arn:aws:s3:us-west-2:123456789012:accesspoint/my-access-point/object/reports/january.pdf`.
|
353
|
+
# The value must be URL encoded.
|
354
|
+
#
|
355
|
+
# <note markdown="1"> Amazon S3 supports copy operations using access points only when the
|
356
|
+
# source and destination buckets are in the same AWS Region.
|
357
|
+
#
|
358
|
+
# </note>
|
359
|
+
#
|
360
|
+
# Alternatively, for objects accessed through Amazon S3 on Outposts,
|
361
|
+
# specify the ARN of the object as accessed in the format
|
362
|
+
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/object/<key>`.
|
363
|
+
# For example, to copy the object `reports/january.pdf` through
|
364
|
+
# outpost `my-outpost` owned by account `123456789012` in Region
|
365
|
+
# `us-west-2`, use the URL encoding of
|
366
|
+
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/object/reports/january.pdf`.
|
367
|
+
# The value must be URL encoded.
|
368
|
+
#
|
369
|
+
# To copy a specific version of an object, append
|
370
|
+
# `?versionId=<version-id>` to the value (for example,
|
371
|
+
# `awsexamplebucket/reports/january.pdf?versionId=QUpfdndhfd8438MNFDN93jdnJFkdmqnh893`).
|
372
|
+
# If you don't specify a version ID, Amazon S3 copies the latest
|
373
|
+
# version of the source object.
|
374
|
+
#
|
375
|
+
#
|
376
|
+
#
|
377
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
|
314
378
|
# @option options [String] :copy_source_if_match
|
315
379
|
# Copies the object if its entity tag (ETag) matches the specified tag.
|
316
380
|
# @option options [Time,DateTime,Date,Integer,String] :copy_source_if_modified_since
|
@@ -326,12 +390,20 @@ module Aws::S3
|
|
326
390
|
# @option options [String] :grant_full_control
|
327
391
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
328
392
|
# object.
|
393
|
+
#
|
394
|
+
# This action is not supported by Amazon S3 on Outposts.
|
329
395
|
# @option options [String] :grant_read
|
330
396
|
# Allows grantee to read the object data and its metadata.
|
397
|
+
#
|
398
|
+
# This action is not supported by Amazon S3 on Outposts.
|
331
399
|
# @option options [String] :grant_read_acp
|
332
400
|
# Allows grantee to read the object ACL.
|
401
|
+
#
|
402
|
+
# This action is not supported by Amazon S3 on Outposts.
|
333
403
|
# @option options [String] :grant_write_acp
|
334
404
|
# Allows grantee to write the ACL for the applicable object.
|
405
|
+
#
|
406
|
+
# This action is not supported by Amazon S3 on Outposts.
|
335
407
|
# @option options [Hash<String,String>] :metadata
|
336
408
|
# A map of metadata to store with the object in S3.
|
337
409
|
# @option options [String] :metadata_directive
|
@@ -344,7 +416,16 @@ module Aws::S3
|
|
344
416
|
# The server-side encryption algorithm used when storing this object in
|
345
417
|
# Amazon S3 (for example, AES256, aws:kms).
|
346
418
|
# @option options [String] :storage_class
|
347
|
-
#
|
419
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
420
|
+
# created objects. The STANDARD storage class provides high durability
|
421
|
+
# and high availability. Depending on performance needs, you can specify
|
422
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
423
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
424
|
+
# in the *Amazon S3 Service Developer Guide*.
|
425
|
+
#
|
426
|
+
#
|
427
|
+
#
|
428
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
348
429
|
# @option options [String] :website_redirect_location
|
349
430
|
# If the bucket is configured as a website, redirects requests for this
|
350
431
|
# object to another object in the same bucket or to an external URL.
|
@@ -357,7 +438,7 @@ module Aws::S3
|
|
357
438
|
# encrypting data. This value is used to store the object and then it is
|
358
439
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
359
440
|
# be appropriate for use with the algorithm specified in the
|
360
|
-
# `x-amz-server-side
|
441
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
361
442
|
# @option options [String] :sse_customer_key_md5
|
362
443
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
363
444
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
@@ -409,6 +490,14 @@ module Aws::S3
|
|
409
490
|
# expire.
|
410
491
|
# @option options [String] :object_lock_legal_hold_status
|
411
492
|
# Specifies whether you want to apply a Legal Hold to the copied object.
|
493
|
+
# @option options [String] :expected_bucket_owner
|
494
|
+
# The account id of the expected destination bucket owner. If the
|
495
|
+
# destination bucket is owned by a different account, the request will
|
496
|
+
# fail with an HTTP `403 (Access Denied)` error.
|
497
|
+
# @option options [String] :expected_source_bucket_owner
|
498
|
+
# The account id of the expected source bucket owner. If the source
|
499
|
+
# bucket is owned by a different account, the request will fail with an
|
500
|
+
# HTTP `403 (Access Denied)` error.
|
412
501
|
# @return [Types::CopyObjectOutput]
|
413
502
|
def copy_from(options = {})
|
414
503
|
options = options.merge(
|
@@ -426,6 +515,7 @@ module Aws::S3
|
|
426
515
|
# version_id: "ObjectVersionId",
|
427
516
|
# request_payer: "requester", # accepts requester
|
428
517
|
# bypass_governance_retention: false,
|
518
|
+
# expected_bucket_owner: "AccountId",
|
429
519
|
# })
|
430
520
|
# @param [Hash] options ({})
|
431
521
|
# @option options [String] :mfa
|
@@ -448,6 +538,10 @@ module Aws::S3
|
|
448
538
|
# @option options [Boolean] :bypass_governance_retention
|
449
539
|
# Indicates whether S3 Object Lock should bypass Governance-mode
|
450
540
|
# restrictions to process this operation.
|
541
|
+
# @option options [String] :expected_bucket_owner
|
542
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
543
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
544
|
+
# Denied)` error.
|
451
545
|
# @return [Types::DeleteObjectOutput]
|
452
546
|
def delete(options = {})
|
453
547
|
options = options.merge(
|
@@ -478,6 +572,7 @@ module Aws::S3
|
|
478
572
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
479
573
|
# request_payer: "requester", # accepts requester
|
480
574
|
# part_number: 1,
|
575
|
+
# expected_bucket_owner: "AccountId",
|
481
576
|
# })
|
482
577
|
# @param [Hash] options ({})
|
483
578
|
# @option options [String] :if_match
|
@@ -495,7 +590,16 @@ module Aws::S3
|
|
495
590
|
# @option options [String] :range
|
496
591
|
# Downloads the specified range bytes of an object. For more information
|
497
592
|
# about the HTTP Range header, see
|
498
|
-
# [
|
593
|
+
# [https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
|
594
|
+
#
|
595
|
+
# <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
|
596
|
+
# `GET` request.
|
597
|
+
#
|
598
|
+
# </note>
|
599
|
+
#
|
600
|
+
#
|
601
|
+
#
|
602
|
+
# [1]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
|
499
603
|
# @option options [String] :response_cache_control
|
500
604
|
# Sets the `Cache-Control` header of the response.
|
501
605
|
# @option options [String] :response_content_disposition
|
@@ -518,7 +622,7 @@ module Aws::S3
|
|
518
622
|
# encrypting data. This value is used to store the object and then it is
|
519
623
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
520
624
|
# be appropriate for use with the algorithm specified in the
|
521
|
-
# `x-amz-server-side
|
625
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
522
626
|
# @option options [String] :sse_customer_key_md5
|
523
627
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
524
628
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
@@ -538,6 +642,10 @@ module Aws::S3
|
|
538
642
|
# between 1 and 10,000. Effectively performs a 'ranged' GET request
|
539
643
|
# for the part specified. Useful for downloading just a part of an
|
540
644
|
# object.
|
645
|
+
# @option options [String] :expected_bucket_owner
|
646
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
647
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
648
|
+
# Denied)` error.
|
541
649
|
# @return [Types::GetObjectOutput]
|
542
650
|
def get(options = {}, &block)
|
543
651
|
options = options.merge(
|
@@ -566,7 +674,7 @@ module Aws::S3
|
|
566
674
|
# "MetadataKey" => "MetadataValue",
|
567
675
|
# },
|
568
676
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
569
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
|
677
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
570
678
|
# website_redirect_location: "WebsiteRedirectLocation",
|
571
679
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
572
680
|
# sse_customer_key: "SSECustomerKey",
|
@@ -578,10 +686,13 @@ module Aws::S3
|
|
578
686
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
579
687
|
# object_lock_retain_until_date: Time.now,
|
580
688
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
689
|
+
# expected_bucket_owner: "AccountId",
|
581
690
|
# })
|
582
691
|
# @param [Hash] options ({})
|
583
692
|
# @option options [String] :acl
|
584
693
|
# The canned ACL to apply to the object.
|
694
|
+
#
|
695
|
+
# This action is not supported by Amazon S3 on Outposts.
|
585
696
|
# @option options [String] :cache_control
|
586
697
|
# Specifies caching behavior along the request/reply chain.
|
587
698
|
# @option options [String] :content_disposition
|
@@ -599,19 +710,36 @@ module Aws::S3
|
|
599
710
|
# @option options [String] :grant_full_control
|
600
711
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
601
712
|
# object.
|
713
|
+
#
|
714
|
+
# This action is not supported by Amazon S3 on Outposts.
|
602
715
|
# @option options [String] :grant_read
|
603
716
|
# Allows grantee to read the object data and its metadata.
|
717
|
+
#
|
718
|
+
# This action is not supported by Amazon S3 on Outposts.
|
604
719
|
# @option options [String] :grant_read_acp
|
605
720
|
# Allows grantee to read the object ACL.
|
721
|
+
#
|
722
|
+
# This action is not supported by Amazon S3 on Outposts.
|
606
723
|
# @option options [String] :grant_write_acp
|
607
724
|
# Allows grantee to write the ACL for the applicable object.
|
725
|
+
#
|
726
|
+
# This action is not supported by Amazon S3 on Outposts.
|
608
727
|
# @option options [Hash<String,String>] :metadata
|
609
728
|
# A map of metadata to store with the object in S3.
|
610
729
|
# @option options [String] :server_side_encryption
|
611
730
|
# The server-side encryption algorithm used when storing this object in
|
612
731
|
# Amazon S3 (for example, AES256, aws:kms).
|
613
732
|
# @option options [String] :storage_class
|
614
|
-
#
|
733
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
734
|
+
# created objects. The STANDARD storage class provides high durability
|
735
|
+
# and high availability. Depending on performance needs, you can specify
|
736
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
737
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
738
|
+
# in the *Amazon S3 Service Developer Guide*.
|
739
|
+
#
|
740
|
+
#
|
741
|
+
#
|
742
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
615
743
|
# @option options [String] :website_redirect_location
|
616
744
|
# If the bucket is configured as a website, redirects requests for this
|
617
745
|
# object to another object in the same bucket or to an external URL.
|
@@ -624,7 +752,7 @@ module Aws::S3
|
|
624
752
|
# encrypting data. This value is used to store the object and then it is
|
625
753
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
626
754
|
# be appropriate for use with the algorithm specified in the
|
627
|
-
# `x-amz-server-side
|
755
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
628
756
|
# @option options [String] :sse_customer_key_md5
|
629
757
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
630
758
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
@@ -665,6 +793,10 @@ module Aws::S3
|
|
665
793
|
# @option options [String] :object_lock_legal_hold_status
|
666
794
|
# Specifies whether you want to apply a Legal Hold to the uploaded
|
667
795
|
# object.
|
796
|
+
# @option options [String] :expected_bucket_owner
|
797
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
798
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
799
|
+
# Denied)` error.
|
668
800
|
# @return [MultipartUpload]
|
669
801
|
def initiate_multipart_upload(options = {})
|
670
802
|
options = options.merge(
|
@@ -701,7 +833,7 @@ module Aws::S3
|
|
701
833
|
# "MetadataKey" => "MetadataValue",
|
702
834
|
# },
|
703
835
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
704
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
|
836
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
705
837
|
# website_redirect_location: "WebsiteRedirectLocation",
|
706
838
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
707
839
|
# sse_customer_key: "SSECustomerKey",
|
@@ -713,16 +845,19 @@ module Aws::S3
|
|
713
845
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
714
846
|
# object_lock_retain_until_date: Time.now,
|
715
847
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
848
|
+
# expected_bucket_owner: "AccountId",
|
716
849
|
# })
|
717
850
|
# @param [Hash] options ({})
|
718
851
|
# @option options [String] :acl
|
719
852
|
# The canned ACL to apply to the object. For more information, see
|
720
853
|
# [Canned ACL][1].
|
721
854
|
#
|
855
|
+
# This action is not supported by Amazon S3 on Outposts.
|
856
|
+
#
|
722
857
|
#
|
723
858
|
#
|
724
859
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
725
|
-
# @option options [String,
|
860
|
+
# @option options [String, StringIO, File] :body
|
726
861
|
# Object data.
|
727
862
|
# @option options [String] :cache_control
|
728
863
|
# Can be used to specify caching behavior along the request/reply chain.
|
@@ -790,20 +925,36 @@ module Aws::S3
|
|
790
925
|
# @option options [String] :grant_full_control
|
791
926
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
792
927
|
# object.
|
928
|
+
#
|
929
|
+
# This action is not supported by Amazon S3 on Outposts.
|
793
930
|
# @option options [String] :grant_read
|
794
931
|
# Allows grantee to read the object data and its metadata.
|
932
|
+
#
|
933
|
+
# This action is not supported by Amazon S3 on Outposts.
|
795
934
|
# @option options [String] :grant_read_acp
|
796
935
|
# Allows grantee to read the object ACL.
|
936
|
+
#
|
937
|
+
# This action is not supported by Amazon S3 on Outposts.
|
797
938
|
# @option options [String] :grant_write_acp
|
798
939
|
# Allows grantee to write the ACL for the applicable object.
|
940
|
+
#
|
941
|
+
# This action is not supported by Amazon S3 on Outposts.
|
799
942
|
# @option options [Hash<String,String>] :metadata
|
800
943
|
# A map of metadata to store with the object in S3.
|
801
944
|
# @option options [String] :server_side_encryption
|
802
945
|
# The server-side encryption algorithm used when storing this object in
|
803
946
|
# Amazon S3 (for example, AES256, aws:kms).
|
804
947
|
# @option options [String] :storage_class
|
805
|
-
#
|
806
|
-
#
|
948
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
949
|
+
# created objects. The STANDARD storage class provides high durability
|
950
|
+
# and high availability. Depending on performance needs, you can specify
|
951
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
952
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
953
|
+
# in the *Amazon S3 Service Developer Guide*.
|
954
|
+
#
|
955
|
+
#
|
956
|
+
#
|
957
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
807
958
|
# @option options [String] :website_redirect_location
|
808
959
|
# If the bucket is configured as a website, redirects requests for this
|
809
960
|
# object to another object in the same bucket or to an external URL.
|
@@ -837,7 +988,7 @@ module Aws::S3
|
|
837
988
|
# encrypting data. This value is used to store the object and then it is
|
838
989
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
839
990
|
# be appropriate for use with the algorithm specified in the
|
840
|
-
# `x-amz-server-side
|
991
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
841
992
|
# @option options [String] :sse_customer_key_md5
|
842
993
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
843
994
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
@@ -882,6 +1033,10 @@ module Aws::S3
|
|
882
1033
|
#
|
883
1034
|
#
|
884
1035
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
1036
|
+
# @option options [String] :expected_bucket_owner
|
1037
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
1038
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
1039
|
+
# Denied)` error.
|
885
1040
|
# @return [Types::PutObjectOutput]
|
886
1041
|
def put(options = {})
|
887
1042
|
options = options.merge(
|
@@ -973,11 +1128,12 @@ module Aws::S3
|
|
973
1128
|
# value: "MetadataValue",
|
974
1129
|
# },
|
975
1130
|
# ],
|
976
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
|
1131
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
977
1132
|
# },
|
978
1133
|
# },
|
979
1134
|
# },
|
980
1135
|
# request_payer: "requester", # accepts requester
|
1136
|
+
# expected_bucket_owner: "AccountId",
|
981
1137
|
# })
|
982
1138
|
# @param [Hash] options ({})
|
983
1139
|
# @option options [String] :version_id
|
@@ -994,6 +1150,10 @@ module Aws::S3
|
|
994
1150
|
#
|
995
1151
|
#
|
996
1152
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
1153
|
+
# @option options [String] :expected_bucket_owner
|
1154
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
1155
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
1156
|
+
# Denied)` error.
|
997
1157
|
# @return [Types::RestoreObjectOutput]
|
998
1158
|
def restore_object(options = {})
|
999
1159
|
options = options.merge(
|
@@ -1090,8 +1250,8 @@ module Aws::S3
|
|
1090
1250
|
|
1091
1251
|
def yield_waiter_and_warn(waiter, &block)
|
1092
1252
|
if !@waiter_block_warned
|
1093
|
-
msg = "pass options to configure the waiter; "
|
1094
|
-
|
1253
|
+
msg = "pass options to configure the waiter; "\
|
1254
|
+
"yielding the waiter is deprecated"
|
1095
1255
|
warn(msg)
|
1096
1256
|
@waiter_block_warned = true
|
1097
1257
|
end
|
@@ -1125,6 +1285,7 @@ module Aws::S3
|
|
1125
1285
|
# mfa: "MFA",
|
1126
1286
|
# request_payer: "requester", # accepts requester
|
1127
1287
|
# bypass_governance_retention: false,
|
1288
|
+
# expected_bucket_owner: "AccountId",
|
1128
1289
|
# })
|
1129
1290
|
# @param options ({})
|
1130
1291
|
# @option options [String] :mfa
|
@@ -1146,6 +1307,10 @@ module Aws::S3
|
|
1146
1307
|
# Specifies whether you want to delete this object even if it has a
|
1147
1308
|
# Governance-type Object Lock in place. You must have sufficient
|
1148
1309
|
# permissions to perform this operation.
|
1310
|
+
# @option options [String] :expected_bucket_owner
|
1311
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
1312
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
1313
|
+
# Denied)` error.
|
1149
1314
|
# @return [void]
|
1150
1315
|
def batch_delete!(options = {})
|
1151
1316
|
batch_enum.each do |batch|
|