aws-sdk-s3 1.91.0 → 1.94.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (36) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +29 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3.rb +1 -1
  5. data/lib/aws-sdk-s3/arn/access_point_arn.rb +4 -6
  6. data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +64 -0
  7. data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +4 -6
  8. data/lib/aws-sdk-s3/bucket.rb +6 -6
  9. data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
  10. data/lib/aws-sdk-s3/bucket_cors.rb +3 -4
  11. data/lib/aws-sdk-s3/bucket_lifecycle.rb +2 -2
  12. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +2 -2
  13. data/lib/aws-sdk-s3/bucket_logging.rb +1 -1
  14. data/lib/aws-sdk-s3/bucket_notification.rb +1 -1
  15. data/lib/aws-sdk-s3/bucket_policy.rb +2 -2
  16. data/lib/aws-sdk-s3/bucket_request_payment.rb +1 -1
  17. data/lib/aws-sdk-s3/bucket_tagging.rb +2 -2
  18. data/lib/aws-sdk-s3/bucket_versioning.rb +3 -3
  19. data/lib/aws-sdk-s3/bucket_website.rb +2 -2
  20. data/lib/aws-sdk-s3/client.rb +758 -482
  21. data/lib/aws-sdk-s3/client_api.rb +58 -0
  22. data/lib/aws-sdk-s3/customizations/object.rb +30 -11
  23. data/lib/aws-sdk-s3/file_uploader.rb +2 -2
  24. data/lib/aws-sdk-s3/multipart_upload.rb +3 -3
  25. data/lib/aws-sdk-s3/multipart_upload_part.rb +4 -4
  26. data/lib/aws-sdk-s3/object.rb +96 -10
  27. data/lib/aws-sdk-s3/object_acl.rb +1 -1
  28. data/lib/aws-sdk-s3/object_summary.rb +9 -9
  29. data/lib/aws-sdk-s3/object_version.rb +4 -4
  30. data/lib/aws-sdk-s3/plugins/arn.rb +57 -34
  31. data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +9 -9
  32. data/lib/aws-sdk-s3/plugins/object_lambda_endpoint.rb +25 -0
  33. data/lib/aws-sdk-s3/plugins/s3_signer.rb +6 -0
  34. data/lib/aws-sdk-s3/presigner.rb +12 -3
  35. data/lib/aws-sdk-s3/types.rb +567 -243
  36. metadata +7 -6
@@ -39,6 +39,7 @@ require 'aws-sdk-s3/plugins/http_200_errors.rb'
39
39
  require 'aws-sdk-s3/plugins/iad_regional_endpoint.rb'
40
40
  require 'aws-sdk-s3/plugins/location_constraint.rb'
41
41
  require 'aws-sdk-s3/plugins/md5s.rb'
42
+ require 'aws-sdk-s3/plugins/object_lambda_endpoint.rb'
42
43
  require 'aws-sdk-s3/plugins/redirects.rb'
43
44
  require 'aws-sdk-s3/plugins/s3_host_id.rb'
44
45
  require 'aws-sdk-s3/plugins/s3_signer.rb'
@@ -102,6 +103,7 @@ module Aws::S3
102
103
  add_plugin(Aws::S3::Plugins::IADRegionalEndpoint)
103
104
  add_plugin(Aws::S3::Plugins::LocationConstraint)
104
105
  add_plugin(Aws::S3::Plugins::Md5s)
106
+ add_plugin(Aws::S3::Plugins::ObjectLambdaEndpoint)
105
107
  add_plugin(Aws::S3::Plugins::Redirects)
106
108
  add_plugin(Aws::S3::Plugins::S3HostId)
107
109
  add_plugin(Aws::S3::Plugins::S3Signer)
@@ -326,8 +328,8 @@ module Aws::S3
326
328
  #
327
329
  #
328
330
  # @option options [String] :s3_us_east_1_regional_endpoint ("legacy")
329
- # Passing in `regional` to enable regional endpoint for S3's `us-east-1`
330
- # region. Defaults to `legacy` mode using global endpoint.
331
+ # Pass in `regional` to enable the `us-east-1` regional endpoint.
332
+ # Defaults to `legacy` mode which uses the global endpoint.
331
333
  #
332
334
  # @option options [Boolean] :s3_use_arn_region (true)
333
335
  # For S3 ARNs passed into the `:bucket` parameter, this option will
@@ -453,7 +455,7 @@ module Aws::S3
453
455
  # When using this action with an access point through the AWS SDKs, you
454
456
  # provide the access point ARN in place of the bucket name. For more
455
457
  # information about access point ARNs, see [Using Access Points][1] in
456
- # the *Amazon Simple Storage Service Developer Guide*.
458
+ # the *Amazon S3 User Guide*.
457
459
  #
458
460
  # When using this action with Amazon S3 on Outposts, you must direct
459
461
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -462,12 +464,12 @@ module Aws::S3
462
464
  # When using this action using S3 on Outposts through the AWS SDKs, you
463
465
  # provide the Outposts bucket ARN in place of the bucket name. For more
464
466
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
465
- # in the *Amazon Simple Storage Service Developer Guide*.
467
+ # in the *Amazon S3 User Guide*.
466
468
  #
467
469
  #
468
470
  #
469
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
470
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
471
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
472
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
471
473
  #
472
474
  # @option params [required, String] :key
473
475
  # Key of the object for which the multipart upload was initiated.
@@ -487,7 +489,7 @@ module Aws::S3
487
489
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
488
490
  #
489
491
  # @option params [String] :expected_bucket_owner
490
- # The account id of the expected bucket owner. If the bucket is owned by
492
+ # The account ID of the expected bucket owner. If the bucket is owned by
491
493
  # a different account, the request will fail with an HTTP `403 (Access
492
494
  # Denied)` error.
493
495
  #
@@ -645,7 +647,7 @@ module Aws::S3
645
647
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
646
648
  #
647
649
  # @option params [String] :expected_bucket_owner
648
- # The account id of the expected bucket owner. If the bucket is owned by
650
+ # The account ID of the expected bucket owner. If the bucket is owned by
649
651
  # a different account, the request will fail with an HTTP `403 (Access
650
652
  # Denied)` error.
651
653
  #
@@ -844,7 +846,7 @@ module Aws::S3
844
846
  #
845
847
  # If a target object uses SSE-KMS, you can enable an S3 Bucket Key for
846
848
  # the object. For more information, see [Amazon S3 Bucket Keys][9] in
847
- # the *Amazon Simple Storage Service User Guide*.
849
+ # the *Amazon S3 User Guide*.
848
850
  #
849
851
  # **Access Control List (ACL)-Specific Request Headers**
850
852
  #
@@ -924,7 +926,7 @@ module Aws::S3
924
926
  # When using this action with an access point through the AWS SDKs, you
925
927
  # provide the access point ARN in place of the bucket name. For more
926
928
  # information about access point ARNs, see [Using Access Points][1] in
927
- # the *Amazon Simple Storage Service Developer Guide*.
929
+ # the *Amazon S3 User Guide*.
928
930
  #
929
931
  # When using this action with Amazon S3 on Outposts, you must direct
930
932
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -933,12 +935,12 @@ module Aws::S3
933
935
  # When using this action using S3 on Outposts through the AWS SDKs, you
934
936
  # provide the Outposts bucket ARN in place of the bucket name. For more
935
937
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
936
- # in the *Amazon Simple Storage Service Developer Guide*.
938
+ # in the *Amazon S3 User Guide*.
937
939
  #
938
940
  #
939
941
  #
940
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
941
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
942
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
943
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
942
944
  #
943
945
  # @option params [String] :cache_control
944
946
  # Specifies caching behavior along the request/reply chain.
@@ -1001,7 +1003,7 @@ module Aws::S3
1001
1003
  #
1002
1004
  #
1003
1005
  #
1004
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
1006
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html
1005
1007
  #
1006
1008
  # @option params [String] :copy_source_if_match
1007
1009
  # Copies the object if its entity tag (ETag) matches the specified tag.
@@ -1159,12 +1161,12 @@ module Aws::S3
1159
1161
  # Specifies whether you want to apply a Legal Hold to the copied object.
1160
1162
  #
1161
1163
  # @option params [String] :expected_bucket_owner
1162
- # The account id of the expected destination bucket owner. If the
1164
+ # The account ID of the expected destination bucket owner. If the
1163
1165
  # destination bucket is owned by a different account, the request will
1164
1166
  # fail with an HTTP `403 (Access Denied)` error.
1165
1167
  #
1166
1168
  # @option params [String] :expected_source_bucket_owner
1167
- # The account id of the expected source bucket owner. If the source
1169
+ # The account ID of the expected source bucket owner. If the source
1168
1170
  # bucket is owned by a different account, the request will fail with an
1169
1171
  # HTTP `403 (Access Denied)` error.
1170
1172
  #
@@ -1417,33 +1419,33 @@ module Aws::S3
1417
1419
  # * {Types::CreateBucketOutput#location #location} => String
1418
1420
  #
1419
1421
  #
1420
- # @example Example: To create a bucket
1422
+ # @example Example: To create a bucket in a specific region
1421
1423
  #
1422
- # # The following example creates a bucket.
1424
+ # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
1423
1425
  #
1424
1426
  # resp = client.create_bucket({
1425
1427
  # bucket: "examplebucket",
1428
+ # create_bucket_configuration: {
1429
+ # location_constraint: "eu-west-1",
1430
+ # },
1426
1431
  # })
1427
1432
  #
1428
1433
  # resp.to_h outputs the following:
1429
1434
  # {
1430
- # location: "/examplebucket",
1435
+ # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
1431
1436
  # }
1432
1437
  #
1433
- # @example Example: To create a bucket in a specific region
1438
+ # @example Example: To create a bucket
1434
1439
  #
1435
- # # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
1440
+ # # The following example creates a bucket.
1436
1441
  #
1437
1442
  # resp = client.create_bucket({
1438
1443
  # bucket: "examplebucket",
1439
- # create_bucket_configuration: {
1440
- # location_constraint: "eu-west-1",
1441
- # },
1442
1444
  # })
1443
1445
  #
1444
1446
  # resp.to_h outputs the following:
1445
1447
  # {
1446
- # location: "http://examplebucket.<Region>.s3.amazonaws.com/",
1448
+ # location: "/examplebucket",
1447
1449
  # }
1448
1450
  #
1449
1451
  # @example Request syntax with placeholder values
@@ -1722,7 +1724,7 @@ module Aws::S3
1722
1724
  # When using this action with an access point through the AWS SDKs, you
1723
1725
  # provide the access point ARN in place of the bucket name. For more
1724
1726
  # information about access point ARNs, see [Using Access Points][1] in
1725
- # the *Amazon Simple Storage Service Developer Guide*.
1727
+ # the *Amazon S3 User Guide*.
1726
1728
  #
1727
1729
  # When using this action with Amazon S3 on Outposts, you must direct
1728
1730
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -1731,12 +1733,12 @@ module Aws::S3
1731
1733
  # When using this action using S3 on Outposts through the AWS SDKs, you
1732
1734
  # provide the Outposts bucket ARN in place of the bucket name. For more
1733
1735
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
1734
- # in the *Amazon Simple Storage Service Developer Guide*.
1736
+ # in the *Amazon S3 User Guide*.
1735
1737
  #
1736
1738
  #
1737
1739
  #
1738
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
1739
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
1740
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
1741
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
1740
1742
  #
1741
1743
  # @option params [String] :cache_control
1742
1744
  # Specifies caching behavior along the request/reply chain.
@@ -1875,7 +1877,7 @@ module Aws::S3
1875
1877
  # object.
1876
1878
  #
1877
1879
  # @option params [String] :expected_bucket_owner
1878
- # The account id of the expected bucket owner. If the bucket is owned by
1880
+ # The account ID of the expected bucket owner. If the bucket is owned by
1879
1881
  # a different account, the request will fail with an HTTP `403 (Access
1880
1882
  # Denied)` error.
1881
1883
  #
@@ -1990,7 +1992,7 @@ module Aws::S3
1990
1992
  # Specifies the bucket being deleted.
1991
1993
  #
1992
1994
  # @option params [String] :expected_bucket_owner
1993
- # The account id of the expected bucket owner. If the bucket is owned by
1995
+ # The account ID of the expected bucket owner. If the bucket is owned by
1994
1996
  # a different account, the request will fail with an HTTP `403 (Access
1995
1997
  # Denied)` error.
1996
1998
  #
@@ -2045,8 +2047,8 @@ module Aws::S3
2045
2047
  #
2046
2048
  #
2047
2049
  #
2048
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2049
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2050
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2051
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2050
2052
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
2051
2053
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
2052
2054
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -2060,7 +2062,7 @@ module Aws::S3
2060
2062
  # The ID that identifies the analytics configuration.
2061
2063
  #
2062
2064
  # @option params [String] :expected_bucket_owner
2063
- # The account id of the expected bucket owner. If the bucket is owned by
2065
+ # The account ID of the expected bucket owner. If the bucket is owned by
2064
2066
  # a different account, the request will fail with an HTTP `403 (Access
2065
2067
  # Denied)` error.
2066
2068
  #
@@ -2090,7 +2092,7 @@ module Aws::S3
2090
2092
  # default and can grant this permission to others.
2091
2093
  #
2092
2094
  # For information about `cors`, see [Enabling Cross-Origin Resource
2093
- # Sharing][1] in the *Amazon Simple Storage Service User Guide*.
2095
+ # Sharing][1] in the *Amazon S3 User Guide*.
2094
2096
  #
2095
2097
  # **Related Resources:**
2096
2098
  #
@@ -2108,7 +2110,7 @@ module Aws::S3
2108
2110
  # Specifies the bucket whose `cors` configuration is being deleted.
2109
2111
  #
2110
2112
  # @option params [String] :expected_bucket_owner
2111
- # The account id of the expected bucket owner. If the bucket is owned by
2113
+ # The account ID of the expected bucket owner. If the bucket is owned by
2112
2114
  # a different account, the request will fail with an HTTP `403 (Access
2113
2115
  # Denied)` error.
2114
2116
  #
@@ -2142,15 +2144,15 @@ module Aws::S3
2142
2144
  # This implementation of the DELETE action removes default encryption
2143
2145
  # from the bucket. For information about the Amazon S3 default
2144
2146
  # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
2145
- # the *Amazon Simple Storage Service User Guide*.
2147
+ # the *Amazon S3 User Guide*.
2146
2148
  #
2147
2149
  # To use this operation, you must have permissions to perform the
2148
2150
  # `s3:PutEncryptionConfiguration` action. The bucket owner has this
2149
2151
  # permission by default. The bucket owner can grant this permission to
2150
2152
  # others. For more information about permissions, see [Permissions
2151
2153
  # Related to Bucket Subresource Operations][2] and [Managing Access
2152
- # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
2153
- # Storage Service User Guide*.
2154
+ # Permissions to your Amazon S3 Resources][3] in the *Amazon S3 User
2155
+ # Guide*.
2154
2156
  #
2155
2157
  # **Related Resources**
2156
2158
  #
@@ -2161,8 +2163,8 @@ module Aws::S3
2161
2163
  #
2162
2164
  #
2163
2165
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
2164
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2165
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2166
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2167
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2166
2168
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
2167
2169
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
2168
2170
  #
@@ -2171,7 +2173,7 @@ module Aws::S3
2171
2173
  # configuration to delete.
2172
2174
  #
2173
2175
  # @option params [String] :expected_bucket_owner
2174
- # The account id of the expected bucket owner. If the bucket is owned by
2176
+ # The account ID of the expected bucket owner. If the bucket is owned by
2175
2177
  # a different account, the request will fail with an HTTP `403 (Access
2176
2178
  # Denied)` error.
2177
2179
  #
@@ -2278,8 +2280,8 @@ module Aws::S3
2278
2280
  #
2279
2281
  #
2280
2282
  #
2281
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2282
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2283
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2284
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2283
2285
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
2284
2286
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
2285
2287
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketInventoryConfiguration.html
@@ -2293,7 +2295,7 @@ module Aws::S3
2293
2295
  # The ID used to identify the inventory configuration.
2294
2296
  #
2295
2297
  # @option params [String] :expected_bucket_owner
2296
- # The account id of the expected bucket owner. If the bucket is owned by
2298
+ # The account ID of the expected bucket owner. If the bucket is owned by
2297
2299
  # a different account, the request will fail with an HTTP `403 (Access
2298
2300
  # Denied)` error.
2299
2301
  #
@@ -2349,7 +2351,7 @@ module Aws::S3
2349
2351
  # The bucket name of the lifecycle to delete.
2350
2352
  #
2351
2353
  # @option params [String] :expected_bucket_owner
2352
- # The account id of the expected bucket owner. If the bucket is owned by
2354
+ # The account ID of the expected bucket owner. If the bucket is owned by
2353
2355
  # a different account, the request will fail with an HTTP `403 (Access
2354
2356
  # Denied)` error.
2355
2357
  #
@@ -2407,8 +2409,8 @@ module Aws::S3
2407
2409
  #
2408
2410
  #
2409
2411
  #
2410
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2411
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2412
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2413
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2412
2414
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
2413
2415
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
2414
2416
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
@@ -2421,7 +2423,7 @@ module Aws::S3
2421
2423
  # The ID used to identify the metrics configuration.
2422
2424
  #
2423
2425
  # @option params [String] :expected_bucket_owner
2424
- # The account id of the expected bucket owner. If the bucket is owned by
2426
+ # The account ID of the expected bucket owner. If the bucket is owned by
2425
2427
  # a different account, the request will fail with an HTTP `403 (Access
2426
2428
  # Denied)` error.
2427
2429
  #
@@ -2468,7 +2470,7 @@ module Aws::S3
2468
2470
  # The Amazon S3 bucket whose `OwnershipControls` you want to delete.
2469
2471
  #
