aws-sdk-s3 1.61.2 → 1.83.1
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 +5 -5
- data/lib/aws-sdk-s3.rb +5 -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 +61 -10
- data/lib/aws-sdk-s3/bucket_acl.rb +7 -0
- data/lib/aws-sdk-s3/bucket_cors.rb +15 -2
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +14 -1
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +14 -1
- data/lib/aws-sdk-s3/bucket_logging.rb +7 -0
- data/lib/aws-sdk-s3/bucket_notification.rb +7 -0
- data/lib/aws-sdk-s3/bucket_policy.rb +14 -1
- data/lib/aws-sdk-s3/bucket_region_cache.rb +2 -0
- data/lib/aws-sdk-s3/bucket_request_payment.rb +7 -0
- data/lib/aws-sdk-s3/bucket_tagging.rb +14 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +17 -0
- data/lib/aws-sdk-s3/bucket_website.rb +18 -3
- data/lib/aws-sdk-s3/client.rb +2521 -1187
- data/lib/aws-sdk-s3/client_api.rb +188 -18
- data/lib/aws-sdk-s3/customizations.rb +3 -0
- data/lib/aws-sdk-s3/customizations/bucket.rb +11 -4
- data/lib/aws-sdk-s3/customizations/multipart_upload.rb +2 -0
- data/lib/aws-sdk-s3/customizations/object.rb +23 -5
- data/lib/aws-sdk-s3/customizations/object_summary.rb +5 -0
- data/lib/aws-sdk-s3/customizations/types/list_object_versions_output.rb +2 -0
- data/lib/aws-sdk-s3/encryption.rb +4 -0
- data/lib/aws-sdk-s3/encryption/client.rb +18 -5
- data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +72 -26
- data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +43 -5
- data/lib/aws-sdk-s3/encryption/default_key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +13 -2
- data/lib/aws-sdk-s3/encryption/errors.rb +2 -0
- data/lib/aws-sdk-s3/encryption/io_auth_decrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryption/io_decrypter.rb +11 -3
- data/lib/aws-sdk-s3/encryption/io_encrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryption/key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +34 -3
- data/lib/aws-sdk-s3/encryption/materials.rb +8 -6
- data/lib/aws-sdk-s3/encryption/utils.rb +25 -0
- data/lib/aws-sdk-s3/encryptionV2/client.rb +566 -0
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +226 -0
- data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +170 -0
- data/lib/aws-sdk-s3/encryptionV2/default_key_provider.rb +40 -0
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +69 -0
- data/lib/aws-sdk-s3/encryptionV2/errors.rb +37 -0
- data/lib/aws-sdk-s3/encryptionV2/io_auth_decrypter.rb +58 -0
- data/lib/aws-sdk-s3/encryptionV2/io_decrypter.rb +37 -0
- data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +73 -0
- data/lib/aws-sdk-s3/encryptionV2/key_provider.rb +31 -0
- data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +169 -0
- data/lib/aws-sdk-s3/encryptionV2/materials.rb +60 -0
- data/lib/aws-sdk-s3/encryptionV2/utils.rb +103 -0
- data/lib/aws-sdk-s3/encryption_v2.rb +23 -0
- data/lib/aws-sdk-s3/errors.rb +2 -0
- data/lib/aws-sdk-s3/event_streams.rb +7 -0
- data/lib/aws-sdk-s3/file_downloader.rb +10 -8
- data/lib/aws-sdk-s3/file_part.rb +2 -0
- data/lib/aws-sdk-s3/file_uploader.rb +14 -1
- data/lib/aws-sdk-s3/legacy_signer.rb +2 -0
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +39 -2
- data/lib/aws-sdk-s3/multipart_stream_uploader.rb +3 -1
- data/lib/aws-sdk-s3/multipart_upload.rb +18 -1
- data/lib/aws-sdk-s3/multipart_upload_error.rb +2 -0
- data/lib/aws-sdk-s3/multipart_upload_part.rb +66 -7
- data/lib/aws-sdk-s3/object.rb +174 -23
- data/lib/aws-sdk-s3/object_acl.rb +15 -0
- data/lib/aws-sdk-s3/object_copier.rb +2 -0
- data/lib/aws-sdk-s3/object_multipart_copier.rb +2 -0
- data/lib/aws-sdk-s3/object_summary.rb +185 -20
- data/lib/aws-sdk-s3/object_version.rb +44 -4
- data/lib/aws-sdk-s3/plugins/accelerate.rb +29 -38
- data/lib/aws-sdk-s3/plugins/arn.rb +187 -0
- data/lib/aws-sdk-s3/plugins/bucket_dns.rb +2 -2
- data/lib/aws-sdk-s3/plugins/bucket_name_restrictions.rb +3 -1
- data/lib/aws-sdk-s3/plugins/dualstack.rb +5 -1
- data/lib/aws-sdk-s3/plugins/expect_100_continue.rb +3 -4
- data/lib/aws-sdk-s3/plugins/get_bucket_location_fix.rb +2 -0
- data/lib/aws-sdk-s3/plugins/http_200_errors.rb +11 -3
- data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +3 -1
- data/lib/aws-sdk-s3/plugins/location_constraint.rb +2 -0
- data/lib/aws-sdk-s3/plugins/md5s.rb +26 -25
- data/lib/aws-sdk-s3/plugins/redirects.rb +2 -0
- data/lib/aws-sdk-s3/plugins/s3_host_id.rb +2 -0
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +31 -7
- data/lib/aws-sdk-s3/plugins/sse_cpk.rb +3 -1
- data/lib/aws-sdk-s3/plugins/streaming_retry.rb +118 -0
- data/lib/aws-sdk-s3/plugins/url_encoded_keys.rb +2 -0
- data/lib/aws-sdk-s3/presigned_post.rb +68 -32
- data/lib/aws-sdk-s3/presigner.rb +102 -34
- data/lib/aws-sdk-s3/resource.rb +4 -2
- data/lib/aws-sdk-s3/types.rb +2016 -256
- data/lib/aws-sdk-s3/waiters.rb +2 -0
- metadata +23 -6
- data/lib/aws-sdk-s3/plugins/bucket_arn.rb +0 -211
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
1
3
|
# WARNING ABOUT GENERATED CODE
|
|
2
4
|
#
|
|
3
5
|
# This file is generated. See the contributing guide for more information:
|
|
@@ -226,6 +228,7 @@ module Aws::S3
|
|
|
226
228
|
# grant_write_acp: "GrantWriteACP",
|
|
227
229
|
# request_payer: "requester", # accepts requester
|
|
228
230
|
# version_id: "ObjectVersionId",
|
|
231
|
+
# expected_bucket_owner: "AccountId",
|
|
229
232
|
# })
|
|
230
233
|
# @param [Hash] options ({})
|
|
231
234
|
# @option options [String] :acl
|
|
@@ -250,15 +253,23 @@ module Aws::S3
|
|
|
250
253
|
# @option options [String] :grant_full_control
|
|
251
254
|
# Allows grantee the read, write, read ACP, and write ACP permissions on
|
|
252
255
|
# the bucket.
|
|
256
|
+
#
|
|
257
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
253
258
|
# @option options [String] :grant_read
|
|
254
259
|
# Allows grantee to list the objects in the bucket.
|
|
260
|
+
#
|
|
261
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
255
262
|
# @option options [String] :grant_read_acp
|
|
256
263
|
# Allows grantee to read the bucket ACL.
|
|
264
|
+
#
|
|
265
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
257
266
|
# @option options [String] :grant_write
|
|
258
267
|
# Allows grantee to create, overwrite, and delete any object in the
|
|
259
268
|
# bucket.
|
|
260
269
|
# @option options [String] :grant_write_acp
|
|
261
270
|
# Allows grantee to write the ACL for the applicable bucket.
|
|
271
|
+
#
|
|
272
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
262
273
|
# @option options [String] :request_payer
|
|
263
274
|
# Confirms that the requester knows that they will be charged for the
|
|
264
275
|
# request. Bucket owners need not specify this parameter in their
|
|
@@ -271,6 +282,10 @@ module Aws::S3
|
|
|
271
282
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
|
272
283
|
# @option options [String] :version_id
|
|
273
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.
|
|
274
289
|
# @return [Types::PutObjectAclOutput]
|
|
275
290
|
def put(options = {})
|
|
276
291
|
options = options.merge(
|
|
@@ -1,3 +1,5 @@
|
|
|
1
|
+
# frozen_string_literal: true
|
|
2
|
+
|
|
1
3
|
# WARNING ABOUT GENERATED CODE
|
|
2
4
|
#
|
|
3
5
|
# This file is generated. See the contributing guide for more information:
|
|
@@ -46,8 +48,24 @@ module Aws::S3
|
|
|
46
48
|
data[:last_modified]
|
|
47
49
|
end
|
|
48
50
|
|
|
49
|
-
# The entity tag is
|
|
50
|
-
#
|
|
51
|
+
# The entity tag is a hash of the object. The ETag reflects changes only
|
|
52
|
+
# to the contents of an object, not its metadata. The ETag may or may
|
|
53
|
+
# not be an MD5 digest of the object data. Whether or not it is depends
|
|
54
|
+
# on how the object was created and how it is encrypted as described
|
|
55
|
+
# below:
|
|
56
|
+
#
|
|
57
|
+
# * Objects created by the PUT Object, POST Object, or Copy operation,
|
|
58
|
+
# or through the AWS Management Console, and are encrypted by SSE-S3
|
|
59
|
+
# or plaintext, have ETags that are an MD5 digest of their object
|
|
60
|
+
# data.
|
|
61
|
+
#
|
|
62
|
+
# * Objects created by the PUT Object, POST Object, or Copy operation,
|
|
63
|
+
# or through the AWS Management Console, and are encrypted by SSE-C or
|
|
64
|
+
# SSE-KMS, have ETags that are not an MD5 digest of their object data.
|
|
65
|
+
#
|
|
66
|
+
# * If an object is created by either the Multipart Upload or Part Copy
|
|
67
|
+
# operation, the ETag is not an MD5 digest, regardless of the method
|
|
68
|
+
# of encryption.
|
|
51
69
|
# @return [String]
|
|
52
70
|
def etag
|
|
53
71
|
data[:etag]
|
|
@@ -277,7 +295,7 @@ module Aws::S3
|
|
|
277
295
|
# metadata_directive: "COPY", # accepts COPY, REPLACE
|
|
278
296
|
# tagging_directive: "COPY", # accepts COPY, REPLACE
|
|
279
297
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
|
280
|
-
# 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
|
|
281
299
|
# website_redirect_location: "WebsiteRedirectLocation",
|
|
282
300
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
283
301
|
# sse_customer_key: "SSECustomerKey",
|
|
@@ -292,10 +310,14 @@ module Aws::S3
|
|
|
292
310
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
|
293
311
|
# object_lock_retain_until_date: Time.now,
|
|
294
312
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
|
313
|
+
# expected_bucket_owner: "AccountId",
|
|
314
|
+
# expected_source_bucket_owner: "AccountId",
|
|
295
315
|
# })
|
|
296
316
|
# @param [Hash] options ({})
|
|
297
317
|
# @option options [String] :acl
|
|
298
318
|
# The canned ACL to apply to the object.
|
|
319
|
+
#
|
|
320
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
299
321
|
# @option options [String] :cache_control
|
|
300
322
|
# Specifies caching behavior along the request/reply chain.
|
|
301
323
|
# @option options [String] :content_disposition
|
|
@@ -309,8 +331,50 @@ module Aws::S3
|
|
|
309
331
|
# @option options [String] :content_type
|
|
310
332
|
# A standard MIME type describing the format of the object data.
|
|
311
333
|
# @option options [required, String] :copy_source
|
|
312
|
-
#
|
|
313
|
-
#
|
|
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
|
|
314
378
|
# @option options [String] :copy_source_if_match
|
|
315
379
|
# Copies the object if its entity tag (ETag) matches the specified tag.
|
|
316
380
|
# @option options [Time,DateTime,Date,Integer,String] :copy_source_if_modified_since
|
|
@@ -326,12 +390,20 @@ module Aws::S3
|
|
|
326
390
|
# @option options [String] :grant_full_control
|
|
327
391
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
|
328
392
|
# object.
|
|
393
|
+
#
|
|
394
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
329
395
|
# @option options [String] :grant_read
|
|
330
396
|
# Allows grantee to read the object data and its metadata.
|
|
397
|
+
#
|
|
398
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
331
399
|
# @option options [String] :grant_read_acp
|
|
332
400
|
# Allows grantee to read the object ACL.
|
|
401
|
+
#
|
|
402
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
333
403
|
# @option options [String] :grant_write_acp
|
|
334
404
|
# Allows grantee to write the ACL for the applicable object.
|
|
405
|
+
#
|
|
406
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
335
407
|
# @option options [Hash<String,String>] :metadata
|
|
336
408
|
# A map of metadata to store with the object in S3.
|
|
337
409
|
# @option options [String] :metadata_directive
|
|
@@ -344,7 +416,16 @@ module Aws::S3
|
|
|
344
416
|
# The server-side encryption algorithm used when storing this object in
|
|
345
417
|
# Amazon S3 (for example, AES256, aws:kms).
|
|
346
418
|
# @option options [String] :storage_class
|
|
347
|
-
#
|
|
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
|
|
348
429
|
# @option options [String] :website_redirect_location
|
|
349
430
|
# If the bucket is configured as a website, redirects requests for this
|
|
350
431
|
# object to another object in the same bucket or to an external URL.
|
|
@@ -357,7 +438,7 @@ module Aws::S3
|
|
|
357
438
|
# encrypting data. This value is used to store the object and then it is
|
|
358
439
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
|
359
440
|
# be appropriate for use with the algorithm specified in the
|
|
360
|
-
# `x-amz-server-side
|
|
441
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
|
361
442
|
# @option options [String] :sse_customer_key_md5
|
|
362
443
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
|
363
444
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
|
@@ -409,6 +490,14 @@ module Aws::S3
|
|
|
409
490
|
# expire.
|
|
410
491
|
# @option options [String] :object_lock_legal_hold_status
|
|
411
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.
|
|
412
501
|
# @return [Types::CopyObjectOutput]
|
|
413
502
|
def copy_from(options = {})
|
|
414
503
|
options = options.merge(
|
|
@@ -426,6 +515,7 @@ module Aws::S3
|
|
|
426
515
|
# version_id: "ObjectVersionId",
|
|
427
516
|
# request_payer: "requester", # accepts requester
|
|
428
517
|
# bypass_governance_retention: false,
|
|
518
|
+
# expected_bucket_owner: "AccountId",
|
|
429
519
|
# })
|
|
430
520
|
# @param [Hash] options ({})
|
|
431
521
|
# @option options [String] :mfa
|
|
@@ -448,6 +538,10 @@ module Aws::S3
|
|
|
448
538
|
# @option options [Boolean] :bypass_governance_retention
|
|
449
539
|
# Indicates whether S3 Object Lock should bypass Governance-mode
|
|
450
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.
|
|
451
545
|
# @return [Types::DeleteObjectOutput]
|
|
452
546
|
def delete(options = {})
|
|
453
547
|
options = options.merge(
|
|
@@ -478,6 +572,7 @@ module Aws::S3
|
|
|
478
572
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
|
479
573
|
# request_payer: "requester", # accepts requester
|
|
480
574
|
# part_number: 1,
|
|
575
|
+
# expected_bucket_owner: "AccountId",
|
|
481
576
|
# })
|
|
482
577
|
# @param [Hash] options ({})
|
|
483
578
|
# @option options [String] :if_match
|
|
@@ -495,7 +590,16 @@ module Aws::S3
|
|
|
495
590
|
# @option options [String] :range
|
|
496
591
|
# Downloads the specified range bytes of an object. For more information
|
|
497
592
|
# about the HTTP Range header, see
|
|
498
|
-
# [
|
|
593
|
+
# [https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
|
|
594
|
+
#
|
|
595
|
+
# <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
|
|
596
|
+
# `GET` request.
|
|
597
|
+
#
|
|
598
|
+
# </note>
|
|
599
|
+
#
|
|
600
|
+
#
|
|
601
|
+
#
|
|
602
|
+
# [1]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
|
|
499
603
|
# @option options [String] :response_cache_control
|
|
500
604
|
# Sets the `Cache-Control` header of the response.
|
|
501
605
|
# @option options [String] :response_content_disposition
|
|
@@ -518,7 +622,7 @@ module Aws::S3
|
|
|
518
622
|
# encrypting data. This value is used to store the object and then it is
|
|
519
623
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
|
520
624
|
# be appropriate for use with the algorithm specified in the
|
|
521
|
-
# `x-amz-server-side
|
|
625
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
|
522
626
|
# @option options [String] :sse_customer_key_md5
|
|
523
627
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
|
524
628
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
|
@@ -538,6 +642,10 @@ module Aws::S3
|
|
|
538
642
|
# between 1 and 10,000. Effectively performs a 'ranged' GET request
|
|
539
643
|
# for the part specified. Useful for downloading just a part of an
|
|
540
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.
|
|
541
649
|
# @return [Types::GetObjectOutput]
|
|
542
650
|
def get(options = {}, &block)
|
|
543
651
|
options = options.merge(
|
|
@@ -566,7 +674,7 @@ module Aws::S3
|
|
|
566
674
|
# "MetadataKey" => "MetadataValue",
|
|
567
675
|
# },
|
|
568
676
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
|
569
|
-
# 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
|
|
570
678
|
# website_redirect_location: "WebsiteRedirectLocation",
|
|
571
679
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
572
680
|
# sse_customer_key: "SSECustomerKey",
|
|
@@ -578,10 +686,13 @@ module Aws::S3
|
|
|
578
686
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
|
579
687
|
# object_lock_retain_until_date: Time.now,
|
|
580
688
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
|
689
|
+
# expected_bucket_owner: "AccountId",
|
|
581
690
|
# })
|
|
582
691
|
# @param [Hash] options ({})
|
|
583
692
|
# @option options [String] :acl
|
|
584
693
|
# The canned ACL to apply to the object.
|
|
694
|
+
#
|
|
695
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
585
696
|
# @option options [String] :cache_control
|
|
586
697
|
# Specifies caching behavior along the request/reply chain.
|
|
587
698
|
# @option options [String] :content_disposition
|
|
@@ -599,19 +710,36 @@ module Aws::S3
|
|
|
599
710
|
# @option options [String] :grant_full_control
|
|
600
711
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
|
601
712
|
# object.
|
|
713
|
+
#
|
|
714
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
602
715
|
# @option options [String] :grant_read
|
|
603
716
|
# Allows grantee to read the object data and its metadata.
|
|
717
|
+
#
|
|
718
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
604
719
|
# @option options [String] :grant_read_acp
|
|
605
720
|
# Allows grantee to read the object ACL.
|
|
721
|
+
#
|
|
722
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
606
723
|
# @option options [String] :grant_write_acp
|
|
607
724
|
# Allows grantee to write the ACL for the applicable object.
|
|
725
|
+
#
|
|
726
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
608
727
|
# @option options [Hash<String,String>] :metadata
|
|
609
728
|
# A map of metadata to store with the object in S3.
|
|
610
729
|
# @option options [String] :server_side_encryption
|
|
611
730
|
# The server-side encryption algorithm used when storing this object in
|
|
612
731
|
# Amazon S3 (for example, AES256, aws:kms).
|
|
613
732
|
# @option options [String] :storage_class
|
|
614
|
-
#
|
|
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
|
|
615
743
|
# @option options [String] :website_redirect_location
|
|
616
744
|
# If the bucket is configured as a website, redirects requests for this
|
|
617
745
|
# object to another object in the same bucket or to an external URL.
|
|
@@ -624,7 +752,7 @@ module Aws::S3
|
|
|
624
752
|
# encrypting data. This value is used to store the object and then it is
|
|
625
753
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
|
626
754
|
# be appropriate for use with the algorithm specified in the
|
|
627
|
-
# `x-amz-server-side
|
|
755
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
|
628
756
|
# @option options [String] :sse_customer_key_md5
|
|
629
757
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
|
630
758
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
|
@@ -665,6 +793,10 @@ module Aws::S3
|
|
|
665
793
|
# @option options [String] :object_lock_legal_hold_status
|
|
666
794
|
# Specifies whether you want to apply a Legal Hold to the uploaded
|
|
667
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.
|
|
668
800
|
# @return [MultipartUpload]
|
|
669
801
|
def initiate_multipart_upload(options = {})
|
|
670
802
|
options = options.merge(
|
|
@@ -701,7 +833,7 @@ module Aws::S3
|
|
|
701
833
|
# "MetadataKey" => "MetadataValue",
|
|
702
834
|
# },
|
|
703
835
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
|
704
|
-
# 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
|
|
705
837
|
# website_redirect_location: "WebsiteRedirectLocation",
|
|
706
838
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
|
707
839
|
# sse_customer_key: "SSECustomerKey",
|
|
@@ -713,16 +845,19 @@ module Aws::S3
|
|
|
713
845
|
# object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
|
|
714
846
|
# object_lock_retain_until_date: Time.now,
|
|
715
847
|
# object_lock_legal_hold_status: "ON", # accepts ON, OFF
|
|
848
|
+
# expected_bucket_owner: "AccountId",
|
|
716
849
|
# })
|
|
717
850
|
# @param [Hash] options ({})
|
|
718
851
|
# @option options [String] :acl
|
|
719
852
|
# The canned ACL to apply to the object. For more information, see
|
|
720
853
|
# [Canned ACL][1].
|
|
721
854
|
#
|
|
855
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
856
|
+
#
|
|
722
857
|
#
|
|
723
858
|
#
|
|
724
859
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
|
725
|
-
# @option options [String,
|
|
860
|
+
# @option options [String, StringIO, File] :body
|
|
726
861
|
# Object data.
|
|
727
862
|
# @option options [String] :cache_control
|
|
728
863
|
# Can be used to specify caching behavior along the request/reply chain.
|
|
@@ -790,20 +925,36 @@ module Aws::S3
|
|
|
790
925
|
# @option options [String] :grant_full_control
|
|
791
926
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
|
792
927
|
# object.
|
|
928
|
+
#
|
|
929
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
793
930
|
# @option options [String] :grant_read
|
|
794
931
|
# Allows grantee to read the object data and its metadata.
|
|
932
|
+
#
|
|
933
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
795
934
|
# @option options [String] :grant_read_acp
|
|
796
935
|
# Allows grantee to read the object ACL.
|
|
936
|
+
#
|
|
937
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
797
938
|
# @option options [String] :grant_write_acp
|
|
798
939
|
# Allows grantee to write the ACL for the applicable object.
|
|
940
|
+
#
|
|
941
|
+
# This action is not supported by Amazon S3 on Outposts.
|
|
799
942
|
# @option options [Hash<String,String>] :metadata
|
|
800
943
|
# A map of metadata to store with the object in S3.
|
|
801
944
|
# @option options [String] :server_side_encryption
|
|
802
945
|
# The server-side encryption algorithm used when storing this object in
|
|
803
946
|
# Amazon S3 (for example, AES256, aws:kms).
|
|
804
947
|
# @option options [String] :storage_class
|
|
805
|
-
#
|
|
806
|
-
#
|
|
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
|
|
807
958
|
# @option options [String] :website_redirect_location
|
|
808
959
|
# If the bucket is configured as a website, redirects requests for this
|
|
809
960
|
# object to another object in the same bucket or to an external URL.
|
|
@@ -837,7 +988,7 @@ module Aws::S3
|
|
|
837
988
|
# encrypting data. This value is used to store the object and then it is
|
|
838
989
|
# discarded; Amazon S3 does not store the encryption key. The key must
|
|
839
990
|
# be appropriate for use with the algorithm specified in the
|
|
840
|
-
# `x-amz-server-side
|
|
991
|
+
# `x-amz-server-side-encryption-customer-algorithm` header.
|
|
841
992
|
# @option options [String] :sse_customer_key_md5
|
|
842
993
|
# Specifies the 128-bit MD5 digest of the encryption key according to
|
|
843
994
|
# RFC 1321. Amazon S3 uses this header for a message integrity check to
|
|
@@ -882,6 +1033,10 @@ module Aws::S3
|
|
|
882
1033
|
#
|
|
883
1034
|
#
|
|
884
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.
|
|
885
1040
|
# @return [Types::PutObjectOutput]
|
|
886
1041
|
def put(options = {})
|
|
887
1042
|
options = options.merge(
|
|
@@ -973,11 +1128,12 @@ module Aws::S3
|
|
|
973
1128
|
# value: "MetadataValue",
|
|
974
1129
|
# },
|
|
975
1130
|
# ],
|
|
976
|
-
# 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
|
|
977
1132
|
# },
|
|
978
1133
|
# },
|
|
979
1134
|
# },
|
|
980
1135
|
# request_payer: "requester", # accepts requester
|
|
1136
|
+
# expected_bucket_owner: "AccountId",
|
|
981
1137
|
# })
|
|
982
1138
|
# @param [Hash] options ({})
|
|
983
1139
|
# @option options [String] :version_id
|
|
@@ -994,6 +1150,10 @@ module Aws::S3
|
|
|
994
1150
|
#
|
|
995
1151
|
#
|
|
996
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.
|
|
997
1157
|
# @return [Types::RestoreObjectOutput]
|
|
998
1158
|
def restore_object(options = {})
|
|
999
1159
|
options = options.merge(
|
|
@@ -1090,8 +1250,8 @@ module Aws::S3
|
|
|
1090
1250
|
|
|
1091
1251
|
def yield_waiter_and_warn(waiter, &block)
|
|
1092
1252
|
if !@waiter_block_warned
|
|
1093
|
-
msg = "pass options to configure the waiter; "
|
|
1094
|
-
|
|
1253
|
+
msg = "pass options to configure the waiter; "\
|
|
1254
|
+
"yielding the waiter is deprecated"
|
|
1095
1255
|
warn(msg)
|
|
1096
1256
|
@waiter_block_warned = true
|
|
1097
1257
|
end
|
|
@@ -1125,6 +1285,7 @@ module Aws::S3
|
|
|
1125
1285
|
# mfa: "MFA",
|
|
1126
1286
|
# request_payer: "requester", # accepts requester
|
|
1127
1287
|
# bypass_governance_retention: false,
|
|
1288
|
+
# expected_bucket_owner: "AccountId",
|
|
1128
1289
|
# })
|
|
1129
1290
|
# @param options ({})
|
|
1130
1291
|
# @option options [String] :mfa
|
|
@@ -1146,6 +1307,10 @@ module Aws::S3
|
|
|
1146
1307
|
# Specifies whether you want to delete this object even if it has a
|
|
1147
1308
|
# Governance-type Object Lock in place. You must have sufficient
|
|
1148
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.
|
|
1149
1314
|
# @return [void]
|
|
1150
1315
|
def batch_delete!(options = {})
|
|
1151
1316
|
batch_enum.each do |batch|
|