aws-sdk-s3 1.78.0 → 1.87.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 +3 -2
- data/lib/aws-sdk-s3/arn/access_point_arn.rb +62 -0
- data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +71 -0
- data/lib/aws-sdk-s3/bucket.rb +65 -6
- data/lib/aws-sdk-s3/bucket_acl.rb +8 -0
- data/lib/aws-sdk-s3/bucket_cors.rb +15 -1
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +14 -1
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +12 -1
- data/lib/aws-sdk-s3/bucket_logging.rb +8 -0
- data/lib/aws-sdk-s3/bucket_notification.rb +5 -0
- data/lib/aws-sdk-s3/bucket_policy.rb +15 -1
- data/lib/aws-sdk-s3/bucket_request_payment.rb +8 -0
- data/lib/aws-sdk-s3/bucket_tagging.rb +15 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +24 -0
- data/lib/aws-sdk-s3/bucket_website.rb +15 -1
- data/lib/aws-sdk-s3/client.rb +2659 -778
- data/lib/aws-sdk-s3/client_api.rb +297 -20
- data/lib/aws-sdk-s3/customizations.rb +1 -1
- data/lib/aws-sdk-s3/customizations/bucket.rb +7 -4
- data/lib/aws-sdk-s3/customizations/object.rb +4 -3
- data/lib/aws-sdk-s3/errors.rb +21 -0
- data/lib/aws-sdk-s3/file_uploader.rb +1 -1
- data/lib/aws-sdk-s3/legacy_signer.rb +15 -25
- 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 +212 -24
- data/lib/aws-sdk-s3/object_acl.rb +16 -0
- data/lib/aws-sdk-s3/object_summary.rb +179 -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/iad_regional_endpoint.rb +7 -2
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +29 -7
- data/lib/aws-sdk-s3/presigned_post.rb +1 -0
- data/lib/aws-sdk-s3/presigner.rb +19 -5
- data/lib/aws-sdk-s3/types.rb +2301 -287
- 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
|
@@ -246,21 +247,32 @@ module Aws::S3
|
|
246
247
|
# not corrupted in transit. For more information, go to [RFC
|
247
248
|
# 1864.>][1]
|
248
249
|
#
|
250
|
+
# For requests made using the AWS Command Line Interface (CLI) or AWS
|
251
|
+
# SDKs, this field is calculated automatically.
|
252
|
+
#
|
249
253
|
#
|
250
254
|
#
|
251
255
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
252
256
|
# @option options [String] :grant_full_control
|
253
257
|
# Allows grantee the read, write, read ACP, and write ACP permissions on
|
254
258
|
# the bucket.
|
259
|
+
#
|
260
|
+
# This action is not supported by Amazon S3 on Outposts.
|
255
261
|
# @option options [String] :grant_read
|
256
262
|
# Allows grantee to list the objects in the bucket.
|
263
|
+
#
|
264
|
+
# This action is not supported by Amazon S3 on Outposts.
|
257
265
|
# @option options [String] :grant_read_acp
|
258
266
|
# Allows grantee to read the bucket ACL.
|
267
|
+
#
|
268
|
+
# This action is not supported by Amazon S3 on Outposts.
|
259
269
|
# @option options [String] :grant_write
|
260
270
|
# Allows grantee to create, overwrite, and delete any object in the
|
261
271
|
# bucket.
|
262
272
|
# @option options [String] :grant_write_acp
|
263
273
|
# Allows grantee to write the ACL for the applicable bucket.
|
274
|
+
#
|
275
|
+
# This action is not supported by Amazon S3 on Outposts.
|
264
276
|
# @option options [String] :request_payer
|
265
277
|
# Confirms that the requester knows that they will be charged for the
|
266
278
|
# request. Bucket owners need not specify this parameter in their
|
@@ -273,6 +285,10 @@ module Aws::S3
|
|
273
285
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
274
286
|
# @option options [String] :version_id
|
275
287
|
# VersionId used to reference a specific version of the object.
|
288
|
+
# @option options [String] :expected_bucket_owner
|
289
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
290
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
291
|
+
# Denied)` error.
|
276
292
|
# @return [Types::PutObjectAclOutput]
|
277
293
|
def put(options = {})
|
278
294
|
options = options.merge(
|
@@ -295,13 +295,14 @@ 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",
|
302
302
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
303
303
|
# ssekms_key_id: "SSEKMSKeyId",
|
304
304
|
# ssekms_encryption_context: "SSEKMSEncryptionContext",
|
305
|
+
# bucket_key_enabled: false,
|
305
306
|
# copy_source_sse_customer_algorithm: "CopySourceSSECustomerAlgorithm",
|
306
307
|
# copy_source_sse_customer_key: "CopySourceSSECustomerKey",
|
307
308
|
# copy_source_sse_customer_key_md5: "CopySourceSSECustomerKeyMD5",
|
@@ -310,10 +311,14 @@ module Aws::S3
|
|
310
311
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
311
312
|
# object_lock_retain_until_date: Time.now,
|
312
313
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
314
|
+
# expected_bucket_owner: "AccountId",
|
315
|
+
# expected_source_bucket_owner: "AccountId",
|
313
316
|
# })
|
314
317
|
# @param [Hash] options ({})
|
315
318
|
# @option options [String] :acl
|
316
319
|
# The canned ACL to apply to the object.
|
320
|
+
#
|
321
|
+
# This action is not supported by Amazon S3 on Outposts.
|
317
322
|
# @option options [String] :cache_control
|
318
323
|
# Specifies caching behavior along the request/reply chain.
|
319
324
|
# @option options [String] :content_disposition
|
@@ -327,8 +332,50 @@ module Aws::S3
|
|
327
332
|
# @option options [String] :content_type
|
328
333
|
# A standard MIME type describing the format of the object data.
|
329
334
|
# @option options [required, String] :copy_source
|
330
|
-
#
|
331
|
-
#
|
335
|
+
# Specifies the source object for the copy operation. You specify the
|
336
|
+
# value in one of two formats, depending on whether you want to access
|
337
|
+
# the source object through an [access point][1]\:
|
338
|
+
#
|
339
|
+
# * For objects not accessed through an access point, specify the name
|
340
|
+
# of the source bucket and the key of the source object, separated by
|
341
|
+
# a slash (/). For example, to copy the object `reports/january.pdf`
|
342
|
+
# from the bucket `awsexamplebucket`, use
|
343
|
+
# `awsexamplebucket/reports/january.pdf`. The value must be URL
|
344
|
+
# encoded.
|
345
|
+
#
|
346
|
+
# * For objects accessed through access points, specify the Amazon
|
347
|
+
# Resource Name (ARN) of the object as accessed through the access
|
348
|
+
# point, in the format
|
349
|
+
# `arn:aws:s3:<Region>:<account-id>:accesspoint/<access-point-name>/object/<key>`.
|
350
|
+
# For example, to copy the object `reports/january.pdf` through access
|
351
|
+
# point `my-access-point` owned by account `123456789012` in Region
|
352
|
+
# `us-west-2`, use the URL encoding of
|
353
|
+
# `arn:aws:s3:us-west-2:123456789012:accesspoint/my-access-point/object/reports/january.pdf`.
|
354
|
+
# The value must be URL encoded.
|
355
|
+
#
|
356
|
+
# <note markdown="1"> Amazon S3 supports copy operations using access points only when the
|
357
|
+
# source and destination buckets are in the same AWS Region.
|
358
|
+
#
|
359
|
+
# </note>
|
360
|
+
#
|
361
|
+
# Alternatively, for objects accessed through Amazon S3 on Outposts,
|
362
|
+
# specify the ARN of the object as accessed in the format
|
363
|
+
# `arn:aws:s3-outposts:<Region>:<account-id>:outpost/<outpost-id>/object/<key>`.
|
364
|
+
# For example, to copy the object `reports/january.pdf` through
|
365
|
+
# outpost `my-outpost` owned by account `123456789012` in Region
|
366
|
+
# `us-west-2`, use the URL encoding of
|
367
|
+
# `arn:aws:s3-outposts:us-west-2:123456789012:outpost/my-outpost/object/reports/january.pdf`.
|
368
|
+
# The value must be URL encoded.
|
369
|
+
#
|
370
|
+
# To copy a specific version of an object, append
|
371
|
+
# `?versionId=<version-id>` to the value (for example,
|
372
|
+
# `awsexamplebucket/reports/january.pdf?versionId=QUpfdndhfd8438MNFDN93jdnJFkdmqnh893`).
|
373
|
+
# If you don't specify a version ID, Amazon S3 copies the latest
|
374
|
+
# version of the source object.
|
375
|
+
#
|
376
|
+
#
|
377
|
+
#
|
378
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
|
332
379
|
# @option options [String] :copy_source_if_match
|
333
380
|
# Copies the object if its entity tag (ETag) matches the specified tag.
|
334
381
|
# @option options [Time,DateTime,Date,Integer,String] :copy_source_if_modified_since
|
@@ -344,12 +391,20 @@ module Aws::S3
|
|
344
391
|
# @option options [String] :grant_full_control
|
345
392
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
346
393
|
# object.
|
394
|
+
#
|
395
|
+
# This action is not supported by Amazon S3 on Outposts.
|
347
396
|
# @option options [String] :grant_read
|
348
397
|
# Allows grantee to read the object data and its metadata.
|
398
|
+
#
|
399
|
+
# This action is not supported by Amazon S3 on Outposts.
|
349
400
|
# @option options [String] :grant_read_acp
|
350
401
|
# Allows grantee to read the object ACL.
|
402
|
+
#
|
403
|
+
# This action is not supported by Amazon S3 on Outposts.
|
351
404
|
# @option options [String] :grant_write_acp
|
352
405
|
# Allows grantee to write the ACL for the applicable object.
|
406
|
+
#
|
407
|
+
# This action is not supported by Amazon S3 on Outposts.
|
353
408
|
# @option options [Hash<String,String>] :metadata
|
354
409
|
# A map of metadata to store with the object in S3.
|
355
410
|
# @option options [String] :metadata_directive
|
@@ -362,7 +417,16 @@ module Aws::S3
|
|
362
417
|
# The server-side encryption algorithm used when storing this object in
|
363
418
|
# Amazon S3 (for example, AES256, aws:kms).
|
364
419
|
# @option options [String] :storage_class
|
365
|
-
#
|
420
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
421
|
+
# created objects. The STANDARD storage class provides high durability
|
422
|
+
# and high availability. Depending on performance needs, you can specify
|
423
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
424
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
425
|
+
# in the *Amazon S3 Service Developer Guide*.
|
426
|
+
#
|
427
|
+
#
|
428
|
+
#
|
429
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
366
430
|
# @option options [String] :website_redirect_location
|
367
431
|
# If the bucket is configured as a website, redirects requests for this
|
368
432
|
# object to another object in the same bucket or to an external URL.
|
@@ -375,7 +439,7 @@ module Aws::S3
|
|
375
439
|
# encrypting data. This value is used to store the object and then it is
|
376
440
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
377
441
|
# be appropriate for use with the algorithm specified in the
|
378
|
-
# `x-amz-server-side
|
442
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
379
443
|
# @option options [String] :sse_customer_key_md5
|
380
444
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
381
445
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
@@ -395,6 +459,14 @@ module Aws::S3
|
|
395
459
|
# Specifies the AWS KMS Encryption Context to use for object encryption.
|
396
460
|
# The value of this header is a base64-encoded UTF-8 string holding JSON
|
397
461
|
# with the encryption context key-value pairs.
|
462
|
+
# @option options [Boolean] :bucket_key_enabled
|
463
|
+
# Specifies whether Amazon S3 should use an S3 Bucket Key for object
|
464
|
+
# encryption with server-side encryption using AWS KMS (SSE-KMS).
|
465
|
+
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
466
|
+
# for object encryption with SSE-KMS.
|
467
|
+
#
|
468
|
+
# Specifying this header with a COPY operation doesn’t affect
|
469
|
+
# bucket-level settings for S3 Bucket Key.
|
398
470
|
# @option options [String] :copy_source_sse_customer_algorithm
|
399
471
|
# Specifies the algorithm to use when decrypting the source object (for
|
400
472
|
# example, AES256).
|
@@ -427,6 +499,14 @@ module Aws::S3
|
|
427
499
|
# expire.
|
428
500
|
# @option options [String] :object_lock_legal_hold_status
|
429
501
|
# Specifies whether you want to apply a Legal Hold to the copied object.
|
502
|
+
# @option options [String] :expected_bucket_owner
|
503
|
+
# The account id of the expected destination bucket owner. If the
|
504
|
+
# destination bucket is owned by a different account, the request will
|
505
|
+
# fail with an HTTP `403 (Access Denied)` error.
|
506
|
+
# @option options [String] :expected_source_bucket_owner
|
507
|
+
# The account id of the expected source bucket owner. If the source
|
508
|
+
# bucket is owned by a different account, the request will fail with an
|
509
|
+
# HTTP `403 (Access Denied)` error.
|
430
510
|
# @return [Types::CopyObjectOutput]
|
431
511
|
def copy_from(options = {})
|
432
512
|
options = options.merge(
|
@@ -444,6 +524,7 @@ module Aws::S3
|
|
444
524
|
# version_id: "ObjectVersionId",
|
445
525
|
# request_payer: "requester", # accepts requester
|
446
526
|
# bypass_governance_retention: false,
|
527
|
+
# expected_bucket_owner: "AccountId",
|
447
528
|
# })
|
448
529
|
# @param [Hash] options ({})
|
449
530
|
# @option options [String] :mfa
|
@@ -466,6 +547,10 @@ module Aws::S3
|
|
466
547
|
# @option options [Boolean] :bypass_governance_retention
|
467
548
|
# Indicates whether S3 Object Lock should bypass Governance-mode
|
468
549
|
# restrictions to process this operation.
|
550
|
+
# @option options [String] :expected_bucket_owner
|
551
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
552
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
553
|
+
# Denied)` error.
|
469
554
|
# @return [Types::DeleteObjectOutput]
|
470
555
|
def delete(options = {})
|
471
556
|
options = options.merge(
|
@@ -496,6 +581,7 @@ module Aws::S3
|
|
496
581
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
497
582
|
# request_payer: "requester", # accepts requester
|
498
583
|
# part_number: 1,
|
584
|
+
# expected_bucket_owner: "AccountId",
|
499
585
|
# })
|
500
586
|
# @param [Hash] options ({})
|
501
587
|
# @option options [String] :if_match
|
@@ -545,7 +631,7 @@ module Aws::S3
|
|
545
631
|
# encrypting data. This value is used to store the object and then it is
|
546
632
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
547
633
|
# be appropriate for use with the algorithm specified in the
|
548
|
-
# `x-amz-server-side
|
634
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
549
635
|
# @option options [String] :sse_customer_key_md5
|
550
636
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
551
637
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
@@ -565,6 +651,10 @@ module Aws::S3
|
|
565
651
|
# between 1 and 10,000. Effectively performs a 'ranged' GET request
|
566
652
|
# for the part specified. Useful for downloading just a part of an
|
567
653
|
# object.
|
654
|
+
# @option options [String] :expected_bucket_owner
|
655
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
656
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
657
|
+
# Denied)` error.
|
568
658
|
# @return [Types::GetObjectOutput]
|
569
659
|
def get(options = {}, &block)
|
570
660
|
options = options.merge(
|
@@ -593,22 +683,26 @@ module Aws::S3
|
|
593
683
|
# "MetadataKey" => "MetadataValue",
|
594
684
|
# },
|
595
685
|
# 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
|
686
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
597
687
|
# website_redirect_location: "WebsiteRedirectLocation",
|
598
688
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
599
689
|
# sse_customer_key: "SSECustomerKey",
|
600
690
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
601
691
|
# ssekms_key_id: "SSEKMSKeyId",
|
602
692
|
# ssekms_encryption_context: "SSEKMSEncryptionContext",
|
693
|
+
# bucket_key_enabled: false,
|
603
694
|
# request_payer: "requester", # accepts requester
|
604
695
|
# tagging: "TaggingHeader",
|
605
696
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
606
697
|
# object_lock_retain_until_date: Time.now,
|
607
698
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
699
|
+
# expected_bucket_owner: "AccountId",
|
608
700
|
# })
|
609
701
|
# @param [Hash] options ({})
|
610
702
|
# @option options [String] :acl
|
611
703
|
# The canned ACL to apply to the object.
|
704
|
+
#
|
705
|
+
# This action is not supported by Amazon S3 on Outposts.
|
612
706
|
# @option options [String] :cache_control
|
613
707
|
# Specifies caching behavior along the request/reply chain.
|
614
708
|
# @option options [String] :content_disposition
|
@@ -626,19 +720,36 @@ module Aws::S3
|
|
626
720
|
# @option options [String] :grant_full_control
|
627
721
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
628
722
|
# object.
|
723
|
+
#
|
724
|
+
# This action is not supported by Amazon S3 on Outposts.
|
629
725
|
# @option options [String] :grant_read
|
630
726
|
# Allows grantee to read the object data and its metadata.
|
727
|
+
#
|
728
|
+
# This action is not supported by Amazon S3 on Outposts.
|
631
729
|
# @option options [String] :grant_read_acp
|
632
730
|
# Allows grantee to read the object ACL.
|
731
|
+
#
|
732
|
+
# This action is not supported by Amazon S3 on Outposts.
|
633
733
|
# @option options [String] :grant_write_acp
|
634
734
|
# Allows grantee to write the ACL for the applicable object.
|
735
|
+
#
|
736
|
+
# This action is not supported by Amazon S3 on Outposts.
|
635
737
|
# @option options [Hash<String,String>] :metadata
|
636
738
|
# A map of metadata to store with the object in S3.
|
637
739
|
# @option options [String] :server_side_encryption
|
638
740
|
# The server-side encryption algorithm used when storing this object in
|
639
741
|
# Amazon S3 (for example, AES256, aws:kms).
|
640
742
|
# @option options [String] :storage_class
|
641
|
-
#
|
743
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
744
|
+
# created objects. The STANDARD storage class provides high durability
|
745
|
+
# and high availability. Depending on performance needs, you can specify
|
746
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
747
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
748
|
+
# in the *Amazon S3 Service Developer Guide*.
|
749
|
+
#
|
750
|
+
#
|
751
|
+
#
|
752
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
642
753
|
# @option options [String] :website_redirect_location
|
643
754
|
# If the bucket is configured as a website, redirects requests for this
|
644
755
|
# object to another object in the same bucket or to an external URL.
|
@@ -651,7 +762,7 @@ module Aws::S3
|
|
651
762
|
# encrypting data. This value is used to store the object and then it is
|
652
763
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
653
764
|
# be appropriate for use with the algorithm specified in the
|
654
|
-
# `x-amz-server-side
|
765
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
655
766
|
# @option options [String] :sse_customer_key_md5
|
656
767
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
657
768
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
@@ -671,6 +782,14 @@ module Aws::S3
|
|
671
782
|
# Specifies the AWS KMS Encryption Context to use for object encryption.
|
672
783
|
# The value of this header is a base64-encoded UTF-8 string holding JSON
|
673
784
|
# with the encryption context key-value pairs.
|
785
|
+
# @option options [Boolean] :bucket_key_enabled
|
786
|
+
# Specifies whether Amazon S3 should use an S3 Bucket Key for object
|
787
|
+
# encryption with server-side encryption using AWS KMS (SSE-KMS).
|
788
|
+
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
789
|
+
# for object encryption with SSE-KMS.
|
790
|
+
#
|
791
|
+
# Specifying this header with an object operation doesn’t affect
|
792
|
+
# bucket-level settings for S3 Bucket Key.
|
674
793
|
# @option options [String] :request_payer
|
675
794
|
# Confirms that the requester knows that they will be charged for the
|
676
795
|
# request. Bucket owners need not specify this parameter in their
|
@@ -692,6 +811,10 @@ module Aws::S3
|
|
692
811
|
# @option options [String] :object_lock_legal_hold_status
|
693
812
|
# Specifies whether you want to apply a Legal Hold to the uploaded
|
694
813
|
# object.
|
814
|
+
# @option options [String] :expected_bucket_owner
|
815
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
816
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
817
|
+
# Denied)` error.
|
695
818
|
# @return [MultipartUpload]
|
696
819
|
def initiate_multipart_upload(options = {})
|
697
820
|
options = options.merge(
|
@@ -728,24 +851,28 @@ module Aws::S3
|
|
728
851
|
# "MetadataKey" => "MetadataValue",
|
729
852
|
# },
|
730
853
|
# 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
|
854
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
732
855
|
# website_redirect_location: "WebsiteRedirectLocation",
|
733
856
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
734
857
|
# sse_customer_key: "SSECustomerKey",
|
735
858
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
736
859
|
# ssekms_key_id: "SSEKMSKeyId",
|
737
860
|
# ssekms_encryption_context: "SSEKMSEncryptionContext",
|
861
|
+
# bucket_key_enabled: false,
|
738
862
|
# request_payer: "requester", # accepts requester
|
739
863
|
# tagging: "TaggingHeader",
|
740
864
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
741
865
|
# object_lock_retain_until_date: Time.now,
|
742
866
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
867
|
+
# expected_bucket_owner: "AccountId",
|
743
868
|
# })
|
744
869
|
# @param [Hash] options ({})
|
745
870
|
# @option options [String] :acl
|
746
871
|
# The canned ACL to apply to the object. For more information, see
|
747
872
|
# [Canned ACL][1].
|
748
873
|
#
|
874
|
+
# This action is not supported by Amazon S3 on Outposts.
|
875
|
+
#
|
749
876
|
#
|
750
877
|
#
|
751
878
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
@@ -817,20 +944,36 @@ module Aws::S3
|
|
817
944
|
# @option options [String] :grant_full_control
|
818
945
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
819
946
|
# object.
|
947
|
+
#
|
948
|
+
# This action is not supported by Amazon S3 on Outposts.
|
820
949
|
# @option options [String] :grant_read
|
821
950
|
# Allows grantee to read the object data and its metadata.
|
951
|
+
#
|
952
|
+
# This action is not supported by Amazon S3 on Outposts.
|
822
953
|
# @option options [String] :grant_read_acp
|
823
954
|
# Allows grantee to read the object ACL.
|
955
|
+
#
|
956
|
+
# This action is not supported by Amazon S3 on Outposts.
|
824
957
|
# @option options [String] :grant_write_acp
|
825
958
|
# Allows grantee to write the ACL for the applicable object.
|
959
|
+
#
|
960
|
+
# This action is not supported by Amazon S3 on Outposts.
|
826
961
|
# @option options [Hash<String,String>] :metadata
|
827
962
|
# A map of metadata to store with the object in S3.
|
828
963
|
# @option options [String] :server_side_encryption
|
829
964
|
# The server-side encryption algorithm used when storing this object in
|
830
965
|
# Amazon S3 (for example, AES256, aws:kms).
|
831
966
|
# @option options [String] :storage_class
|
832
|
-
#
|
833
|
-
#
|
967
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
968
|
+
# created objects. The STANDARD storage class provides high durability
|
969
|
+
# and high availability. Depending on performance needs, you can specify
|
970
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
971
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
972
|
+
# in the *Amazon S3 Service Developer Guide*.
|
973
|
+
#
|
974
|
+
#
|
975
|
+
#
|
976
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
834
977
|
# @option options [String] :website_redirect_location
|
835
978
|
# If the bucket is configured as a website, redirects requests for this
|
836
979
|
# object to another object in the same bucket or to an external URL.
|
@@ -864,7 +1007,7 @@ module Aws::S3
|
|
864
1007
|
# encrypting data. This value is used to store the object and then it is
|
865
1008
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
866
1009
|
# be appropriate for use with the algorithm specified in the
|
867
|
-
# `x-amz-server-side
|
1010
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
868
1011
|
# @option options [String] :sse_customer_key_md5
|
869
1012
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
870
1013
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
@@ -885,6 +1028,14 @@ module Aws::S3
|
|
885
1028
|
# Specifies the AWS KMS Encryption Context to use for object encryption.
|
886
1029
|
# The value of this header is a base64-encoded UTF-8 string holding JSON
|
887
1030
|
# with the encryption context key-value pairs.
|
1031
|
+
# @option options [Boolean] :bucket_key_enabled
|
1032
|
+
# Specifies whether Amazon S3 should use an S3 Bucket Key for object
|
1033
|
+
# encryption with server-side encryption using AWS KMS (SSE-KMS).
|
1034
|
+
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
1035
|
+
# for object encryption with SSE-KMS.
|
1036
|
+
#
|
1037
|
+
# Specifying this header with a PUT operation doesn’t affect
|
1038
|
+
# bucket-level settings for S3 Bucket Key.
|
888
1039
|
# @option options [String] :request_payer
|
889
1040
|
# Confirms that the requester knows that they will be charged for the
|
890
1041
|
# request. Bucket owners need not specify this parameter in their
|
@@ -909,6 +1060,10 @@ module Aws::S3
|
|
909
1060
|
#
|
910
1061
|
#
|
911
1062
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
1063
|
+
# @option options [String] :expected_bucket_owner
|
1064
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
1065
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
1066
|
+
# Denied)` error.
|
912
1067
|
# @return [Types::PutObjectOutput]
|
913
1068
|
def put(options = {})
|
914
1069
|
options = options.merge(
|
@@ -1000,11 +1155,12 @@ module Aws::S3
|
|
1000
1155
|
# value: "MetadataValue",
|
1001
1156
|
# },
|
1002
1157
|
# ],
|
1003
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE
|
1158
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
1004
1159
|
# },
|
1005
1160
|
# },
|
1006
1161
|
# },
|
1007
1162
|
# request_payer: "requester", # accepts requester
|
1163
|
+
# expected_bucket_owner: "AccountId",
|
1008
1164
|
# })
|
1009
1165
|
# @param [Hash] options ({})
|
1010
1166
|
# @option options [String] :version_id
|
@@ -1021,6 +1177,10 @@ module Aws::S3
|
|
1021
1177
|
#
|
1022
1178
|
#
|
1023
1179
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
1180
|
+
# @option options [String] :expected_bucket_owner
|
1181
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
1182
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
1183
|
+
# Denied)` error.
|
1024
1184
|
# @return [Types::RestoreObjectOutput]
|
1025
1185
|
def restore_object(options = {})
|
1026
1186
|
options = options.merge(
|
@@ -1152,6 +1312,7 @@ module Aws::S3
|
|
1152
1312
|
# mfa: "MFA",
|
1153
1313
|
# request_payer: "requester", # accepts requester
|
1154
1314
|
# bypass_governance_retention: false,
|
1315
|
+
# expected_bucket_owner: "AccountId",
|
1155
1316
|
# })
|
1156
1317
|
# @param options ({})
|
1157
1318
|
# @option options [String] :mfa
|
@@ -1173,6 +1334,10 @@ module Aws::S3
|
|
1173
1334
|
# Specifies whether you want to delete this object even if it has a
|
1174
1335
|
# Governance-type Object Lock in place. You must have sufficient
|
1175
1336
|
# permissions to perform this operation.
|
1337
|
+
# @option options [String] :expected_bucket_owner
|
1338
|
+
# The account id of the expected bucket owner. If the bucket is owned by
|
1339
|
+
# a different account, the request will fail with an HTTP `403 (Access
|
1340
|
+
# Denied)` error.
|
1176
1341
|
# @return [void]
|
1177
1342
|
def batch_delete!(options = {})
|
1178
1343
|
batch_enum.each do |batch|
|