2470
2472
  # @option params [String] :expected_bucket_owner
2471
- # The account id of the expected bucket owner. If the bucket is owned by
2473
+ # The account ID of the expected bucket owner. If the bucket is owned by
2472
2474
  # a different account, the request will fail with an HTTP `403 (Access
2473
2475
  # Denied)` error.
2474
2476
  #
@@ -2525,7 +2527,7 @@ module Aws::S3
2525
2527
  # The bucket name.
2526
2528
  #
2527
2529
  # @option params [String] :expected_bucket_owner
2528
- # The account id of the expected bucket owner. If the bucket is owned by
2530
+ # The account ID of the expected bucket owner. If the bucket is owned by
2529
2531
  # a different account, the request will fail with an HTTP `403 (Access
2530
2532
  # Denied)` error.
2531
2533
  #
@@ -2581,8 +2583,8 @@ module Aws::S3
2581
2583
  #
2582
2584
  #
2583
2585
  #
2584
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2585
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
2586
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
2587
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
2586
2588
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html
2587
2589
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketReplication.html
2588
2590
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
@@ -2591,7 +2593,7 @@ module Aws::S3
2591
2593
  # The bucket name.
2592
2594
  #
2593
2595
  # @option params [String] :expected_bucket_owner
2594
- # The account id of the expected bucket owner. If the bucket is owned by
2596
+ # The account ID of the expected bucket owner. If the bucket is owned by
2595
2597
  # a different account, the request will fail with an HTTP `403 (Access
2596
2598
  # Denied)` error.
2597
2599
  #
@@ -2643,7 +2645,7 @@ module Aws::S3
2643
2645
  # The bucket that has the tag set to be removed.
2644
2646
  #
2645
2647
  # @option params [String] :expected_bucket_owner
2646
- # The account id of the expected bucket owner. If the bucket is owned by
2648
+ # The account ID of the expected bucket owner. If the bucket is owned by
2647
2649
  # a different account, the request will fail with an HTTP `403 (Access
2648
2650
  # Denied)` error.
2649
2651
  #
@@ -2707,7 +2709,7 @@ module Aws::S3
2707
2709
  # configuration.
2708
2710
  #
2709
2711
  # @option params [String] :expected_bucket_owner
2710
- # The account id of the expected bucket owner. If the bucket is owned by
2712
+ # The account ID of the expected bucket owner. If the bucket is owned by
2711
2713
  # a different account, the request will fail with an HTTP `403 (Access
2712
2714
  # Denied)` error.
2713
2715
  #
@@ -2740,7 +2742,8 @@ module Aws::S3
2740
2742
 
2741
2743
  # Removes the null version (if there is one) of an object and inserts a
2742
2744
  # delete marker, which becomes the latest version of the object. If
2743
- # there isn't a null version, Amazon S3 does not remove any objects.
2745
+ # there isn't a null version, Amazon S3 does not remove any objects but
2746
+ # will still respond that the command was successful.
2744
2747
  #
2745
2748
  # To remove a specific version, you must be the bucket owner and you
2746
2749
  # must use the version Id subresource. Using this subresource
@@ -2785,7 +2788,7 @@ module Aws::S3
2785
2788
  # When using this action with an access point through the AWS SDKs, you
2786
2789
  # provide the access point ARN in place of the bucket name. For more
2787
2790
  # information about access point ARNs, see [Using Access Points][1] in
2788
- # the *Amazon Simple Storage Service Developer Guide*.
2791
+ # the *Amazon S3 User Guide*.
2789
2792
  #
2790
2793
  # When using this action with Amazon S3 on Outposts, you must direct
2791
2794
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2794,12 +2797,12 @@ module Aws::S3
2794
2797
  # When using this action using S3 on Outposts through the AWS SDKs, you
2795
2798
  # provide the Outposts bucket ARN in place of the bucket name. For more
2796
2799
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
2797
- # in the *Amazon Simple Storage Service Developer Guide*.
2800
+ # in the *Amazon S3 User Guide*.
2798
2801
  #
2799
2802
  #
2800
2803
  #
2801
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2802
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2804
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
2805
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2803
2806
  #
2804
2807
  # @option params [required, String] :key
2805
2808
  # Key name of the object to delete.
@@ -2829,7 +2832,7 @@ module Aws::S3
2829
2832
  # restrictions to process this operation.
2830
2833
  #
2831
2834
  # @option params [String] :expected_bucket_owner
2832
- # The account id of the expected bucket owner. If the bucket is owned by
2835
+ # The account ID of the expected bucket owner. If the bucket is owned by
2833
2836
  # a different account, the request will fail with an HTTP `403 (Access
2834
2837
  # Denied)` error.
2835
2838
  #
@@ -2840,6 +2843,15 @@ module Aws::S3
2840
2843
  # * {Types::DeleteObjectOutput#request_charged #request_charged} => String
2841
2844
  #
2842
2845
  #
2846
+ # @example Example: To delete an object (from a non-versioned bucket)
2847
+ #
2848
+ # # The following example deletes an object from a non-versioned bucket.
2849
+ #
2850
+ # resp = client.delete_object({
2851
+ # bucket: "ExampleBucket",
2852
+ # key: "HappyFace.jpg",
2853
+ # })
2854
+ #
2843
2855
  # @example Example: To delete an object
2844
2856
  #
2845
2857
  # # The following example deletes an object from an S3 bucket.
@@ -2853,15 +2865,6 @@ module Aws::S3
2853
2865
  # {
2854
2866
  # }
2855
2867
  #
2856
- # @example Example: To delete an object (from a non-versioned bucket)
2857
- #
2858
- # # The following example deletes an object from a non-versioned bucket.
2859
- #
2860
- # resp = client.delete_object({
2861
- # bucket: "ExampleBucket",
2862
- # key: "HappyFace.jpg",
2863
- # })
2864
- #
2865
2868
  # @example Request syntax with placeholder values
2866
2869
  #
2867
2870
  # resp = client.delete_object({
@@ -2921,7 +2924,7 @@ module Aws::S3
2921
2924
  # When using this action with an access point through the AWS SDKs, you
2922
2925
  # provide the access point ARN in place of the bucket name. For more
2923
2926
  # information about access point ARNs, see [Using Access Points][1] in
2924
- # the *Amazon Simple Storage Service Developer Guide*.
2927
+ # the *Amazon S3 User Guide*.
2925
2928
  #
2926
2929
  # When using this action with Amazon S3 on Outposts, you must direct
2927
2930
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -2930,12 +2933,12 @@ module Aws::S3
2930
2933
  # When using this action using S3 on Outposts through the AWS SDKs, you
2931
2934
  # provide the Outposts bucket ARN in place of the bucket name. For more
2932
2935
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
2933
- # in the *Amazon Simple Storage Service Developer Guide*.
2936
+ # in the *Amazon S3 User Guide*.
2934
2937
  #
2935
2938
  #
2936
2939
  #
2937
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2938
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
2940
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
2941
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
2939
2942
  #
2940
2943
  # @option params [required, String] :key
2941
2944
  # The key that identifies the object in the bucket from which to remove
@@ -2945,7 +2948,7 @@ module Aws::S3
2945
2948
  # The versionId of the object that the tag-set will be removed from.
2946
2949
  #
2947
2950
  # @option params [String] :expected_bucket_owner
2948
- # The account id of the expected bucket owner. If the bucket is owned by
2951
+ # The account ID of the expected bucket owner. If the bucket is owned by
2949
2952
  # a different account, the request will fail with an HTTP `403 (Access
2950
2953
  # Denied)` error.
2951
2954
  #
@@ -2954,35 +2957,35 @@ module Aws::S3
2954
2957
  # * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
2955
2958
  #
2956
2959
  #
2957
- # @example Example: To remove tag set from an object version
2960
+ # @example Example: To remove tag set from an object
2958
2961
  #
2959
- # # The following example removes tag set associated with the specified object version. The request specifies both the
2960
- # # object key and object version.
2962
+ # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2963
+ # # operation removes tag set from the latest object version.
2961
2964
  #
2962
2965
  # resp = client.delete_object_tagging({
2963
2966
  # bucket: "examplebucket",
2964
2967
  # key: "HappyFace.jpg",
2965
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2966
2968
  # })
2967
2969
  #
2968
2970
  # resp.to_h outputs the following:
2969
2971
  # {
2970
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2972
+ # version_id: "null",
2971
2973
  # }
2972
2974
  #
2973
- # @example Example: To remove tag set from an object
2975
+ # @example Example: To remove tag set from an object version
2974
2976
  #
2975
- # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2976
- # # operation removes tag set from the latest object version.
2977
+ # # The following example removes tag set associated with the specified object version. The request specifies both the
2978
+ # # object key and object version.
2977
2979
  #
2978
2980
  # resp = client.delete_object_tagging({
2979
2981
  # bucket: "examplebucket",
2980
2982
  # key: "HappyFace.jpg",
2983
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2981
2984
  # })
2982
2985
  #
2983
2986
  # resp.to_h outputs the following:
2984
2987
  # {
2985
- # version_id: "null",
2988
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2986
2989
  # }
2987
2990
  #
2988
2991
  # @example Request syntax with placeholder values
@@ -3069,7 +3072,7 @@ module Aws::S3
3069
3072
  # When using this action with an access point through the AWS SDKs, you
3070
3073
  # provide the access point ARN in place of the bucket name. For more
3071
3074
  # information about access point ARNs, see [Using Access Points][1] in
3072
- # the *Amazon Simple Storage Service Developer Guide*.
3075
+ # the *Amazon S3 User Guide*.
3073
3076
  #
3074
3077
  # When using this action with Amazon S3 on Outposts, you must direct
3075
3078
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -3078,12 +3081,12 @@ module Aws::S3
3078
3081
  # When using this action using S3 on Outposts through the AWS SDKs, you
3079
3082
  # provide the Outposts bucket ARN in place of the bucket name. For more
3080
3083
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
3081
- # in the *Amazon Simple Storage Service Developer Guide*.
3084
+ # in the *Amazon S3 User Guide*.
3082
3085
  #
3083
3086
  #
3084
3087
  #
3085
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
3086
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
3088
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
3089
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
3087
3090
  #
3088
3091
  # @option params [required, Types::Delete] :delete
3089
3092
  # Container for the request.
@@ -3111,7 +3114,7 @@ module Aws::S3
3111
3114
  # permissions to perform this operation.
3112
3115
  #
3113
3116
  # @option params [String] :expected_bucket_owner
3114
- # The account id of the expected bucket owner. If the bucket is owned by
3117
+ # The account ID of the expected bucket owner. If the bucket is owned by
3115
3118
  # a different account, the request will fail with an HTTP `403 (Access
3116
3119
  # Denied)` error.
3117
3120
  #
@@ -3122,20 +3125,22 @@ module Aws::S3
3122
3125
  # * {Types::DeleteObjectsOutput#errors #errors} => Array&lt;Types::Error&gt;
3123
3126
  #
3124
3127
  #
3125
- # @example Example: To delete multiple objects from a versioned bucket
3128
+ # @example Example: To delete multiple object versions from a versioned bucket
3126
3129
  #
3127
- # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
3128
- # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
3130
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
3131
+ # # versions and returns the key and versions of deleted objects in the response.
3129
3132
  #
3130
3133
  # resp = client.delete_objects({
3131
3134
  # bucket: "examplebucket",
3132
3135
  # delete: {
3133
3136
  # objects: [
3134
3137
  # {
3135
- # key: "objectkey1",
3138
+ # key: "HappyFace.jpg",
3139
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3136
3140
  # },
3137
3141
  # {
3138
- # key: "objectkey2",
3142
+ # key: "HappyFace.jpg",
3143
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3139
3144
  # },
3140
3145
  # ],
3141
3146
  # quiet: false,
@@ -3146,34 +3151,30 @@ module Aws::S3
3146
3151
  # {
3147
3152
  # deleted: [
3148
3153
  # {
3149
- # delete_marker: true,
3150
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
3151
- # key: "objectkey1",
3154
+ # key: "HappyFace.jpg",
3155
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3152
3156
  # },
3153
3157
  # {
3154
- # delete_marker: true,
3155
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
3156
- # key: "objectkey2",
3158
+ # key: "HappyFace.jpg",
3159
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3157
3160
  # },
3158
3161
  # ],
3159
3162
  # }
3160
3163
  #
3161
- # @example Example: To delete multiple object versions from a versioned bucket
3164
+ # @example Example: To delete multiple objects from a versioned bucket
3162
3165
  #
3163
- # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
3164
- # # versions and returns the key and versions of deleted objects in the response.
3166
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
3167
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
3165
3168
  #
3166
3169
  # resp = client.delete_objects({
3167
3170
  # bucket: "examplebucket",
3168
3171
  # delete: {
3169
3172
  # objects: [
3170
3173
  # {
3171
- # key: "HappyFace.jpg",
3172
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3174
+ # key: "objectkey1",
3173
3175
  # },
3174
3176
  # {
3175
- # key: "HappyFace.jpg",
3176
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3177
+ # key: "objectkey2",
3177
3178
  # },
3178
3179
  # ],
3179
3180
  # quiet: false,
@@ -3184,12 +3185,14 @@ module Aws::S3
3184
3185
  # {
3185
3186
  # deleted: [
3186
3187
  # {
3187
- # key: "HappyFace.jpg",
3188
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
3188
+ # delete_marker: true,
3189
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
3190
+ # key: "objectkey1",
3189
3191
  # },
3190
3192
  # {
3191
- # key: "HappyFace.jpg",
3192
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
3193
+ # delete_marker: true,
3194
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
3195
+ # key: "objectkey2",
3193
3196
  # },
3194
3197
  # ],
3195
3198
  # }
@@ -3255,8 +3258,8 @@ module Aws::S3
3255
3258
  #
3256
3259
  #
3257
3260
  #
3258
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3259
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3261
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3262
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3260
3263
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html
3261
3264
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetPublicAccessBlock.html
3262
3265
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutPublicAccessBlock.html
@@ -3267,7 +3270,7 @@ module Aws::S3
3267
3270
  # to delete.
3268
3271
  #
3269
3272
  # @option params [String] :expected_bucket_owner
3270
- # The account id of the expected bucket owner. If the bucket is owned by
3273
+ # The account ID of the expected bucket owner. If the bucket is owned by
3271
3274
  # a different account, the request will fail with an HTTP `403 (Access
3272
3275
  # Denied)` error.
3273
3276
  #
@@ -3300,8 +3303,8 @@ module Aws::S3
3300
3303
  # permission by default. The bucket owner can grant this permission to
3301
3304
  # others. For more information about permissions, see [Permissions
3302
3305
  # Related to Bucket Subresource Operations][1] and [Managing Access
3303
- # Permissions to your Amazon S3 Resources][2] in the *Amazon Simple
3304
- # Storage Service User Guide*.
3306
+ # Permissions to your Amazon S3 Resources][2] in the *Amazon S3 User
3307
+ # Guide*.
3305
3308
  #
3306
3309
  # You set the Transfer Acceleration state of an existing bucket to
3307
3310
  # `Enabled` or `Suspended` by using the
@@ -3312,7 +3315,7 @@ module Aws::S3
3312
3315
  # Acceleration state if a state has never been set on the bucket.
3313
3316
  #
3314
3317
  # For more information about transfer acceleration, see [Transfer
3315
- # Acceleration][4] in the Amazon Simple Storage Service User Guide.
3318
+ # Acceleration][4] in the Amazon S3 User Guide.
3316
3319
  #
3317
3320
  # **Related Resources**
3318
3321
  #
@@ -3322,8 +3325,8 @@ module Aws::S3
3322
3325
  #
3323
3326
  #
3324
3327
  #
3325
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3326
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3328
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3329
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3327
3330
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketAccelerateConfiguration.html
3328
3331
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
3329
3332
  #
@@ -3332,7 +3335,7 @@ module Aws::S3
3332
3335
  # retrieved.
3333
3336
  #
3334
3337
  # @option params [String] :expected_bucket_owner
3335
- # The account id of the expected bucket owner. If the bucket is owned by
3338
+ # The account ID of the expected bucket owner. If the bucket is owned by
3336
3339
  # a different account, the request will fail with an HTTP `403 (Access
3337
3340
  # Denied)` error.
3338
3341
  #
@@ -3381,7 +3384,7 @@ module Aws::S3
3381
3384
  # Specifies the S3 bucket whose ACL is being requested.
3382
3385
  #
3383
3386
  # @option params [String] :expected_bucket_owner
3384
- # The account id of the expected bucket owner. If the bucket is owned by
3387
+ # The account ID of the expected bucket owner. If the bucket is owned by
3385
3388
  # a different account, the request will fail with an HTTP `403 (Access
3386
3389
  # Denied)` error.
3387
3390
  #
@@ -3427,12 +3430,11 @@ module Aws::S3
3427
3430
  # permission by default. The bucket owner can grant this permission to
3428
3431
  # others. For more information about permissions, see [ Permissions
3429
3432
  # Related to Bucket Subresource Operations][1] and [Managing Access
3430
- # Permissions to Your Amazon S3 Resources][2] in the *Amazon Simple
3431
- # Storage Service User Guide*.
3433
+ # Permissions to Your Amazon S3 Resources][2] in the *Amazon S3 User
3434
+ # Guide*.
3432
3435
  #
3433
3436
  # For information about Amazon S3 analytics feature, see [Amazon S3
3434
- # Analytics – Storage Class Analysis][3] in the *Amazon Simple Storage
3435
- # Service User Guide*.
3437
+ # Analytics – Storage Class Analysis][3] in the *Amazon S3 User Guide*.
3436
3438
  #
3437
3439
  # **Related Resources**
3438
3440
  #
@@ -3444,8 +3446,8 @@ module Aws::S3
3444
3446
  #
3445
3447
  #
3446
3448
  #
