aws-sdk-s3 1.79.1 → 1.83.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -228,6 +228,7 @@ module Aws::S3
228
228
  # grant_write_acp: "GrantWriteACP",
229
229
  # request_payer: "requester", # accepts requester
230
230
  # version_id: "ObjectVersionId",
231
+ # expected_bucket_owner: "AccountId",
231
232
  # })
232
233
  # @param [Hash] options ({})
233
234
  # @option options [String] :acl
@@ -252,15 +253,23 @@ module Aws::S3
252
253
  # @option options [String] :grant_full_control
253
254
  # Allows grantee the read, write, read ACP, and write ACP permissions on
254
255
  # the bucket.
256
+ #
257
+ # This action is not supported by Amazon S3 on Outposts.
255
258
  # @option options [String] :grant_read
256
259
  # Allows grantee to list the objects in the bucket.
260
+ #
261
+ # This action is not supported by Amazon S3 on Outposts.
257
262
  # @option options [String] :grant_read_acp
258
263
  # Allows grantee to read the bucket ACL.
264
+ #
265
+ # This action is not supported by Amazon S3 on Outposts.
259
266
  # @option options [String] :grant_write
260
267
  # Allows grantee to create, overwrite, and delete any object in the
261
268
  # bucket.
262
269
  # @option options [String] :grant_write_acp
263
270
  # Allows grantee to write the ACL for the applicable bucket.
271
+ #
272
+ # This action is not supported by Amazon S3 on Outposts.
264
273
  # @option options [String] :request_payer
265
274
  # Confirms that the requester knows that they will be charged for the
266
275
  # request. Bucket owners need not specify this parameter in their
@@ -273,6 +282,10 @@ module Aws::S3
273
282
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
274
283
  # @option options [String] :version_id
275
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.
276
289
  # @return [Types::PutObjectAclOutput]
277
290
  def put(options = {})
