aws-sdk-s3 1.59.1 → 1.60.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/aws-sdk-s3.rb +1 -1
- data/lib/aws-sdk-s3/bucket.rb +17 -16
- data/lib/aws-sdk-s3/client.rb +168 -148
- data/lib/aws-sdk-s3/multipart_upload.rb +15 -15
- data/lib/aws-sdk-s3/multipart_upload_part.rb +10 -10
- data/lib/aws-sdk-s3/object.rb +51 -49
- data/lib/aws-sdk-s3/object_acl.rb +5 -5
- data/lib/aws-sdk-s3/object_summary.rb +49 -48
- data/lib/aws-sdk-s3/object_version.rb +20 -20
- data/lib/aws-sdk-s3/types.rb +156 -132
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA1:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 41449023622c76f2366a11c1125599bc04ccd427
|
4
|
+
data.tar.gz: b73499cc776de6ed3cd07dc67107e4ddc68cab2b
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: f8777b96c2858dc1fda5dd836b188f4dc07e28890f14d449ec5fe925354e061308b5902d7977398eafa6d2da4cf3e8d2921d41d27805ff8db0e2cd961ec07c84
|
7
|
+
data.tar.gz: 9c0d3175675973fa1ec54d660dcdea88caf3980ce78ed0d4f4de8e8d12ffa43f9ce9d4cb85165842d357d27bc1febe99318347f3609ba56f22c21be2880f8ffe
|
data/lib/aws-sdk-s3.rb
CHANGED
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -289,15 +289,15 @@ module Aws::S3
|
|
289
289
|
# Required to permanently delete a versioned object if versioning is
|
290
290
|
# configured with MFA delete enabled.
|
291
291
|
# @option options [String] :request_payer
|
292
|
-
# Confirms that the requester knows that
|
293
|
-
#
|
294
|
-
# requests. For information about downloading objects from
|
295
|
-
#
|
292
|
+
# Confirms that the requester knows that they will be charged for the
|
293
|
+
# request. Bucket owners need not specify this parameter in their
|
294
|
+
# requests. For information about downloading objects from requester
|
295
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
296
296
|
# in the *Amazon S3 Developer Guide*.
|
297
297
|
#
|
298
298
|
#
|
299
299
|
#
|
300
|
-
# [1]: https://docs.aws.amazon.com/
|
300
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
301
301
|
# @option options [Boolean] :bypass_governance_retention
|
302
302
|
# Specifies whether you want to delete this object even if it has a
|
303
303
|
# Governance-type Object Lock in place. You must have sufficient
|
@@ -477,28 +477,29 @@ module Aws::S3
|
|
477
477
|
# @option options [String] :ssekms_key_id
|
478
478
|
# If `x-amz-server-side-encryption` is present and has the value of
|
479
479
|
# `aws:kms`, this header specifies the ID of the AWS Key Management
|
480
|
-
# Service (AWS KMS) customer master key
|
481
|
-
# object.
|
480
|
+
# Service (AWS KMS) symmetrical customer managed customer master key
|
481
|
+
# (CMK) that was used for the object.
|
482
482
|
#
|
483
483
|
# If the value of `x-amz-server-side-encryption` is `aws:kms`, this
|
484
|
-
# header specifies the ID of the AWS KMS CMK
|
485
|
-
# object. If you specify
|
486
|
-
#
|
487
|
-
#
|
484
|
+
# header specifies the ID of the symmetric customer managed AWS KMS CMK
|
485
|
+
# that will be used for the object. If you specify
|
486
|
+
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
487
|
+
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the AWS
|
488
|
+
# managed CMK in AWS to protect the data.
|
488
489
|
# @option options [String] :ssekms_encryption_context
|
489
490
|
# Specifies the AWS KMS Encryption Context to use for object encryption.
|
490
491
|
# The value of this header is a base64-encoded UTF-8 string holding JSON
|
491
492
|
# with the encryption context key-value pairs.
|
492
493
|
# @option options [String] :request_payer
|
493
|
-
# Confirms that the requester knows that
|
494
|
-
#
|
495
|
-
# requests. For information about downloading objects from
|
496
|
-
#
|
494
|
+
# Confirms that the requester knows that they will be charged for the
|
495
|
+
# request. Bucket owners need not specify this parameter in their
|
496
|
+
# requests. For information about downloading objects from requester
|
497
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
497
498
|
# in the *Amazon S3 Developer Guide*.
|
498
499
|
#
|
499
500
|
#
|
500
501
|
#
|
501
|
-
# [1]: https://docs.aws.amazon.com/
|
502
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
502
503
|
# @option options [String] :tagging
|
503
504
|
# The tag-set for the object. The tag-set must be encoded as URL Query
|
504
505
|
# parameters. (For example, "Key1=Value1")
|
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -385,15 +385,15 @@ module Aws::S3
|
|
385
385
|
# Upload ID that identifies the multipart upload.
|
386
386
|
#
|
387
387
|
# @option params [String] :request_payer
|
388
|
-
# Confirms that the requester knows that
|
389
|
-
#
|
390
|
-
# requests. For information about downloading objects from
|
391
|
-
#
|
388
|
+
# Confirms that the requester knows that they will be charged for the
|
389
|
+
# request. Bucket owners need not specify this parameter in their
|
390
|
+
# requests. For information about downloading objects from requester
|
391
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
392
392
|
# in the *Amazon S3 Developer Guide*.
|
393
393
|
#
|
394
394
|
#
|
395
395
|
#
|
396
|
-
# [1]: https://docs.aws.amazon.com/
|
396
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
397
397
|
#
|
398
398
|
# @return [Types::AbortMultipartUploadOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
399
399
|
#
|
@@ -533,15 +533,15 @@ module Aws::S3
|
|
533
533
|
# ID for the initiated multipart upload.
|
534
534
|
#
|
535
535
|
# @option params [String] :request_payer
|
536
|
-
# Confirms that the requester knows that
|
537
|
-
#
|
538
|
-
# requests. For information about downloading objects from
|
539
|
-
#
|
536
|
+
# Confirms that the requester knows that they will be charged for the
|
537
|
+
# request. Bucket owners need not specify this parameter in their
|
538
|
+
# requests. For information about downloading objects from requester
|
539
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
540
540
|
# in the *Amazon S3 Developer Guide*.
|
541
541
|
#
|
542
542
|
#
|
543
543
|
#
|
544
|
-
# [1]: https://docs.aws.amazon.com/
|
544
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
545
545
|
#
|
546
546
|
# @return [Types::CompleteMultipartUploadOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
547
547
|
#
|
@@ -781,10 +781,15 @@ module Aws::S3
|
|
781
781
|
#
|
782
782
|
# * `x-amz-server-side-encryption-context`
|
783
783
|
#
|
784
|
-
# <note markdown="1"> If you specify `x-amz-server-side-encryption:aws:kms
|
785
|
-
# provide `x-amz-server-side-
|
786
|
-
# uses the AWS managed
|
787
|
-
#
|
784
|
+
# <note markdown="1"> If you specify `x-amz-server-side-encryption:aws:kms`, but don't
|
785
|
+
# provide `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3
|
786
|
+
# uses the AWS managed CMK in AWS KMS to protect the data. If you
|
787
|
+
# want to use a customer managed AWS KMS CMK, you must provide the
|
788
|
+
# `x-amz-server-side-encryption-aws-kms-key-id` of the symmetric
|
789
|
+
# customer managed CMK. Amazon S3 only supports symmetric CMKs and
|
790
|
+
# not asymmetric CMKs. For more information, see [Using Symmetric
|
791
|
+
# and Asymmetric Keys][10] in the *AWS Key Management Service
|
792
|
+
# Developer Guide*.
|
788
793
|
#
|
789
794
|
# </note>
|
790
795
|
#
|
@@ -793,7 +798,7 @@ module Aws::S3
|
|
793
798
|
#
|
794
799
|
# For more information about server-side encryption with CMKs stored
|
795
800
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
796
|
-
# Encryption with CMKs stored in KMS][
|
801
|
+
# Encryption with CMKs stored in KMS][11].
|
797
802
|
#
|
798
803
|
# * To encrypt the target object using server-side encryption with an
|
799
804
|
# encryption key that you provide, use the following headers.
|
@@ -816,7 +821,7 @@ module Aws::S3
|
|
816
821
|
#
|
817
822
|
# For more information about server-side encryption with CMKs stored
|
818
823
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
819
|
-
# Encryption with CMKs stored in Amazon KMS][
|
824
|
+
# Encryption with CMKs stored in Amazon KMS][11].
|
820
825
|
#
|
821
826
|
# Access-Control-List (ACL)-Specific Request Headers
|
822
827
|
#
|
@@ -876,7 +881,7 @@ module Aws::S3
|
|
876
881
|
#
|
877
882
|
# * GetObject
|
878
883
|
#
|
879
|
-
# For more information, see [Copying Objects][
|
884
|
+
# For more information, see [Copying Objects][12].
|
880
885
|
#
|
881
886
|
#
|
882
887
|
#
|
@@ -885,12 +890,13 @@ module Aws::S3
|
|
885
890
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
|
886
891
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
|
887
892
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
888
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
893
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
889
894
|
# [7]: https://aws.amazon.com/s3/pricing/
|
890
895
|
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
891
896
|
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
892
|
-
# [10]: https://docs.aws.amazon.com/
|
893
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
897
|
+
# [10]: https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html
|
898
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html
|
899
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html
|
894
900
|
#
|
895
901
|
# @option params [String] :acl
|
896
902
|
# The canned ACL to apply to the object.
|
@@ -1001,7 +1007,7 @@ module Aws::S3
|
|
1001
1007
|
#
|
1002
1008
|
#
|
1003
1009
|
#
|
1004
|
-
# [1]: https://docs.aws.amazon.com/
|
1010
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
|
1005
1011
|
#
|
1006
1012
|
# @option params [String] :ssekms_encryption_context
|
1007
1013
|
# Specifies the AWS KMS Encryption Context to use for object encryption.
|
@@ -1023,15 +1029,15 @@ module Aws::S3
|
|
1023
1029
|
# ensure that the encryption key was transmitted without error.
|
1024
1030
|
#
|
1025
1031
|
# @option params [String] :request_payer
|
1026
|
-
# Confirms that the requester knows that
|
1027
|
-
#
|
1028
|
-
# requests. For information about downloading objects from
|
1029
|
-
#
|
1032
|
+
# Confirms that the requester knows that they will be charged for the
|
1033
|
+
# request. Bucket owners need not specify this parameter in their
|
1034
|
+
# requests. For information about downloading objects from requester
|
1035
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
1030
1036
|
# in the *Amazon S3 Developer Guide*.
|
1031
1037
|
#
|
1032
1038
|
#
|
1033
1039
|
#
|
1034
|
-
# [1]: https://docs.aws.amazon.com/
|
1040
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
1035
1041
|
#
|
1036
1042
|
# @option params [String] :tagging
|
1037
1043
|
# The tag-set for the object destination object this value must be used
|
@@ -1422,7 +1428,7 @@ module Aws::S3
|
|
1422
1428
|
# * x-amz-server-side-encryption-context
|
1423
1429
|
#
|
1424
1430
|
# <note markdown="1"> If you specify `x-amz-server-side-encryption:aws:kms`, but don't
|
1425
|
-
# provide `x-amz-server-side-
|
1431
|
+
# provide `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3
|
1426
1432
|
# uses the AWS managed CMK in AWS KMS to protect the data.
|
1427
1433
|
#
|
1428
1434
|
# </note>
|
@@ -1598,12 +1604,12 @@ module Aws::S3
|
|
1598
1604
|
# ensure that the encryption key was transmitted without error.
|
1599
1605
|
#
|
1600
1606
|
# @option params [String] :ssekms_key_id
|
1601
|
-
# Specifies the
|
1602
|
-
#
|
1603
|
-
# via SSL or using SigV4. For
|
1604
|
-
#
|
1605
|
-
#
|
1606
|
-
# Developer Guide*.
|
1607
|
+
# Specifies the ID of the symmetric customer managed AWS KMS CMK to use
|
1608
|
+
# for object encryption. All GET and PUT requests for an object
|
1609
|
+
# protected by AWS KMS will fail if not made via SSL or using SigV4. For
|
1610
|
+
# information about configuring using any of the officially supported
|
1611
|
+
# AWS SDKs and AWS CLI, see [Specifying the Signature Version in Request
|
1612
|
+
# Authentication][1] in the *Amazon S3 Developer Guide*.
|
1607
1613
|
#
|
1608
1614
|
#
|
1609
1615
|
#
|
@@ -1615,15 +1621,15 @@ module Aws::S3
|
|
1615
1621
|
# with the encryption context key-value pairs.
|
1616
1622
|
#
|
1617
1623
|
# @option params [String] :request_payer
|
1618
|
-
# Confirms that the requester knows that
|
1619
|
-
#
|
1620
|
-
# requests. For information about downloading objects from
|
1621
|
-
#
|
1624
|
+
# Confirms that the requester knows that they will be charged for the
|
1625
|
+
# request. Bucket owners need not specify this parameter in their
|
1626
|
+
# requests. For information about downloading objects from requester
|
1627
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
1622
1628
|
# in the *Amazon S3 Developer Guide*.
|
1623
1629
|
#
|
1624
1630
|
#
|
1625
1631
|
#
|
1626
|
-
# [1]: https://docs.aws.amazon.com/
|
1632
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
1627
1633
|
#
|
1628
1634
|
# @option params [String] :tagging
|
1629
1635
|
# The tag-set for the object. The tag-set must be encoded as URL Query
|
@@ -2347,15 +2353,15 @@ module Aws::S3
|
|
2347
2353
|
# VersionId used to reference a specific version of the object.
|
2348
2354
|
#
|
2349
2355
|
# @option params [String] :request_payer
|
2350
|
-
# Confirms that the requester knows that
|
2351
|
-
#
|
2352
|
-
# requests. For information about downloading objects from
|
2353
|
-
#
|
2356
|
+
# Confirms that the requester knows that they will be charged for the
|
2357
|
+
# request. Bucket owners need not specify this parameter in their
|
2358
|
+
# requests. For information about downloading objects from requester
|
2359
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
2354
2360
|
# in the *Amazon S3 Developer Guide*.
|
2355
2361
|
#
|
2356
2362
|
#
|
2357
2363
|
#
|
2358
|
-
# [1]: https://docs.aws.amazon.com/
|
2364
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
2359
2365
|
#
|
2360
2366
|
# @option params [Boolean] :bypass_governance_retention
|
2361
2367
|
# Indicates whether S3 Object Lock should bypass Governance-mode
|
@@ -2435,7 +2441,7 @@ module Aws::S3
|
|
2435
2441
|
#
|
2436
2442
|
#
|
2437
2443
|
#
|
2438
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
2444
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html
|
2439
2445
|
#
|
2440
2446
|
# @option params [required, String] :bucket
|
2441
2447
|
# The bucket name containing the objects from which to remove the tags.
|
@@ -2588,15 +2594,15 @@ module Aws::S3
|
|
2588
2594
|
# configured with MFA delete enabled.
|
2589
2595
|
#
|
2590
2596
|
# @option params [String] :request_payer
|
2591
|
-
# Confirms that the requester knows that
|
2592
|
-
#
|
2593
|
-
# requests. For information about downloading objects from
|
2594
|
-
#
|
2597
|
+
# Confirms that the requester knows that they will be charged for the
|
2598
|
+
# request. Bucket owners need not specify this parameter in their
|
2599
|
+
# requests. For information about downloading objects from requester
|
2600
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
2595
2601
|
# in the *Amazon S3 Developer Guide*.
|
2596
2602
|
#
|
2597
2603
|
#
|
2598
2604
|
#
|
2599
|
-
# [1]: https://docs.aws.amazon.com/
|
2605
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
2600
2606
|
#
|
2601
2607
|
# @option params [Boolean] :bypass_governance_retention
|
2602
2608
|
# Specifies whether you want to delete this object even if it has a
|
@@ -4446,15 +4452,15 @@ module Aws::S3
|
|
4446
4452
|
# ensure that the encryption key was transmitted without error.
|
4447
4453
|
#
|
4448
4454
|
# @option params [String] :request_payer
|
4449
|
-
# Confirms that the requester knows that
|
4450
|
-
#
|
4451
|
-
# requests. For information about downloading objects from
|
4452
|
-
#
|
4455
|
+
# Confirms that the requester knows that they will be charged for the
|
4456
|
+
# request. Bucket owners need not specify this parameter in their
|
4457
|
+
# requests. For information about downloading objects from requester
|
4458
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
4453
4459
|
# in the *Amazon S3 Developer Guide*.
|
4454
4460
|
#
|
4455
4461
|
#
|
4456
4462
|
#
|
4457
|
-
# [1]: https://docs.aws.amazon.com/
|
4463
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
4458
4464
|
#
|
4459
4465
|
# @option params [Integer] :part_number
|
4460
4466
|
# Part number of the object being read. This is a positive integer
|
@@ -4680,15 +4686,15 @@ module Aws::S3
|
|
4680
4686
|
# VersionId used to reference a specific version of the object.
|
4681
4687
|
#
|
4682
4688
|
# @option params [String] :request_payer
|
4683
|
-
# Confirms that the requester knows that
|
4684
|
-
#
|
4685
|
-
# requests. For information about downloading objects from
|
4686
|
-
#
|
4689
|
+
# Confirms that the requester knows that they will be charged for the
|
4690
|
+
# request. Bucket owners need not specify this parameter in their
|
4691
|
+
# requests. For information about downloading objects from requester
|
4692
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
4687
4693
|
# in the *Amazon S3 Developer Guide*.
|
4688
4694
|
#
|
4689
4695
|
#
|
4690
4696
|
#
|
4691
|
-
# [1]: https://docs.aws.amazon.com/
|
4697
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
4692
4698
|
#
|
4693
4699
|
# @return [Types::GetObjectAclOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4694
4700
|
#
|
@@ -4811,15 +4817,15 @@ module Aws::S3
|
|
4811
4817
|
# retrieve.
|
4812
4818
|
#
|
4813
4819
|
# @option params [String] :request_payer
|
4814
|
-
# Confirms that the requester knows that
|
4815
|
-
#
|
4816
|
-
# requests. For information about downloading objects from
|
4817
|
-
#
|
4820
|
+
# Confirms that the requester knows that they will be charged for the
|
4821
|
+
# request. Bucket owners need not specify this parameter in their
|
4822
|
+
# requests. For information about downloading objects from requester
|
4823
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
4818
4824
|
# in the *Amazon S3 Developer Guide*.
|
4819
4825
|
#
|
4820
4826
|
#
|
4821
4827
|
#
|
4822
|
-
# [1]: https://docs.aws.amazon.com/
|
4828
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
4823
4829
|
#
|
4824
4830
|
# @return [Types::GetObjectLegalHoldOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4825
4831
|
#
|
@@ -4917,15 +4923,15 @@ module Aws::S3
|
|
4917
4923
|
# retrieve.
|
4918
4924
|
#
|
4919
4925
|
# @option params [String] :request_payer
|
4920
|
-
# Confirms that the requester knows that
|
4921
|
-
#
|
4922
|
-
# requests. For information about downloading objects from
|
4923
|
-
#
|
4926
|
+
# Confirms that the requester knows that they will be charged for the
|
4927
|
+
# request. Bucket owners need not specify this parameter in their
|
4928
|
+
# requests. For information about downloading objects from requester
|
4929
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
4924
4930
|
# in the *Amazon S3 Developer Guide*.
|
4925
4931
|
#
|
4926
4932
|
#
|
4927
4933
|
#
|
4928
|
-
# [1]: https://docs.aws.amazon.com/
|
4934
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
4929
4935
|
#
|
4930
4936
|
# @return [Types::GetObjectRetentionOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4931
4937
|
#
|
@@ -5110,15 +5116,15 @@ module Aws::S3
|
|
5110
5116
|
# The object key for which to get the information.
|
5111
5117
|
#
|
5112
5118
|
# @option params [String] :request_payer
|
5113
|
-
# Confirms that the requester knows that
|
5114
|
-
#
|
5115
|
-
# requests. For information about downloading objects from
|
5116
|
-
#
|
5119
|
+
# Confirms that the requester knows that they will be charged for the
|
5120
|
+
# request. Bucket owners need not specify this parameter in their
|
5121
|
+
# requests. For information about downloading objects from requester
|
5122
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
5117
5123
|
# in the *Amazon S3 Developer Guide*.
|
5118
5124
|
#
|
5119
5125
|
#
|
5120
5126
|
#
|
5121
|
-
# [1]: https://docs.aws.amazon.com/
|
5127
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
5122
5128
|
#
|
5123
5129
|
# @return [Types::GetObjectTorrentOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
5124
5130
|
#
|
@@ -5400,15 +5406,15 @@ module Aws::S3
|
|
5400
5406
|
# ensure that the encryption key was transmitted without error.
|
5401
5407
|
#
|
5402
5408
|
# @option params [String] :request_payer
|
5403
|
-
# Confirms that the requester knows that
|
5404
|
-
#
|
5405
|
-
# requests. For information about downloading objects from
|
5406
|
-
#
|
5409
|
+
# Confirms that the requester knows that they will be charged for the
|
5410
|
+
# request. Bucket owners need not specify this parameter in their
|
5411
|
+
# requests. For information about downloading objects from requester
|
5412
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
5407
5413
|
# in the *Amazon S3 Developer Guide*.
|
5408
5414
|
#
|
5409
5415
|
#
|
5410
5416
|
#
|
5411
|
-
# [1]: https://docs.aws.amazon.com/
|
5417
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
5412
5418
|
#
|
5413
5419
|
# @option params [Integer] :part_number
|
5414
5420
|
# Part number of the object being read. This is a positive integer
|
@@ -6697,15 +6703,15 @@ module Aws::S3
|
|
6697
6703
|
# listed.
|
6698
6704
|
#
|
6699
6705
|
# @option params [String] :request_payer
|
6700
|
-
# Confirms that the requester knows that
|
6701
|
-
#
|
6702
|
-
# requests. For information about downloading objects from
|
6703
|
-
#
|
6706
|
+
# Confirms that the requester knows that they will be charged for the
|
6707
|
+
# request. Bucket owners need not specify this parameter in their
|
6708
|
+
# requests. For information about downloading objects from requester
|
6709
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
6704
6710
|
# in the *Amazon S3 Developer Guide*.
|
6705
6711
|
#
|
6706
6712
|
#
|
6707
6713
|
#
|
6708
|
-
# [1]: https://docs.aws.amazon.com/
|
6714
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
6709
6715
|
#
|
6710
6716
|
# @return [Types::ListPartsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
6711
6717
|
#
|
@@ -7342,8 +7348,8 @@ module Aws::S3
|
|
7342
7348
|
# subresource to set the default encryption state of an existing bucket.
|
7343
7349
|
#
|
7344
7350
|
# This implementation of the `PUT` operation sets default encryption for
|
7345
|
-
# a
|
7346
|
-
# SSE-S3 or AWS KMS customer master keys (CMKs) (SSE-KMS)
|
7351
|
+
# a bucket using server-side encryption with Amazon S3-managed keys
|
7352
|
+
# SSE-S3 or AWS KMS customer master keys (CMKs) (SSE-KMS).
|
7347
7353
|
#
|
7348
7354
|
# This operation requires AWS Signature Version 4. For more information,
|
7349
7355
|
# see [ Authenticating Requests (AWS Signature Version
|
@@ -9037,8 +9043,14 @@ module Aws::S3
|
|
9037
9043
|
# * x-amz-server-side-encryption-context
|
9038
9044
|
#
|
9039
9045
|
# <note markdown="1"> If you specify `x-amz-server-side-encryption:aws:kms`, but don't
|
9040
|
-
# provide `x-amz-server-side-
|
9041
|
-
# uses the AWS managed CMK in AWS KMS to protect the data.
|
9046
|
+
# provide `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3
|
9047
|
+
# uses the AWS managed CMK in AWS KMS to protect the data. If you
|
9048
|
+
# want to use a customer managed AWS KMS CMK, you must provide the
|
9049
|
+
# `x-amz-server-side-encryption-aws-kms-key-id` of the symmetric
|
9050
|
+
# customer managed CMK. Amazon S3 only supports symmetric CMKs and
|
9051
|
+
# not asymmetric CMKs. For more information, see [Using Symmetric
|
9052
|
+
# and Asymmetric Keys][5] in the *AWS Key Management Service
|
9053
|
+
# Developer Guide*.
|
9042
9054
|
#
|
9043
9055
|
# </note>
|
9044
9056
|
#
|
@@ -9047,7 +9059,7 @@ module Aws::S3
|
|
9047
9059
|
#
|
9048
9060
|
# For more information about server-side encryption with CMKs stored
|
9049
9061
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
9050
|
-
# Encryption with CMKs stored in AWS][
|
9062
|
+
# Encryption with CMKs stored in AWS][6].
|
9051
9063
|
#
|
9052
9064
|
# * Use customer-provided encryption keys – If you want to manage your
|
9053
9065
|
# own encryption keys, provide all the following headers in the
|
@@ -9061,7 +9073,7 @@ module Aws::S3
|
|
9061
9073
|
#
|
9062
9074
|
# For more information about server-side encryption with CMKs stored
|
9063
9075
|
# in KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
9064
|
-
# Encryption with CMKs stored in AWS
|
9076
|
+
# Encryption with CMKs stored in AWS][6].
|
9065
9077
|
#
|
9066
9078
|
# Access-Control-List (ACL)-Specific Request Headers
|
9067
9079
|
#
|
@@ -9071,7 +9083,7 @@ module Aws::S3
|
|
9071
9083
|
# permissions to individual AWS accounts or to predefined groups
|
9072
9084
|
# defined by Amazon S3. These permissions are then added to the Access
|
9073
9085
|
# Control List (ACL) on the object. For more information, see [Using
|
9074
|
-
# ACLs][
|
9086
|
+
# ACLs][7]. With this operation, you can grant access permissions
|
9075
9087
|
# using one of the following two methods:
|
9076
9088
|
#
|
9077
9089
|
# * Specify a canned ACL (`x-amz-acl`) — Amazon S3 supports a set of
|
@@ -9124,7 +9136,7 @@ module Aws::S3
|
|
9124
9136
|
#
|
9125
9137
|
# For a list of all the Amazon S3 supported Regions and
|
9126
9138
|
# endpoints,
|
9127
|
-
# see [Regions and Endpoints][
|
9139
|
+
# see [Regions and Endpoints][8] in the AWS General Reference
|
9128
9140
|
#
|
9129
9141
|
# * `id` – if the value specified is the canonical user ID of an AWS
|
9130
9142
|
# account
|
@@ -9159,8 +9171,14 @@ module Aws::S3
|
|
9159
9171
|
# * x-amz-server-side-encryption-context
|
9160
9172
|
#
|
9161
9173
|
# <note markdown="1"> If you specify `x-amz-server-side-encryption:aws:kms`, but don't
|
9162
|
-
# provide `x-amz-server-side-
|
9163
|
-
# uses the
|
9174
|
+
# provide `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3
|
9175
|
+
# uses the AWS managed CMK in AWS KMS to protect the data. If you
|
9176
|
+
# want to use a customer managed AWS KMS CMK, you must provide the
|
9177
|
+
# `x-amz-server-side-encryption-aws-kms-key-id` of the symmetric
|
9178
|
+
# customer managed CMK. Amazon S3 only supports symmetric CMKs and
|
9179
|
+
# not asymmetric CMKs. For more information, see [Using Symmetric
|
9180
|
+
# and Asymmetric Keys][5] in the *AWS Key Management Service
|
9181
|
+
# Developer Guide*.
|
9164
9182
|
#
|
9165
9183
|
# </note>
|
9166
9184
|
#
|
@@ -9169,7 +9187,7 @@ module Aws::S3
|
|
9169
9187
|
#
|
9170
9188
|
# For more information about server-side encryption with CMKs stored
|
9171
9189
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
9172
|
-
# Encryption with CMKs stored in AWS KMS][
|
9190
|
+
# Encryption with CMKs stored in AWS KMS][6].
|
9173
9191
|
#
|
9174
9192
|
# * Use customer-provided encryption keys – If you want to manage your
|
9175
9193
|
# own encryption keys, provide all the following headers in the
|
@@ -9188,7 +9206,7 @@ module Aws::S3
|
|
9188
9206
|
#
|
9189
9207
|
# For more information about server-side encryption with CMKs stored
|
9190
9208
|
# in AWS KMS (SSE-KMS), see [Protecting Data Using Server-Side
|
9191
|
-
# Encryption with CMKs stored in AWS KMS][
|
9209
|
+
# Encryption with CMKs stored in AWS KMS][6].
|
9192
9210
|
#
|
9193
9211
|
# **Storage Class Options**
|
9194
9212
|
#
|
@@ -9196,7 +9214,7 @@ module Aws::S3
|
|
9196
9214
|
# created objects. The Standard storage class provides high durability
|
9197
9215
|
# and high availability. You can specify other storage classes depending
|
9198
9216
|
# on the performance needs. For more information, see [Storage
|
9199
|
-
# Classes][
|
9217
|
+
# Classes][9] in the Amazon Simple Storage Service Developer Guide.
|
9200
9218
|
#
|
9201
9219
|
# **Versioning**
|
9202
9220
|
#
|
@@ -9222,10 +9240,11 @@ module Aws::S3
|
|
9222
9240
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
9223
9241
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
9224
9242
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
9225
|
-
# [5]: https://docs.aws.amazon.com/
|
9226
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
9227
|
-
# [7]: https://docs.aws.amazon.com/
|
9228
|
-
# [8]: https://docs.aws.amazon.com/
|
9243
|
+
# [5]: https://docs.aws.amazon.com/kms/latest/developerguide/symmetric-asymmetric.html
|
9244
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingKMSEncryption.html
|
9245
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
9246
|
+
# [8]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
9247
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
9229
9248
|
#
|
9230
9249
|
# @option params [String] :acl
|
9231
9250
|
# The canned ACL to apply to the object. For more information, see
|
@@ -9396,14 +9415,15 @@ module Aws::S3
|
|
9396
9415
|
# @option params [String] :ssekms_key_id
|
9397
9416
|
# If `x-amz-server-side-encryption` is present and has the value of
|
9398
9417
|
# `aws:kms`, this header specifies the ID of the AWS Key Management
|
9399
|
-
# Service (AWS KMS) customer master key
|
9400
|
-
# object.
|
9418
|
+
# Service (AWS KMS) symmetrical customer managed customer master key
|
9419
|
+
# (CMK) that was used for the object.
|
9401
9420
|
#
|
9402
9421
|
# If the value of `x-amz-server-side-encryption` is `aws:kms`, this
|
9403
|
-
# header specifies the ID of the AWS KMS CMK
|
9404
|
-
# object. If you specify
|
9405
|
-
#
|
9406
|
-
#
|
9422
|
+
# header specifies the ID of the symmetric customer managed AWS KMS CMK
|
9423
|
+
# that will be used for the object. If you specify
|
9424
|
+
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
9425
|
+
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the AWS
|
9426
|
+
# managed CMK in AWS to protect the data.
|
9407
9427
|
#
|
9408
9428
|
# @option params [String] :ssekms_encryption_context
|
9409
9429
|
# Specifies the AWS KMS Encryption Context to use for object encryption.
|
@@ -9411,15 +9431,15 @@ module Aws::S3
|
|
9411
9431
|
# with the encryption context key-value pairs.
|
9412
9432
|
#
|
9413
9433
|
# @option params [String] :request_payer
|
9414
|
-
# Confirms that the requester knows that
|
9415
|
-
#
|
9416
|
-
# requests. For information about downloading objects from
|
9417
|
-
#
|
9434
|
+
# Confirms that the requester knows that they will be charged for the
|
9435
|
+
# request. Bucket owners need not specify this parameter in their
|
9436
|
+
# requests. For information about downloading objects from requester
|
9437
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
9418
9438
|
# in the *Amazon S3 Developer Guide*.
|
9419
9439
|
#
|
9420
9440
|
#
|
9421
9441
|
#
|
9422
|
-
# [1]: https://docs.aws.amazon.com/
|
9442
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
9423
9443
|
#
|
9424
9444
|
# @option params [String] :tagging
|
9425
9445
|
# The tag-set for the object. The tag-set must be encoded as URL Query
|
@@ -9799,15 +9819,15 @@ module Aws::S3
|
|
9799
9819
|
# Key for which the PUT operation was initiated.
|
9800
9820
|
#
|
9801
9821
|
# @option params [String] :request_payer
|
9802
|
-
# Confirms that the requester knows that
|
9803
|
-
#
|
9804
|
-
# requests. For information about downloading objects from
|
9805
|
-
#
|
9822
|
+
# Confirms that the requester knows that they will be charged for the
|
9823
|
+
# request. Bucket owners need not specify this parameter in their
|
9824
|
+
# requests. For information about downloading objects from requester
|
9825
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
9806
9826
|
# in the *Amazon S3 Developer Guide*.
|
9807
9827
|
#
|
9808
9828
|
#
|
9809
9829
|
#
|
9810
|
-
# [1]: https://docs.aws.amazon.com/
|
9830
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
9811
9831
|
#
|
9812
9832
|
# @option params [String] :version_id
|
9813
9833
|
# VersionId used to reference a specific version of the object.
|
@@ -9918,15 +9938,15 @@ module Aws::S3
|
|
9918
9938
|
# to the specified object.
|
9919
9939
|
#
|
9920
9940
|
# @option params [String] :request_payer
|
9921
|
-
# Confirms that the requester knows that
|
9922
|
-
#
|
9923
|
-
# requests. For information about downloading objects from
|
9924
|
-
#
|
9941
|
+
# Confirms that the requester knows that they will be charged for the
|
9942
|
+
# request. Bucket owners need not specify this parameter in their
|
9943
|
+
# requests. For information about downloading objects from requester
|
9944
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
9925
9945
|
# in the *Amazon S3 Developer Guide*.
|
9926
9946
|
#
|
9927
9947
|
#
|
9928
9948
|
#
|
9929
|
-
# [1]: https://docs.aws.amazon.com/
|
9949
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
9930
9950
|
#
|
9931
9951
|
# @option params [String] :version_id
|
9932
9952
|
# The version ID of the object that you want to place a Legal Hold on.
|
@@ -9992,15 +10012,15 @@ module Aws::S3
|
|
9992
10012
|
# bucket.
|
9993
10013
|
#
|
9994
10014
|
# @option params [String] :request_payer
|
9995
|
-
# Confirms that the requester knows that
|
9996
|
-
#
|
9997
|
-
# requests. For information about downloading objects from
|
9998
|
-
#
|
10015
|
+
# Confirms that the requester knows that they will be charged for the
|
10016
|
+
# request. Bucket owners need not specify this parameter in their
|
10017
|
+
# requests. For information about downloading objects from requester
|
10018
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
9999
10019
|
# in the *Amazon S3 Developer Guide*.
|
10000
10020
|
#
|
10001
10021
|
#
|
10002
10022
|
#
|
10003
|
-
# [1]: https://docs.aws.amazon.com/
|
10023
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
10004
10024
|
#
|
10005
10025
|
# @option params [String] :token
|
10006
10026
|
# A token to allow Object Lock to be enabled for an existing bucket.
|
@@ -10080,15 +10100,15 @@ module Aws::S3
|
|
10080
10100
|
# The container element for the Object Retention configuration.
|
10081
10101
|
#
|
10082
10102
|
# @option params [String] :request_payer
|
10083
|
-
# Confirms that the requester knows that
|
10084
|
-
#
|
10085
|
-
# requests. For information about downloading objects from
|
10086
|
-
#
|
10103
|
+
# Confirms that the requester knows that they will be charged for the
|
10104
|
+
# request. Bucket owners need not specify this parameter in their
|
10105
|
+
# requests. For information about downloading objects from requester
|
10106
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
10087
10107
|
# in the *Amazon S3 Developer Guide*.
|
10088
10108
|
#
|
10089
10109
|
#
|
10090
10110
|
#
|
10091
|
-
# [1]: https://docs.aws.amazon.com/
|
10111
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
10092
10112
|
#
|
10093
10113
|
# @option params [String] :version_id
|
10094
10114
|
# The version ID for the object that you want to apply this Object
|
@@ -10619,15 +10639,15 @@ module Aws::S3
|
|
10619
10639
|
# Container for restore job parameters.
|
10620
10640
|
#
|
10621
10641
|
# @option params [String] :request_payer
|
10622
|
-
# Confirms that the requester knows that
|
10623
|
-
#
|
10624
|
-
# requests. For information about downloading objects from
|
10625
|
-
#
|
10642
|
+
# Confirms that the requester knows that they will be charged for the
|
10643
|
+
# request. Bucket owners need not specify this parameter in their
|
10644
|
+
# requests. For information about downloading objects from requester
|
10645
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
10626
10646
|
# in the *Amazon S3 Developer Guide*.
|
10627
10647
|
#
|
10628
10648
|
#
|
10629
10649
|
#
|
10630
|
-
# [1]: https://docs.aws.amazon.com/
|
10650
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
10631
10651
|
#
|
10632
10652
|
# @return [Types::RestoreObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
10633
10653
|
#
|
@@ -11304,15 +11324,15 @@ module Aws::S3
|
|
11304
11324
|
# ensure that the encryption key was transmitted without error.
|
11305
11325
|
#
|
11306
11326
|
# @option params [String] :request_payer
|
11307
|
-
# Confirms that the requester knows that
|
11308
|
-
#
|
11309
|
-
# requests. For information about downloading objects from
|
11310
|
-
#
|
11327
|
+
# Confirms that the requester knows that they will be charged for the
|
11328
|
+
# request. Bucket owners need not specify this parameter in their
|
11329
|
+
# requests. For information about downloading objects from requester
|
11330
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
11311
11331
|
# in the *Amazon S3 Developer Guide*.
|
11312
11332
|
#
|
11313
11333
|
#
|
11314
11334
|
#
|
11315
|
-
# [1]: https://docs.aws.amazon.com/
|
11335
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
11316
11336
|
#
|
11317
11337
|
# @return [Types::UploadPartOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
11318
11338
|
#
|
@@ -11575,15 +11595,15 @@ module Aws::S3
|
|
11575
11595
|
# ensure that the encryption key was transmitted without error.
|
11576
11596
|
#
|
11577
11597
|
# @option params [String] :request_payer
|
11578
|
-
# Confirms that the requester knows that
|
11579
|
-
#
|
11580
|
-
# requests. For information about downloading objects from
|
11581
|
-
#
|
11598
|
+
# Confirms that the requester knows that they will be charged for the
|
11599
|
+
# request. Bucket owners need not specify this parameter in their
|
11600
|
+
# requests. For information about downloading objects from requester
|
11601
|
+
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
11582
11602
|
# in the *Amazon S3 Developer Guide*.
|
11583
11603
|
#
|
11584
11604
|
#
|
11585
11605
|
#
|
11586
|
-
# [1]: https://docs.aws.amazon.com/
|
11606
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
11587
11607
|
#
|
11588
11608
|
# @return [Types::UploadPartCopyOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
11589
11609
|
#
|
@@ -11693,7 +11713,7 @@ module Aws::S3
|
|
11693
11713
|
params: params,
|
11694
11714
|
config: config)
|
11695
11715
|
context[:gem_name] = 'aws-sdk-s3'
|
11696
|
-
context[:gem_version] = '1.
|
11716
|
+
context[:gem_version] = '1.60.0'
|
11697
11717
|
Seahorse::Client::Request.new(handlers, context)
|
11698
11718
|
end
|
11699
11719
|
|