3447
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3448
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3449
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3450
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3449
3451
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
3450
3452
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
3451
3453
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -3459,7 +3461,7 @@ module Aws::S3
3459
3461
  # The ID that identifies the analytics configuration.
3460
3462
  #
3461
3463
  # @option params [String] :expected_bucket_owner
3462
- # The account id of the expected bucket owner. If the bucket is owned by
3464
+ # The account ID of the expected bucket owner. If the bucket is owned by
3463
3465
  # a different account, the request will fail with an HTTP `403 (Access
3464
3466
  # Denied)` error.
3465
3467
  #
@@ -3525,7 +3527,7 @@ module Aws::S3
3525
3527
  # The bucket name for which to get the cors configuration.
3526
3528
  #
3527
3529
  # @option params [String] :expected_bucket_owner
3528
- # The account id of the expected bucket owner. If the bucket is owned by
3530
+ # The account ID of the expected bucket owner. If the bucket is owned by
3529
3531
  # a different account, the request will fail with an HTTP `403 (Access
3530
3532
  # Denied)` error.
3531
3533
  #
@@ -3614,8 +3616,8 @@ module Aws::S3
3614
3616
  #
3615
3617
  #
3616
3618
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
3617
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3618
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3619
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3620
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3619
3621
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
3620
3622
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
3621
3623
  #
@@ -3624,7 +3626,7 @@ module Aws::S3
3624
3626
  # configuration is retrieved.
3625
3627
  #
3626
3628
  # @option params [String] :expected_bucket_owner
3627
- # The account id of the expected bucket owner. If the bucket is owned by
3629
+ # The account ID of the expected bucket owner. If the bucket is owned by
3628
3630
  # a different account, the request will fail with an HTTP `403 (Access
3629
3631
  # Denied)` error.
3630
3632
  #
@@ -3758,8 +3760,8 @@ module Aws::S3
3758
3760
  #
3759
3761
  #
3760
3762
  #
3761
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3762
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3763
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3764
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3763
3765
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
3764
3766
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
3765
3767
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
@@ -3773,7 +3775,7 @@ module Aws::S3
3773
3775
  # The ID used to identify the inventory configuration.
3774
3776
  #
3775
3777
  # @option params [String] :expected_bucket_owner
3776
- # The account id of the expected bucket owner. If the bucket is owned by
3778
+ # The account ID of the expected bucket owner. If the bucket is owned by
3777
3779
  # a different account, the request will fail with an HTTP `403 (Access
3778
3780
  # Denied)` error.
3779
3781
  #
@@ -3852,8 +3854,8 @@ module Aws::S3
3852
3854
  #
3853
3855
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
3854
3856
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
3855
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3856
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3857
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3858
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3857
3859
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
3858
3860
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
3859
3861
  #
@@ -3861,7 +3863,7 @@ module Aws::S3
3861
3863
  # The name of the bucket for which to get the lifecycle information.
3862
3864
  #
3863
3865
  # @option params [String] :expected_bucket_owner
3864
- # The account id of the expected bucket owner. If the bucket is owned by
3866
+ # The account ID of the expected bucket owner. If the bucket is owned by
3865
3867
  # a different account, the request will fail with an HTTP `403 (Access
3866
3868
  # Denied)` error.
3867
3869
  #
@@ -3970,8 +3972,8 @@ module Aws::S3
3970
3972
  #
3971
3973
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
3972
3974
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
3973
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3974
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
3975
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
3976
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
3975
3977
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
3976
3978
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketLifecycle.html
3977
3979
  #
@@ -3979,7 +3981,7 @@ module Aws::S3
3979
3981
  # The name of the bucket for which to get the lifecycle information.
3980
3982
  #
3981
3983
  # @option params [String] :expected_bucket_owner
3982
- # The account id of the expected bucket owner. If the bucket is owned by
3984
+ # The account ID of the expected bucket owner. If the bucket is owned by
3983
3985
  # a different account, the request will fail with an HTTP `403 (Access
3984
3986
  # Denied)` error.
3985
3987
  #
@@ -4077,7 +4079,7 @@ module Aws::S3
4077
4079
  # The name of the bucket for which to get the location.
4078
4080
  #
4079
4081
  # @option params [String] :expected_bucket_owner
4080
- # The account id of the expected bucket owner. If the bucket is owned by
4082
+ # The account ID of the expected bucket owner. If the bucket is owned by
4081
4083
  # a different account, the request will fail with an HTTP `403 (Access
4082
4084
  # Denied)` error.
4083
4085
  #
@@ -4138,7 +4140,7 @@ module Aws::S3
4138
4140
  # The bucket name for which to get the logging information.
4139
4141
  #
4140
4142
  # @option params [String] :expected_bucket_owner
4141
- # The account id of the expected bucket owner. If the bucket is owned by
4143
+ # The account ID of the expected bucket owner. If the bucket is owned by
4142
4144
  # a different account, the request will fail with an HTTP `403 (Access
4143
4145
  # Denied)` error.
4144
4146
  #
@@ -4201,8 +4203,8 @@ module Aws::S3
4201
4203
  #
4202
4204
  #
4203
4205
  #
4204
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
4205
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
4206
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
4207
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
4206
4208
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
4207
4209
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
4208
4210
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
@@ -4216,7 +4218,7 @@ module Aws::S3
4216
4218
  # The ID used to identify the metrics configuration.
4217
4219
  #
4218
4220
  # @option params [String] :expected_bucket_owner
4219
- # The account id of the expected bucket owner. If the bucket is owned by
4221
+ # The account ID of the expected bucket owner. If the bucket is owned by
4220
4222
  # a different account, the request will fail with an HTTP `403 (Access
4221
4223
  # Denied)` error.
4222
4224
  #
@@ -4263,7 +4265,7 @@ module Aws::S3
4263
4265
  # configuration.
4264
4266
  #
4265
4267
  # @option params [String] :expected_bucket_owner
4266
- # The account id of the expected bucket owner. If the bucket is owned by
4268
+ # The account ID of the expected bucket owner. If the bucket is owned by
4267
4269
  # a different account, the request will fail with an HTTP `403 (Access
4268
4270
  # Denied)` error.
4269
4271
  #
@@ -4397,7 +4399,7 @@ module Aws::S3
4397
4399
  # configuration.
4398
4400
  #
4399
4401
  # @option params [String] :expected_bucket_owner
4400
- # The account id of the expected bucket owner. If the bucket is owned by
4402
+ # The account ID of the expected bucket owner. If the bucket is owned by
4401
4403
  # a different account, the request will fail with an HTTP `403 (Access
4402
4404
  # Denied)` error.
4403
4405
  #
@@ -4474,7 +4476,7 @@ module Aws::S3
4474
4476
  # retrieve.
4475
4477
  #
4476
4478
  # @option params [String] :expected_bucket_owner
4477
- # The account id of the expected bucket owner. If the bucket is owned by
4479
+ # The account ID of the expected bucket owner. If the bucket is owned by
4478
4480
  # a different account, the request will fail with an HTTP `403 (Access
4479
4481
  # Denied)` error.
4480
4482
  #
@@ -4536,7 +4538,7 @@ module Aws::S3
4536
4538
  # The bucket name for which to get the bucket policy.
4537
4539
  #
4538
4540
  # @option params [String] :expected_bucket_owner
4539
- # The account id of the expected bucket owner. If the bucket is owned by
4541
+ # The account ID of the expected bucket owner. If the bucket is owned by
4540
4542
  # a different account, the request will fail with an HTTP `403 (Access
4541
4543
  # Denied)` error.
4542
4544
  #
@@ -4611,7 +4613,7 @@ module Aws::S3
4611
4613
  # retrieve.
4612
4614
  #
4613
4615
  # @option params [String] :expected_bucket_owner
4614
- # The account id of the expected bucket owner. If the bucket is owned by
4616
+ # The account ID of the expected bucket owner. If the bucket is owned by
4615
4617
  # a different account, the request will fail with an HTTP `403 (Access
4616
4618
  # Denied)` error.
4617
4619
  #
@@ -4648,7 +4650,7 @@ module Aws::S3
4648
4650
  # </note>
4649
4651
  #
4650
4652
  # For information about replication configuration, see [Replication][1]
4651
- # in the *Amazon Simple Storage Service User Guide*.
4653
+ # in the *Amazon S3 User Guide*.
4652
4654
  #
4653
4655
  # This action requires permissions for the
4654
4656
  # `s3:GetReplicationConfiguration` action. For more information about
@@ -4679,7 +4681,7 @@ module Aws::S3
4679
4681
  # The bucket name for which to get the replication information.
4680
4682
  #
4681
4683
  # @option params [String] :expected_bucket_owner
4682
- # The account id of the expected bucket owner. If the bucket is owned by
4684
+ # The account ID of the expected bucket owner. If the bucket is owned by
4683
4685
  # a different account, the request will fail with an HTTP `403 (Access
4684
4686
  # Denied)` error.
4685
4687
  #
@@ -4778,7 +4780,7 @@ module Aws::S3
4778
4780
  # configuration
4779
4781
  #
4780
4782
  # @option params [String] :expected_bucket_owner
4781
- # The account id of the expected bucket owner. If the bucket is owned by
4783
+ # The account ID of the expected bucket owner. If the bucket is owned by
4782
4784
  # a different account, the request will fail with an HTTP `403 (Access
4783
4785
  # Denied)` error.
4784
4786
  #
@@ -4849,7 +4851,7 @@ module Aws::S3
4849
4851
  # The name of the bucket for which to get the tagging information.
4850
4852
  #
4851
4853
  # @option params [String] :expected_bucket_owner
4852
- # The account id of the expected bucket owner. If the bucket is owned by
4854
+ # The account ID of the expected bucket owner. If the bucket is owned by
4853
4855
  # a different account, the request will fail with an HTTP `403 (Access
4854
4856
  # Denied)` error.
4855
4857
  #
@@ -4930,7 +4932,7 @@ module Aws::S3
4930
4932
  # The name of the bucket for which to get the versioning information.
4931
4933
  #
4932
4934
  # @option params [String] :expected_bucket_owner
4933
- # The account id of the expected bucket owner. If the bucket is owned by
4935
+ # The account ID of the expected bucket owner. If the bucket is owned by
4934
4936
  # a different account, the request will fail with an HTTP `403 (Access
4935
4937
  # Denied)` error.
4936
4938
  #
@@ -5002,7 +5004,7 @@ module Aws::S3
5002
5004
  # The bucket name for which to get the website configuration.
5003
5005
  #
5004
5006
  # @option params [String] :expected_bucket_owner
5005
- # The account id of the expected bucket owner. If the bucket is owned by
5007
+ # The account ID of the expected bucket owner. If the bucket is owned by
5006
5008
  # a different account, the request will fail with an HTTP `403 (Access
5007
5009
  # Denied)` error.
5008
5010
  #
@@ -5230,7 +5232,7 @@ module Aws::S3
5230
5232
  # When using this action with an access point through the AWS SDKs, you
5231
5233
  # provide the access point ARN in place of the bucket name. For more
5232
5234
  # information about access point ARNs, see [Using Access Points][1] in
5233
- # the *Amazon Simple Storage Service Developer Guide*.
5235
+ # the *Amazon S3 User Guide*.
5234
5236
  #
5235
5237
  # When using this action with Amazon S3 on Outposts, you must direct
5236
5238
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5239,12 +5241,12 @@ module Aws::S3
5239
5241
  # When using this action using S3 on Outposts through the AWS SDKs, you
5240
5242
  # provide the Outposts bucket ARN in place of the bucket name. For more
5241
5243
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
5242
- # in the *Amazon Simple Storage Service Developer Guide*.
5244
+ # in the *Amazon S3 User Guide*.
5243
5245
  #
5244
5246
  #
5245
5247
  #
5246
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5247
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
5248
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5249
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5248
5250
  #
5249
5251
  # @option params [String] :if_match
5250
5252
  # Return the object only if its entity tag (ETag) is the same as the one
@@ -5334,7 +5336,7 @@ module Aws::S3
5334
5336
  # object.
5335
5337
  #
5336
5338
  # @option params [String] :expected_bucket_owner
5337
- # The account id of the expected bucket owner. If the bucket is owned by
5339
+ # The account ID of the expected bucket owner. If the bucket is owned by
5338
5340
  # a different account, the request will fail with an HTTP `403 (Access
5339
5341
  # Denied)` error.
5340
5342
  #
@@ -5375,49 +5377,49 @@ module Aws::S3
5375
5377
  # * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
5376
5378
  #
5377
5379
  #
5378
- # @example Example: To retrieve a byte range of an object
5380
+ # @example Example: To retrieve an object
5379
5381
  #
5380
- # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
5381
- # # specific byte range.
5382
+ # # The following example retrieves an object for an S3 bucket.
5382
5383
  #
5383
5384
  # resp = client.get_object({
5384
5385
  # bucket: "examplebucket",
5385
- # key: "SampleFile.txt",
5386
- # range: "bytes=0-9",
5386
+ # key: "HappyFace.jpg",
5387
5387
  # })
5388
5388
  #
5389
5389
  # resp.to_h outputs the following:
5390
5390
  # {
5391
5391
  # accept_ranges: "bytes",
5392
- # content_length: 10,
5393
- # content_range: "bytes 0-9/43",
5394
- # content_type: "text/plain",
5395
- # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
5396
- # last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
5392
+ # content_length: 3191,
5393
+ # content_type: "image/jpeg",
5394
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
5395
+ # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
5397
5396
  # metadata: {
5398
5397
  # },
5398
+ # tag_count: 2,
5399
5399
  # version_id: "null",
5400
5400
  # }
5401
5401
  #
5402
- # @example Example: To retrieve an object
5402
+ # @example Example: To retrieve a byte range of an object
5403
5403
  #
5404
- # # The following example retrieves an object for an S3 bucket.
5404
+ # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
5405
+ # # specific byte range.
5405
5406
  #
5406
5407
  # resp = client.get_object({
5407
5408
  # bucket: "examplebucket",
5408
- # key: "HappyFace.jpg",
5409
+ # key: "SampleFile.txt",
5410
+ # range: "bytes=0-9",
5409
5411
  # })
5410
5412
  #
5411
5413
  # resp.to_h outputs the following:
5412
5414
  # {
5413
5415
  # accept_ranges: "bytes",
5414
- # content_length: 3191,
5415
- # content_type: "image/jpeg",
5416
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
5417
- # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
5416
+ # content_length: 10,
5417
+ # content_range: "bytes 0-9/43",
5418
+ # content_type: "text/plain",
5419
+ # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
5420
+ # last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
5418
5421
  # metadata: {
5419
5422
  # },
5420
- # tag_count: 2,
5421
5423
  # version_id: "null",
5422
5424
  # }
5423
5425
  #
@@ -5556,11 +5558,11 @@ module Aws::S3
5556
5558
  # When using this action with an access point through the AWS SDKs, you
5557
5559
  # provide the access point ARN in place of the bucket name. For more
5558
5560
  # information about access point ARNs, see [Using Access Points][1] in
5559
- # the *Amazon Simple Storage Service Developer Guide*.
5561
+ # the *Amazon S3 User Guide*.
5560
5562
  #
5561
5563
  #
5562
5564
  #
5563
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5565
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5564
5566
  #
5565
5567
  # @option params [required, String] :key
5566
5568
  # The key of the object for which to get the ACL information.
@@ -5580,7 +5582,7 @@ module Aws::S3
5580
5582
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5581
5583
  #
5582
5584
  # @option params [String] :expected_bucket_owner
5583
- # The account id of the expected bucket owner. If the bucket is owned by
5585
+ # The account ID of the expected bucket owner. If the bucket is owned by
5584
5586
  # a different account, the request will fail with an HTTP `403 (Access
5585
5587
  # Denied)` error.
5586
5588
  #
@@ -5693,11 +5695,11 @@ module Aws::S3
5693
5695
  # When using this action with an access point through the AWS SDKs, you
5694
5696
  # provide the access point ARN in place of the bucket name. For more
5695
5697
  # information about access point ARNs, see [Using Access Points][1] in
5696
- # the *Amazon Simple Storage Service Developer Guide*.
5698
+ # the *Amazon S3 User Guide*.
5697
5699
  #
5698
5700
  #
5699
5701
  #
5700
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5702
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5701
5703
  #
5702
5704
  # @option params [required, String] :key
5703
5705
  # The key name for the object whose Legal Hold status you want to
@@ -5719,7 +5721,7 @@ module Aws::S3
5719
5721
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5720
5722
  #
5721
5723
  # @option params [String] :expected_bucket_owner
5722
- # The account id of the expected bucket owner. If the bucket is owned by
5724
+ # The account ID of the expected bucket owner. If the bucket is owned by
5723
5725
  # a different account, the request will fail with an HTTP `403 (Access
5724
5726
  # Denied)` error.
5725
5727
  #
@@ -5768,14 +5770,14 @@ module Aws::S3
5768
5770
  # When using this action with an access point through the AWS SDKs, you
5769
5771
  # provide the access point ARN in place of the bucket name. For more
5770
5772
  # information about access point ARNs, see [Using Access Points][1] in
5771
- # the *Amazon Simple Storage Service Developer Guide*.
5773
+ # the *Amazon S3 User Guide*.
5772
5774
  #
5773
5775
  #
5774
5776
  #
5775
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5777
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5776
5778
  #
5777
5779
  # @option params [String] :expected_bucket_owner
5778
- # The account id of the expected bucket owner. If the bucket is owned by
5780
+ # The account ID of the expected bucket owner. If the bucket is owned by
5779
5781
  # a different account, the request will fail with an HTTP `403 (Access
5780
5782
  # Denied)` error.
5781
5783
  #
@@ -5825,11 +5827,11 @@ module Aws::S3
5825
5827
  # When using this action with an access point through the AWS SDKs, you
5826
5828
  # provide the access point ARN in place of the bucket name. For more