278
291
  options = options.merge(
@@ -295,7 +295,7 @@ module Aws::S3
295
295
  # metadata_directive: "COPY", # accepts COPY, REPLACE
296
296
  # tagging_directive: "COPY", # accepts COPY, REPLACE
297
297
  # server_side_encryption: "AES256", # accepts AES256, aws:kms
298
- # 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
299
299
  # website_redirect_location: "WebsiteRedirectLocation",
300
300
  # sse_customer_algorithm: "SSECustomerAlgorithm",
301
301
  # sse_customer_key: "SSECustomerKey",
@@ -310,10 +310,14 @@ module Aws::S3
310
310
  # object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
311
311
  # object_lock_retain_until_date: Time.now,
312
312
  # object_lock_legal_hold_status: "ON", # accepts ON, OFF
313
+ # expected_bucket_owner: "AccountId",
314
+ # expected_source_bucket_owner: "AccountId",
313
315
  # })
314
316
  # @param [Hash] options ({})
315
317
  # @option options [String] :acl
316
318
  # The canned ACL to apply to the object.
319
+ #
320
+ # This action is not supported by Amazon S3 on Outposts.
317
321
  # @option options [String] :cache_control
318
322
  # Specifies caching behavior along the request/reply chain.
319
323
  # @option options [String] :content_disposition
@@ -327,8 +331,50 @@ module Aws::S3
327
331
  # @option options [String] :content_type
328
332
  # A standard MIME type describing the format of the object data.
329
333
  # @option options [required, String] :copy_source
330
- # The name of the source bucket and key name of the source object,
331
- # separated by a slash (/). Must be URL-encoded.
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
332
378
  # @option options [String] :copy_source_if_match
333
379
  # Copies the object if its entity tag (ETag) matches the specified tag.
334
380
  # @option options [Time,DateTime,Date,Integer,String] :copy_source_if_modified_since
@@ -344,12 +390,20 @@ module Aws::S3
344
390
  # @option options [String] :grant_full_control
345
391
  # Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
346
392
  # object.
393
+ #
394
+ # This action is not supported by Amazon S3 on Outposts.
347
395
  # @option options [String] :grant_read
348
396
  # Allows grantee to read the object data and its metadata.
397
+ #
398
+ # This action is not supported by Amazon S3 on Outposts.
349
399
  # @option options [String] :grant_read_acp
350
400
  # Allows grantee to read the object ACL.
401
+ #
402
+ # This action is not supported by Amazon S3 on Outposts.
351
403
  # @option options [String] :grant_write_acp
352
404
  # Allows grantee to write the ACL for the applicable object.
405
+ #
406
+ # This action is not supported by Amazon S3 on Outposts.
353
407
  # @option options [Hash<String,String>] :metadata
354
408
  # A map of metadata to store with the object in S3.
355
409
  # @option options [String] :metadata_directive
@@ -362,7 +416,16 @@ module Aws::S3
362
416
  # The server-side encryption algorithm used when storing this object in
363
417
  # Amazon S3 (for example, AES256, aws:kms).
364
418
  # @option options [String] :storage_class
365
- # The type of storage to use for the object. Defaults to 'STANDARD'.
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
366
429
  # @option options [String] :website_redirect_location
367
430
  # If the bucket is configured as a website, redirects requests for this
368
431
  # object to another object in the same bucket or to an external URL.
@@ -375,7 +438,7 @@ module Aws::S3
375
438
  # encrypting data. This value is used to store the object and then it is
376
439
  # discarded; Amazon S3 does not store the encryption key. The key must
377
440
  # be appropriate for use with the algorithm specified in the
378
- # `x-amz-server-side​-encryption​-customer-algorithm` header.
441
+ # `x-amz-server-side-encryption-customer-algorithm` header.
379
442
  # @option options [String] :sse_customer_key_md5
380
443
  # Specifies the 128-bit MD5 digest of the encryption key according to
381
444
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
@@ -427,6 +490,14 @@ module Aws::S3
427
490
  # expire.
428
491
  # @option options [String] :object_lock_legal_hold_status
429
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.
430
501
  # @return [Types::CopyObjectOutput]
431
502
  def copy_from(options = {})
432
503
  options = options.merge(
@@ -444,6 +515,7 @@ module Aws::S3
444
515
  # version_id: "ObjectVersionId",
445
516
  # request_payer: "requester", # accepts requester
446
517
  # bypass_governance_retention: false,
518
+ # expected_bucket_owner: "AccountId",
447
519
  # })
448
520
  # @param [Hash] options ({})
449
521
  # @option options [String] :mfa
@@ -466,6 +538,10 @@ module Aws::S3
466
538
  # @option options [Boolean] :bypass_governance_retention
467
539
  # Indicates whether S3 Object Lock should bypass Governance-mode
468
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.
469
545
  # @return [Types::DeleteObjectOutput]
470
546
  def delete(options = {})
471
547
  options = options.merge(
@@ -496,6 +572,7 @@ module Aws::S3
496
572
  # sse_customer_key_md5: "SSECustomerKeyMD5",
497
573
  # request_payer: "requester", # accepts requester
498
574
  # part_number: 1,
575
+ # expected_bucket_owner: "AccountId",
499
576
  # })
500
577
  # @param [Hash] options ({})
501
578
  # @option options [String] :if_match
@@ -545,7 +622,7 @@ module Aws::S3
545
622
  # encrypting data. This value is used to store the object and then it is
546
623
  # discarded; Amazon S3 does not store the encryption key. The key must
547
624
  # be appropriate for use with the algorithm specified in the
548
- # `x-amz-server-side​-encryption​-customer-algorithm` header.
625
+ # `x-amz-server-side-encryption-customer-algorithm` header.
549
626
  # @option options [String] :sse_customer_key_md5
550
627
  # Specifies the 128-bit MD5 digest of the encryption key according to
551
628
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
@@ -565,6 +642,10 @@ module Aws::S3
565
642
  # between 1 and 10,000. Effectively performs a 'ranged' GET request
566
643
  # for the part specified. Useful for downloading just a part of an
567
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.
568
649
  # @return [Types::GetObjectOutput]
569
650
  def get(options = {}, &block)
570
651
  options = options.merge(
@@ -593,7 +674,7 @@ module Aws::S3
593
674
  # "MetadataKey" => "MetadataValue",
594
675
  # },
595
676
  # server_side_encryption: "AES256", # accepts AES256, aws:kms
596
- # 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
597
678
  # website_redirect_location: "WebsiteRedirectLocation",
598
679
  # sse_customer_algorithm: "SSECustomerAlgorithm",
599
680
  # sse_customer_key: "SSECustomerKey",
@@ -605,10 +686,13 @@ module Aws::S3
605
686
  # object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
606
687
  # object_lock_retain_until_date: Time.now,
607
688
  # object_lock_legal_hold_status: "ON", # accepts ON, OFF
689
+ # expected_bucket_owner: "AccountId",
608
690
  # })
609
691
  # @param [Hash] options ({})
610
692
  # @option options [String] :acl
611
693
  # The canned ACL to apply to the object.
694
+ #
695
+ # This action is not supported by Amazon S3 on Outposts.
612
696
  # @option options [String] :cache_control
613
697
  # Specifies caching behavior along the request/reply chain.
614
698
  # @option options [String] :content_disposition
@@ -626,19 +710,36 @@ module Aws::S3
626
710
  # @option options [String] :grant_full_control
627
711
  # Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
628
712
  # object.
713
+ #
714
+ # This action is not supported by Amazon S3 on Outposts.
629
715
  # @option options [String] :grant_read
630
716
  # Allows grantee to read the object data and its metadata.
717
+ #
718
+ # This action is not supported by Amazon S3 on Outposts.
631
719
  # @option options [String] :grant_read_acp
632
720
  # Allows grantee to read the object ACL.
721
+ #
722
+ # This action is not supported by Amazon S3 on Outposts.
633
723
  # @option options [String] :grant_write_acp
634
724
  # Allows grantee to write the ACL for the applicable object.
725
+ #
726
+ # This action is not supported by Amazon S3 on Outposts.
635
727
  # @option options [Hash<String,String>] :metadata
636
728
  # A map of metadata to store with the object in S3.
637
729
  # @option options [String] :server_side_encryption
638
730
  # The server-side encryption algorithm used when storing this object in
639
731
  # Amazon S3 (for example, AES256, aws:kms).
640
732
  # @option options [String] :storage_class
641
- # The type of storage to use for the object. Defaults to 'STANDARD'.
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
642
743
  # @option options [String] :website_redirect_location
643
744
  # If the bucket is configured as a website, redirects requests for this
644
745
  # object to another object in the same bucket or to an external URL.
@@ -651,7 +752,7 @@ module Aws::S3
651
752
  # encrypting data. This value is used to store the object and then it is
652
753
  # discarded; Amazon S3 does not store the encryption key. The key must
653
754
  # be appropriate for use with the algorithm specified in the
654
- # `x-amz-server-side​-encryption​-customer-algorithm` header.
755
+ # `x-amz-server-side-encryption-customer-algorithm` header.
655
756
  # @option options [String] :sse_customer_key_md5
656
757
  # Specifies the 128-bit MD5 digest of the encryption key according to
657
758
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
@@ -692,6 +793,10 @@ module Aws::S3
692
793
  # @option options [String] :object_lock_legal_hold_status
693
794
  # Specifies whether you want to apply a Legal Hold to the uploaded
694
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.
695
800
  # @return [MultipartUpload]
696
801
  def initiate_multipart_upload(options = {})
697
802
  options = options.merge(
@@ -728,7 +833,7 @@ module Aws::S3
728
833
  # "MetadataKey" => "MetadataValue",
729
834
  # },
730
835
  # server_side_encryption: "AES256", # accepts AES256, aws:kms
731
- # 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
732
837
  # website_redirect_location: "WebsiteRedirectLocation",
733
838
  # sse_customer_algorithm: "SSECustomerAlgorithm",
734
839
  # sse_customer_key: "SSECustomerKey",
@@ -740,12 +845,15 @@ module Aws::S3
740
845
  # object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
741
846
  # object_lock_retain_until_date: Time.now,
742
847
  # object_lock_legal_hold_status: "ON", # accepts ON, OFF
848
+ # expected_bucket_owner: "AccountId",
743
849
  # })
744
850
  # @param [Hash] options ({})
745
851
  # @option options [String] :acl
746
852
  # The canned ACL to apply to the object. For more information, see
747
853
  # [Canned ACL][1].
748
854
  #
855
+ # This action is not supported by Amazon S3 on Outposts.
856
+ #
749
857
  #
750
858
  #
751
859
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
@@ -817,20 +925,36 @@ module Aws::S3
817
925
  # @option options [String] :grant_full_control
818
926
  # Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
819
927
  # object.
928
+ #
929
+ # This action is not supported by Amazon S3 on Outposts.
820
930
  # @option options [String] :grant_read
821
931
  # Allows grantee to read the object data and its metadata.
932
+ #
933
+ # This action is not supported by Amazon S3 on Outposts.
822
934
  # @option options [String] :grant_read_acp
823
935
  # Allows grantee to read the object ACL.
936
+ #
937
+ # This action is not supported by Amazon S3 on Outposts.
824
938
  # @option options [String] :grant_write_acp
825
939
  # Allows grantee to write the ACL for the applicable object.
940
+ #
941
+ # This action is not supported by Amazon S3 on Outposts.
826
942
  # @option options [Hash<String,String>] :metadata
827
943
  # A map of metadata to store with the object in S3.
828
944
  # @option options [String] :server_side_encryption
829
945
  # The server-side encryption algorithm used when storing this object in
830
946
  # Amazon S3 (for example, AES256, aws:kms).
831
947
  # @option options [String] :storage_class
832
- # If you don't specify, S3 Standard is the default storage class.
833
- # Amazon S3 supports other storage classes.
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
834
958
  # @option options [String] :website_redirect_location
835
959
  # If the bucket is configured as a website, redirects requests for this
836
960
  # object to another object in the same bucket or to an external URL.
@@ -864,7 +988,7 @@ module Aws::S3
864
988
  # encrypting data. This value is used to store the object and then it is
865
989
  # discarded; Amazon S3 does not store the encryption key. The key must
866
990
  # be appropriate for use with the algorithm specified in the
867
- # `x-amz-server-side​-encryption​-customer-algorithm` header.
991
+ # `x-amz-server-side-encryption-customer-algorithm` header.
868
992
  # @option options [String] :sse_customer_key_md5
869
993
  # Specifies the 128-bit MD5 digest of the encryption key according to
870
994
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
@@ -909,6 +1033,10 @@ module Aws::S3
909
1033
  #
910
1034
  #
911
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.
912
1040
  # @return [Types::PutObjectOutput]
913
1041
  def put(options = {})
914
1042
  options = options.merge(
@@ -1000,11 +1128,12 @@ module Aws::S3
1000
1128
  # value: "MetadataValue",
1001
1129
  # },
1002
1130
  # ],
1003
- # 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
1004
1132
  # },
1005
1133
  # },
1006
1134
  # },
1007
1135
  # request_payer: "requester", # accepts requester
1136
+ # expected_bucket_owner: "AccountId",
1008
1137
  # })
1009
1138
  # @param [Hash] options ({})
1010
1139
  # @option options [String] :version_id
@@ -1021,6 +1150,10 @@ module Aws::S3
1021
1150
  #
1022
1151
  #
1023
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.
1024
1157
  # @return [Types::RestoreObjectOutput]
1025
1158
  def restore_object(options = {})
1026
1159
  options = options.merge(
@@ -1152,6 +1285,7 @@ module Aws::S3
1152
1285
  # mfa: "MFA",
1153
1286
  # request_payer: "requester", # accepts requester
1154
1287
  # bypass_governance_retention: false,
1288
+ # expected_bucket_owner: "AccountId",
1155
1289
  # })
1156
1290
  # @param options ({})
1157
1291
  # @option options [String] :mfa
@@ -1173,6 +1307,10 @@ module Aws::S3
1173
1307
  # Specifies whether you want to delete this object even if it has a
1174
1308
  # Governance-type Object Lock in place. You must have sufficient
1175
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.
1176
1314
  # @return [void]
1177
1315
  def batch_delete!(options = {})
1178
1316
  batch_enum.each do |batch|
@@ -234,6 +234,7 @@ module Aws::S3
234
234
  # mfa: "MFA",
235
235
  # request_payer: "requester", # accepts requester
236
236
  # bypass_governance_retention: false,
237
+ # expected_bucket_owner: "AccountId",
237
238
  # })
238
239
  # @param [Hash] options ({})
239
240
  # @option options [String] :mfa
@@ -254,6 +255,10 @@ module Aws::S3
254
255
  # @option options [Boolean] :bypass_governance_retention
255
256
  # Indicates whether S3 Object Lock should bypass Governance-mode
256
257
  # restrictions to process this operation.
258
+ # @option options [String] :expected_bucket_owner
259
+ # The account id of the expected bucket owner. If the bucket is owned by
260
+ # a different account, the request will fail with an HTTP `403 (Access
261
+ # Denied)` error.
257
262
  # @return [Types::DeleteObjectOutput]
258
263
  def delete(options = {})
259
264
  options = options.merge(
@@ -284,6 +289,7 @@ module Aws::S3
284
289
  # sse_customer_key_md5: "SSECustomerKeyMD5",
285
290
  # request_payer: "requester", # accepts requester
286
291
  # part_number: 1,
292
+ # expected_bucket_owner: "AccountId",
287
293
  # })
288
294
  # @param [Hash] options ({})
289
295
  # @option options [String] :if_match
@@ -331,7 +337,7 @@ module Aws::S3
331
337
  # encrypting data. This value is used to store the object and then it is
332
338
  # discarded; Amazon S3 does not store the encryption key. The key must
333
339
  # be appropriate for use with the algorithm specified in the
334
- # `x-amz-server-side​-encryption​-customer-algorithm` header.
340
+ # `x-amz-server-side-encryption-customer-algorithm` header.
335
341
  # @option options [String] :sse_customer_key_md5
336
342
  # Specifies the 128-bit MD5 digest of the encryption key according to
337
343
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
@@ -351,6 +357,10 @@ module Aws::S3
351
357
  # between 1 and 10,000. Effectively performs a 'ranged' GET request
352
358
  # for the part specified. Useful for downloading just a part of an
353
359
  # object.
360
+ # @option options [String] :expected_bucket_owner
361
+ # The account id of the expected bucket owner. If the bucket is owned by
362
+ # a different account, the request will fail with an HTTP `403 (Access
363
+ # Denied)` error.
354
364
  # @return [Types::GetObjectOutput]
355
365
  def get(options = {}, &block)
356
366
  options = options.merge(
@@ -375,6 +385,7 @@ module Aws::S3
375
385
  # sse_customer_key_md5: "SSECustomerKeyMD5",
376
386
  # request_payer: "requester", # accepts requester
377
387
  # part_number: 1,
388
+ # expected_bucket_owner: "AccountId",
378
389
  # })
379
390
  # @param [Hash] options ({})
380
391
  # @option options [String] :if_match
@@ -392,12 +403,16 @@ module Aws::S3
392
403
  # @option options [String] :range
393
404
  # Downloads the specified range bytes of an object. For more information
394
405
  # about the HTTP Range header, see
395
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35]().
406
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
396
407
  #
397
408
  # <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
398
409
  # `GET` request.
399
410
  #
400
411
  # </note>
412
+ #
413
+ #
414
+ #
415
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
401
416
  # @option options [String] :sse_customer_algorithm
402
417
  # Specifies the algorithm to use to when encrypting the object (for
403
418
  # example, AES256).
@@ -406,7 +421,7 @@ module Aws::S3
406
421
  # encrypting data. This value is used to store the object and then it is
407
422
  # discarded; Amazon S3 does not store the encryption key. The key must
408
423
  # be appropriate for use with the algorithm specified in the
409
- # `x-amz-server-side​-encryption​-customer-algorithm` header.
424
+ # `x-amz-server-side-encryption-customer-algorithm` header.
410
425
  # @option options [String] :sse_customer_key_md5
411
426
  # Specifies the 128-bit MD5 digest of the encryption key according to
412
427
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
@@ -426,6 +441,10 @@ module Aws::S3
426
441
  # between 1 and 10,000. Effectively performs a 'ranged' HEAD request
427
442
  # for the part specified. Useful querying about the size of the part and
428
443
  # the number of parts in this object.
444
+ # @option options [String] :expected_bucket_owner
445
+ # The account id of the expected bucket owner. If the bucket is owned by
446
+ # a different account, the request will fail with an HTTP `403 (Access
447
+ # Denied)` error.
429
448
  # @return [Types::HeadObjectOutput]
430
449
  def head(options = {})
431
450
  options = options.merge(
@@ -504,6 +523,7 @@ module Aws::S3
504
523
  # mfa: "MFA",
505
524
  # request_payer: "requester", # accepts requester
506
525
  # bypass_governance_retention: false,
526
+ # expected_bucket_owner: "AccountId",
507
527
  # })
508
528
  # @param options ({})
509
529
  # @option options [String] :mfa
@@ -525,6 +545,10 @@ module Aws::S3
525
545
  # Specifies whether you want to delete this object even if it has a
526
546
  # Governance-type Object Lock in place. You must have sufficient
527
547
  # permissions to perform this operation.
548
+ # @option options [String] :expected_bucket_owner
549
+ # The account id of the expected bucket owner. If the bucket is owned by
550
+ # a different account, the request will fail with an HTTP `403 (Access
551
+ # Denied)` error.
528
552
  # @return [void]
529
553
  def batch_delete!(options = {})
530
554
  batch_enum.each do |batch|