aws-sdk-s3 1.86.2 → 1.116.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/CHANGELOG.md +913 -0
- data/LICENSE.txt +202 -0
- data/VERSION +1 -0
- data/lib/aws-sdk-s3/arn/access_point_arn.rb +19 -12
- data/lib/aws-sdk-s3/arn/multi_region_access_point_arn.rb +68 -0
- data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +69 -0
- data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +15 -12
- data/lib/aws-sdk-s3/bucket.rb +145 -47
- data/lib/aws-sdk-s3/bucket_acl.rb +27 -8
- data/lib/aws-sdk-s3/bucket_cors.rb +28 -11
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +30 -11
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +31 -9
- data/lib/aws-sdk-s3/bucket_logging.rb +24 -8
- data/lib/aws-sdk-s3/bucket_notification.rb +21 -9
- data/lib/aws-sdk-s3/bucket_policy.rb +26 -9
- data/lib/aws-sdk-s3/bucket_request_payment.rb +26 -10
- data/lib/aws-sdk-s3/bucket_tagging.rb +26 -9
- data/lib/aws-sdk-s3/bucket_versioning.rb +67 -16
- data/lib/aws-sdk-s3/bucket_website.rb +26 -9
- data/lib/aws-sdk-s3/client.rb +3633 -1862
- data/lib/aws-sdk-s3/client_api.rb +546 -116
- data/lib/aws-sdk-s3/customizations/bucket.rb +8 -3
- data/lib/aws-sdk-s3/customizations/object.rb +116 -18
- data/lib/aws-sdk-s3/encryption/client.rb +1 -1
- data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/encryptionV2/client.rb +1 -1
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +3 -3
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/errors.rb +1 -1
- data/lib/aws-sdk-s3/event_streams.rb +1 -1
- data/lib/aws-sdk-s3/file_downloader.rb +7 -2
- data/lib/aws-sdk-s3/file_uploader.rb +8 -3
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +26 -7
- data/lib/aws-sdk-s3/multipart_upload.rb +133 -19
- data/lib/aws-sdk-s3/multipart_upload_part.rb +141 -21
- data/lib/aws-sdk-s3/object.rb +391 -130
- data/lib/aws-sdk-s3/object_acl.rb +30 -11
- data/lib/aws-sdk-s3/object_summary.rb +243 -115
- data/lib/aws-sdk-s3/object_version.rb +80 -53
- data/lib/aws-sdk-s3/plugins/accelerate.rb +13 -4
- data/lib/aws-sdk-s3/plugins/arn.rb +125 -58
- data/lib/aws-sdk-s3/plugins/bucket_dns.rb +1 -1
- data/lib/aws-sdk-s3/plugins/dualstack.rb +33 -32
- data/lib/aws-sdk-s3/plugins/expect_100_continue.rb +2 -1
- data/lib/aws-sdk-s3/plugins/get_bucket_location_fix.rb +1 -1
- data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +17 -11
- data/lib/aws-sdk-s3/plugins/md5s.rb +5 -3
- data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +25 -0
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +55 -28
- data/lib/aws-sdk-s3/plugins/skip_whole_multipart_get_checksums.rb +31 -0
- data/lib/aws-sdk-s3/plugins/streaming_retry.rb +23 -2
- data/lib/aws-sdk-s3/presigned_post.rb +38 -19
- data/lib/aws-sdk-s3/presigner.rb +33 -30
- data/lib/aws-sdk-s3/resource.rb +24 -4
- data/lib/aws-sdk-s3/types.rb +3777 -1306
- data/lib/aws-sdk-s3/waiters.rb +1 -1
- data/lib/aws-sdk-s3.rb +2 -2
- metadata +20 -14
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -223,7 +223,7 @@ module Aws::S3
|
|
223
223
|
# bucket.create({
|
224
224
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
225
225
|
# create_bucket_configuration: {
|
226
|
-
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
226
|
+
# location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ap-southeast-3, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
|
227
227
|
# },
|
228
228
|
# grant_full_control: "GrantFullControl",
|
229
229
|
# grant_read: "GrantRead",
|
@@ -231,6 +231,7 @@ module Aws::S3
|
|
231
231
|
# grant_write: "GrantWrite",
|
232
232
|
# grant_write_acp: "GrantWriteACP",
|
233
233
|
# object_lock_enabled_for_bucket: false,
|
234
|
+
# object_ownership: "BucketOwnerPreferred", # accepts BucketOwnerPreferred, ObjectWriter, BucketOwnerEnforced
|
234
235
|
# })
|
235
236
|
# @param [Hash] options ({})
|
236
237
|
# @option options [String] :acl
|
@@ -245,13 +246,32 @@ module Aws::S3
|
|
245
246
|
# @option options [String] :grant_read_acp
|
246
247
|
# Allows grantee to read the bucket ACL.
|
247
248
|
# @option options [String] :grant_write
|
248
|
-
# Allows grantee to create
|
249
|
-
#
|
249
|
+
# Allows grantee to create new objects in the bucket.
|
250
|
+
#
|
251
|
+
# For the bucket and object owners of existing objects, also allows
|
252
|
+
# deletions and overwrites of those objects.
|
250
253
|
# @option options [String] :grant_write_acp
|
251
254
|
# Allows grantee to write the ACL for the applicable bucket.
|
252
255
|
# @option options [Boolean] :object_lock_enabled_for_bucket
|
253
256
|
# Specifies whether you want S3 Object Lock to be enabled for the new
|
254
257
|
# bucket.
|
258
|
+
# @option options [String] :object_ownership
|
259
|
+
# The container element for object ownership for a bucket's ownership
|
260
|
+
# controls.
|
261
|
+
#
|
262
|
+
# BucketOwnerPreferred - Objects uploaded to the bucket change ownership
|
263
|
+
# to the bucket owner if the objects are uploaded with the
|
264
|
+
# `bucket-owner-full-control` canned ACL.
|
265
|
+
#
|
266
|
+
# ObjectWriter - The uploading account will own the object if the object
|
267
|
+
# is uploaded with the `bucket-owner-full-control` canned ACL.
|
268
|
+
#
|
269
|
+
# BucketOwnerEnforced - Access control lists (ACLs) are disabled and no
|
270
|
+
# longer affect permissions. The bucket owner automatically owns and has
|
271
|
+
# full control over every object in the bucket. The bucket only accepts
|
272
|
+
# PUT requests that don't specify an ACL or bucket owner full control
|
273
|
+
# ACLs, such as the `bucket-owner-full-control` canned ACL or an
|
274
|
+
# equivalent form of this ACL expressed in the XML format.
|
255
275
|
# @return [Types::CreateBucketOutput]
|
256
276
|
def create(options = {})
|
257
277
|
options = options.merge(bucket: @name)
|
@@ -266,9 +286,9 @@ module Aws::S3
|
|
266
286
|
# })
|
267
287
|
# @param [Hash] options ({})
|
268
288
|
# @option options [String] :expected_bucket_owner
|
269
|
-
# The account
|
270
|
-
# a different account, the request
|
271
|
-
#
|
289
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
290
|
+
# a different account, the request fails with the HTTP status code `403
|
291
|
+
# Forbidden` (access denied).
|
272
292
|
# @return [EmptyStructure]
|
273
293
|
def delete(options = {})
|
274
294
|
options = options.merge(bucket: @name)
|
@@ -292,6 +312,7 @@ module Aws::S3
|
|
292
312
|
# request_payer: "requester", # accepts requester
|
293
313
|
# bypass_governance_retention: false,
|
294
314
|
# expected_bucket_owner: "AccountId",
|
315
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
295
316
|
# })
|
296
317
|
# @param [Hash] options ({})
|
297
318
|
# @option options [required, Types::Delete] :delete
|
@@ -304,21 +325,39 @@ module Aws::S3
|
|
304
325
|
# @option options [String] :request_payer
|
305
326
|
# Confirms that the requester knows that they will be charged for the
|
306
327
|
# request. Bucket owners need not specify this parameter in their
|
307
|
-
# requests. For information about downloading objects from
|
308
|
-
#
|
309
|
-
# in the *Amazon S3
|
328
|
+
# requests. For information about downloading objects from Requester
|
329
|
+
# Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
|
330
|
+
# in the *Amazon S3 User Guide*.
|
310
331
|
#
|
311
332
|
#
|
312
333
|
#
|
313
334
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
314
335
|
# @option options [Boolean] :bypass_governance_retention
|
315
336
|
# Specifies whether you want to delete this object even if it has a
|
316
|
-
# Governance-type Object Lock in place.
|
317
|
-
#
|
337
|
+
# Governance-type Object Lock in place. To use this header, you must
|
338
|
+
# have the `s3:BypassGovernanceRetention` permission.
|
318
339
|
# @option options [String] :expected_bucket_owner
|
319
|
-
# The account
|
320
|
-
# a different account, the request
|
321
|
-
#
|
340
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
341
|
+
# a different account, the request fails with the HTTP status code `403
|
342
|
+
# Forbidden` (access denied).
|
343
|
+
# @option options [String] :checksum_algorithm
|
344
|
+
# Indicates the algorithm used to create the checksum for the object
|
345
|
+
# when using the SDK. This header will not provide any additional
|
346
|
+
# functionality if not using the SDK. When sending this header, there
|
347
|
+
# must be a corresponding `x-amz-checksum` or `x-amz-trailer` header
|
348
|
+
# sent. Otherwise, Amazon S3 fails the request with the HTTP status code
|
349
|
+
# `400 Bad Request`. For more information, see [Checking object
|
350
|
+
# integrity][1] in the *Amazon S3 User Guide*.
|
351
|
+
#
|
352
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
353
|
+
# `ChecksumAlgorithm` parameter.
|
354
|
+
#
|
355
|
+
# This checksum algorithm must be the same for all parts and it match
|
356
|
+
# the checksum value supplied in the `CreateMultipartUpload` request.
|
357
|
+
#
|
358
|
+
#
|
359
|
+
#
|
360
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
322
361
|
# @return [Types::DeleteObjectsOutput]
|
323
362
|
def delete_objects(options = {})
|
324
363
|
options = options.merge(bucket: @name)
|
@@ -338,6 +377,11 @@ module Aws::S3
|
|
338
377
|
# content_length: 1,
|
339
378
|
# content_md5: "ContentMD5",
|
340
379
|
# content_type: "ContentType",
|
380
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
381
|
+
# checksum_crc32: "ChecksumCRC32",
|
382
|
+
# checksum_crc32c: "ChecksumCRC32C",
|
383
|
+
# checksum_sha1: "ChecksumSHA1",
|
384
|
+
# checksum_sha256: "ChecksumSHA256",
|
341
385
|
# expires: Time.now,
|
342
386
|
# grant_full_control: "GrantFullControl",
|
343
387
|
# grant_read: "GrantRead",
|
@@ -348,7 +392,7 @@ module Aws::S3
|
|
348
392
|
# "MetadataKey" => "MetadataValue",
|
349
393
|
# },
|
350
394
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
351
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
395
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
352
396
|
# website_redirect_location: "WebsiteRedirectLocation",
|
353
397
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
354
398
|
# sse_customer_key: "SSECustomerKey",
|
@@ -430,6 +474,61 @@ module Aws::S3
|
|
430
474
|
#
|
431
475
|
#
|
432
476
|
# [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
|
477
|
+
# @option options [String] :checksum_algorithm
|
478
|
+
# Indicates the algorithm used to create the checksum for the object
|
479
|
+
# when using the SDK. This header will not provide any additional
|
480
|
+
# functionality if not using the SDK. When sending this header, there
|
481
|
+
# must be a corresponding `x-amz-checksum` or `x-amz-trailer` header
|
482
|
+
# sent. Otherwise, Amazon S3 fails the request with the HTTP status code
|
483
|
+
# `400 Bad Request`. For more information, see [Checking object
|
484
|
+
# integrity][1] in the *Amazon S3 User Guide*.
|
485
|
+
#
|
486
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
487
|
+
# `ChecksumAlgorithm` parameter.
|
488
|
+
#
|
489
|
+
#
|
490
|
+
#
|
491
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
492
|
+
# @option options [String] :checksum_crc32
|
493
|
+
# This header can be used as a data integrity check to verify that the
|
494
|
+
# data received is the same data that was originally sent. This header
|
495
|
+
# specifies the base64-encoded, 32-bit CRC32 checksum of the object. For
|
496
|
+
# more information, see [Checking object integrity][1] in the *Amazon S3
|
497
|
+
# User Guide*.
|
498
|
+
#
|
499
|
+
#
|
500
|
+
#
|
501
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
502
|
+
# @option options [String] :checksum_crc32c
|
503
|
+
# This header can be used as a data integrity check to verify that the
|
504
|
+
# data received is the same data that was originally sent. This header
|
505
|
+
# specifies the base64-encoded, 32-bit CRC32C checksum of the object.
|
506
|
+
# For more information, see [Checking object integrity][1] in the
|
507
|
+
# *Amazon S3 User Guide*.
|
508
|
+
#
|
509
|
+
#
|
510
|
+
#
|
511
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
512
|
+
# @option options [String] :checksum_sha1
|
513
|
+
# This header can be used as a data integrity check to verify that the
|
514
|
+
# data received is the same data that was originally sent. This header
|
515
|
+
# specifies the base64-encoded, 160-bit SHA-1 digest of the object. For
|
516
|
+
# more information, see [Checking object integrity][1] in the *Amazon S3
|
517
|
+
# User Guide*.
|
518
|
+
#
|
519
|
+
#
|
520
|
+
#
|
521
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
522
|
+
# @option options [String] :checksum_sha256
|
523
|
+
# This header can be used as a data integrity check to verify that the
|
524
|
+
# data received is the same data that was originally sent. This header
|
525
|
+
# specifies the base64-encoded, 256-bit SHA-256 digest of the object.
|
526
|
+
# For more information, see [Checking object integrity][1] in the
|
527
|
+
# *Amazon S3 User Guide*.
|
528
|
+
#
|
529
|
+
#
|
530
|
+
#
|
531
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
433
532
|
# @option options [Time,DateTime,Date,Integer,String] :expires
|
434
533
|
# The date and time at which the object is no longer cacheable. For more
|
435
534
|
# information, see
|
@@ -456,7 +555,7 @@ module Aws::S3
|
|
456
555
|
#
|
457
556
|
# This action is not supported by Amazon S3 on Outposts.
|
458
557
|
# @option options [required, String] :key
|
459
|
-
# Object key for which the PUT
|
558
|
+
# Object key for which the PUT action was initiated.
|
460
559
|
# @option options [Hash<String,String>] :metadata
|
461
560
|
# A map of metadata to store with the object in S3.
|
462
561
|
# @option options [String] :server_side_encryption
|
@@ -468,7 +567,7 @@ module Aws::S3
|
|
468
567
|
# and high availability. Depending on performance needs, you can specify
|
469
568
|
# a different Storage Class. Amazon S3 on Outposts only uses the
|
470
569
|
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
471
|
-
# in the *Amazon S3
|
570
|
+
# in the *Amazon S3 User Guide*.
|
472
571
|
#
|
473
572
|
#
|
474
573
|
#
|
@@ -513,34 +612,32 @@ module Aws::S3
|
|
513
612
|
# ensure that the encryption key was transmitted without error.
|
514
613
|
# @option options [String] :ssekms_key_id
|
515
614
|
# If `x-amz-server-side-encryption` is present and has the value of
|
516
|
-
# `aws:kms`, this header specifies the ID of the
|
517
|
-
# Service (
|
518
|
-
#
|
519
|
-
#
|
520
|
-
# If the value of `x-amz-server-side-encryption` is `aws:kms`, this
|
521
|
-
# header specifies the ID of the symmetric customer managed AWS KMS CMK
|
522
|
-
# that will be used for the object. If you specify
|
615
|
+
# `aws:kms`, this header specifies the ID of the Amazon Web Services Key
|
616
|
+
# Management Service (Amazon Web Services KMS) symmetrical customer
|
617
|
+
# managed key that was used for the object. If you specify
|
523
618
|
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
524
|
-
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
525
|
-
#
|
619
|
+
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
620
|
+
# Amazon Web Services managed key to protect the data. If the KMS key
|
621
|
+
# does not exist in the same account issuing the command, you must use
|
622
|
+
# the full ARN and not just the ID.
|
526
623
|
# @option options [String] :ssekms_encryption_context
|
527
|
-
# Specifies the
|
528
|
-
# The value of this header is a base64-encoded UTF-8
|
529
|
-
# with the encryption context key-value pairs.
|
624
|
+
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
625
|
+
# object encryption. The value of this header is a base64-encoded UTF-8
|
626
|
+
# string holding JSON with the encryption context key-value pairs.
|
530
627
|
# @option options [Boolean] :bucket_key_enabled
|
531
628
|
# Specifies whether Amazon S3 should use an S3 Bucket Key for object
|
532
629
|
# encryption with server-side encryption using AWS KMS (SSE-KMS).
|
533
630
|
# Setting this header to `true` causes Amazon S3 to use an S3 Bucket Key
|
534
631
|
# for object encryption with SSE-KMS.
|
535
632
|
#
|
536
|
-
# Specifying this header with a PUT
|
537
|
-
#
|
633
|
+
# Specifying this header with a PUT action doesn’t affect bucket-level
|
634
|
+
# settings for S3 Bucket Key.
|
538
635
|
# @option options [String] :request_payer
|
539
636
|
# Confirms that the requester knows that they will be charged for the
|
540
637
|
# request. Bucket owners need not specify this parameter in their
|
541
|
-
# requests. For information about downloading objects from
|
542
|
-
#
|
543
|
-
# in the *Amazon S3
|
638
|
+
# requests. For information about downloading objects from Requester
|
639
|
+
# Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
|
640
|
+
# in the *Amazon S3 User Guide*.
|
544
641
|
#
|
545
642
|
#
|
546
643
|
#
|
@@ -552,6 +649,7 @@ module Aws::S3
|
|
552
649
|
# The Object Lock mode that you want to apply to this object.
|
553
650
|
# @option options [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
|
554
651
|
# The date and time when you want this object's Object Lock to expire.
|
652
|
+
# Must be formatted as a timestamp parameter.
|
555
653
|
# @option options [String] :object_lock_legal_hold_status
|
556
654
|
# Specifies whether a legal hold will be applied to this object. For
|
557
655
|
# more information about S3 Object Lock, see [Object Lock][1].
|
@@ -560,9 +658,9 @@ module Aws::S3
|
|
560
658
|
#
|
561
659
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
|
562
660
|
# @option options [String] :expected_bucket_owner
|
563
|
-
# The account
|
564
|
-
# a different account, the request
|
565
|
-
#
|
661
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
662
|
+
# a different account, the request fails with the HTTP status code `403
|
663
|
+
# Forbidden` (access denied).
|
566
664
|
# @return [Object]
|
567
665
|
def put_object(options = {})
|
568
666
|
options = options.merge(bucket: @name)
|
@@ -668,9 +766,9 @@ module Aws::S3
|
|
668
766
|
# list only if they have an upload ID lexicographically greater than the
|
669
767
|
# specified `upload-id-marker`.
|
670
768
|
# @option options [String] :expected_bucket_owner
|
671
|
-
# The account
|
672
|
-
# a different account, the request
|
673
|
-
#
|
769
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
770
|
+
# a different account, the request fails with the HTTP status code `403
|
771
|
+
# Forbidden` (access denied).
|
674
772
|
# @return [MultipartUpload::Collection]
|
675
773
|
def multipart_uploads(options = {})
|
676
774
|
batches = Enumerator.new do |y|
|
@@ -748,9 +846,9 @@ module Aws::S3
|
|
748
846
|
# @option options [String] :version_id_marker
|
749
847
|
# Specifies the object version you want to start listing from.
|
750
848
|
# @option options [String] :expected_bucket_owner
|
751
|
-
# The account
|
752
|
-
# a different account, the request
|
753
|
-
#
|
849
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
850
|
+
# a different account, the request fails with the HTTP status code `403
|
851
|
+
# Forbidden` (access denied).
|
754
852
|
# @return [ObjectVersion::Collection]
|
755
853
|
def object_versions(options = {})
|
756
854
|
batches = Enumerator.new do |y|
|
@@ -804,9 +902,9 @@ module Aws::S3
|
|
804
902
|
# the list objects request in V2 style. Bucket owners need not specify
|
805
903
|
# this parameter in their requests.
|
806
904
|
# @option options [String] :expected_bucket_owner
|
807
|
-
# The account
|
808
|
-
# a different account, the request
|
809
|
-
#
|
905
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
906
|
+
# a different account, the request fails with the HTTP status code `403
|
907
|
+
# Forbidden` (access denied).
|
810
908
|
# @return [ObjectSummary::Collection]
|
811
909
|
def objects(options = {})
|
812
910
|
batches = Enumerator.new do |y|
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -203,6 +203,7 @@ module Aws::S3
|
|
203
203
|
# },
|
204
204
|
# },
|
205
205
|
# content_md5: "ContentMD5",
|
206
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
206
207
|
# grant_full_control: "GrantFullControl",
|
207
208
|
# grant_read: "GrantRead",
|
208
209
|
# grant_read_acp: "GrantReadACP",
|
@@ -221,12 +222,28 @@ module Aws::S3
|
|
221
222
|
# used as a message integrity check to verify that the request body was
|
222
223
|
# not corrupted in transit. For more information, go to [RFC 1864.][1]
|
223
224
|
#
|
224
|
-
# For requests made using the
|
225
|
-
# SDKs, this field is calculated
|
225
|
+
# For requests made using the Amazon Web Services Command Line Interface
|
226
|
+
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
227
|
+
# automatically.
|
226
228
|
#
|
227
229
|
#
|
228
230
|
#
|
229
231
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
232
|
+
# @option options [String] :checksum_algorithm
|
233
|
+
# Indicates the algorithm used to create the checksum for the object
|
234
|
+
# when using the SDK. This header will not provide any additional
|
235
|
+
# functionality if not using the SDK. When sending this header, there
|
236
|
+
# must be a corresponding `x-amz-checksum` or `x-amz-trailer` header
|
237
|
+
# sent. Otherwise, Amazon S3 fails the request with the HTTP status code
|
238
|
+
# `400 Bad Request`. For more information, see [Checking object
|
239
|
+
# integrity][1] in the *Amazon S3 User Guide*.
|
240
|
+
#
|
241
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
242
|
+
# `ChecksumAlgorithm` parameter.
|
243
|
+
#
|
244
|
+
#
|
245
|
+
#
|
246
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
230
247
|
# @option options [String] :grant_full_control
|
231
248
|
# Allows grantee the read, write, read ACP, and write ACP permissions on
|
232
249
|
# the bucket.
|
@@ -235,14 +252,16 @@ module Aws::S3
|
|
235
252
|
# @option options [String] :grant_read_acp
|
236
253
|
# Allows grantee to read the bucket ACL.
|
237
254
|
# @option options [String] :grant_write
|
238
|
-
# Allows grantee to create
|
239
|
-
#
|
255
|
+
# Allows grantee to create new objects in the bucket.
|
256
|
+
#
|
257
|
+
# For the bucket and object owners of existing objects, also allows
|
258
|
+
# deletions and overwrites of those objects.
|
240
259
|
# @option options [String] :grant_write_acp
|
241
260
|
# Allows grantee to write the ACL for the applicable bucket.
|
242
261
|
# @option options [String] :expected_bucket_owner
|
243
|
-
# The account
|
244
|
-
# a different account, the request
|
245
|
-
#
|
262
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
263
|
+
# a different account, the request fails with the HTTP status code `403
|
264
|
+
# Forbidden` (access denied).
|
246
265
|
# @return [EmptyStructure]
|
247
266
|
def put(options = {})
|
248
267
|
options = options.merge(bucket: @bucket_name)
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -182,9 +182,9 @@ module Aws::S3
|
|
182
182
|
# })
|
183
183
|
# @param [Hash] options ({})
|
184
184
|
# @option options [String] :expected_bucket_owner
|
185
|
-
# The account
|
186
|
-
# a different account, the request
|
187
|
-
#
|
185
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
186
|
+
# a different account, the request fails with the HTTP status code `403
|
187
|
+
# Forbidden` (access denied).
|
188
188
|
# @return [EmptyStructure]
|
189
189
|
def delete(options = {})
|
190
190
|
options = options.merge(bucket: @bucket_name)
|
@@ -198,6 +198,7 @@ module Aws::S3
|
|
198
198
|
# cors_configuration: { # required
|
199
199
|
# cors_rules: [ # required
|
200
200
|
# {
|
201
|
+
# id: "ID",
|
201
202
|
# allowed_headers: ["AllowedHeader"],
|
202
203
|
# allowed_methods: ["AllowedMethod"], # required
|
203
204
|
# allowed_origins: ["AllowedOrigin"], # required
|
@@ -207,14 +208,14 @@ module Aws::S3
|
|
207
208
|
# ],
|
208
209
|
# },
|
209
210
|
# content_md5: "ContentMD5",
|
211
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
210
212
|
# expected_bucket_owner: "AccountId",
|
211
213
|
# })
|
212
214
|
# @param [Hash] options ({})
|
213
215
|
# @option options [required, Types::CORSConfiguration] :cors_configuration
|
214
216
|
# Describes the cross-origin access configuration for objects in an
|
215
217
|
# Amazon S3 bucket. For more information, see [Enabling Cross-Origin
|
216
|
-
# Resource Sharing][1] in the *Amazon
|
217
|
-
# Guide*.
|
218
|
+
# Resource Sharing][1] in the *Amazon S3 User Guide*.
|
218
219
|
#
|
219
220
|
#
|
220
221
|
#
|
@@ -224,16 +225,32 @@ module Aws::S3
|
|
224
225
|
# used as a message integrity check to verify that the request body was
|
225
226
|
# not corrupted in transit. For more information, go to [RFC 1864.][1]
|
226
227
|
#
|
227
|
-
# For requests made using the
|
228
|
-
# SDKs, this field is calculated
|
228
|
+
# For requests made using the Amazon Web Services Command Line Interface
|
229
|
+
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
230
|
+
# automatically.
|
229
231
|
#
|
230
232
|
#
|
231
233
|
#
|
232
234
|
# [1]: http://www.ietf.org/rfc/rfc1864.txt
|
235
|
+
# @option options [String] :checksum_algorithm
|
236
|
+
# Indicates the algorithm used to create the checksum for the object
|
237
|
+
# when using the SDK. This header will not provide any additional
|
238
|
+
# functionality if not using the SDK. When sending this header, there
|
239
|
+
# must be a corresponding `x-amz-checksum` or `x-amz-trailer` header
|
240
|
+
# sent. Otherwise, Amazon S3 fails the request with the HTTP status code
|
241
|
+
# `400 Bad Request`. For more information, see [Checking object
|
242
|
+
# integrity][1] in the *Amazon S3 User Guide*.
|
243
|
+
#
|
244
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
245
|
+
# `ChecksumAlgorithm` parameter.
|
246
|
+
#
|
247
|
+
#
|
248
|
+
#
|
249
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
233
250
|
# @option options [String] :expected_bucket_owner
|
234
|
-
# The account
|
235
|
-
# a different account, the request
|
236
|
-
#
|
251
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
252
|
+
# a different account, the request fails with the HTTP status code `403
|
253
|
+
# Forbidden` (access denied).
|
237
254
|
# @return [EmptyStructure]
|
238
255
|
def put(options = {})
|
239
256
|
options = options.merge(bucket: @bucket_name)
|
@@ -3,7 +3,7 @@
|
|
3
3
|
# WARNING ABOUT GENERATED CODE
|
4
4
|
#
|
5
5
|
# This file is generated. See the contributing guide for more information:
|
6
|
-
# https://github.com/aws/aws-sdk-ruby/blob/
|
6
|
+
# https://github.com/aws/aws-sdk-ruby/blob/version-3/CONTRIBUTING.md
|
7
7
|
#
|
8
8
|
# WARNING ABOUT GENERATED CODE
|
9
9
|
|
@@ -181,9 +181,9 @@ module Aws::S3
|
|
181
181
|
# })
|
182
182
|
# @param [Hash] options ({})
|
183
183
|
# @option options [String] :expected_bucket_owner
|
184
|
-
# The account
|
185
|
-
# a different account, the request
|
186
|
-
#
|
184
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
185
|
+
# a different account, the request fails with the HTTP status code `403
|
186
|
+
# Forbidden` (access denied).
|
187
187
|
# @return [EmptyStructure]
|
188
188
|
def delete(options = {})
|
189
189
|
options = options.merge(bucket: @bucket_name)
|
@@ -195,6 +195,7 @@ module Aws::S3
|
|
195
195
|
#
|
196
196
|
# bucket_lifecycle.put({
|
197
197
|
# content_md5: "ContentMD5",
|
198
|
+
# checksum_algorithm: "CRC32", # accepts CRC32, CRC32C, SHA1, SHA256
|
198
199
|
# lifecycle_configuration: {
|
199
200
|
# rules: [ # required
|
200
201
|
# {
|
@@ -209,14 +210,16 @@ module Aws::S3
|
|
209
210
|
# transition: {
|
210
211
|
# date: Time.now,
|
211
212
|
# days: 1,
|
212
|
-
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE
|
213
|
+
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE, GLACIER_IR
|
213
214
|
# },
|
214
215
|
# noncurrent_version_transition: {
|
215
216
|
# noncurrent_days: 1,
|
216
|
-
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE
|
217
|
+
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE, GLACIER_IR
|
218
|
+
# newer_noncurrent_versions: 1,
|
217
219
|
# },
|
218
220
|
# noncurrent_version_expiration: {
|
219
221
|
# noncurrent_days: 1,
|
222
|
+
# newer_noncurrent_versions: 1,
|
220
223
|
# },
|
221
224
|
# abort_incomplete_multipart_upload: {
|
222
225
|
# days_after_initiation: 1,
|
@@ -228,13 +231,29 @@ module Aws::S3
|
|
228
231
|
# })
|
229
232
|
# @param [Hash] options ({})
|
230
233
|
# @option options [String] :content_md5
|
231
|
-
# For requests made using the
|
232
|
-
# SDKs, this field is calculated
|
234
|
+
# For requests made using the Amazon Web Services Command Line Interface
|
235
|
+
# (CLI) or Amazon Web Services SDKs, this field is calculated
|
236
|
+
# automatically.
|
237
|
+
# @option options [String] :checksum_algorithm
|
238
|
+
# Indicates the algorithm used to create the checksum for the object
|
239
|
+
# when using the SDK. This header will not provide any additional
|
240
|
+
# functionality if not using the SDK. When sending this header, there
|
241
|
+
# must be a corresponding `x-amz-checksum` or `x-amz-trailer` header
|
242
|
+
# sent. Otherwise, Amazon S3 fails the request with the HTTP status code
|
243
|
+
# `400 Bad Request`. For more information, see [Checking object
|
244
|
+
# integrity][1] in the *Amazon S3 User Guide*.
|
245
|
+
#
|
246
|
+
# If you provide an individual checksum, Amazon S3 ignores any provided
|
247
|
+
# `ChecksumAlgorithm` parameter.
|
248
|
+
#
|
249
|
+
#
|
250
|
+
#
|
251
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
233
252
|
# @option options [Types::LifecycleConfiguration] :lifecycle_configuration
|
234
253
|
# @option options [String] :expected_bucket_owner
|
235
|
-
# The account
|
236
|
-
# a different account, the request
|
237
|
-
#
|
254
|
+
# The account ID of the expected bucket owner. If the bucket is owned by
|
255
|
+
# a different account, the request fails with the HTTP status code `403
|
256
|
+
# Forbidden` (access denied).
|
238
257
|
# @return [EmptyStructure]
|
239
258
|
def put(options = {})
|
240
259
|
options = options.merge(bucket: @bucket_name)
|