5827
5829
  # information about access point ARNs, see [Using Access Points][1] in
5828
- # the *Amazon Simple Storage Service Developer Guide*.
5830
+ # the *Amazon S3 User Guide*.
5829
5831
  #
5830
5832
  #
5831
5833
  #
5832
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5834
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5833
5835
  #
5834
5836
  # @option params [required, String] :key
5835
5837
  # The key name for the object whose retention settings you want to
@@ -5851,7 +5853,7 @@ module Aws::S3
5851
5853
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
5852
5854
  #
5853
5855
  # @option params [String] :expected_bucket_owner
5854
- # The account id of the expected bucket owner. If the bucket is owned by
5856
+ # The account ID of the expected bucket owner. If the bucket is owned by
5855
5857
  # a different account, the request will fail with an HTTP `403 (Access
5856
5858
  # Denied)` error.
5857
5859
  #
@@ -5921,7 +5923,7 @@ module Aws::S3
5921
5923
  # When using this action with an access point through the AWS SDKs, you
5922
5924
  # provide the access point ARN in place of the bucket name. For more
5923
5925
  # information about access point ARNs, see [Using Access Points][1] in
5924
- # the *Amazon Simple Storage Service Developer Guide*.
5926
+ # the *Amazon S3 User Guide*.
5925
5927
  #
5926
5928
  # When using this action with Amazon S3 on Outposts, you must direct
5927
5929
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -5930,12 +5932,12 @@ module Aws::S3
5930
5932
  # When using this action using S3 on Outposts through the AWS SDKs, you
5931
5933
  # provide the Outposts bucket ARN in place of the bucket name. For more
5932
5934
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
5933
- # in the *Amazon Simple Storage Service Developer Guide*.
5935
+ # in the *Amazon S3 User Guide*.
5934
5936
  #
5935
5937
  #
5936
5938
  #
5937
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
5938
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
5939
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5940
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5939
5941
  #
5940
5942
  # @option params [required, String] :key
5941
5943
  # Object key for which to get the tagging information.
@@ -5944,7 +5946,7 @@ module Aws::S3
5944
5946
  # The versionId of the object for which to get the tagging information.
5945
5947
  #
5946
5948
  # @option params [String] :expected_bucket_owner
5947
- # The account id of the expected bucket owner. If the bucket is owned by
5949
+ # The account ID of the expected bucket owner. If the bucket is owned by
5948
5950
  # a different account, the request will fail with an HTTP `403 (Access
5949
5951
  # Denied)` error.
5950
5952
  #
@@ -5965,49 +5967,49 @@ module Aws::S3
5965
5967
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
5966
5968
  #
5967
5969
  #
5968
- # @example Example: To retrieve tag set of an object
5970
+ # @example Example: To retrieve tag set of a specific object version
5969
5971
  #
5970
- # # The following example retrieves tag set of an object.
5972
+ # # The following example retrieves tag set of an object. The request specifies object version.
5971
5973
  #
5972
5974
  # resp = client.get_object_tagging({
5973
5975
  # bucket: "examplebucket",
5974
- # key: "HappyFace.jpg",
5976
+ # key: "exampleobject",
5977
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5975
5978
  # })
5976
5979
  #
5977
5980
  # resp.to_h outputs the following:
5978
5981
  # {
5979
5982
  # tag_set: [
5980
5983
  # {
5981
- # key: "Key4",
5982
- # value: "Value4",
5983
- # },
5984
- # {
5985
- # key: "Key3",
5986
- # value: "Value3",
5984
+ # key: "Key1",
5985
+ # value: "Value1",
5987
5986
  # },
5988
5987
  # ],
5989
- # version_id: "null",
5988
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5990
5989
  # }
5991
5990
  #
5992
- # @example Example: To retrieve tag set of a specific object version
5991
+ # @example Example: To retrieve tag set of an object
5993
5992
  #
5994
- # # The following example retrieves tag set of an object. The request specifies object version.
5993
+ # # The following example retrieves tag set of an object.
5995
5994
  #
5996
5995
  # resp = client.get_object_tagging({
5997
5996
  # bucket: "examplebucket",
5998
- # key: "exampleobject",
5999
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5997
+ # key: "HappyFace.jpg",
6000
5998
  # })
6001
5999
  #
6002
6000
  # resp.to_h outputs the following:
6003
6001
  # {
6004
6002
  # tag_set: [
6005
6003
  # {
6006
- # key: "Key1",
6007
- # value: "Value1",
6004
+ # key: "Key4",
6005
+ # value: "Value4",
6006
+ # },
6007
+ # {
6008
+ # key: "Key3",
6009
+ # value: "Value3",
6008
6010
  # },
6009
6011
  # ],
6010
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6012
+ # version_id: "null",
6011
6013
  # }
6012
6014
  #
6013
6015
  # @example Request syntax with placeholder values
@@ -6083,7 +6085,7 @@ module Aws::S3
6083
6085
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
6084
6086
  #
6085
6087
  # @option params [String] :expected_bucket_owner
6086
- # The account id of the expected bucket owner. If the bucket is owned by
6088
+ # The account ID of the expected bucket owner. If the bucket is owned by
6087
6089
  # a different account, the request will fail with an HTTP `403 (Access
6088
6090
  # Denied)` error.
6089
6091
  #
@@ -6169,7 +6171,7 @@ module Aws::S3
6169
6171
  # configuration you want to retrieve.
6170
6172
  #
6171
6173
  # @option params [String] :expected_bucket_owner
6172
- # The account id of the expected bucket owner. If the bucket is owned by
6174
+ # The account ID of the expected bucket owner. If the bucket is owned by
6173
6175
  # a different account, the request will fail with an HTTP `403 (Access
6174
6176
  # Denied)` error.
6175
6177
  #
@@ -6218,8 +6220,8 @@ module Aws::S3
6218
6220
  #
6219
6221
  #
6220
6222
  #
6221
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6222
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6223
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6224
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6223
6225
  #
6224
6226
  # @option params [required, String] :bucket
6225
6227
  # The bucket name.
@@ -6230,7 +6232,7 @@ module Aws::S3
6230
6232
  # When using this action with an access point through the AWS SDKs, you
6231
6233
  # provide the access point ARN in place of the bucket name. For more
6232
6234
  # information about access point ARNs, see [Using Access Points][1] in
6233
- # the *Amazon Simple Storage Service Developer Guide*.
6235
+ # the *Amazon S3 User Guide*.
6234
6236
  #
6235
6237
  # When using this action with Amazon S3 on Outposts, you must direct
6236
6238
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6239,15 +6241,15 @@ module Aws::S3
6239
6241
  # When using this action using S3 on Outposts through the AWS SDKs, you
6240
6242
  # provide the Outposts bucket ARN in place of the bucket name. For more
6241
6243
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
6242
- # in the *Amazon Simple Storage Service Developer Guide*.
6244
+ # in the *Amazon S3 User Guide*.
6243
6245
  #
6244
6246
  #
6245
6247
  #
6246
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
6247
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
6248
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
6249
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6248
6250
  #
6249
6251
  # @option params [String] :expected_bucket_owner
6250
- # The account id of the expected bucket owner. If the bucket is owned by
6252
+ # The account ID of the expected bucket owner. If the bucket is owned by
6251
6253
  # a different account, the request will fail with an HTTP `403 (Access
6252
6254
  # Denied)` error.
6253
6255
  #
@@ -6383,7 +6385,7 @@ module Aws::S3
6383
6385
  # When using this action with an access point through the AWS SDKs, you
6384
6386
  # provide the access point ARN in place of the bucket name. For more
6385
6387
  # information about access point ARNs, see [Using Access Points][1] in
6386
- # the *Amazon Simple Storage Service Developer Guide*.
6388
+ # the *Amazon S3 User Guide*.
6387
6389
  #
6388
6390
  # When using this action with Amazon S3 on Outposts, you must direct
6389
6391
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -6392,12 +6394,12 @@ module Aws::S3
6392
6394
  # When using this action using S3 on Outposts through the AWS SDKs, you
6393
6395
  # provide the Outposts bucket ARN in place of the bucket name. For more
6394
6396
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
6395
- # in the *Amazon Simple Storage Service Developer Guide*.
6397
+ # in the *Amazon S3 User Guide*.
6396
6398
  #
6397
6399
  #
6398
6400
  #
6399
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
6400
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
6401
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
6402
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6401
6403
  #
6402
6404
  # @option params [String] :if_match
6403
6405
  # Return the object only if its entity tag (ETag) is the same as the one
@@ -6469,7 +6471,7 @@ module Aws::S3
6469
6471
  # the number of parts in this object.
6470
6472
  #
6471
6473
  # @option params [String] :expected_bucket_owner
6472
- # The account id of the expected bucket owner. If the bucket is owned by
6474
+ # The account ID of the expected bucket owner. If the bucket is owned by
6473
6475
  # a different account, the request will fail with an HTTP `403 (Access
6474
6476
  # Denied)` error.
6475
6477
  #
@@ -6631,8 +6633,8 @@ module Aws::S3
6631
6633
  #
6632
6634
  #
6633
6635
  #
6634
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6635
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6636
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6637
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6636
6638
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
6637
6639
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
6638
6640
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
@@ -6647,7 +6649,7 @@ module Aws::S3
6647
6649
  # request should begin.
6648
6650
  #
6649
6651
  # @option params [String] :expected_bucket_owner
6650
- # The account id of the expected bucket owner. If the bucket is owned by
6652
+ # The account ID of the expected bucket owner. If the bucket is owned by
6651
6653
  # a different account, the request will fail with an HTTP `403 (Access
6652
6654
  # Denied)` error.
6653
6655
  #
@@ -6815,8 +6817,8 @@ module Aws::S3
6815
6817
  #
6816
6818
  #
6817
6819
  #
6818
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6819
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6820
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6821
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6820
6822
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
6821
6823
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
6822
6824
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
@@ -6833,7 +6835,7 @@ module Aws::S3
6833
6835
  # token is an opaque value that Amazon S3 understands.
6834
6836
  #
6835
6837
  # @option params [String] :expected_bucket_owner
6836
- # The account id of the expected bucket owner. If the bucket is owned by
6838
+ # The account ID of the expected bucket owner. If the bucket is owned by
6837
6839
  # a different account, the request will fail with an HTTP `403 (Access
6838
6840
  # Denied)` error.
6839
6841
  #
@@ -6915,8 +6917,8 @@ module Aws::S3
6915
6917
  #
6916
6918
  #
6917
6919
  #
6918
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6919
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
6920
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
6921
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
6920
6922
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
6921
6923
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
6922
6924
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
@@ -6933,7 +6935,7 @@ module Aws::S3
6933
6935
  # continuation token is an opaque value that Amazon S3 understands.
6934
6936
  #
6935
6937
  # @option params [String] :expected_bucket_owner
6936
- # The account id of the expected bucket owner. If the bucket is owned by
6938
+ # The account ID of the expected bucket owner. If the bucket is owned by
6937
6939
  # a different account, the request will fail with an HTTP `403 (Access
6938
6940
  # Denied)` error.
6939
6941
  #
@@ -7090,7 +7092,7 @@ module Aws::S3
7090
7092
  # When using this action with an access point through the AWS SDKs, you
7091
7093
  # provide the access point ARN in place of the bucket name. For more
7092
7094
  # information about access point ARNs, see [Using Access Points][1] in
7093
- # the *Amazon Simple Storage Service Developer Guide*.
7095
+ # the *Amazon S3 User Guide*.
7094
7096
  #
7095
7097
  # When using this action with Amazon S3 on Outposts, you must direct
7096
7098
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7099,12 +7101,12 @@ module Aws::S3
7099
7101
  # When using this action using S3 on Outposts through the AWS SDKs, you
7100
7102
  # provide the Outposts bucket ARN in place of the bucket name. For more
7101
7103
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7102
- # in the *Amazon Simple Storage Service Developer Guide*.
7104
+ # in the *Amazon S3 User Guide*.
7103
7105
  #
7104
7106
  #
7105
7107
  #
7106
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7107
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7108
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7109
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7108
7110
  #
7109
7111
  # @option params [String] :delimiter
7110
7112
  # Character you use to group keys.
@@ -7157,7 +7159,7 @@ module Aws::S3
7157
7159
  # specified `upload-id-marker`.
7158
7160
  #
7159
7161
  # @option params [String] :expected_bucket_owner
7160
- # The account id of the expected bucket owner. If the bucket is owned by
7162
+ # The account ID of the expected bucket owner. If the bucket is owned by
7161
7163
  # a different account, the request will fail with an HTTP `403 (Access
7162
7164
  # Denied)` error.
7163
7165
  #
@@ -7179,97 +7181,97 @@ module Aws::S3
7179
7181
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
7180
7182
  #
7181
7183
  #
7182
- # @example Example: List next set of multipart uploads when previous result is truncated
7184
+ # @example Example: To list in-progress multipart uploads on a bucket
7183
7185
  #
7184
- # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
7185
- # # setup of multipart uploads.
7186
+ # # The following example lists in-progress multipart uploads on a specific bucket.
7186
7187
  #
7187
7188
  # resp = client.list_multipart_uploads({
7188
7189
  # bucket: "examplebucket",
7189
- # key_marker: "nextkeyfrompreviousresponse",
7190
- # max_uploads: 2,
7191
- # upload_id_marker: "valuefrompreviousresponse",
7192
7190
  # })
7193
7191
  #
7194
7192
  # resp.to_h outputs the following:
7195
7193
  # {
7196
- # bucket: "acl1",
7197
- # is_truncated: true,
7198
- # key_marker: "",
7199
- # max_uploads: 2,
7200
- # next_key_marker: "someobjectkey",
7201
- # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7202
- # upload_id_marker: "",
7203
7194
  # uploads: [
7204
7195
  # {
7205
7196
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
7206
7197
  # initiator: {
7207
- # display_name: "ownder-display-name",
7198
+ # display_name: "display-name",
7208
7199
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7209
7200
  # },
7210
7201
  # key: "JavaFile",
7211
7202
  # owner: {
7212
- # display_name: "mohanataws",
7213
- # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7203
+ # display_name: "display-name",
7204
+ # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7214
7205
  # },
7215
7206
  # storage_class: "STANDARD",
7216
- # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7207
+ # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7217
7208
  # },
7218
7209
  # {
7219
7210
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
7220
7211
  # initiator: {
7221
- # display_name: "ownder-display-name",
7212
+ # display_name: "display-name",
7222
7213
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7223
7214
  # },
7224
7215
  # key: "JavaFile",
7225
7216
  # owner: {
7226
- # display_name: "ownder-display-name",
7217
+ # display_name: "display-name",
7227
7218
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7228
7219
  # },
7229
7220
  # storage_class: "STANDARD",
7230
- # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7221
+ # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7231
7222
  # },
7232
7223
  # ],
7233
7224
  # }
7234
7225
  #
7235
- # @example Example: To list in-progress multipart uploads on a bucket
7226
+ # @example Example: List next set of multipart uploads when previous result is truncated
7236
7227
  #
7237
- # # The following example lists in-progress multipart uploads on a specific bucket.
7228
+ # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
7229
+ # # setup of multipart uploads.
7238
7230
  #
7239
7231
  # resp = client.list_multipart_uploads({
7240
7232
  # bucket: "examplebucket",
7233
+ # key_marker: "nextkeyfrompreviousresponse",
7234
+ # max_uploads: 2,
7235
+ # upload_id_marker: "valuefrompreviousresponse",
7241
7236
  # })
7242
7237
  #
7243
7238
  # resp.to_h outputs the following:
7244
7239
  # {
7240
+ # bucket: "acl1",
7241
+ # is_truncated: true,
7242
+ # key_marker: "",
7243
+ # max_uploads: 2,
7244
+ # next_key_marker: "someobjectkey",
7245
+ # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7246
+ # upload_id_marker: "",
7245
7247
  # uploads: [
7246
7248
  # {
7247
7249
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
7248
7250
  # initiator: {
7249
- # display_name: "display-name",
7251
+ # display_name: "ownder-display-name",
7250
7252
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7251
7253
  # },
7252
7254
  # key: "JavaFile",
7253
7255
  # owner: {
7254
- # display_name: "display-name",
7255
- # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7256
+ # display_name: "mohanataws",
7257
+ # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7256
7258
  # },
7257
7259
  # storage_class: "STANDARD",
7258
- # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7260
+ # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
7259
7261
  # },
7260
7262
  # {
7261
7263
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
7262
7264
  # initiator: {
7263
- # display_name: "display-name",
7265
+ # display_name: "ownder-display-name",
7264
7266
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7265
7267
  # },
7266
7268
  # key: "JavaFile",
7267
7269
  # owner: {
7268
- # display_name: "display-name",
7270
+ # display_name: "ownder-display-name",
7269
7271
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
7270
7272
  # },
7271
7273
  # storage_class: "STANDARD",
7272
- # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7274
+ # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
7273
7275
  # },
7274
7276
  # ],
7275
7277
  # }
@@ -7324,6 +7326,9 @@ module Aws::S3
7324
7326
  # can also use request parameters as selection criteria to return
7325
7327
  # metadata about a subset of all the object versions.
7326
7328
  #
7329
+ # To use this operation, you must have permissions to perform the
7330
+ # `s3:ListBucketVersions` action. Be aware of the name difference.
7331
+ #
7327
7332
  # <note markdown="1"> A 200 OK response can contain valid or invalid XML. Make sure to
7328
7333
  # design your application to parse the contents of the response and
7329
7334
  # handle it appropriately.
@@ -7393,7 +7398,7 @@ module Aws::S3
7393
7398
  # Specifies the object version you want to start listing from.
7394
7399
  #
7395
7400
  # @option params [String] :expected_bucket_owner
7396
- # The account id of the expected bucket owner. If the bucket is owned by
7401
+ # The account ID of the expected bucket owner. If the bucket is owned by
7397
7402
  # a different account, the request will fail with an HTTP `403 (Access
