aws-sdk-s3 1.79.1 → 1.83.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 +2 -1
- 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 +54 -5
- data/lib/aws-sdk-s3/bucket_acl.rb +5 -0
- data/lib/aws-sdk-s3/bucket_cors.rb +12 -1
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +12 -1
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +12 -1
- data/lib/aws-sdk-s3/bucket_logging.rb +5 -0
- data/lib/aws-sdk-s3/bucket_notification.rb +5 -0
- data/lib/aws-sdk-s3/bucket_policy.rb +12 -1
- data/lib/aws-sdk-s3/bucket_request_payment.rb +5 -0
- data/lib/aws-sdk-s3/bucket_tagging.rb +12 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +15 -0
- data/lib/aws-sdk-s3/bucket_website.rb +12 -1
- data/lib/aws-sdk-s3/client.rb +2009 -586
- data/lib/aws-sdk-s3/client_api.rb +148 -0
- data/lib/aws-sdk-s3/customizations/bucket.rb +7 -4
- data/lib/aws-sdk-s3/multipart_upload.rb +15 -0
- data/lib/aws-sdk-s3/multipart_upload_part.rb +63 -6
- data/lib/aws-sdk-s3/object.rb +157 -18
- data/lib/aws-sdk-s3/object_acl.rb +13 -0
- data/lib/aws-sdk-s3/object_summary.rb +152 -14
- data/lib/aws-sdk-s3/object_version.rb +27 -3
- data/lib/aws-sdk-s3/plugins/arn.rb +187 -0
- data/lib/aws-sdk-s3/plugins/bucket_dns.rb +0 -2
- data/lib/aws-sdk-s3/plugins/bucket_name_restrictions.rb +1 -1
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +29 -7
- data/lib/aws-sdk-s3/presigner.rb +1 -0
- data/lib/aws-sdk-s3/types.rb +1591 -214
- metadata +7 -5
- data/lib/aws-sdk-s3/plugins/bucket_arn.rb +0 -212
@@ -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
|
-
#
|
331
|
-
#
|
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
|
-
#
|
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
|
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
|
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
|
-
#
|
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
|
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
|
-
#
|
833
|
-
#
|
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
|
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
|
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
|
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|
|