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.
- 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|
|