7398
7403
  # Denied)` error.
7399
7404
  #
@@ -7552,7 +7557,7 @@ module Aws::S3
7552
7557
  # When using this action with an access point through the AWS SDKs, you
7553
7558
  # provide the access point ARN in place of the bucket name. For more
7554
7559
  # information about access point ARNs, see [Using Access Points][1] in
7555
- # the *Amazon Simple Storage Service Developer Guide*.
7560
+ # the *Amazon S3 User Guide*.
7556
7561
  #
7557
7562
  # When using this action with Amazon S3 on Outposts, you must direct
7558
7563
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7561,12 +7566,12 @@ module Aws::S3
7561
7566
  # When using this action using S3 on Outposts through the AWS SDKs, you
7562
7567
  # provide the Outposts bucket ARN in place of the bucket name. For more
7563
7568
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7564
- # in the *Amazon Simple Storage Service Developer Guide*.
7569
+ # in the *Amazon S3 User Guide*.
7565
7570
  #
7566
7571
  #
7567
7572
  #
7568
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7569
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7573
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7574
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7570
7575
  #
7571
7576
  # @option params [String] :delimiter
7572
7577
  # A delimiter is a character you use to group keys.
@@ -7596,7 +7601,7 @@ module Aws::S3
7596
7601
  # parameter in their requests.
7597
7602
  #
7598
7603
  # @option params [String] :expected_bucket_owner
7599
- # The account id of the expected bucket owner. If the bucket is owned by
7604
+ # The account ID of the expected bucket owner. If the bucket is owned by
7600
7605
  # a different account, the request will fail with an HTTP `403 (Access
7601
7606
  # Denied)` error.
7602
7607
  #
@@ -7731,8 +7736,8 @@ module Aws::S3
7731
7736
  #
7732
7737
  #
7733
7738
  #
7734
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7735
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
7739
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
7740
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
7736
7741
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
7737
7742
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBuckets.html
7738
7743
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
@@ -7748,7 +7753,7 @@ module Aws::S3
7748
7753
  # When using this action with an access point through the AWS SDKs, you
7749
7754
  # provide the access point ARN in place of the bucket name. For more
7750
7755
  # information about access point ARNs, see [Using Access Points][1] in
7751
- # the *Amazon Simple Storage Service Developer Guide*.
7756
+ # the *Amazon S3 User Guide*.
7752
7757
  #
7753
7758
  # When using this action with Amazon S3 on Outposts, you must direct
7754
7759
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7757,12 +7762,12 @@ module Aws::S3
7757
7762
  # When using this action using S3 on Outposts through the AWS SDKs, you
7758
7763
  # provide the Outposts bucket ARN in place of the bucket name. For more
7759
7764
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7760
- # in the *Amazon Simple Storage Service Developer Guide*.
7765
+ # in the *Amazon S3 User Guide*.
7761
7766
  #
7762
7767
  #
7763
7768
  #
7764
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7765
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7769
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7770
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7766
7771
  #
7767
7772
  # @option params [String] :delimiter
7768
7773
  # A delimiter is a character you use to group keys.
@@ -7799,7 +7804,7 @@ module Aws::S3
7799
7804
  # this parameter in their requests.
7800
7805
  #
7801
7806
  # @option params [String] :expected_bucket_owner
7802
- # The account id of the expected bucket owner. If the bucket is owned by
7807
+ # The account ID of the expected bucket owner. If the bucket is owned by
7803
7808
  # a different account, the request will fail with an HTTP `403 (Access
7804
7809
  # Denied)` error.
7805
7810
  #
@@ -7954,7 +7959,7 @@ module Aws::S3
7954
7959
  # When using this action with an access point through the AWS SDKs, you
7955
7960
  # provide the access point ARN in place of the bucket name. For more
7956
7961
  # information about access point ARNs, see [Using Access Points][1] in
7957
- # the *Amazon Simple Storage Service Developer Guide*.
7962
+ # the *Amazon S3 User Guide*.
7958
7963
  #
7959
7964
  # When using this action with Amazon S3 on Outposts, you must direct
7960
7965
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -7963,12 +7968,12 @@ module Aws::S3
7963
7968
  # When using this action using S3 on Outposts through the AWS SDKs, you
7964
7969
  # provide the Outposts bucket ARN in place of the bucket name. For more
7965
7970
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
7966
- # in the *Amazon Simple Storage Service Developer Guide*.
7971
+ # in the *Amazon S3 User Guide*.
7967
7972
  #
7968
7973
  #
7969
7974
  #
7970
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
7971
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
7975
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
7976
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
7972
7977
  #
7973
7978
  # @option params [required, String] :key
7974
7979
  # Object key for which the multipart upload was initiated.
@@ -7996,7 +8001,7 @@ module Aws::S3
7996
8001
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
7997
8002
  #
7998
8003
  # @option params [String] :expected_bucket_owner
7999
- # The account id of the expected bucket owner. If the bucket is owned by
8004
+ # The account ID of the expected bucket owner. If the bucket is owned by
8000
8005
  # a different account, the request will fail with an HTTP `403 (Access
8001
8006
  # Denied)` error.
8002
8007
  #
@@ -8141,8 +8146,8 @@ module Aws::S3
8141
8146
  #
8142
8147
  #
8143
8148
  #
8144
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8145
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8149
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8150
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8146
8151
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAccelerateConfiguration.html
8147
8152
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html
8148
8153
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
@@ -8154,7 +8159,7 @@ module Aws::S3
8154
8159
  # Container for setting the transfer acceleration state.
8155
8160
  #
8156
8161
  # @option params [String] :expected_bucket_owner
8157
- # The account id of the expected bucket owner. If the bucket is owned by
8162
+ # The account ID of the expected bucket owner. If the bucket is owned by
8158
8163
  # a different account, the request will fail with an HTTP `403 (Access
8159
8164
  # Denied)` error.
8160
8165
  #
@@ -8376,7 +8381,7 @@ module Aws::S3
8376
8381
  # Allows grantee to write the ACL for the applicable bucket.
8377
8382
  #
8378
8383
  # @option params [String] :expected_bucket_owner
8379
- # The account id of the expected bucket owner. If the bucket is owned by
8384
+ # The account ID of the expected bucket owner. If the bucket is owned by
8380
8385
  # a different account, the request will fail with an HTTP `403 (Access
8381
8386
  # Denied)` error.
8382
8387
  #
@@ -8498,8 +8503,8 @@ module Aws::S3
8498
8503
  #
8499
8504
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html
8500
8505
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
8501
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8502
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8506
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8507
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8503
8508
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketAnalyticsConfiguration.html
8504
8509
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketAnalyticsConfiguration.html
8505
8510
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketAnalyticsConfigurations.html
@@ -8514,7 +8519,7 @@ module Aws::S3
8514
8519
  # The configuration and any analyses for the analytics filter.
8515
8520
  #
8516
8521
  # @option params [String] :expected_bucket_owner
8517
- # The account id of the expected bucket owner. If the bucket is owned by
8522
+ # The account ID of the expected bucket owner. If the bucket is owned by
8518
8523
  # a different account, the request will fail with an HTTP `403 (Access
8519
8524
  # Denied)` error.
8520
8525
  #
@@ -8605,7 +8610,7 @@ module Aws::S3
8605
8610
  # element.
8606
8611
  #
8607
8612
  # For more information about CORS, go to [Enabling Cross-Origin Resource
8608
- # Sharing][1] in the *Amazon Simple Storage Service User Guide*.
8613
+ # Sharing][1] in the *Amazon S3 User Guide*.
8609
8614
  #
8610
8615
  # **Related Resources**
8611
8616
  #
@@ -8628,8 +8633,7 @@ module Aws::S3
8628
8633
  # @option params [required, Types::CORSConfiguration] :cors_configuration
8629
8634
  # Describes the cross-origin access configuration for objects in an
8630
8635
  # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
8631
- # Resource Sharing][1] in the *Amazon Simple Storage Service User
8632
- # Guide*.
8636
+ # Resource Sharing][1] in the *Amazon S3 User Guide*.
8633
8637
  #
8634
8638
  #
8635
8639
  #
@@ -8648,7 +8652,7 @@ module Aws::S3
8648
8652
  # [1]: http://www.ietf.org/rfc/rfc1864.txt
8649
8653
  #
8650
8654
  # @option params [String] :expected_bucket_owner
8651
- # The account id of the expected bucket owner. If the bucket is owned by
8655
+ # The account ID of the expected bucket owner. If the bucket is owned by
8652
8656
  # a different account, the request will fail with an HTTP `403 (Access
8653
8657
  # Denied)` error.
8654
8658
  #
@@ -8735,9 +8739,8 @@ module Aws::S3
8735
8739
  # (SSE-KMS). If you specify default encryption using SSE-KMS, you can
8736
8740
  # also configure Amazon S3 Bucket Key. For information about default
8737
8741
  # encryption, see [Amazon S3 default bucket encryption][1] in the
8738
- # *Amazon Simple Storage Service User Guide*. For more information about
8739
- # S3 Bucket Keys, see [Amazon S3 Bucket Keys][2] in the *Amazon Simple
8740
- # Storage Service User Guide*.
8742
+ # *Amazon S3 User Guide*. For more information about S3 Bucket Keys, see
8743
+ # [Amazon S3 Bucket Keys][2] in the *Amazon S3 User Guide*.
8741
8744
  #
8742
8745
  # This action requires AWS Signature Version 4. For more information,
8743
8746
  # see [ Authenticating Requests (AWS Signature Version 4)][3].
@@ -8747,8 +8750,8 @@ module Aws::S3
8747
8750
  # permission by default. The bucket owner can grant this permission to
8748
8751
  # others. For more information about permissions, see [Permissions
8749
8752
  # Related to Bucket Subresource Operations][4] and [Managing Access
8750
- # Permissions to Your Amazon S3 Resources][5] in the Amazon Simple
8751
- # Storage Service User Guide.
8753
+ # Permissions to Your Amazon S3 Resources][5] in the Amazon S3 User
8754
+ # Guide.
8752
8755
  #
8753
8756
  # **Related Resources**
8754
8757
  #
@@ -8761,8 +8764,8 @@ module Aws::S3
8761
8764
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
8762
8765
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
8763
8766
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html
8764
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8765
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
8767
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
8768
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
8766
8769
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
8767
8770
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
8768
8771
  #
@@ -8771,7 +8774,7 @@ module Aws::S3
8771
8774
  # with Amazon S3-managed keys (SSE-S3) or customer master keys stored in
8772
8775
  # AWS KMS (SSE-KMS). For information about the Amazon S3 default
8773
8776
  # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
8774
- # the *Amazon Simple Storage Service Developer Guide*.
8777
+ # the *Amazon S3 User Guide*.
8775
8778
  #
8776
8779
  #
8777
8780
  #
@@ -8788,7 +8791,7 @@ module Aws::S3
8788
8791
  # Specifies the default server-side-encryption configuration.
8789
8792
  #
8790
8793
  # @option params [String] :expected_bucket_owner
8791
- # The account id of the expected bucket owner. If the bucket is owned by
8794
+ # The account ID of the expected bucket owner. If the bucket is owned by
8792
8795
  # a different account, the request will fail with an HTTP `403 (Access
8793
8796
  # Denied)` error.
8794
8797
  #
@@ -8959,8 +8962,7 @@ module Aws::S3
8959
8962
  # whether to generate the inventory daily or weekly. You can also
8960
8963
  # configure what object metadata to include and whether to inventory all
8961
8964
  # object versions or only current versions. For more information, see
8962
- # [Amazon S3 Inventory][1] in the Amazon Simple Storage Service User
8963
- # Guide.
8965
+ # [Amazon S3 Inventory][1] in the Amazon S3 User Guide.
8964
8966
  #
8965
8967
  # You must create a bucket policy on the *destination* bucket to grant
8966
8968
  # permissions to Amazon S3 to write objects to the bucket in the defined
@@ -8972,8 +8974,7 @@ module Aws::S3
8972
8974
  # permission by default and can grant this permission to others. For
8973
8975
  # more information about permissions, see [Permissions Related to Bucket
8974
8976
  # Subresource Operations][3] and [Managing Access Permissions to Your
8975
- # Amazon S3 Resources][4] in the Amazon Simple Storage Service User
8976
- # Guide.
8977
+ # Amazon S3 Resources][4] in the Amazon S3 User Guide.
8977
8978
  #
8978
8979
  # **Special Errors**
8979
8980
  #
@@ -9010,8 +9011,8 @@ module Aws::S3
9010
9011
  #
9011
9012
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html
9012
9013
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9
9013
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9014
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9014
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9015
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9015
9016
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketInventoryConfiguration.html
9016
9017
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketInventoryConfiguration.html
9017
9018
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketInventoryConfigurations.html
@@ -9027,7 +9028,7 @@ module Aws::S3
9027
9028
  # Specifies the inventory configuration.
9028
9029
  #
9029
9030
  # @option params [String] :expected_bucket_owner
9030
- # The account id of the expected bucket owner. If the bucket is owned by
9031
+ # The account ID of the expected bucket owner. If the bucket is owned by
9031
9032
  # a different account, the request will fail with an HTTP `403 (Access
9032
9033
  # Denied)` error.
9033
9034
  #
@@ -9084,8 +9085,8 @@ module Aws::S3
9084
9085
  #
9085
9086
  # Creates a new lifecycle configuration for the bucket or replaces an
9086
9087
  # existing lifecycle configuration. For information about lifecycle
9087
- # configuration, see [Object Lifecycle Management][2] in the *Amazon
9088
- # Simple Storage Service User Guide*.
9088
+ # configuration, see [Object Lifecycle Management][2] in the *Amazon S3
9089
+ # User Guide*.
9089
9090
  #
9090
9091
  # By default, all Amazon S3 resources, including buckets, objects, and
9091
9092
  # related subresources (for example, lifecycle configuration and website
@@ -9107,8 +9108,8 @@ module Aws::S3
9107
9108
  # * `s3:PutLifecycleConfiguration`
9108
9109
  #
9109
9110
  # For more information about permissions, see [Managing Access
9110
- # Permissions to your Amazon S3 Resources][3] in the *Amazon Simple
9111
- # Storage Service User Guide*.
9111
+ # Permissions to your Amazon S3 Resources][3] in the *Amazon S3 User
9112
+ # Guide*.
9112
9113
  #
9113
9114
  # For more examples of transitioning objects to storage classes such as
9114
9115
  # STANDARD\_IA or ONEZONE\_IA, see [Examples of Lifecycle
@@ -9126,7 +9127,7 @@ module Aws::S3
9126
9127
  # the AWS account that created the bucket—can perform any of the
9127
9128
  # operations. A resource owner can also grant others permission to
9128
9129
  # perform the operation. For more information, see the following
9129
- # topics in the Amazon Simple Storage Service User Guide:
9130
+ # topics in the Amazon S3 User Guide:
9130
9131
  #
9131
9132
  # * [Specifying Permissions in a Policy][8]
9132
9133
  #
@@ -9136,7 +9137,7 @@ module Aws::S3
9136
9137
  #
9137
9138
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
9138
9139
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
9139
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9140
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9140
9141
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html#lifecycle-configuration-examples
9141
9142
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycle.html
9142
9143
  # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
@@ -9152,7 +9153,7 @@ module Aws::S3
9152
9153
  # @option params [Types::LifecycleConfiguration] :lifecycle_configuration
9153
9154
  #
9154
9155
  # @option params [String] :expected_bucket_owner
9155
- # The account id of the expected bucket owner. If the bucket is owned by
9156
+ # The account ID of the expected bucket owner. If the bucket is owned by
9156
9157
  # a different account, the request will fail with an HTTP `403 (Access
9157
9158
  # Denied)` error.
9158
9159
  #
@@ -9276,7 +9277,7 @@ module Aws::S3
9276
9277
  #
9277
9278
  #
9278
9279
  #
9279
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9280
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9280
9281
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html
9281
9282
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html
9282
9283
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html
@@ -9291,7 +9292,7 @@ module Aws::S3
9291
9292
  # Container for lifecycle rules. You can add as many as 1,000 rules.
9292
9293
  #
9293
9294
  # @option params [String] :expected_bucket_owner
9294
- # The account id of the expected bucket owner. If the bucket is owned by
9295
+ # The account ID of the expected bucket owner. If the bucket is owned by
9295
9296
  # a different account, the request will fail with an HTTP `403 (Access
9296
9297
  # Denied)` error.
9297
9298
  #
@@ -9472,7 +9473,7 @@ module Aws::S3
9472
9473
  # SDKs, this field is calculated automatically.
9473
9474
  #
9474
9475
  # @option params [String] :expected_bucket_owner
9475
- # The account id of the expected bucket owner. If the bucket is owned by
9476
+ # The account ID of the expected bucket owner. If the bucket is owned by
9476
9477
  # a different account, the request will fail with an HTTP `403 (Access
9477
9478
  # Denied)` error.
9478
9479
  #
@@ -9575,8 +9576,8 @@ module Aws::S3
9575
9576
  #
9576
9577
  #
9577
9578
  #
9578
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9579
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
9579
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
9580
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
9580
9581
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
9581
9582
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
9582
9583
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
@@ -9592,7 +9593,7 @@ module Aws::S3
9592
9593
  # Specifies the metrics configuration.
9593
9594
  #
9594
9595
  # @option params [String] :expected_bucket_owner
9595
- # The account id of the expected bucket owner. If the bucket is owned by
9596
+ # The account ID of the expected bucket owner. If the bucket is owned by
9596
9597
  # a different account, the request will fail with an HTTP `403 (Access
9597
9598
  # Denied)` error.
9598
9599
  #
@@ -9654,7 +9655,7 @@ module Aws::S3
9654
9655
  # The container for the configuration.
