aws-sdk-s3 1.82.0 → 1.83.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: e842f232d7e50f3e6f5a12aeecd8c1efc1cee2171e92944b773f8b66de1379f5
4
- data.tar.gz: f30436b18bccb7cb2d20f8c024c55ea6192638d34089fd43bfef7092e1b1096e
3
+ metadata.gz: 27e8142d94b3b51ad2725ffab43afcc4bbd80562eb8370ae34dd5833001e850f
4
+ data.tar.gz: a8ca9825f4ec5e42f6c126d41e3073c618525082a0e07196073d4bd68bc5c0de
5
5
  SHA512:
6
- metadata.gz: 5a0e7f3d81929759b8b9e17c83f9212c40145da665b9b146061a2e6ff6b8ac6b97028d10529fedfbc561be344561098d61c8c0428b60df525dd8265f28879728
7
- data.tar.gz: 39403a36b6fadea6ae1c9a4b029650761dc3fbee30db41fd450694dfc1f5a2297fb8012f85f82e418fff52c63e4b36ba6ecc7facb0e5629cd09725b737c659cc
6
+ metadata.gz: 6ede8e603a7ae101eb9e3eaec06dddb179654f73ce1df05a7eeee4629a2a48c0feef529b6a0a6cf35508c2666e02df6414b215c7631c07cd83303aaf8e16b127
7
+ data.tar.gz: 05fa2eb62aa82394adf13d2262faf9a29c685ca001316e8001b6c760e534a1e736c4663564ef2f75f074abea8cd5f4956e6063569ce7200d062afd2684a03f82
@@ -69,6 +69,6 @@ require_relative 'aws-sdk-s3/event_streams'
69
69
  # @!group service
70
70
  module Aws::S3
71
71
 
72
- GEM_VERSION = '1.82.0'
72
+ GEM_VERSION = '1.83.0'
73
73
 
74
74
  end
@@ -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
- # If you don't specify, S3 Standard is the default storage class.
455
- # Amazon S3 supports other storage classes.
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.
@@ -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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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
- # The type of storage to use for the object. Defaults to 'STANDARD'.
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 Buckets][1].
1269
+ # bucket naming restrictions, see [Working with Amazon S3 buckets][1].
1251
1270
  #
1252
- # If you want to create an **Amazon S3 on Outposts** bucket, see [Create
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 [How to Select a Region
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 Hosting of Buckets][4].
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 Control List (ACL)
1289
- # Overview][6].
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 using an access point through the AWS SDKs,
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
- # The type of storage to use for the object. Defaults to 'STANDARD'.
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 storage class to store newly
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 storage class. For more information, see [Storage
10112
- # Classes][5] in the *Amazon S3 Service Developer Guide*.
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 using an access point through the AWS SDKs,
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
- # If you don't specify, S3 Standard is the default storage class.
10276
- # Amazon S3 supports other storage classes.
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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][3] in the <i>Amazon Simple Storage Service Developer Guide
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][4] in the
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][5] in the *Amazon Simple Storage Service
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][6]
12564
+ # * [CompleteMultipartUpload][7]
12341
12565
  #
12342
- # * [AbortMultipartUpload][7]
12566
+ # * [AbortMultipartUpload][8]
12343
12567
  #
12344
- # * [ListParts][8]
12568
+ # * [ListParts][9]
12345
12569
  #
12346
- # * [ListMultipartUploads][9]
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/dev/mpuoverview.html
12353
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
12354
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
12355
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
12356
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
12357
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
12358
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
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 using an access point through the AWS SDKs,
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 using an access point through the AWS SDKs,
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.82.0'
13126
+ context[:gem_version] = '1.83.0'
12902
13127
  Seahorse::Client::Request.new(handlers, context)
12903
13128
  end
12904
13129