aws-sdk-s3 1.82.0 → 1.83.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/aws-sdk-s3.rb +1 -1
- data/lib/aws-sdk-s3/bucket.rb +20 -2
- data/lib/aws-sdk-s3/client.rb +302 -77
- data/lib/aws-sdk-s3/client_api.rb +61 -0
- data/lib/aws-sdk-s3/object.rb +60 -4
- data/lib/aws-sdk-s3/object_acl.rb +8 -0
- data/lib/aws-sdk-s3/object_summary.rb +60 -4
- data/lib/aws-sdk-s3/object_version.rb +5 -1
- data/lib/aws-sdk-s3/types.rb +348 -120
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 27e8142d94b3b51ad2725ffab43afcc4bbd80562eb8370ae34dd5833001e850f
|
4
|
+
data.tar.gz: a8ca9825f4ec5e42f6c126d41e3073c618525082a0e07196073d4bd68bc5c0de
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 6ede8e603a7ae101eb9e3eaec06dddb179654f73ce1df05a7eeee4629a2a48c0feef529b6a0a6cf35508c2666e02df6414b215c7631c07cd83303aaf8e16b127
|
7
|
+
data.tar.gz: 05fa2eb62aa82394adf13d2262faf9a29c685ca001316e8001b6c760e534a1e736c4663564ef2f75f074abea8cd5f4956e6063569ce7200d062afd2684a03f82
|
data/lib/aws-sdk-s3.rb
CHANGED
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -366,6 +366,8 @@ module Aws::S3
|
|
366
366
|
# The canned ACL to apply to the object. For more information, see
|
367
367
|
# [Canned ACL][1].
|
368
368
|
#
|
369
|
+
# This action is not supported by Amazon S3 on Outposts.
|
370
|
+
#
|
369
371
|
#
|
370
372
|
#
|
371
373
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
@@ -437,12 +439,20 @@ module Aws::S3
|
|
437
439
|
# @option options [String] :grant_full_control
|
438
440
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
439
441
|
# object.
|
442
|
+
#
|
443
|
+
# This action is not supported by Amazon S3 on Outposts.
|
440
444
|
# @option options [String] :grant_read
|
441
445
|
# Allows grantee to read the object data and its metadata.
|
446
|
+
#
|
447
|
+
# This action is not supported by Amazon S3 on Outposts.
|
442
448
|
# @option options [String] :grant_read_acp
|
443
449
|
# Allows grantee to read the object ACL.
|
450
|
+
#
|
451
|
+
# This action is not supported by Amazon S3 on Outposts.
|
444
452
|
# @option options [String] :grant_write_acp
|
445
453
|
# Allows grantee to write the ACL for the applicable object.
|
454
|
+
#
|
455
|
+
# This action is not supported by Amazon S3 on Outposts.
|
446
456
|
# @option options [required, String] :key
|
447
457
|
# Object key for which the PUT operation was initiated.
|
448
458
|
# @option options [Hash<String,String>] :metadata
|
@@ -451,8 +461,16 @@ module Aws::S3
|
|
451
461
|
# The server-side encryption algorithm used when storing this object in
|
452
462
|
# Amazon S3 (for example, AES256, aws:kms).
|
453
463
|
# @option options [String] :storage_class
|
454
|
-
#
|
455
|
-
#
|
464
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
465
|
+
# created objects. The STANDARD storage class provides high durability
|
466
|
+
# and high availability. Depending on performance needs, you can specify
|
467
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
468
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
469
|
+
# in the *Amazon S3 Service Developer Guide*.
|
470
|
+
#
|
471
|
+
#
|
472
|
+
#
|
473
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
456
474
|
# @option options [String] :website_redirect_location
|
457
475
|
# If the bucket is configured as a website, redirects requests for this
|
458
476
|
# object to another object in the same bucket or to an external URL.
|
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -450,7 +450,7 @@ module Aws::S3
|
|
450
450
|
# When using this API with an access point, you must direct requests to
|
451
451
|
# the access point hostname. The access point hostname takes the form
|
452
452
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
453
|
-
# When using this operation
|
453
|
+
# When using this operation with an access point through the AWS SDKs,
|
454
454
|
# you provide the access point ARN in place of the bucket name. For more
|
455
455
|
# information about access point ARNs, see [Using Access Points][1] in
|
456
456
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -467,7 +467,7 @@ module Aws::S3
|
|
467
467
|
#
|
468
468
|
#
|
469
469
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
470
|
-
# [2]: https://docs.aws.amazon.com/
|
470
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
471
471
|
#
|
472
472
|
# @option params [required, String] :key
|
473
473
|
# Key of the object for which the multipart upload was initiated.
|
@@ -913,13 +913,15 @@ module Aws::S3
|
|
913
913
|
# @option params [String] :acl
|
914
914
|
# The canned ACL to apply to the object.
|
915
915
|
#
|
916
|
+
# This action is not supported by Amazon S3 on Outposts.
|
917
|
+
#
|
916
918
|
# @option params [required, String] :bucket
|
917
919
|
# The name of the destination bucket.
|
918
920
|
#
|
919
921
|
# When using this API with an access point, you must direct requests to
|
920
922
|
# the access point hostname. The access point hostname takes the form
|
921
923
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
922
|
-
# When using this operation
|
924
|
+
# When using this operation with an access point through the AWS SDKs,
|
923
925
|
# you provide the access point ARN in place of the bucket name. For more
|
924
926
|
# information about access point ARNs, see [Using Access Points][1] in
|
925
927
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -936,7 +938,7 @@ module Aws::S3
|
|
936
938
|
#
|
937
939
|
#
|
938
940
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
939
|
-
# [2]: https://docs.aws.amazon.com/
|
941
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
940
942
|
#
|
941
943
|
# @option params [String] :cache_control
|
942
944
|
# Specifies caching behavior along the request/reply chain.
|
@@ -1022,15 +1024,23 @@ module Aws::S3
|
|
1022
1024
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
1023
1025
|
# object.
|
1024
1026
|
#
|
1027
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1028
|
+
#
|
1025
1029
|
# @option params [String] :grant_read
|
1026
1030
|
# Allows grantee to read the object data and its metadata.
|
1027
1031
|
#
|
1032
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1033
|
+
#
|
1028
1034
|
# @option params [String] :grant_read_acp
|
1029
1035
|
# Allows grantee to read the object ACL.
|
1030
1036
|
#
|
1037
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1038
|
+
#
|
1031
1039
|
# @option params [String] :grant_write_acp
|
1032
1040
|
# Allows grantee to write the ACL for the applicable object.
|
1033
1041
|
#
|
1042
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1043
|
+
#
|
1034
1044
|
# @option params [required, String] :key
|
1035
1045
|
# The key of the destination object.
|
1036
1046
|
#
|
@@ -1050,7 +1060,16 @@ module Aws::S3
|
|
1050
1060
|
# Amazon S3 (for example, AES256, aws:kms).
|
1051
1061
|
#
|
1052
1062
|
# @option params [String] :storage_class
|
1053
|
-
#
|
1063
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
1064
|
+
# created objects. The STANDARD storage class provides high durability
|
1065
|
+
# and high availability. Depending on performance needs, you can specify
|
1066
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
1067
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
1068
|
+
# in the *Amazon S3 Service Developer Guide*.
|
1069
|
+
#
|
1070
|
+
#
|
1071
|
+
#
|
1072
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
1054
1073
|
#
|
1055
1074
|
# @option params [String] :website_redirect_location
|
1056
1075
|
# If the bucket is configured as a website, redirects requests for this
|
@@ -1247,9 +1266,9 @@ module Aws::S3
|
|
1247
1266
|
# the bucket, you become the bucket owner.
|
1248
1267
|
#
|
1249
1268
|
# Not every string is an acceptable bucket name. For information about
|
1250
|
-
# bucket naming restrictions, see [Working with Amazon S3
|
1269
|
+
# bucket naming restrictions, see [Working with Amazon S3 buckets][1].
|
1251
1270
|
#
|
1252
|
-
# If you want to create an
|
1271
|
+
# If you want to create an Amazon S3 on Outposts bucket, see [Create
|
1253
1272
|
# Bucket][2].
|
1254
1273
|
#
|
1255
1274
|
# By default, the bucket is created in the US East (N. Virginia) Region.
|
@@ -1257,8 +1276,7 @@ module Aws::S3
|
|
1257
1276
|
# choose a Region to optimize latency, minimize costs, or address
|
1258
1277
|
# regulatory requirements. For example, if you reside in Europe, you
|
1259
1278
|
# will probably find it advantageous to create buckets in the Europe
|
1260
|
-
# (Ireland) Region. For more information, see [
|
1261
|
-
# for Your Buckets][3].
|
1279
|
+
# (Ireland) Region. For more information, see [Accessing a bucket][3].
|
1262
1280
|
#
|
1263
1281
|
# <note markdown="1"> If you send your create bucket request to the `s3.amazonaws.com`
|
1264
1282
|
# endpoint, the request goes to the us-east-1 Region. Accordingly, the
|
@@ -1267,7 +1285,7 @@ module Aws::S3
|
|
1267
1285
|
# another Region where the bucket is to be created. If you create a
|
1268
1286
|
# bucket in a Region other than US East (N. Virginia), your application
|
1269
1287
|
# must be able to handle 307 redirect. For more information, see
|
1270
|
-
# [Virtual
|
1288
|
+
# [Virtual hosting of buckets][4].
|
1271
1289
|
#
|
1272
1290
|
# </note>
|
1273
1291
|
#
|
@@ -1285,8 +1303,8 @@ module Aws::S3
|
|
1285
1303
|
# `x-amz-grant-write`, `x-amz-grant-read-acp`,
|
1286
1304
|
# `x-amz-grant-write-acp`, and `x-amz-grant-full-control` headers.
|
1287
1305
|
# These headers map to the set of permissions Amazon S3 supports in an
|
1288
|
-
# ACL. For more information, see [Access
|
1289
|
-
#
|
1306
|
+
# ACL. For more information, see [Access control list (ACL)
|
1307
|
+
# overview][6].
|
1290
1308
|
#
|
1291
1309
|
# You specify each grantee as a type=value pair, where the type is one
|
1292
1310
|
# of the following:
|
@@ -1681,13 +1699,15 @@ module Aws::S3
|
|
1681
1699
|
# @option params [String] :acl
|
1682
1700
|
# The canned ACL to apply to the object.
|
1683
1701
|
#
|
1702
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1703
|
+
#
|
1684
1704
|
# @option params [required, String] :bucket
|
1685
1705
|
# The name of the bucket to which to initiate the upload
|
1686
1706
|
#
|
1687
1707
|
# When using this API with an access point, you must direct requests to
|
1688
1708
|
# the access point hostname. The access point hostname takes the form
|
1689
1709
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
1690
|
-
# When using this operation
|
1710
|
+
# When using this operation with an access point through the AWS SDKs,
|
1691
1711
|
# you provide the access point ARN in place of the bucket name. For more
|
1692
1712
|
# information about access point ARNs, see [Using Access Points][1] in
|
1693
1713
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -1704,7 +1724,7 @@ module Aws::S3
|
|
1704
1724
|
#
|
1705
1725
|
#
|
1706
1726
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
1707
|
-
# [2]: https://docs.aws.amazon.com/
|
1727
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
1708
1728
|
#
|
1709
1729
|
# @option params [String] :cache_control
|
1710
1730
|
# Specifies caching behavior along the request/reply chain.
|
@@ -1730,15 +1750,23 @@ module Aws::S3
|
|
1730
1750
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
1731
1751
|
# object.
|
1732
1752
|
#
|
1753
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1754
|
+
#
|
1733
1755
|
# @option params [String] :grant_read
|
1734
1756
|
# Allows grantee to read the object data and its metadata.
|
1735
1757
|
#
|
1758
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1759
|
+
#
|
1736
1760
|
# @option params [String] :grant_read_acp
|
1737
1761
|
# Allows grantee to read the object ACL.
|
1738
1762
|
#
|
1763
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1764
|
+
#
|
1739
1765
|
# @option params [String] :grant_write_acp
|
1740
1766
|
# Allows grantee to write the ACL for the applicable object.
|
1741
1767
|
#
|
1768
|
+
# This action is not supported by Amazon S3 on Outposts.
|
1769
|
+
#
|
1742
1770
|
# @option params [required, String] :key
|
1743
1771
|
# Object key for which the multipart upload is to be initiated.
|
1744
1772
|
#
|
@@ -1750,7 +1778,16 @@ module Aws::S3
|
|
1750
1778
|
# Amazon S3 (for example, AES256, aws:kms).
|
1751
1779
|
#
|
1752
1780
|
# @option params [String] :storage_class
|
1753
|
-
#
|
1781
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
1782
|
+
# created objects. The STANDARD storage class provides high durability
|
1783
|
+
# and high availability. Depending on performance needs, you can specify
|
1784
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
1785
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
1786
|
+
# in the *Amazon S3 Service Developer Guide*.
|
1787
|
+
#
|
1788
|
+
#
|
1789
|
+
#
|
1790
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
1754
1791
|
#
|
1755
1792
|
# @option params [String] :website_redirect_location
|
1756
1793
|
# If the bucket is configured as a website, redirects requests for this
|
@@ -2321,6 +2358,49 @@ module Aws::S3
|
|
2321
2358
|
req.send_request(options)
|
2322
2359
|
end
|
2323
2360
|
|
2361
|
+
# Removes `OwnershipControls` for an Amazon S3 bucket. To use this
|
2362
|
+
# operation, you must have the `s3:PutBucketOwnershipControls`
|
2363
|
+
# permission. For more information about Amazon S3 permissions, see
|
2364
|
+
# [Specifying Permissions in a Policy][1].
|
2365
|
+
#
|
2366
|
+
# For information about Amazon S3 Object Ownership, see [Using Object
|
2367
|
+
# Ownership][2].
|
2368
|
+
#
|
2369
|
+
# The following operations are related to
|
2370
|
+
# `DeleteBucketOwnershipControls`\:
|
2371
|
+
#
|
2372
|
+
# * GetBucketOwnershipControls
|
2373
|
+
#
|
2374
|
+
# * PutBucketOwnershipControls
|
2375
|
+
#
|
2376
|
+
#
|
2377
|
+
#
|
2378
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
2379
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/about-object-ownership.html
|
2380
|
+
#
|
2381
|
+
# @option params [required, String] :bucket
|
2382
|
+
# The Amazon S3 bucket whose `OwnershipControls` you want to delete.
|
2383
|
+
#
|
2384
|
+
# @option params [String] :expected_bucket_owner
|
2385
|
+
#
|
2386
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
2387
|
+
#
|
2388
|
+
# @example Request syntax with placeholder values
|
2389
|
+
#
|
2390
|
+
# resp = client.delete_bucket_ownership_controls({
|
2391
|
+
# bucket: "BucketName", # required
|
2392
|
+
# expected_bucket_owner: "AccountId",
|
2393
|
+
# })
|
2394
|
+
#
|
2395
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketOwnershipControls AWS API Documentation
|
2396
|
+
#
|
2397
|
+
# @overload delete_bucket_ownership_controls(params = {})
|
2398
|
+
# @param [Hash] params ({})
|
2399
|
+
def delete_bucket_ownership_controls(params = {}, options = {})
|
2400
|
+
req = build_request(:delete_bucket_ownership_controls, params)
|
2401
|
+
req.send_request(options)
|
2402
|
+
end
|
2403
|
+
|
2324
2404
|
# This implementation of the DELETE operation uses the policy
|
2325
2405
|
# subresource to delete the policy of a specified bucket. If you are
|
2326
2406
|
# using an identity other than the root user of the AWS account that
|
@@ -2613,7 +2693,7 @@ module Aws::S3
|
|
2613
2693
|
# When using this API with an access point, you must direct requests to
|
2614
2694
|
# the access point hostname. The access point hostname takes the form
|
2615
2695
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
2616
|
-
# When using this operation
|
2696
|
+
# When using this operation with an access point through the AWS SDKs,
|
2617
2697
|
# you provide the access point ARN in place of the bucket name. For more
|
2618
2698
|
# information about access point ARNs, see [Using Access Points][1] in
|
2619
2699
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -2630,7 +2710,7 @@ module Aws::S3
|
|
2630
2710
|
#
|
2631
2711
|
#
|
2632
2712
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
2633
|
-
# [2]: https://docs.aws.amazon.com/
|
2713
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
2634
2714
|
#
|
2635
2715
|
# @option params [required, String] :key
|
2636
2716
|
# Key name of the object to delete.
|
@@ -2749,7 +2829,7 @@ module Aws::S3
|
|
2749
2829
|
# When using this API with an access point, you must direct requests to
|
2750
2830
|
# the access point hostname. The access point hostname takes the form
|
2751
2831
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
2752
|
-
# When using this operation
|
2832
|
+
# When using this operation with an access point through the AWS SDKs,
|
2753
2833
|
# you provide the access point ARN in place of the bucket name. For more
|
2754
2834
|
# information about access point ARNs, see [Using Access Points][1] in
|
2755
2835
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -2766,7 +2846,7 @@ module Aws::S3
|
|
2766
2846
|
#
|
2767
2847
|
#
|
2768
2848
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
2769
|
-
# [2]: https://docs.aws.amazon.com/
|
2849
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
2770
2850
|
#
|
2771
2851
|
# @option params [required, String] :key
|
2772
2852
|
# Name of the object key.
|
@@ -2896,7 +2976,7 @@ module Aws::S3
|
|
2896
2976
|
# When using this API with an access point, you must direct requests to
|
2897
2977
|
# the access point hostname. The access point hostname takes the form
|
2898
2978
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
2899
|
-
# When using this operation
|
2979
|
+
# When using this operation with an access point through the AWS SDKs,
|
2900
2980
|
# you provide the access point ARN in place of the bucket name. For more
|
2901
2981
|
# information about access point ARNs, see [Using Access Points][1] in
|
2902
2982
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -2913,7 +2993,7 @@ module Aws::S3
|
|
2913
2993
|
#
|
2914
2994
|
#
|
2915
2995
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
2916
|
-
# [2]: https://docs.aws.amazon.com/
|
2996
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
2917
2997
|
#
|
2918
2998
|
# @option params [required, Types::Delete] :delete
|
2919
2999
|
# Container for the request.
|
@@ -4195,6 +4275,56 @@ module Aws::S3
|
|
4195
4275
|
req.send_request(options)
|
4196
4276
|
end
|
4197
4277
|
|
4278
|
+
# Retrieves `OwnershipControls` for an Amazon S3 bucket. To use this
|
4279
|
+
# operation, you must have the `s3:GetBucketOwnershipControls`
|
4280
|
+
# permission. For more information about Amazon S3 permissions, see
|
4281
|
+
# [Specifying Permissions in a Policy][1].
|
4282
|
+
#
|
4283
|
+
# For information about Amazon S3 Object Ownership, see [Using Object
|
4284
|
+
# Ownership][2].
|
4285
|
+
#
|
4286
|
+
# The following operations are related to `GetBucketOwnershipControls`\:
|
4287
|
+
#
|
4288
|
+
# * PutBucketOwnershipControls
|
4289
|
+
#
|
4290
|
+
# * DeleteBucketOwnershipControls
|
4291
|
+
#
|
4292
|
+
#
|
4293
|
+
#
|
4294
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
4295
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/about-object-ownership.html
|
4296
|
+
#
|
4297
|
+
# @option params [required, String] :bucket
|
4298
|
+
# The name of the Amazon S3 bucket whose `OwnershipControls` you want to
|
4299
|
+
# retrieve.
|
4300
|
+
#
|
4301
|
+
# @option params [String] :expected_bucket_owner
|
4302
|
+
#
|
4303
|
+
# @return [Types::GetBucketOwnershipControlsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4304
|
+
#
|
4305
|
+
# * {Types::GetBucketOwnershipControlsOutput#ownership_controls #ownership_controls} => Types::OwnershipControls
|
4306
|
+
#
|
4307
|
+
# @example Request syntax with placeholder values
|
4308
|
+
#
|
4309
|
+
# resp = client.get_bucket_ownership_controls({
|
4310
|
+
# bucket: "BucketName", # required
|
4311
|
+
# expected_bucket_owner: "AccountId",
|
4312
|
+
# })
|
4313
|
+
#
|
4314
|
+
# @example Response structure
|
4315
|
+
#
|
4316
|
+
# resp.ownership_controls.rules #=> Array
|
4317
|
+
# resp.ownership_controls.rules[0].object_ownership #=> String, one of "BucketOwnerPreferred", "ObjectWriter"
|
4318
|
+
#
|
4319
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketOwnershipControls AWS API Documentation
|
4320
|
+
#
|
4321
|
+
# @overload get_bucket_ownership_controls(params = {})
|
4322
|
+
# @param [Hash] params ({})
|
4323
|
+
def get_bucket_ownership_controls(params = {}, options = {})
|
4324
|
+
req = build_request(:get_bucket_ownership_controls, params)
|
4325
|
+
req.send_request(options)
|
4326
|
+
end
|
4327
|
+
|
4198
4328
|
# Returns the policy of a specified bucket. If you are using an identity
|
4199
4329
|
# other than the root user of the AWS account that owns the bucket, the
|
4200
4330
|
# calling identity must have the `GetBucketPolicy` permissions on the
|
@@ -4917,7 +5047,7 @@ module Aws::S3
|
|
4917
5047
|
# When using this API with an access point, you must direct requests to
|
4918
5048
|
# the access point hostname. The access point hostname takes the form
|
4919
5049
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
4920
|
-
# When using this operation
|
5050
|
+
# When using this operation with an access point through the AWS SDKs,
|
4921
5051
|
# you provide the access point ARN in place of the bucket name. For more
|
4922
5052
|
# information about access point ARNs, see [Using Access Points][1] in
|
4923
5053
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -4934,7 +5064,7 @@ module Aws::S3
|
|
4934
5064
|
#
|
4935
5065
|
#
|
4936
5066
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
4937
|
-
# [2]: https://docs.aws.amazon.com/
|
5067
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
4938
5068
|
#
|
4939
5069
|
# @option params [String] :if_match
|
4940
5070
|
# Return the object only if its entity tag (ETag) is the same as the one
|
@@ -5241,7 +5371,7 @@ module Aws::S3
|
|
5241
5371
|
# When using this API with an access point, you must direct requests to
|
5242
5372
|
# the access point hostname. The access point hostname takes the form
|
5243
5373
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5244
|
-
# When using this operation
|
5374
|
+
# When using this operation with an access point through the AWS SDKs,
|
5245
5375
|
# you provide the access point ARN in place of the bucket name. For more
|
5246
5376
|
# information about access point ARNs, see [Using Access Points][1] in
|
5247
5377
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -5378,7 +5508,7 @@ module Aws::S3
|
|
5378
5508
|
# When using this API with an access point, you must direct requests to
|
5379
5509
|
# the access point hostname. The access point hostname takes the form
|
5380
5510
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5381
|
-
# When using this operation
|
5511
|
+
# When using this operation with an access point through the AWS SDKs,
|
5382
5512
|
# you provide the access point ARN in place of the bucket name. For more
|
5383
5513
|
# information about access point ARNs, see [Using Access Points][1] in
|
5384
5514
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -5453,7 +5583,7 @@ module Aws::S3
|
|
5453
5583
|
# When using this API with an access point, you must direct requests to
|
5454
5584
|
# the access point hostname. The access point hostname takes the form
|
5455
5585
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5456
|
-
# When using this operation
|
5586
|
+
# When using this operation with an access point through the AWS SDKs,
|
5457
5587
|
# you provide the access point ARN in place of the bucket name. For more
|
5458
5588
|
# information about access point ARNs, see [Using Access Points][1] in
|
5459
5589
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -5510,7 +5640,7 @@ module Aws::S3
|
|
5510
5640
|
# When using this API with an access point, you must direct requests to
|
5511
5641
|
# the access point hostname. The access point hostname takes the form
|
5512
5642
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5513
|
-
# When using this operation
|
5643
|
+
# When using this operation with an access point through the AWS SDKs,
|
5514
5644
|
# you provide the access point ARN in place of the bucket name. For more
|
5515
5645
|
# information about access point ARNs, see [Using Access Points][1] in
|
5516
5646
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -5605,7 +5735,7 @@ module Aws::S3
|
|
5605
5735
|
# When using this API with an access point, you must direct requests to
|
5606
5736
|
# the access point hostname. The access point hostname takes the form
|
5607
5737
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5608
|
-
# When using this operation
|
5738
|
+
# When using this operation with an access point through the AWS SDKs,
|
5609
5739
|
# you provide the access point ARN in place of the bucket name. For more
|
5610
5740
|
# information about access point ARNs, see [Using Access Points][1] in
|
5611
5741
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -5622,7 +5752,7 @@ module Aws::S3
|
|
5622
5752
|
#
|
5623
5753
|
#
|
5624
5754
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
5625
|
-
# [2]: https://docs.aws.amazon.com/
|
5755
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
5626
5756
|
#
|
5627
5757
|
# @option params [required, String] :key
|
5628
5758
|
# Object key for which to get the tagging information.
|
@@ -5899,7 +6029,7 @@ module Aws::S3
|
|
5899
6029
|
# When using this API with an access point, you must direct requests to
|
5900
6030
|
# the access point hostname. The access point hostname takes the form
|
5901
6031
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5902
|
-
# When using this operation
|
6032
|
+
# When using this operation with an access point through the AWS SDKs,
|
5903
6033
|
# you provide the access point ARN in place of the bucket name. For more
|
5904
6034
|
# information about access point ARNs, see [Using Access Points][1] in
|
5905
6035
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -5916,7 +6046,7 @@ module Aws::S3
|
|
5916
6046
|
#
|
5917
6047
|
#
|
5918
6048
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
5919
|
-
# [2]: https://docs.aws.amazon.com/
|
6049
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
5920
6050
|
#
|
5921
6051
|
# @option params [String] :expected_bucket_owner
|
5922
6052
|
# The account id of the expected bucket owner. If the bucket is owned by
|
@@ -6046,7 +6176,7 @@ module Aws::S3
|
|
6046
6176
|
# When using this API with an access point, you must direct requests to
|
6047
6177
|
# the access point hostname. The access point hostname takes the form
|
6048
6178
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
6049
|
-
# When using this operation
|
6179
|
+
# When using this operation with an access point through the AWS SDKs,
|
6050
6180
|
# you provide the access point ARN in place of the bucket name. For more
|
6051
6181
|
# information about access point ARNs, see [Using Access Points][1] in
|
6052
6182
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -6063,7 +6193,7 @@ module Aws::S3
|
|
6063
6193
|
#
|
6064
6194
|
#
|
6065
6195
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
6066
|
-
# [2]: https://docs.aws.amazon.com/
|
6196
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
6067
6197
|
#
|
6068
6198
|
# @option params [String] :if_match
|
6069
6199
|
# Return the object only if its entity tag (ETag) is the same as the one
|
@@ -6087,13 +6217,17 @@ module Aws::S3
|
|
6087
6217
|
# @option params [String] :range
|
6088
6218
|
# Downloads the specified range bytes of an object. For more information
|
6089
6219
|
# about the HTTP Range header, see
|
6090
|
-
# [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35]
|
6220
|
+
# [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
|
6091
6221
|
#
|
6092
6222
|
# <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
|
6093
6223
|
# `GET` request.
|
6094
6224
|
#
|
6095
6225
|
# </note>
|
6096
6226
|
#
|
6227
|
+
#
|
6228
|
+
#
|
6229
|
+
# [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
|
6230
|
+
#
|
6097
6231
|
# @option params [String] :version_id
|
6098
6232
|
# VersionId used to reference a specific version of the object.
|
6099
6233
|
#
|
@@ -6660,7 +6794,7 @@ module Aws::S3
|
|
6660
6794
|
# When using this API with an access point, you must direct requests to
|
6661
6795
|
# the access point hostname. The access point hostname takes the form
|
6662
6796
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
6663
|
-
# When using this operation
|
6797
|
+
# When using this operation with an access point through the AWS SDKs,
|
6664
6798
|
# you provide the access point ARN in place of the bucket name. For more
|
6665
6799
|
# information about access point ARNs, see [Using Access Points][1] in
|
6666
6800
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -6677,7 +6811,7 @@ module Aws::S3
|
|
6677
6811
|
#
|
6678
6812
|
#
|
6679
6813
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
6680
|
-
# [2]: https://docs.aws.amazon.com/
|
6814
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
6681
6815
|
#
|
6682
6816
|
# @option params [String] :delimiter
|
6683
6817
|
# Character you use to group keys.
|
@@ -7122,7 +7256,7 @@ module Aws::S3
|
|
7122
7256
|
# When using this API with an access point, you must direct requests to
|
7123
7257
|
# the access point hostname. The access point hostname takes the form
|
7124
7258
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
7125
|
-
# When using this operation
|
7259
|
+
# When using this operation with an access point through the AWS SDKs,
|
7126
7260
|
# you provide the access point ARN in place of the bucket name. For more
|
7127
7261
|
# information about access point ARNs, see [Using Access Points][1] in
|
7128
7262
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -7139,7 +7273,7 @@ module Aws::S3
|
|
7139
7273
|
#
|
7140
7274
|
#
|
7141
7275
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
7142
|
-
# [2]: https://docs.aws.amazon.com/
|
7276
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
7143
7277
|
#
|
7144
7278
|
# @option params [String] :delimiter
|
7145
7279
|
# A delimiter is a character you use to group keys.
|
@@ -7316,7 +7450,7 @@ module Aws::S3
|
|
7316
7450
|
# When using this API with an access point, you must direct requests to
|
7317
7451
|
# the access point hostname. The access point hostname takes the form
|
7318
7452
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
7319
|
-
# When using this operation
|
7453
|
+
# When using this operation with an access point through the AWS SDKs,
|
7320
7454
|
# you provide the access point ARN in place of the bucket name. For more
|
7321
7455
|
# information about access point ARNs, see [Using Access Points][1] in
|
7322
7456
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -7333,7 +7467,7 @@ module Aws::S3
|
|
7333
7467
|
#
|
7334
7468
|
#
|
7335
7469
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
7336
|
-
# [2]: https://docs.aws.amazon.com/
|
7470
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
7337
7471
|
#
|
7338
7472
|
# @option params [String] :delimiter
|
7339
7473
|
# A delimiter is a character you use to group keys.
|
@@ -7522,7 +7656,7 @@ module Aws::S3
|
|
7522
7656
|
# When using this API with an access point, you must direct requests to
|
7523
7657
|
# the access point hostname. The access point hostname takes the form
|
7524
7658
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
7525
|
-
# When using this operation
|
7659
|
+
# When using this operation with an access point through the AWS SDKs,
|
7526
7660
|
# you provide the access point ARN in place of the bucket name. For more
|
7527
7661
|
# information about access point ARNs, see [Using Access Points][1] in
|
7528
7662
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -7539,7 +7673,7 @@ module Aws::S3
|
|
7539
7673
|
#
|
7540
7674
|
#
|
7541
7675
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
7542
|
-
# [2]: https://docs.aws.amazon.com/
|
7676
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
7543
7677
|
#
|
7544
7678
|
# @option params [required, String] :key
|
7545
7679
|
# Object key for which the multipart upload was initiated.
|
@@ -9296,6 +9430,64 @@ module Aws::S3
|
|
9296
9430
|
req.send_request(options)
|
9297
9431
|
end
|
9298
9432
|
|
9433
|
+
# Creates or modifies `OwnershipControls` for an Amazon S3 bucket. To
|
9434
|
+
# use this operation, you must have the `s3:GetBucketOwnershipControls`
|
9435
|
+
# permission. For more information about Amazon S3 permissions, see
|
9436
|
+
# [Specifying Permissions in a Policy][1].
|
9437
|
+
#
|
9438
|
+
# For information about Amazon S3 Object Ownership, see [Using Object
|
9439
|
+
# Ownership][2].
|
9440
|
+
#
|
9441
|
+
# The following operations are related to `GetBucketOwnershipControls`\:
|
9442
|
+
#
|
9443
|
+
# * GetBucketOwnershipControls
|
9444
|
+
#
|
9445
|
+
# * DeleteBucketOwnershipControls
|
9446
|
+
#
|
9447
|
+
#
|
9448
|
+
#
|
9449
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
9450
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/about-object-ownership.html
|
9451
|
+
#
|
9452
|
+
# @option params [required, String] :bucket
|
9453
|
+
# The name of the Amazon S3 bucket whose `OwnershipControls` you want to
|
9454
|
+
# set.
|
9455
|
+
#
|
9456
|
+
# @option params [String] :content_md5
|
9457
|
+
# The MD5 hash of the `OwnershipControls` request body.
|
9458
|
+
#
|
9459
|
+
# @option params [String] :expected_bucket_owner
|
9460
|
+
#
|
9461
|
+
# @option params [required, Types::OwnershipControls] :ownership_controls
|
9462
|
+
# The `OwnershipControls` (BucketOwnerPreferred or ObjectWriter) that
|
9463
|
+
# you want to apply to this Amazon S3 bucket.
|
9464
|
+
#
|
9465
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
9466
|
+
#
|
9467
|
+
# @example Request syntax with placeholder values
|
9468
|
+
#
|
9469
|
+
# resp = client.put_bucket_ownership_controls({
|
9470
|
+
# bucket: "BucketName", # required
|
9471
|
+
# content_md5: "ContentMD5",
|
9472
|
+
# expected_bucket_owner: "AccountId",
|
9473
|
+
# ownership_controls: { # required
|
9474
|
+
# rules: [ # required
|
9475
|
+
# {
|
9476
|
+
# object_ownership: "BucketOwnerPreferred", # required, accepts BucketOwnerPreferred, ObjectWriter
|
9477
|
+
# },
|
9478
|
+
# ],
|
9479
|
+
# },
|
9480
|
+
# })
|
9481
|
+
#
|
9482
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketOwnershipControls AWS API Documentation
|
9483
|
+
#
|
9484
|
+
# @overload put_bucket_ownership_controls(params = {})
|
9485
|
+
# @param [Hash] params ({})
|
9486
|
+
def put_bucket_ownership_controls(params = {}, options = {})
|
9487
|
+
req = build_request(:put_bucket_ownership_controls, params)
|
9488
|
+
req.send_request(options)
|
9489
|
+
end
|
9490
|
+
|
9299
9491
|
# Applies an Amazon S3 bucket policy to an Amazon S3 bucket. If you are
|
9300
9492
|
# using an identity other than the root user of the AWS account that
|
9301
9493
|
# owns the bucket, the calling identity must have the `PutBucketPolicy`
|
@@ -10105,11 +10297,12 @@ module Aws::S3
|
|
10105
10297
|
#
|
10106
10298
|
# **Storage Class Options**
|
10107
10299
|
#
|
10108
|
-
# By default, Amazon S3 uses the STANDARD
|
10300
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
10109
10301
|
# created objects. The STANDARD storage class provides high durability
|
10110
10302
|
# and high availability. Depending on performance needs, you can specify
|
10111
|
-
# a different
|
10112
|
-
#
|
10303
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
10304
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][5]
|
10305
|
+
# in the *Amazon S3 Service Developer Guide*.
|
10113
10306
|
#
|
10114
10307
|
# **Versioning**
|
10115
10308
|
#
|
@@ -10145,6 +10338,8 @@ module Aws::S3
|
|
10145
10338
|
# The canned ACL to apply to the object. For more information, see
|
10146
10339
|
# [Canned ACL][1].
|
10147
10340
|
#
|
10341
|
+
# This action is not supported by Amazon S3 on Outposts.
|
10342
|
+
#
|
10148
10343
|
#
|
10149
10344
|
#
|
10150
10345
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
@@ -10158,7 +10353,7 @@ module Aws::S3
|
|
10158
10353
|
# When using this API with an access point, you must direct requests to
|
10159
10354
|
# the access point hostname. The access point hostname takes the form
|
10160
10355
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
10161
|
-
# When using this operation
|
10356
|
+
# When using this operation with an access point through the AWS SDKs,
|
10162
10357
|
# you provide the access point ARN in place of the bucket name. For more
|
10163
10358
|
# information about access point ARNs, see [Using Access Points][1] in
|
10164
10359
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -10175,7 +10370,7 @@ module Aws::S3
|
|
10175
10370
|
#
|
10176
10371
|
#
|
10177
10372
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
10178
|
-
# [2]: https://docs.aws.amazon.com/
|
10373
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
10179
10374
|
#
|
10180
10375
|
# @option params [String] :cache_control
|
10181
10376
|
# Can be used to specify caching behavior along the request/reply chain.
|
@@ -10252,15 +10447,23 @@ module Aws::S3
|
|
10252
10447
|
# Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
|
10253
10448
|
# object.
|
10254
10449
|
#
|
10450
|
+
# This action is not supported by Amazon S3 on Outposts.
|
10451
|
+
#
|
10255
10452
|
# @option params [String] :grant_read
|
10256
10453
|
# Allows grantee to read the object data and its metadata.
|
10257
10454
|
#
|
10455
|
+
# This action is not supported by Amazon S3 on Outposts.
|
10456
|
+
#
|
10258
10457
|
# @option params [String] :grant_read_acp
|
10259
10458
|
# Allows grantee to read the object ACL.
|
10260
10459
|
#
|
10460
|
+
# This action is not supported by Amazon S3 on Outposts.
|
10461
|
+
#
|
10261
10462
|
# @option params [String] :grant_write_acp
|
10262
10463
|
# Allows grantee to write the ACL for the applicable object.
|
10263
10464
|
#
|
10465
|
+
# This action is not supported by Amazon S3 on Outposts.
|
10466
|
+
#
|
10264
10467
|
# @option params [required, String] :key
|
10265
10468
|
# Object key for which the PUT operation was initiated.
|
10266
10469
|
#
|
@@ -10272,8 +10475,16 @@ module Aws::S3
|
|
10272
10475
|
# Amazon S3 (for example, AES256, aws:kms).
|
10273
10476
|
#
|
10274
10477
|
# @option params [String] :storage_class
|
10275
|
-
#
|
10276
|
-
#
|
10478
|
+
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
10479
|
+
# created objects. The STANDARD storage class provides high durability
|
10480
|
+
# and high availability. Depending on performance needs, you can specify
|
10481
|
+
# a different Storage Class. Amazon S3 on Outposts only uses the
|
10482
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][1]
|
10483
|
+
# in the *Amazon S3 Service Developer Guide*.
|
10484
|
+
#
|
10485
|
+
#
|
10486
|
+
#
|
10487
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
10277
10488
|
#
|
10278
10489
|
# @option params [String] :website_redirect_location
|
10279
10490
|
# If the bucket is configured as a website, redirects requests for this
|
@@ -10748,7 +10959,7 @@ module Aws::S3
|
|
10748
10959
|
# When using this API with an access point, you must direct requests to
|
10749
10960
|
# the access point hostname. The access point hostname takes the form
|
10750
10961
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
10751
|
-
# When using this operation
|
10962
|
+
# When using this operation with an access point through the AWS SDKs,
|
10752
10963
|
# you provide the access point ARN in place of the bucket name. For more
|
10753
10964
|
# information about access point ARNs, see [Using Access Points][1] in
|
10754
10965
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -10771,12 +10982,18 @@ module Aws::S3
|
|
10771
10982
|
# Allows grantee the read, write, read ACP, and write ACP permissions on
|
10772
10983
|
# the bucket.
|
10773
10984
|
#
|
10985
|
+
# This action is not supported by Amazon S3 on Outposts.
|
10986
|
+
#
|
10774
10987
|
# @option params [String] :grant_read
|
10775
10988
|
# Allows grantee to list the objects in the bucket.
|
10776
10989
|
#
|
10990
|
+
# This action is not supported by Amazon S3 on Outposts.
|
10991
|
+
#
|
10777
10992
|
# @option params [String] :grant_read_acp
|
10778
10993
|
# Allows grantee to read the bucket ACL.
|
10779
10994
|
#
|
10995
|
+
# This action is not supported by Amazon S3 on Outposts.
|
10996
|
+
#
|
10780
10997
|
# @option params [String] :grant_write
|
10781
10998
|
# Allows grantee to create, overwrite, and delete any object in the
|
10782
10999
|
# bucket.
|
@@ -10784,13 +11001,15 @@ module Aws::S3
|
|
10784
11001
|
# @option params [String] :grant_write_acp
|
10785
11002
|
# Allows grantee to write the ACL for the applicable bucket.
|
10786
11003
|
#
|
11004
|
+
# This action is not supported by Amazon S3 on Outposts.
|
11005
|
+
#
|
10787
11006
|
# @option params [required, String] :key
|
10788
11007
|
# Key for which the PUT operation was initiated.
|
10789
11008
|
#
|
10790
11009
|
# When using this API with an access point, you must direct requests to
|
10791
11010
|
# the access point hostname. The access point hostname takes the form
|
10792
11011
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
10793
|
-
# When using this operation
|
11012
|
+
# When using this operation with an access point through the AWS SDKs,
|
10794
11013
|
# you provide the access point ARN in place of the bucket name. For more
|
10795
11014
|
# information about access point ARNs, see [Using Access Points][1] in
|
10796
11015
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -10807,7 +11026,7 @@ module Aws::S3
|
|
10807
11026
|
#
|
10808
11027
|
#
|
10809
11028
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
10810
|
-
# [2]: https://docs.aws.amazon.com/
|
11029
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
10811
11030
|
#
|
10812
11031
|
# @option params [String] :request_payer
|
10813
11032
|
# Confirms that the requester knows that they will be charged for the
|
@@ -10920,7 +11139,7 @@ module Aws::S3
|
|
10920
11139
|
# When using this API with an access point, you must direct requests to
|
10921
11140
|
# the access point hostname. The access point hostname takes the form
|
10922
11141
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
10923
|
-
# When using this operation
|
11142
|
+
# When using this operation with an access point through the AWS SDKs,
|
10924
11143
|
# you provide the access point ARN in place of the bucket name. For more
|
10925
11144
|
# information about access point ARNs, see [Using Access Points][1] in
|
10926
11145
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -11096,7 +11315,7 @@ module Aws::S3
|
|
11096
11315
|
# When using this API with an access point, you must direct requests to
|
11097
11316
|
# the access point hostname. The access point hostname takes the form
|
11098
11317
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
11099
|
-
# When using this operation
|
11318
|
+
# When using this operation with an access point through the AWS SDKs,
|
11100
11319
|
# you provide the access point ARN in place of the bucket name. For more
|
11101
11320
|
# information about access point ARNs, see [Using Access Points][1] in
|
11102
11321
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -11234,7 +11453,7 @@ module Aws::S3
|
|
11234
11453
|
# When using this API with an access point, you must direct requests to
|
11235
11454
|
# the access point hostname. The access point hostname takes the form
|
11236
11455
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
11237
|
-
# When using this operation
|
11456
|
+
# When using this operation with an access point through the AWS SDKs,
|
11238
11457
|
# you provide the access point ARN in place of the bucket name. For more
|
11239
11458
|
# information about access point ARNs, see [Using Access Points][1] in
|
11240
11459
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -11251,7 +11470,7 @@ module Aws::S3
|
|
11251
11470
|
#
|
11252
11471
|
#
|
11253
11472
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
11254
|
-
# [2]: https://docs.aws.amazon.com/
|
11473
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
11255
11474
|
#
|
11256
11475
|
# @option params [required, String] :key
|
11257
11476
|
# Name of the object key.
|
@@ -11663,7 +11882,7 @@ module Aws::S3
|
|
11663
11882
|
# When using this API with an access point, you must direct requests to
|
11664
11883
|
# the access point hostname. The access point hostname takes the form
|
11665
11884
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
11666
|
-
# When using this operation
|
11885
|
+
# When using this operation with an access point through the AWS SDKs,
|
11667
11886
|
# you provide the access point ARN in place of the bucket name. For more
|
11668
11887
|
# information about access point ARNs, see [Using Access Points][1] in
|
11669
11888
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -11680,7 +11899,7 @@ module Aws::S3
|
|
11680
11899
|
#
|
11681
11900
|
#
|
11682
11901
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
11683
|
-
# [2]: https://docs.aws.amazon.com/
|
11902
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
11684
11903
|
#
|
11685
11904
|
# @option params [required, String] :key
|
11686
11905
|
# Object key for which the operation was initiated.
|
@@ -12278,6 +12497,11 @@ module Aws::S3
|
|
12278
12497
|
# checks the part data against the provided MD5 value. If they do not
|
12279
12498
|
# match, Amazon S3 returns an error.
|
12280
12499
|
#
|
12500
|
+
# If the upload request is signed with Signature Version 4, then AWS S3
|
12501
|
+
# uses the `x-amz-content-sha256` header as a checksum instead of
|
12502
|
+
# `Content-MD5`. For more information see [Authenticating Requests:
|
12503
|
+
# Using the Authorization Header (AWS Signature Version 4)][3].
|
12504
|
+
#
|
12281
12505
|
# **Note:** After you initiate multipart upload and upload one or more
|
12282
12506
|
# parts, you must either complete or abort multipart upload in order to
|
12283
12507
|
# stop getting charged for storage of the uploaded parts. Only after you
|
@@ -12285,11 +12509,11 @@ module Aws::S3
|
|
12285
12509
|
# parts storage and stops charging you for the parts storage.
|
12286
12510
|
#
|
12287
12511
|
# For more information on multipart uploads, go to [Multipart Upload
|
12288
|
-
# Overview][
|
12512
|
+
# Overview][4] in the <i>Amazon Simple Storage Service Developer Guide
|
12289
12513
|
# </i>.
|
12290
12514
|
#
|
12291
12515
|
# For information on the permissions required to use the multipart
|
12292
|
-
# upload API, go to [Multipart Upload API and Permissions][
|
12516
|
+
# upload API, go to [Multipart Upload API and Permissions][5] in the
|
12293
12517
|
# *Amazon Simple Storage Service Developer Guide*.
|
12294
12518
|
#
|
12295
12519
|
# You can optionally request server-side encryption where Amazon S3
|
@@ -12300,7 +12524,7 @@ module Aws::S3
|
|
12300
12524
|
# request headers you provide in the request must match the headers you
|
12301
12525
|
# used in the request to initiate the upload by using
|
12302
12526
|
# [CreateMultipartUpload][2]. For more information, go to [Using
|
12303
|
-
# Server-Side Encryption][
|
12527
|
+
# Server-Side Encryption][6] in the *Amazon Simple Storage Service
|
12304
12528
|
# Developer Guide*.
|
12305
12529
|
#
|
12306
12530
|
# Server-side encryption is supported by the S3 Multipart Upload
|
@@ -12337,25 +12561,26 @@ module Aws::S3
|
|
12337
12561
|
#
|
12338
12562
|
# * [CreateMultipartUpload][2]
|
12339
12563
|
#
|
12340
|
-
# * [CompleteMultipartUpload][
|
12564
|
+
# * [CompleteMultipartUpload][7]
|
12341
12565
|
#
|
12342
|
-
# * [AbortMultipartUpload][
|
12566
|
+
# * [AbortMultipartUpload][8]
|
12343
12567
|
#
|
12344
|
-
# * [ListParts][
|
12568
|
+
# * [ListParts][9]
|
12345
12569
|
#
|
12346
|
-
# * [ListMultipartUploads][
|
12570
|
+
# * [ListMultipartUploads][10]
|
12347
12571
|
#
|
12348
12572
|
#
|
12349
12573
|
#
|
12350
12574
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
12351
12575
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
12352
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12353
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
12354
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
12355
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12356
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12357
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12358
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12576
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
|
12577
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
12578
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
12579
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
12580
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
12581
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
12582
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
12583
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
12359
12584
|
#
|
12360
12585
|
# @option params [String, StringIO, File] :body
|
12361
12586
|
# Object data.
|
@@ -12366,7 +12591,7 @@ module Aws::S3
|
|
12366
12591
|
# When using this API with an access point, you must direct requests to
|
12367
12592
|
# the access point hostname. The access point hostname takes the form
|
12368
12593
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
12369
|
-
# When using this operation
|
12594
|
+
# When using this operation with an access point through the AWS SDKs,
|
12370
12595
|
# you provide the access point ARN in place of the bucket name. For more
|
12371
12596
|
# information about access point ARNs, see [Using Access Points][1] in
|
12372
12597
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -12383,7 +12608,7 @@ module Aws::S3
|
|
12383
12608
|
#
|
12384
12609
|
#
|
12385
12610
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
12386
|
-
# [2]: https://docs.aws.amazon.com/
|
12611
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
12387
12612
|
#
|
12388
12613
|
# @option params [Integer] :content_length
|
12389
12614
|
# Size of the body in bytes. This parameter is useful when the size of
|
@@ -12639,7 +12864,7 @@ module Aws::S3
|
|
12639
12864
|
# When using this API with an access point, you must direct requests to
|
12640
12865
|
# the access point hostname. The access point hostname takes the form
|
12641
12866
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
12642
|
-
# When using this operation
|
12867
|
+
# When using this operation with an access point through the AWS SDKs,
|
12643
12868
|
# you provide the access point ARN in place of the bucket name. For more
|
12644
12869
|
# information about access point ARNs, see [Using Access Points][1] in
|
12645
12870
|
# the *Amazon Simple Storage Service Developer Guide*.
|
@@ -12656,7 +12881,7 @@ module Aws::S3
|
|
12656
12881
|
#
|
12657
12882
|
#
|
12658
12883
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
|
12659
|
-
# [2]: https://docs.aws.amazon.com/
|
12884
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
|
12660
12885
|
#
|
12661
12886
|
# @option params [required, String] :copy_source
|
12662
12887
|
# Specifies the source object for the copy operation. You specify the
|
@@ -12898,7 +13123,7 @@ module Aws::S3
|
|
12898
13123
|
params: params,
|
12899
13124
|
config: config)
|
12900
13125
|
context[:gem_name] = 'aws-sdk-s3'
|
12901
|
-
context[:gem_version] = '1.
|
13126
|
+
context[:gem_version] = '1.83.0'
|
12902
13127
|
Seahorse::Client::Request.new(handlers, context)
|
12903
13128
|
end
|
12904
13129
|
|