9655
9656
  #
9656
9657
  # @option params [String] :expected_bucket_owner
9657
- # The account id of the expected bucket owner. If the bucket is owned by
9658
+ # The account ID of the expected bucket owner. If the bucket is owned by
9658
9659
  # a different account, the request will fail with an HTTP `403 (Access
9659
9660
  # Denied)` error.
9660
9661
  #
@@ -9774,7 +9775,7 @@ module Aws::S3
9774
9775
  # bucket.
9775
9776
  #
9776
9777
  # @option params [String] :expected_bucket_owner
9777
- # The account id of the expected bucket owner. If the bucket is owned by
9778
+ # The account ID of the expected bucket owner. If the bucket is owned by
9778
9779
  # a different account, the request will fail with an HTTP `403 (Access
9779
9780
  # Denied)` error.
9780
9781
  #
@@ -9898,7 +9899,7 @@ module Aws::S3
9898
9899
  # SDKs, this field is calculated automatically.
9899
9900
  #
9900
9901
  # @option params [String] :expected_bucket_owner
9901
- # The account id of the expected bucket owner. If the bucket is owned by
9902
+ # The account ID of the expected bucket owner. If the bucket is owned by
9902
9903
  # a different account, the request will fail with an HTTP `403 (Access
9903
9904
  # Denied)` error.
9904
9905
  #
@@ -9979,7 +9980,7 @@ module Aws::S3
9979
9980
  # The bucket policy as a JSON document.
9980
9981
  #
9981
9982
  # @option params [String] :expected_bucket_owner
9982
- # The account id of the expected bucket owner. If the bucket is owned by
9983
+ # The account ID of the expected bucket owner. If the bucket is owned by
9983
9984
  # a different account, the request will fail with an HTTP `403 (Access
9984
9985
  # Denied)` error.
9985
9986
  #
@@ -10084,7 +10085,7 @@ module Aws::S3
10084
10085
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations
10085
10086
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html
10086
10087
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
10087
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
10088
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
10088
10089
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html
10089
10090
  # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList
10090
10091
  # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html
@@ -10113,7 +10114,7 @@ module Aws::S3
10113
10114
  # A token to allow Object Lock to be enabled for an existing bucket.
10114
10115
  #
10115
10116
  # @option params [String] :expected_bucket_owner
10116
- # The account id of the expected bucket owner. If the bucket is owned by
10117
+ # The account ID of the expected bucket owner. If the bucket is owned by
10117
10118
  # a different account, the request will fail with an HTTP `403 (Access
10118
10119
  # Denied)` error.
10119
10120
  #
@@ -10260,7 +10261,7 @@ module Aws::S3
10260
10261
  # Container for Payer.
10261
10262
  #
10262
10263
  # @option params [String] :expected_bucket_owner
10263
- # The account id of the expected bucket owner. If the bucket is owned by
10264
+ # The account ID of the expected bucket owner. If the bucket is owned by
10264
10265
  # a different account, the request will fail with an HTTP `403 (Access
10265
10266
  # Denied)` error.
10266
10267
  #
@@ -10363,8 +10364,8 @@ module Aws::S3
10363
10364
  #
10364
10365
  # [1]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html
10365
10366
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CostAllocTagging.html
10366
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
10367
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
10367
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
10368
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
10368
10369
  # [5]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html
10369
10370
  # [6]: https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tag-restrictions.html
10370
10371
  # [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html
@@ -10389,7 +10390,7 @@ module Aws::S3
10389
10390
  # Container for the `TagSet` and `Tag` elements.
10390
10391
  #
10391
10392
  # @option params [String] :expected_bucket_owner
10392
- # The account id of the expected bucket owner. If the bucket is owned by
10393
+ # The account ID of the expected bucket owner. If the bucket is owned by
10393
10394
  # a different account, the request will fail with an HTTP `403 (Access
10394
10395
  # Denied)` error.
10395
10396
  #
@@ -10509,7 +10510,7 @@ module Aws::S3
10509
10510
  # Container for setting the versioning state.
10510
10511
  #
10511
10512
  # @option params [String] :expected_bucket_owner
10512
- # The account id of the expected bucket owner. If the bucket is owned by
10513
+ # The account ID of the expected bucket owner. If the bucket is owned by
10513
10514
  # a different account, the request will fail with an HTTP `403 (Access
10514
10515
  # Denied)` error.
10515
10516
  #
@@ -10616,7 +10617,7 @@ module Aws::S3
10616
10617
  # Amazon S3 has a limitation of 50 routing rules per website
10617
10618
  # configuration. If you require more than 50 routing rules, you can use
10618
10619
  # object redirect. For more information, see [Configuring an Object
10619
- # Redirect][2] in the *Amazon Simple Storage Service User Guide*.
10620
+ # Redirect][2] in the *Amazon S3 User Guide*.
10620
10621
  #
10621
10622
  #
10622
10623
  #
@@ -10642,7 +10643,7 @@ module Aws::S3
10642
10643
  # Container for the request.
10643
10644
  #
10644
10645
  # @option params [String] :expected_bucket_owner
10645
- # The account id of the expected bucket owner. If the bucket is owned by
10646
+ # The account ID of the expected bucket owner. If the bucket is owned by
10646
10647
  # a different account, the request will fail with an HTTP `403 (Access
10647
10648
  # Denied)` error.
10648
10649
  #
@@ -10732,8 +10733,7 @@ module Aws::S3
10732
10733
  # <note markdown="1"> The `Content-MD5` header is required for any request to upload an
10733
10734
  # object with a retention period configured using Amazon S3 Object Lock.
10734
10735
  # For more information about Amazon S3 Object Lock, see [Amazon S3
10735
- # Object Lock Overview][1] in the *Amazon Simple Storage Service
10736
- # Developer Guide*.
10736
+ # Object Lock Overview][1] in the *Amazon S3 User Guide*.
10737
10737
  #
10738
10738
  # </note>
10739
10739
  #
@@ -10748,8 +10748,8 @@ module Aws::S3
10748
10748
  #
10749
10749
  # If you request server-side encryption using AWS Key Management Service
10750
10750
  # (SSE-KMS), you can enable an S3 Bucket Key at the object-level. For
10751
- # more information, see [Amazon S3 Bucket Keys][3] in the *Amazon Simple
10752
- # Storage Service User Guide*.
10751
+ # more information, see [Amazon S3 Bucket Keys][3] in the *Amazon S3
10752
+ # User Guide*.
10753
10753
  #
10754
10754
  # **Access Control List (ACL)-Specific Request Headers**
10755
10755
  #
@@ -10823,7 +10823,7 @@ module Aws::S3
10823
10823
  # When using this action with an access point through the AWS SDKs, you
10824
10824
  # provide the access point ARN in place of the bucket name. For more
10825
10825
  # information about access point ARNs, see [Using Access Points][1] in
10826
- # the *Amazon Simple Storage Service Developer Guide*.
10826
+ # the *Amazon S3 User Guide*.
10827
10827
  #
10828
10828
  # When using this action with Amazon S3 on Outposts, you must direct
10829
10829
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -10832,12 +10832,12 @@ module Aws::S3
10832
10832
  # When using this action using S3 on Outposts through the AWS SDKs, you
10833
10833
  # provide the Outposts bucket ARN in place of the bucket name. For more
10834
10834
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
10835
- # in the *Amazon Simple Storage Service Developer Guide*.
10835
+ # in the *Amazon S3 User Guide*.
10836
10836
  #
10837
10837
  #
10838
10838
  #
10839
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
10840
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
10839
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
10840
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
10841
10841
  #
10842
10842
  # @option params [String] :cache_control
10843
10843
  # Can be used to specify caching behavior along the request/reply chain.
@@ -11052,7 +11052,7 @@ module Aws::S3
11052
11052
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
11053
11053
  #
11054
11054
  # @option params [String] :expected_bucket_owner
11055
- # The account id of the expected bucket owner. If the bucket is owned by
11055
+ # The account ID of the expected bucket owner. If the bucket is owned by
11056
11056
  # a different account, the request will fail with an HTTP `403 (Access
11057
11057
  # Denied)` error.
11058
11058
  #
@@ -11088,96 +11088,96 @@ module Aws::S3
11088
11088
  # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
11089
11089
  # }
11090
11090
  #
11091
- # @example Example: To upload an object and specify canned ACL.
11091
+ # @example Example: To create an object.
11092
11092
  #
11093
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
11094
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
11093
+ # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
11095
11094
  #
11096
11095
  # resp = client.put_object({
11097
- # acl: "authenticated-read",
11098
11096
  # body: "filetoupload",
11099
11097
  # bucket: "examplebucket",
11100
- # key: "exampleobject",
11098
+ # key: "objectkey",
11101
11099
  # })
11102
11100
  #
11103
11101
  # resp.to_h outputs the following:
11104
11102
  # {
11105
11103
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11106
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
11104
+ # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
11107
11105
  # }
11108
11106
  #
11109
- # @example Example: To create an object.
11107
+ # @example Example: To upload object and specify user-defined metadata
11110
11108
  #
11111
- # # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
11109
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
11110
+ # # enabled, S3 returns version ID in response.
11112
11111
  #
11113
11112
  # resp = client.put_object({
11114
11113
  # body: "filetoupload",
11115
11114
  # bucket: "examplebucket",
11116
- # key: "objectkey",
11115
+ # key: "exampleobject",
11116
+ # metadata: {
11117
+ # "metadata1" => "value1",
11118
+ # "metadata2" => "value2",
11119
+ # },
11117
11120
  # })
11118
11121
  #
11119
11122
  # resp.to_h outputs the following:
11120
11123
  # {
11121
11124
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11122
- # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
11125
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
11123
11126
  # }
11124
11127
  #
11125
- # @example Example: To upload an object and specify server-side encryption and object tags
11128
+ # @example Example: To upload an object
11126
11129
  #
11127
- # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
11128
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
11130
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
11131
+ # # syntax. S3 returns VersionId of the newly created object.
11129
11132
  #
11130
11133
  # resp = client.put_object({
11131
- # body: "filetoupload",
11134
+ # body: "HappyFace.jpg",
11132
11135
  # bucket: "examplebucket",
11133
- # key: "exampleobject",
11134
- # server_side_encryption: "AES256",
11135
- # tagging: "key1=value1&key2=value2",
11136
+ # key: "HappyFace.jpg",
11136
11137
  # })
11137
11138
  #
11138
11139
  # resp.to_h outputs the following:
11139
11140
  # {
11140
11141
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11141
- # server_side_encryption: "AES256",
11142
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11142
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11143
11143
  # }
11144
11144
  #
11145
- # @example Example: To upload object and specify user-defined metadata
11145
+ # @example Example: To upload an object and specify server-side encryption and object tags
11146
11146
  #
11147
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
11148
- # # enabled, S3 returns version ID in response.
11147
+ # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
11148
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
11149
11149
  #
11150
11150
  # resp = client.put_object({
11151
11151
  # body: "filetoupload",
11152
11152
  # bucket: "examplebucket",
11153
11153
  # key: "exampleobject",
11154
- # metadata: {
11155
- # "metadata1" => "value1",
11156
- # "metadata2" => "value2",
11157
- # },
11154
+ # server_side_encryption: "AES256",
11155
+ # tagging: "key1=value1&key2=value2",
11158
11156
  # })
11159
11157
  #
11160
11158
  # resp.to_h outputs the following:
11161
11159
  # {
11162
11160
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11163
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
11161
+ # server_side_encryption: "AES256",
11162
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
11164
11163
  # }
11165
11164
  #
11166
- # @example Example: To upload an object
11165
+ # @example Example: To upload an object and specify canned ACL.
11167
11166
  #
11168
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
11169
- # # syntax. S3 returns VersionId of the newly created object.
11167
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
11168
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
11170
11169
  #
11171
11170
  # resp = client.put_object({
11172
- # body: "HappyFace.jpg",
11171
+ # acl: "authenticated-read",
11172
+ # body: "filetoupload",
11173
11173
  # bucket: "examplebucket",
11174
- # key: "HappyFace.jpg",
11174
+ # key: "exampleobject",
11175
11175
  # })
11176
11176
  #
11177
11177
  # resp.to_h outputs the following:
11178
11178
  # {
11179
11179
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
11180
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
11180
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
11181
11181
  # }
11182
11182
  #
11183
11183
  # @example Example: To upload an object (specify optional headers)
@@ -11270,8 +11270,8 @@ module Aws::S3
11270
11270
  # Uses the `acl` subresource to set the access control list (ACL)
11271
11271
  # permissions for a new or existing object in an S3 bucket. You must
11272
11272
  # have `WRITE_ACP` permission to set the ACL of an object. For more
11273
- # information, see [What permissions can I grant?][1] in the *Amazon
11274
- # Simple Storage Service User Guide*.
11273
+ # information, see [What permissions can I grant?][1] in the *Amazon S3
11274
+ # User Guide*.
11275
11275
  #
11276
11276
  # This action is not supported by Amazon S3 on Outposts.
11277
11277
  #
@@ -11441,11 +11441,11 @@ module Aws::S3
11441
11441
  # When using this action with an access point through the AWS SDKs, you
11442
11442
  # provide the access point ARN in place of the bucket name. For more
11443
11443
  # information about access point ARNs, see [Using Access Points][1] in
11444
- # the *Amazon Simple Storage Service Developer Guide*.
11444
+ # the *Amazon S3 User Guide*.
11445
11445
  #
11446
11446
  #
11447
11447
  #
11448
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11448
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11449
11449
  #
11450
11450
  # @option params [String] :content_md5
11451
11451
  # The base64-encoded 128-bit MD5 digest of the data. This header must be
@@ -11494,7 +11494,7 @@ module Aws::S3
11494
11494
  # When using this action with an access point through the AWS SDKs, you
11495
11495
  # provide the access point ARN in place of the bucket name. For more
11496
11496
  # information about access point ARNs, see [Using Access Points][1] in
11497
- # the *Amazon Simple Storage Service Developer Guide*.
11497
+ # the *Amazon S3 User Guide*.
11498
11498
  #
11499
11499
  # When using this action with Amazon S3 on Outposts, you must direct
11500
11500
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11503,12 +11503,12 @@ module Aws::S3
11503
11503
  # When using this action using S3 on Outposts through the AWS SDKs, you
11504
11504
  # provide the Outposts bucket ARN in place of the bucket name. For more
11505
11505
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
11506
- # in the *Amazon Simple Storage Service Developer Guide*.
11506
+ # in the *Amazon S3 User Guide*.
11507
11507
  #
11508
11508
  #
11509
11509
  #
11510
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11511
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
11510
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11511
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
11512
11512
  #
11513
11513
  # @option params [String] :request_payer
11514
11514
  # Confirms that the requester knows that they will be charged for the
@@ -11525,7 +11525,7 @@ module Aws::S3
11525
11525
  # VersionId used to reference a specific version of the object.
11526
11526
  #
11527
11527
  # @option params [String] :expected_bucket_owner
11528
- # The account id of the expected bucket owner. If the bucket is owned by
11528
+ # The account ID of the expected bucket owner. If the bucket is owned by
11529
11529
  # a different account, the request will fail with an HTTP `403 (Access
11530
11530
  # Denied)` error.
11531
11531
  #
@@ -11600,16 +11600,11 @@ module Aws::S3
11600
11600
  req.send_request(options)
11601
11601
  end
11602
11602
 
11603
- # Applies a Legal Hold configuration to the specified object.
11603
+ # Applies a Legal Hold configuration to the specified object. For more
11604
+ # information, see [Locking Objects][1].
11604
11605
  #
11605
11606
  # This action is not supported by Amazon S3 on Outposts.
11606
11607
  #
11607
- # **Related Resources**
11608
- #
11609
- # * [Locking Objects][1]
11610
- #
11611
- # ^
11612
- #
11613
11608
  #
11614
11609
  #
11615
11610
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -11624,11 +11619,11 @@ module Aws::S3
11624
11619
  # When using this action with an access point through the AWS SDKs, you
11625
11620
  # provide the access point ARN in place of the bucket name. For more
11626
11621
  # information about access point ARNs, see [Using Access Points][1] in
11627
- # the *Amazon Simple Storage Service Developer Guide*.
11622
+ # the *Amazon S3 User Guide*.
11628
11623
  #
11629
11624
  #
11630
11625
  #
11631
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11626
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11632
11627
  #
11633
11628
  # @option params [required, String] :key
11634
11629
  # The key name for the object that you want to place a Legal Hold on.
@@ -11658,7 +11653,7 @@ module Aws::S3
11658
11653
  # SDKs, this field is calculated automatically.
11659
11654
  #
11660
11655
  # @option params [String] :expected_bucket_owner
11661
- # The account id of the expected bucket owner. If the bucket is owned by
11656
+ # The account ID of the expected bucket owner. If the bucket is owned by
11662
11657
  # a different account, the request will fail with an HTTP `403 (Access
11663
11658
  # Denied)` error.
11664
11659
  #
@@ -11695,18 +11690,19 @@ module Aws::S3
11695
11690
 
11696
11691
  # Places an Object Lock configuration on the specified bucket. The rule
11697
11692
  # specified in the Object Lock configuration will be applied by default
11698
- # to every new object placed in the specified bucket.
11699
- #
11700
- # <note markdown="1"> `DefaultRetention` requires either Days or Years. You can't specify
11701
- # both at the same time.
11693
+ # to every new object placed in the specified bucket. For more
11694
+ # information, see [Locking Objects][1].
11702
11695
  #
11703
- # </note>
11696
+ # <note markdown="1"> * The `DefaultRetention` settings require both a mode and a period.
11704
11697
  #
11705
- # **Related Resources**
11698
+ # * The `DefaultRetention` period can be either `Days` or `Years` but
11699
+ # you must select one. You cannot specify `Days` and `Years` at the
11700
+ # same time.
11706
11701
  #
11707
- # * [Locking Objects][1]
11702
+ # * You can only enable Object Lock for new buckets. If you want to turn
11703
+ # on Object Lock for an existing bucket, contact AWS Support.
11708
11704
  #
11709
- # ^
11705
+ # </note>
11710
11706
  #
11711
11707
  #
11712
11708
  #
@@ -11741,7 +11737,7 @@ module Aws::S3
11741
11737
  # SDKs, this field is calculated automatically.
11742
11738
  #
11743
11739
  # @option params [String] :expected_bucket_owner
11744
- # The account id of the expected bucket owner. If the bucket is owned by
11740
+ # The account ID of the expected bucket owner. If the bucket is owned by
11745
11741
  # a different account, the request will fail with an HTTP `403 (Access
11746
11742
  # Denied)` error.
11747
11743
  #
@@ -11782,16 +11778,11 @@ module Aws::S3
11782
11778
  req.send_request(options)
11783
11779
  end
11784
11780
 
11785
- # Places an Object Retention configuration on an object.
11781
+ # Places an Object Retention configuration on an object. For more
11782
+ # information, see [Locking Objects][1].
11786
11783
  #
11787
11784
  # This action is not supported by Amazon S3 on Outposts.
11788
11785
  #
11789
- # **Related Resources**
11790
- #
11791
- # * [Locking Objects][1]
11792
- #
11793
- # ^
11794
- #
11795
11786
  #
11796
11787
  #
11797
11788
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
@@ -11806,11 +11797,11 @@ module Aws::S3
11806
11797
  # When using this action with an access point through the AWS SDKs, you
11807
11798
  # provide the access point ARN in place of the bucket name. For more
11808
11799
  # information about access point ARNs, see [Using Access Points][1] in
11809
- # the *Amazon Simple Storage Service Developer Guide*.
11800
+ # the *Amazon S3 User Guide*.
11810
11801
  #
11811
11802
  #
11812
11803
  #
11813
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11804
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11814
11805
  #
11815
11806
  # @option params [required, String] :key
11816
11807
  # The key name for the object that you want to apply this Object
@@ -11845,7 +11836,7 @@ module Aws::S3
11845
11836
  # SDKs, this field is calculated automatically.
11846
11837
  #
11847
11838
  # @option params [String] :expected_bucket_owner
11848
- # The account id of the expected bucket owner. If the bucket is owned by
11839
+ # The account ID of the expected bucket owner. If the bucket is owned by
11849
11840
  # a different account, the request will fail with an HTTP `403 (Access
11850
11841
  # Denied)` error.
11851
11842
  #
@@ -11948,7 +11939,7 @@ module Aws::S3
11948
11939
  # When using this action with an access point through the AWS SDKs, you
11949
11940
  # provide the access point ARN in place of the bucket name. For more
11950
11941
  # information about access point ARNs, see [Using Access Points][1] in
11951
- # the *Amazon Simple Storage Service Developer Guide*.
11942
+ # the *Amazon S3 User Guide*.
11952
11943
  #
11953
11944
  # When using this action with Amazon S3 on Outposts, you must direct
11954
11945
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -11957,12 +11948,12 @@ module Aws::S3
11957
11948
  # When using this action using S3 on Outposts through the AWS SDKs, you
11958
11949
  # provide the Outposts bucket ARN in place of the bucket name. For more
11959
11950
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
11960
- # in the *Amazon Simple Storage Service Developer Guide*.
11951
+ # in the *Amazon S3 User Guide*.
11961
11952
  #
11962
11953
  #
11963
11954
  #
11964
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
11965
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
11955
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
11956
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
11966
11957
  #
11967
11958
  # @option params [required, String] :key
11968
11959
  # Name of the object key.
@@ -11980,7 +11971,7 @@ module Aws::S3
11980
11971
  # Container for the `TagSet` and `Tag` elements
11981
11972
  #
11982
11973
  # @option params [String] :expected_bucket_owner
11983
- # The account id of the expected bucket owner. If the bucket is owned by
11974
+ # The account ID of the expected bucket owner. If the bucket is owned by
11984
11975
  # a different account, the request will fail with an HTTP `403 (Access
11985
11976
  # Denied)` error.
11986
11977
  #
@@ -12108,14 +12099,14 @@ module Aws::S3
12108
12099
  # Amazon S3 bucket. You can enable the configuration options in any
12109
12100
  # combination. For more information about when Amazon S3 considers a
12110
12101
  # bucket or object public, see [The Meaning of "Public"][1] in the
12111
- # *Amazon Simple Storage Service Developer Guide*.
12102
+ # *Amazon S3 User Guide*.
12112
12103
  #
12113
12104
  #
12114
12105
  #
12115
12106
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status
12116
12107
  #
12117
12108
  # @option params [String] :expected_bucket_owner
12118
- # The account id of the expected bucket owner. If the bucket is owned by
12109
+ # The account ID of the expected bucket owner. If the bucket is owned by
12119
12110
  # a different account, the request will fail with an HTTP `403 (Access
12120
12111
  # Denied)` error.
12121
12112
  #
@@ -12159,7 +12150,7 @@ module Aws::S3
12159
12150
  # default and can grant this permission to others. For more information
12160
12151
  # about permissions, see [Permissions Related to Bucket Subresource
12161
12152
  # Operations][1] and [Managing Access Permissions to Your Amazon S3
12162
- # Resources][2] in the *Amazon Simple Storage Service User Guide*.
12153
+ # Resources][2] in the *Amazon S3 User Guide*.
12163
12154
  #
12164
12155
  # **Querying Archives with Select Requests**
12165
12156
  #
@@ -12169,7 +12160,7 @@ module Aws::S3
12169
12160
  # files. You can run queries and custom analytics on your archived data
12170
12161
  # without having to restore your data to a hotter Amazon S3 tier. For an
12171
12162
  # overview about select requests, see [Querying Archived Objects][3] in
12172
- # the *Amazon Simple Storage Service User Guide*.
12163
+ # the *Amazon S3 User Guide*.
12173
12164
  #
12174
12165
  # When making a select request, do the following:
12175
12166
  #
@@ -12179,19 +12170,18 @@ module Aws::S3
12179
12170
  # that initiates the job must have permissions to write to the S3
12180
12171
  # bucket. You can specify the storage class and encryption for the
12181
12172
  # output objects stored in the bucket. For more information about
12182
- # output, see [Querying Archived Objects][3] in the *Amazon Simple
12183
- # Storage Service User Guide*.
12173
+ # output, see [Querying Archived Objects][3] in the *Amazon S3 User
12174
+ # Guide*.
12184
12175
  #
12185
12176
  # For more information about the `S3` structure in the request body,
12186
12177
  # see the following:
12187
12178
  #
12188
12179
  # * [PutObject][4]
12189
12180
  #
12190
- # * [Managing Access with ACLs][5] in the *Amazon Simple Storage
12191
- # Service User Guide*
12181
+ # * [Managing Access with ACLs][5] in the *Amazon S3 User Guide*
12192
12182
  #
12193
12183
  # * [Protecting Data Using Server-Side Encryption][6] in the *Amazon
12194
- # Simple Storage Service User Guide*
12184
+ # S3 User Guide*
12195
12185
  #
12196
12186
  # * Define the SQL expression for the `SELECT` type of restoration for
12197
12187
  # your query in the request body's `SelectParameters` structure. You
@@ -12217,7 +12207,7 @@ module Aws::S3
12217
12207
  #
12218
12208
  # For more information about using SQL with S3 Glacier Select restore,
12219
12209
  # see [SQL Reference for Amazon S3 Select and S3 Glacier Select][7] in
12220
- # the *Amazon Simple Storage Service User Guide*.
12210
+ # the *Amazon S3 User Guide*.
12221
12211
  #
12222
12212
  # When making a select request, you can also do the following:
12223
12213
  #
@@ -12296,20 +12286,19 @@ module Aws::S3
12296
12286
  #
12297
12287
  # For more information about archive retrieval options and provisioned
12298
12288
  # capacity for `Expedited` data access, see [Restoring Archived
12299
- # Objects][8] in the *Amazon Simple Storage Service User Guide*.
12289
+ # Objects][8] in the *Amazon S3 User Guide*.
12300
12290
  #
12301
12291
  # You can use Amazon S3 restore speed upgrade to change the restore
12302
12292
  # speed to a faster speed while it is in progress. For more information,
12303
12293
  # see [ Upgrading the speed of an in-progress restore][9] in the *Amazon
12304
- # Simple Storage Service User Guide*.
12294
+ # S3 User Guide*.
12305
12295
  #
12306
12296
  # To get the status of object restoration, you can send a `HEAD`
12307
12297
  # request. Operations return the `x-amz-restore` header, which provides
12308
12298
  # information about the restoration status, in the response. You can use
12309
12299
  # Amazon S3 event notifications to notify you when a restore is
12310
12300
  # initiated or completed. For more information, see [Configuring Amazon
12311
- # S3 Event Notifications][10] in the *Amazon Simple Storage Service User
12312
- # Guide*.
12301
+ # S3 Event Notifications][10] in the *Amazon S3 User Guide*.
12313
12302
  #
12314
12303
  # After restoring an archived object, you can update the restoration
12315
12304
  # period by reissuing the request with a new period. Amazon S3 updates
@@ -12325,7 +12314,7 @@ module Aws::S3
12325
12314
  # days, Amazon S3 deletes the object in 3 days. For more information
12326
12315
  # about lifecycle configuration, see
12327
12316
  # [PutBucketLifecycleConfiguration][11] and [Object Lifecycle
12328
- # Management][12] in *Amazon Simple Storage Service User Guide*.
12317
+ # Management][12] in *Amazon S3 User Guide*.
12329
12318
  #
12330
12319
  # **Responses**
12331
12320
  #
@@ -12367,12 +12356,12 @@ module Aws::S3
12367
12356
  # * [GetBucketNotificationConfiguration][13]
12368
12357
  #
12369
12358
  # * [SQL Reference for Amazon S3 Select and S3 Glacier Select ][7] in
12370
- # the *Amazon Simple Storage Service User Guide*
12359
+ # the *Amazon S3 User Guide*
12371
12360
  #
12372
12361
  #
12373
12362
  #
12374
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12375
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-access-control.html
12363
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
12364
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
12376
12365
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/querying-glacier-archives.html
12377
12366
  # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
12378
12367
  # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
@@ -12394,7 +12383,7 @@ module Aws::S3
12394
12383
  # When using this action with an access point through the AWS SDKs, you
12395
12384
  # provide the access point ARN in place of the bucket name. For more
12396
12385
  # information about access point ARNs, see [Using Access Points][1] in
12397
- # the *Amazon Simple Storage Service Developer Guide*.
12386
+ # the *Amazon S3 User Guide*.
12398
12387
  #
12399
12388
  # When using this action with Amazon S3 on Outposts, you must direct
12400
12389
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -12403,12 +12392,12 @@ module Aws::S3
12403
12392
  # When using this action using S3 on Outposts through the AWS SDKs, you
12404
12393
  # provide the Outposts bucket ARN in place of the bucket name. For more
12405
12394
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
12406
- # in the *Amazon Simple Storage Service Developer Guide*.
12395
+ # in the *Amazon S3 User Guide*.
12407
12396
  #
12408
12397
  #
12409
12398
  #
12410
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
12411
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
12399
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
12400
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
12412
12401
  #
12413
12402
  # @option params [required, String] :key
12414
12403
  # Object key for which the action was initiated.
@@ -12431,7 +12420,7 @@ module Aws::S3
12431
12420
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
12432
12421
  #
12433
12422
  # @option params [String] :expected_bucket_owner
12434
- # The account id of the expected bucket owner. If the bucket is owned by
12423
+ # The account ID of the expected bucket owner. If the bucket is owned by
12435
12424
  # a different account, the request will fail with an HTTP `403 (Access
12436
12425
  # Denied)` error.
12437
12426
  #
@@ -12576,11 +12565,11 @@ module Aws::S3
12576
12565
  # This action is not supported by Amazon S3 on Outposts.
12577
12566
  #
12578
12567
  # For more information about Amazon S3 Select, see [Selecting Content
12579
- # from Objects][1] in the *Amazon Simple Storage Service User Guide*.
12568
+ # from Objects][1] in the *Amazon S3 User Guide*.
12580
12569
  #
12581
12570
  # For more information about using SQL with Amazon S3 Select, see [ SQL
12582
12571
  # Reference for Amazon S3 Select and S3 Glacier Select][2] in the
12583
- # *Amazon Simple Storage Service User Guide*.
12572
+ # *Amazon S3 User Guide*.
12584
12573
  #
12585
12574
  #
12586
12575
  #
@@ -12589,7 +12578,7 @@ module Aws::S3
12589
12578
  # You must have `s3:GetObject` permission for this operation. Amazon S3
12590
12579
  # Select does not support anonymous access. For more information about
12591
12580
  # permissions, see [Specifying Permissions in a Policy][3] in the
12592
- # *Amazon Simple Storage Service User Guide*.
12581
+ # *Amazon S3 User Guide*.
12593
12582
  #
12594
12583
  #
12595
12584
  #
@@ -12617,8 +12606,7 @@ module Aws::S3
12617
12606
  # keys (SSE-C), you must use HTTPS, and you must use the headers that
12618
12607
  # are documented in the [GetObject][4]. For more information about
12619
12608
  # SSE-C, see [Server-Side Encryption (Using Customer-Provided
12620
- # Encryption Keys)][5] in the *Amazon Simple Storage Service User
12621
- # Guide*.
12609
+ # Encryption Keys)][5] in the *Amazon S3 User Guide*.
12622
12610
  #
12623
12611
  # For objects that are encrypted with Amazon S3 managed encryption
12624
12612
  # keys (SSE-S3) and customer master keys (CMKs) stored in AWS Key
@@ -12626,7 +12614,7 @@ module Aws::S3
12626
12614
  # transparently, so you don't need to specify anything. For more
12627
12615
  # information about server-side encryption, including SSE-S3 and
12628
12616
  # SSE-KMS, see [Protecting Data Using Server-Side Encryption][6] in
12629
- # the *Amazon Simple Storage Service User Guide*.
12617
+ # the *Amazon S3 User Guide*.
12630
12618
  #
12631
12619
  # **Working with the Response Body**
12632
12620
  #
@@ -12650,8 +12638,7 @@ module Aws::S3
12650
12638
  # * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
12651
12639
  # cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
12652
12640
  # storage classes. For more information, about storage classes see
12653
- # [Storage Classes][9] in the *Amazon Simple Storage Service User
12654
- # Guide*.
12641
+ # [Storage Classes][9] in the *Amazon S3 User Guide*.
12655
12642
  #
12656
12643
  #
12657
12644
  #
@@ -12750,7 +12737,7 @@ module Aws::S3
12750
12737
  # within the last 50 bytes of the file.
12751
12738
  #
12752
12739
  # @option params [String] :expected_bucket_owner
12753
- # The account id of the expected bucket owner. If the bucket is owned by
12740
+ # The account ID of the expected bucket owner. If the bucket is owned by
12754
12741
  # a different account, the request will fail with an HTTP `403 (Access
12755
12742
  # Denied)` error.
12756
12743
  #
@@ -13017,11 +13004,11 @@ module Aws::S3
13017
13004
  # parts storage and stops charging you for the parts storage.
13018
13005
  #
13019
13006
  # For more information on multipart uploads, go to [Multipart Upload
13020
- # Overview][4] in the <i>Amazon Simple Storage Service User Guide </i>.
13007
+ # Overview][4] in the <i>Amazon S3 User Guide </i>.
13021
13008
  #
13022
13009
  # For information on the permissions required to use the multipart
13023
13010
  # upload API, go to [Multipart Upload and Permissions][5] in the *Amazon
13024
- # Simple Storage Service User Guide*.
13011
+ # S3 User Guide*.
13025
13012
  #
13026
13013
  # You can optionally request server-side encryption where Amazon S3
13027
13014
  # encrypts your data as it writes it to disks in its data centers and
@@ -13031,8 +13018,7 @@ module Aws::S3
13031
13018
  # request headers you provide in the request must match the headers you
13032
13019
  # used in the request to initiate the upload by using
13033
13020
  # [CreateMultipartUpload][2]. For more information, go to [Using
13034
- # Server-Side Encryption][6] in the *Amazon Simple Storage Service User
13035
- # Guide*.
13021
+ # Server-Side Encryption][6] in the *Amazon S3 User Guide*.
13036
13022
  #
13037
13023
  # Server-side encryption is supported by the S3 Multipart Upload
13038
13024
  # actions. Unless you are using a customer-provided encryption key, you
@@ -13101,7 +13087,7 @@ module Aws::S3
13101
13087
  # When using this action with an access point through the AWS SDKs, you
13102
13088
  # provide the access point ARN in place of the bucket name. For more
13103
13089
  # information about access point ARNs, see [Using Access Points][1] in
13104
- # the *Amazon Simple Storage Service Developer Guide*.
13090
+ # the *Amazon S3 User Guide*.
13105
13091
  #
13106
13092
  # When using this action with Amazon S3 on Outposts, you must direct
13107
13093
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -13110,12 +13096,12 @@ module Aws::S3
13110
13096
  # When using this action using S3 on Outposts through the AWS SDKs, you
13111
13097
  # provide the Outposts bucket ARN in place of the bucket name. For more
13112
13098
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
13113
- # in the *Amazon Simple Storage Service Developer Guide*.
13099
+ # in the *Amazon S3 User Guide*.
13114
13100
  #
13115
13101
  #
13116
13102
  #
13117
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
13118
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
13103
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
13104
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
13119
13105
  #
13120
13106
  # @option params [Integer] :content_length
13121
13107
  # Size of the body in bytes. This parameter is useful when the size of
@@ -13167,7 +13153,7 @@ module Aws::S3
13167
13153
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
13168
13154
  #
13169
13155
  # @option params [String] :expected_bucket_owner
13170
- # The account id of the expected bucket owner. If the bucket is owned by
13156
+ # The account ID of the expected bucket owner. If the bucket is owned by
13171
13157
  # a different account, the request will fail with an HTTP `403 (Access
13172
13158
  # Denied)` error.
13173
13159
  #
@@ -13243,7 +13229,7 @@ module Aws::S3
13243
13229
  #
13244
13230
  # The minimum allowable part size for a multipart upload is 5 MB. For
13245
13231
  # more information about multipart upload limits, go to [Quick Facts][1]
13246
- # in the *Amazon Simple Storage Service User Guide*.
13232
+ # in the *Amazon S3 User Guide*.
13247
13233
  #
13248
13234
  # <note markdown="1"> Instead of using an existing object as part data, you might use the
13249
13235
  # [UploadPart][2] action and provide data in your request.
@@ -13259,16 +13245,15 @@ module Aws::S3
13259
13245
  # the following:
13260
13246
  #
13261
13247
  # * For conceptual information about multipart uploads, see [Uploading
13262
- # Objects Using Multipart Upload][3] in the *Amazon Simple Storage
13263
- # Service User Guide*.
13248
+ # Objects Using Multipart Upload][3] in the *Amazon S3 User Guide*.
13264
13249
  #
13265
13250
  # * For information about permissions required to use the multipart
13266
13251
  # upload API, see [Multipart Upload and Permissions][4] in the *Amazon
13267
- # Simple Storage Service User Guide*.
13252
+ # S3 User Guide*.
13268
13253
  #
13269
13254
  # * For information about copying objects using a single atomic action
13270
13255
  # vs. the multipart upload, see [Operations on Objects][5] in the
13271
- # *Amazon Simple Storage Service User Guide*.
13256
+ # *Amazon S3 User Guide*.
13272
13257
  #
13273
13258
  # * For information about using server-side encryption with
13274
13259
  # customer-provided encryption keys with the UploadPartCopy operation,
@@ -13376,7 +13361,7 @@ module Aws::S3
13376
13361
  # When using this action with an access point through the AWS SDKs, you
13377
13362
  # provide the access point ARN in place of the bucket name. For more
13378
13363
  # information about access point ARNs, see [Using Access Points][1] in
13379
- # the *Amazon Simple Storage Service Developer Guide*.
13364
+ # the *Amazon S3 User Guide*.
13380
13365
  #
13381
13366
  # When using this action with Amazon S3 on Outposts, you must direct
13382
13367
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
@@ -13385,12 +13370,12 @@ module Aws::S3
13385
13370
  # When using this action using S3 on Outposts through the AWS SDKs, you
13386
13371
  # provide the Outposts bucket ARN in place of the bucket name. For more
13387
13372
  # information about S3 on Outposts ARNs, see [Using S3 on Outposts][2]
13388
- # in the *Amazon Simple Storage Service Developer Guide*.
13373
+ # in the *Amazon S3 User Guide*.
13389
13374
  #
13390
13375
  #
13391
13376
  #
13392
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
13393
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3onOutposts.html
13377
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
13378
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
13394
13379
  #
13395
13380
  # @option params [required, String] :copy_source
13396
13381
  # Specifies the source object for the copy operation. You specify the
@@ -13436,7 +13421,7 @@ module Aws::S3
13436
13421
  #
13437
13422
  #
13438
13423
  #
13439
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/access-points.html
13424
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-points.html
13440
13425
  #
13441
13426
  # @option params [String] :copy_source_if_match
13442
13427
  # Copies the object if its entity tag (ETag) matches the specified tag.
@@ -13513,12 +13498,12 @@ module Aws::S3
13513
13498
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
13514
13499
  #
13515
13500
  # @option params [String] :expected_bucket_owner
13516
- # The account id of the expected destination bucket owner. If the
13501
+ # The account ID of the expected destination bucket owner. If the
13517
13502
  # destination bucket is owned by a different account, the request will
13518
13503
  # fail with an HTTP `403 (Access Denied)` error.
13519
13504
  #
13520
13505
  # @option params [String] :expected_source_bucket_owner
13521
- # The account id of the expected source bucket owner. If the source
13506
+ # The account ID of the expected source bucket owner. If the source
13522
13507
  # bucket is owned by a different account, the request will fail with an
13523
13508
  # HTTP `403 (Access Denied)` error.
13524
13509
  #
@@ -13621,6 +13606,297 @@ module Aws::S3
13621
13606
  req.send_request(options)
13622
13607
  end
13623
13608
 
13609
+ # Passes transformed objects to a `GetObject` operation when using
13610
+ # Object Lambda Access Points. For information about Object Lambda
13611
+ # Access Points, see [Transforming objects with Object Lambda Access
13612
+ # Points][1] in the *Amazon S3 User Guide*.
13613
+ #
13614
+ # This operation supports metadata that can be returned by
13615
+ # [GetObject][2], in addition to `RequestRoute`, `RequestToken`,
13616
+ # `StatusCode`, `ErrorCode`, and `ErrorMessage`. The `GetObject`
13617
+ # response metadata is supported so that the `WriteGetObjectResponse`
13618
+ # caller, typically an AWS Lambda function, can provide the same
13619
+ # metadata when it internally invokes `GetObject`. When
13620
+ # `WriteGetObjectResponse` is called by a customer-owned Lambda
13621
+ # function, the metadata returned to the end user `GetObject` call might
13622
+ # differ from what Amazon S3 would normally return.
13623
+ #
13624
+ # AWS provides some prebuilt Lambda functions that you can use with S3
13625
+ # Object Lambda to detect and redact personally identifiable information
13626
+ # (PII) and decompress S3 objects. These Lambda functions are available
13627
+ # in the AWS Serverless Application Repository, and can be selected
13628
+ # through the AWS Management Console when you create your Object Lambda
13629
+ # Access Point.
13630
+ #
13631
+ # Example 1: PII Access Control - This Lambda function uses Amazon
13632
+ # Comprehend, a natural language processing (NLP) service using machine
13633
+ # learning to find insights and relationships in text. It automatically
13634
+ # detects personally identifiable information (PII) such as names,
13635
+ # addresses, dates, credit card numbers, and social security numbers
13636
+ # from documents in your Amazon S3 bucket.
13637
+ #
13638
+ # Example 2: PII Redaction - This Lambda function uses Amazon
13639
+ # Comprehend, a natural language processing (NLP) service using machine
13640
+ # learning to find insights and relationships in text. It automatically
13641
+ # redacts personally identifiable information (PII) such as names,
13642
+ # addresses, dates, credit card numbers, and social security numbers
13643
+ # from documents in your Amazon S3 bucket.
13644
+ #
13645
+ # Example 3: Decompression - The Lambda function
13646
+ # S3ObjectLambdaDecompression, is equipped to decompress objects stored
13647
+ # in S3 in one of six compressed file formats including bzip2, gzip,
13648
+ # snappy, zlib, zstandard and ZIP.
13649
+ #
13650
+ # For information on how to view and use these functions, see [Using AWS
13651
+ # built Lambda functions][3] in the *Amazon S3 User Guide*.
13652
+ #
13653
+ #
13654
+ #
13655
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
13656
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
13657
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/olap-examples.html
13658
+ #
13659
+ # @option params [required, String] :request_route
13660
+ # Route prefix to the HTTP URL generated.
13661
+ #
13662
+ # @option params [required, String] :request_token
13663
+ # A single use encrypted token that maps `WriteGetObjectResponse` to the
13664
+ # end user `GetObject` request.
13665
+ #
13666
+ # @option params [String, IO] :body
13667
+ # The object data.
13668
+ #
13669
+ # @option params [Integer] :status_code
13670
+ # The integer status code for an HTTP response of a corresponding
13671
+ # `GetObject` request.
13672
+ #
13673
+ # **Status Codes**
13674
+ #
13675
+ # * *200 - OK*
13676
+ #
13677
+ # * *206 - Partial Content*
13678
+ #
13679
+ # * *304 - Not Modified*
13680
+ #
13681
+ # * *400 - Bad Request*
13682
+ #
13683
+ # * *401 - Unauthorized*
13684
+ #
13685
+ # * *403 - Forbidden*
13686
+ #
13687
+ # * *404 - Not Found*
13688
+ #
13689
+ # * *405 - Method Not Allowed*
13690
+ #
13691
+ # * *409 - Conflict*
13692
+ #
13693
+ # * *411 - Length Required*
13694
+ #
13695
+ # * *412 - Precondition Failed*
13696
+ #
13697
+ # * *416 - Range Not Satisfiable*
13698
+ #
13699
+ # * *500 - Internal Server Error*
13700
+ #
13701
+ # * *503 - Service Unavailable*
13702
+ #
13703
+ # @option params [String] :error_code
13704
+ # A string that uniquely identifies an error condition. Returned in the
13705
+ # &lt;Code&gt; tag of the error XML response for a corresponding
13706
+ # `GetObject` call. Cannot be used with a successful `StatusCode` header
13707
+ # or when the transformed object is provided in the body. All error
13708
+ # codes from S3 are sentence-cased. Regex value is
13709
+ # "^\[A-Z\]\[a-zA-Z\]+$".
13710
+ #
13711
+ # @option params [String] :error_message
13712
+ # Contains a generic description of the error condition. Returned in the
13713
+ # &lt;Message&gt; tag of the error XML response for a corresponding
13714
+ # `GetObject` call. Cannot be used with a successful `StatusCode` header
13715
+ # or when the transformed object is provided in body.
13716
+ #
13717
+ # @option params [String] :accept_ranges
13718
+ # Indicates that a range of bytes was specified.
13719
+ #
13720
+ # @option params [String] :cache_control
13721
+ # Specifies caching behavior along the request/reply chain.
13722
+ #
13723
+ # @option params [String] :content_disposition
13724
+ # Specifies presentational information for the object.
13725
+ #
13726
+ # @option params [String] :content_encoding
13727
+ # Specifies what content encodings have been applied to the object and
13728
+ # thus what decoding mechanisms must be applied to obtain the media-type
13729
+ # referenced by the Content-Type header field.
13730
+ #
13731
+ # @option params [String] :content_language
13732
+ # The language the content is in.
13733
+ #
13734
+ # @option params [Integer] :content_length
13735
+ # The size of the content body in bytes.
13736
+ #
13737
+ # @option params [String] :content_range
13738
+ # The portion of the object returned in the response.
13739
+ #
13740
+ # @option params [String] :content_type
13741
+ # A standard MIME type describing the format of the object data.
13742
+ #
13743
+ # @option params [Boolean] :delete_marker
13744
+ # Specifies whether an object stored in Amazon S3 is (`true`) or is not
13745
+ # (`false`) a delete marker.
13746
+ #
13747
+ # @option params [String] :etag
13748
+ # An opaque identifier assigned by a web server to a specific version of
13749
+ # a resource found at a URL.
13750
+ #
13751
+ # @option params [Time,DateTime,Date,Integer,String] :expires
13752
+ # The date and time at which the object is no longer cacheable.
13753
+ #
13754
+ # @option params [String] :expiration
13755
+ # If object stored in Amazon S3 expiration is configured (see PUT Bucket
13756
+ # lifecycle) it includes expiry-date and rule-id key-value pairs
13757
+ # providing object expiration information. The value of the rule-id is
13758
+ # URL encoded.
13759
+ #
13760
+ # @option params [Time,DateTime,Date,Integer,String] :last_modified
13761
+ # The date and time that the object was last modified.
13762
+ #
13763
+ # @option params [Integer] :missing_meta
13764
+ # Set to the number of metadata entries not returned in `x-amz-meta`
13765
+ # headers. This can happen if you create metadata using an API like SOAP
13766
+ # that supports more flexible metadata than the REST API. For example,
13767
+ # using SOAP, you can create metadata whose values are not legal HTTP
13768
+ # headers.
13769
+ #
13770
+ # @option params [Hash<String,String>] :metadata
13771
+ # A map of metadata to store with the object in S3.
13772
+ #
13773
+ # @option params [String] :object_lock_mode
13774
+ # Indicates whether an object stored in Amazon S3 has Object Lock
13775
+ # enabled. For more information about S3 Object Lock, see [Object
13776
+ # Lock][1].
13777
+ #
13778
+ #
13779
+ #
13780
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html
13781
+ #
13782
+ # @option params [String] :object_lock_legal_hold_status
13783
+ # Indicates whether an object stored in Amazon S3 has an active legal
13784
+ # hold.
13785
+ #
13786
+ # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
13787
+ # The date and time when Object Lock is configured to expire.
13788
+ #
13789
+ # @option params [Integer] :parts_count
13790
+ # The count of parts this object has.
13791
+ #
13792
+ # @option params [String] :replication_status
13793
+ # Indicates if request involves bucket that is either a source or
13794
+ # destination in a Replication rule. For more information about S3
13795
+ # Replication, see [Replication][1].
13796
+ #
13797
+ #
13798
+ #
13799
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/replication.html
13800
+ #
13801
+ # @option params [String] :request_charged
13802
+ # If present, indicates that the requester was successfully charged for
13803
+ # the request.
13804
+ #
13805
+ # @option params [String] :restore
13806
+ # Provides information about object restoration operation and expiration
13807
+ # time of the restored object copy.
13808
+ #
13809
+ # @option params [String] :server_side_encryption
13810
+ # The server-side encryption algorithm used when storing requested
13811
+ # object in Amazon S3 (for example, AES256, aws:kms).
13812
+ #
13813
+ # @option params [String] :sse_customer_algorithm
13814
+ # Encryption algorithm used if server-side encryption with a
13815
+ # customer-provided encryption key was specified for object stored in
13816
+ # Amazon S3.
13817
+ #
13818
+ # @option params [String] :ssekms_key_id
13819
+ # If present, specifies the ID of the AWS Key Management Service (AWS
13820
+ # KMS) symmetric customer managed customer master key (CMK) that was
13821
+ # used for stored in Amazon S3 object.
13822
+ #
13823
+ # @option params [String] :sse_customer_key_md5
13824
+ # 128-bit MD5 digest of customer-provided encryption key used in Amazon
13825
+ # S3 to encrypt data stored in S3. For more information, see [Protecting
13826
+ # data using server-side encryption with customer-provided encryption
13827
+ # keys (SSE-C)][1].
13828
+ #
13829
+ #
13830
+ #
13831
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
13832
+ #
13833
+ # @option params [String] :storage_class
13834
+ # The class of storage used to store object in Amazon S3.
13835
+ #
13836
+ # @option params [Integer] :tag_count
13837
+ # The number of tags, if any, on the object.
13838
+ #
13839
+ # @option params [String] :version_id
13840
+ # An ID used to reference a specific version of the object.
13841
+ #
13842
+ # @option params [Boolean] :bucket_key_enabled
13843
+ # Indicates whether the object stored in Amazon S3 uses an S3 bucket key
13844
+ # for server-side encryption with AWS KMS (SSE-KMS).
13845
+ #
13846
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
13847
+ #
13848
+ # @example Request syntax with placeholder values
13849
+ #
13850
+ # resp = client.write_get_object_response({
13851
+ # request_route: "RequestRoute", # required
13852
+ # request_token: "RequestToken", # required
13853
+ # body: source_file,
13854
+ # status_code: 1,
13855
+ # error_code: "ErrorCode",
13856
+ # error_message: "ErrorMessage",
13857
+ # accept_ranges: "AcceptRanges",
13858
+ # cache_control: "CacheControl",
13859
+ # content_disposition: "ContentDisposition",
13860
+ # content_encoding: "ContentEncoding",
13861
+ # content_language: "ContentLanguage",
13862
+ # content_length: 1,
13863
+ # content_range: "ContentRange",
13864
+ # content_type: "ContentType",
13865
+ # delete_marker: false,
13866
+ # etag: "ETag",
13867
+ # expires: Time.now,
13868
+ # expiration: "Expiration",
13869
+ # last_modified: Time.now,
13870
+ # missing_meta: 1,
13871
+ # metadata: {
13872
+ # "MetadataKey" => "MetadataValue",
13873
+ # },
13874
+ # object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
13875
+ # object_lock_legal_hold_status: "ON", # accepts ON, OFF
13876
+ # object_lock_retain_until_date: Time.now,
13877
+ # parts_count: 1,
13878
+ # replication_status: "COMPLETE", # accepts COMPLETE, PENDING, FAILED, REPLICA
13879
+ # request_charged: "requester", # accepts requester
13880
+ # restore: "Restore",
13881
+ # server_side_encryption: "AES256", # accepts AES256, aws:kms
13882
+ # sse_customer_algorithm: "SSECustomerAlgorithm",
13883
+ # ssekms_key_id: "SSEKMSKeyId",
13884
+ # sse_customer_key_md5: "SSECustomerKeyMD5",
13885
+ # storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
13886
+ # tag_count: 1,
13887
+ # version_id: "ObjectVersionId",
13888
+ # bucket_key_enabled: false,
13889
+ # })
13890
+ #
13891
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/WriteGetObjectResponse AWS API Documentation
13892
+ #
13893
+ # @overload write_get_object_response(params = {})
13894
+ # @param [Hash] params ({})
13895
+ def write_get_object_response(params = {}, options = {})
13896
+ req = build_request(:write_get_object_response, params)
13897
+ req.send_request(options)
13898
+ end
13899
+
13624
13900
  # @!endgroup
13625
13901
 
13626
13902
  # @param params ({})
@@ -13634,7 +13910,7 @@ module Aws::S3
13634
13910
  params: params,
13635
13911
  config: config)
13636
13912
  context[:gem_name] = 'aws-sdk-s3'
13637
- context[:gem_version] = '1.91.0'
13913
+ context[:gem_version] = '1.94.1'
13638
13914
  Seahorse::Client::Request.new(handlers, context)
13639
13915
  end
13640
13916