aws-sdk-s3 1.121.0 → 1.136.0

Sign up to get free protection for your applications and to get access to all the features.
Files changed (45) hide show
  1. checksums.yaml +4 -4
  2. data/CHANGELOG.md +99 -0
  3. data/VERSION +1 -1
  4. data/lib/aws-sdk-s3/bucket.rb +122 -60
  5. data/lib/aws-sdk-s3/bucket_acl.rb +9 -3
  6. data/lib/aws-sdk-s3/bucket_cors.rb +12 -4
  7. data/lib/aws-sdk-s3/bucket_lifecycle.rb +12 -4
  8. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +12 -4
  9. data/lib/aws-sdk-s3/bucket_logging.rb +9 -3
  10. data/lib/aws-sdk-s3/bucket_notification.rb +9 -3
  11. data/lib/aws-sdk-s3/bucket_policy.rb +12 -4
  12. data/lib/aws-sdk-s3/bucket_request_payment.rb +9 -3
  13. data/lib/aws-sdk-s3/bucket_tagging.rb +12 -4
  14. data/lib/aws-sdk-s3/bucket_versioning.rb +15 -5
  15. data/lib/aws-sdk-s3/bucket_website.rb +12 -4
  16. data/lib/aws-sdk-s3/client.rb +2017 -1674
  17. data/lib/aws-sdk-s3/client_api.rb +24 -0
  18. data/lib/aws-sdk-s3/customizations/bucket.rb +3 -1
  19. data/lib/aws-sdk-s3/customizations/errors.rb +1 -1
  20. data/lib/aws-sdk-s3/customizations/object.rb +91 -18
  21. data/lib/aws-sdk-s3/encryption/client.rb +6 -2
  22. data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +13 -9
  23. data/lib/aws-sdk-s3/encryptionV2/client.rb +6 -2
  24. data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +1 -0
  25. data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +10 -6
  26. data/lib/aws-sdk-s3/endpoint_parameters.rb +4 -0
  27. data/lib/aws-sdk-s3/endpoint_provider.rb +22 -246
  28. data/lib/aws-sdk-s3/endpoints.rb +1 -0
  29. data/lib/aws-sdk-s3/file_downloader.rb +170 -44
  30. data/lib/aws-sdk-s3/file_uploader.rb +8 -6
  31. data/lib/aws-sdk-s3/multipart_stream_uploader.rb +5 -3
  32. data/lib/aws-sdk-s3/multipart_upload.rb +27 -13
  33. data/lib/aws-sdk-s3/multipart_upload_part.rb +19 -9
  34. data/lib/aws-sdk-s3/object.rb +151 -105
  35. data/lib/aws-sdk-s3/object_acl.rb +14 -6
  36. data/lib/aws-sdk-s3/object_copier.rb +7 -5
  37. data/lib/aws-sdk-s3/object_multipart_copier.rb +33 -17
  38. data/lib/aws-sdk-s3/object_summary.rb +144 -89
  39. data/lib/aws-sdk-s3/object_version.rb +55 -21
  40. data/lib/aws-sdk-s3/presigned_post.rb +52 -43
  41. data/lib/aws-sdk-s3/presigner.rb +4 -2
  42. data/lib/aws-sdk-s3/resource.rb +7 -3
  43. data/lib/aws-sdk-s3/types.rb +854 -484
  44. data/lib/aws-sdk-s3.rb +1 -1
  45. metadata +6 -6
@@ -13,8 +13,8 @@ module Aws::S3
13
13
  # Specifies the days since the initiation of an incomplete multipart
14
14
  # upload that Amazon S3 will wait before permanently removing all parts
15
15
  # of the upload. For more information, see [ Aborting Incomplete
16
- # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
17
- # S3 User Guide*.
16
+ # Multipart Uploads Using a Bucket Lifecycle Configuration][1] in the
17
+ # *Amazon S3 User Guide*.
18
18
  #
19
19
  #
20
20
  #
@@ -58,14 +58,14 @@ module Aws::S3
58
58
  # bucket name. For more information about access point ARNs, see
59
59
  # [Using access points][1] in the *Amazon S3 User Guide*.
60
60
  #
61
- # When using this action with Amazon S3 on Outposts, you must direct
61
+ # When you use this action with Amazon S3 on Outposts, you must direct
62
62
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
63
63
  # takes the form `
64
64
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
65
- # When using this action with S3 on Outposts through the Amazon Web
66
- # Services SDKs, you provide the Outposts bucket ARN in place of the
67
- # bucket name. For more information about S3 on Outposts ARNs, see
68
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
65
+ # When you use this action with S3 on Outposts through the Amazon Web
66
+ # Services SDKs, you provide the Outposts access point ARN in place of
67
+ # the bucket name. For more information about S3 on Outposts ARNs, see
68
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
69
69
  #
70
70
  #
71
71
  #
@@ -84,9 +84,11 @@ module Aws::S3
84
84
  # @!attribute [rw] request_payer
85
85
  # Confirms that the requester knows that they will be charged for the
86
86
  # request. Bucket owners need not specify this parameter in their
87
- # requests. For information about downloading objects from Requester
88
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
89
- # in the *Amazon S3 User Guide*.
87
+ # requests. If either the source or destination Amazon S3 bucket has
88
+ # Requester Pays enabled, the requester will pay for corresponding
89
+ # charges to copy the object. For information about downloading
90
+ # objects from Requester Pays buckets, see [Downloading Objects in
91
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
90
92
  #
91
93
  #
92
94
  #
@@ -474,7 +476,10 @@ module Aws::S3
474
476
  # @!attribute [rw] comments
475
477
  # A single character used to indicate that a row should be ignored
476
478
  # when the character is present at the start of that row. You can
477
- # specify any character to indicate a comment line.
479
+ # specify any character to indicate a comment line. The default
480
+ # character is `#`.
481
+ #
482
+ # Default: `#`
478
483
  # @return [String]
479
484
  #
480
485
  # @!attribute [rw] quote_escape_character
@@ -708,14 +713,14 @@ module Aws::S3
708
713
  # bucket name. For more information about access point ARNs, see
709
714
  # [Using access points][1] in the *Amazon S3 User Guide*.
710
715
  #
711
- # When using this action with Amazon S3 on Outposts, you must direct
716
+ # When you use this action with Amazon S3 on Outposts, you must direct
712
717
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
713
718
  # takes the form `
714
719
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
715
- # When using this action with S3 on Outposts through the Amazon Web
716
- # Services SDKs, you provide the Outposts bucket ARN in place of the
717
- # bucket name. For more information about S3 on Outposts ARNs, see
718
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
720
+ # When you use this action with S3 on Outposts through the Amazon Web
721
+ # Services SDKs, you provide the Outposts access point ARN in place of
722
+ # the bucket name. For more information about S3 on Outposts ARNs, see
723
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
719
724
  #
720
725
  #
721
726
  #
@@ -802,11 +807,8 @@ module Aws::S3
802
807
  # @return [String]
803
808
  #
804
809
  # @!attribute [rw] server_side_encryption
805
- # If you specified server-side encryption either with an Amazon
806
- # S3-managed encryption key or an Amazon Web Services KMS key in your
807
- # initiate multipart upload request, the response includes this
808
- # header. It confirms the encryption algorithm that Amazon S3 used to
809
- # encrypt the object.
810
+ # The server-side encryption algorithm used when storing this object
811
+ # in Amazon S3 (for example, `AES256`, `aws:kms`).
810
812
  # @return [String]
811
813
  #
812
814
  # @!attribute [rw] version_id
@@ -815,14 +817,15 @@ module Aws::S3
815
817
  # @return [String]
816
818
  #
817
819
  # @!attribute [rw] ssekms_key_id
818
- # If present, specifies the ID of the Amazon Web Services Key
819
- # Management Service (Amazon Web Services KMS) symmetric customer
820
- # managed key that was used for the object.
820
+ # If present, specifies the ID of the Key Management Service (KMS)
821
+ # symmetric encryption customer managed key that was used for the
822
+ # object.
821
823
  # @return [String]
822
824
  #
823
825
  # @!attribute [rw] bucket_key_enabled
824
826
  # Indicates whether the multipart upload uses an S3 Bucket Key for
825
- # server-side encryption with Amazon Web Services KMS (SSE-KMS).
827
+ # server-side encryption with Key Management Service (KMS) keys
828
+ # (SSE-KMS).
826
829
  # @return [Boolean]
827
830
  #
828
831
  # @!attribute [rw] request_charged
@@ -863,14 +866,14 @@ module Aws::S3
863
866
  # bucket name. For more information about access point ARNs, see
864
867
  # [Using access points][1] in the *Amazon S3 User Guide*.
865
868
  #
866
- # When using this action with Amazon S3 on Outposts, you must direct
869
+ # When you use this action with Amazon S3 on Outposts, you must direct
867
870
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
868
871
  # takes the form `
869
872
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
870
- # When using this action with S3 on Outposts through the Amazon Web
871
- # Services SDKs, you provide the Outposts bucket ARN in place of the
872
- # bucket name. For more information about S3 on Outposts ARNs, see
873
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
873
+ # When you use this action with S3 on Outposts through the Amazon Web
874
+ # Services SDKs, you provide the Outposts access point ARN in place of
875
+ # the bucket name. For more information about S3 on Outposts ARNs, see
876
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
874
877
  #
875
878
  #
876
879
  #
@@ -941,9 +944,11 @@ module Aws::S3
941
944
  # @!attribute [rw] request_payer
942
945
  # Confirms that the requester knows that they will be charged for the
943
946
  # request. Bucket owners need not specify this parameter in their
944
- # requests. For information about downloading objects from Requester
945
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
946
- # in the *Amazon S3 User Guide*.
947
+ # requests. If either the source or destination Amazon S3 bucket has
948
+ # Requester Pays enabled, the requester will pay for corresponding
949
+ # charges to copy the object. For information about downloading
950
+ # objects from Requester Pays buckets, see [Downloading Objects in
951
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
947
952
  #
948
953
  #
949
954
  #
@@ -1172,7 +1177,7 @@ module Aws::S3
1172
1177
  #
1173
1178
  # @!attribute [rw] server_side_encryption
1174
1179
  # The server-side encryption algorithm used when storing this object
1175
- # in Amazon S3 (for example, AES256, aws:kms).
1180
+ # in Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
1176
1181
  # @return [String]
1177
1182
  #
1178
1183
  # @!attribute [rw] sse_customer_algorithm
@@ -1189,9 +1194,9 @@ module Aws::S3
1189
1194
  # @return [String]
1190
1195
  #
1191
1196
  # @!attribute [rw] ssekms_key_id
1192
- # If present, specifies the ID of the Amazon Web Services Key
1193
- # Management Service (Amazon Web Services KMS) symmetric customer
1194
- # managed key that was used for the object.
1197
+ # If present, specifies the ID of the Key Management Service (KMS)
1198
+ # symmetric encryption customer managed key that was used for the
1199
+ # object.
1195
1200
  # @return [String]
1196
1201
  #
1197
1202
  # @!attribute [rw] ssekms_encryption_context
@@ -1203,7 +1208,8 @@ module Aws::S3
1203
1208
  #
1204
1209
  # @!attribute [rw] bucket_key_enabled
1205
1210
  # Indicates whether the copied object uses an S3 Bucket Key for
1206
- # server-side encryption with Amazon Web Services KMS (SSE-KMS).
1211
+ # server-side encryption with Key Management Service (KMS) keys
1212
+ # (SSE-KMS).
1207
1213
  # @return [Boolean]
1208
1214
  #
1209
1215
  # @!attribute [rw] request_charged
@@ -1247,14 +1253,14 @@ module Aws::S3
1247
1253
  # bucket name. For more information about access point ARNs, see
1248
1254
  # [Using access points][1] in the *Amazon S3 User Guide*.
1249
1255
  #
1250
- # When using this action with Amazon S3 on Outposts, you must direct
1256
+ # When you use this action with Amazon S3 on Outposts, you must direct
1251
1257
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
1252
1258
  # takes the form `
1253
1259
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1254
- # When using this action with S3 on Outposts through the Amazon Web
1255
- # Services SDKs, you provide the Outposts bucket ARN in place of the
1256
- # bucket name. For more information about S3 on Outposts ARNs, see
1257
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
1260
+ # When you use this action with S3 on Outposts through the Amazon Web
1261
+ # Services SDKs, you provide the Outposts access point ARN in place of
1262
+ # the bucket name. For more information about S3 on Outposts ARNs, see
1263
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
1258
1264
  #
1259
1265
  #
1260
1266
  #
@@ -1410,15 +1416,16 @@ module Aws::S3
1410
1416
  #
1411
1417
  # @!attribute [rw] server_side_encryption
1412
1418
  # The server-side encryption algorithm used when storing this object
1413
- # in Amazon S3 (for example, AES256, aws:kms).
1419
+ # in Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
1414
1420
  # @return [String]
1415
1421
  #
1416
1422
  # @!attribute [rw] storage_class
1417
- # By default, Amazon S3 uses the STANDARD Storage Class to store newly
1418
- # created objects. The STANDARD storage class provides high durability
1419
- # and high availability. Depending on performance needs, you can
1420
- # specify a different Storage Class. Amazon S3 on Outposts only uses
1421
- # the OUTPOSTS Storage Class. For more information, see [Storage
1423
+ # If the `x-amz-storage-class` header is not used, the copied object
1424
+ # will be stored in the STANDARD Storage Class by default. The
1425
+ # STANDARD storage class provides high durability and high
1426
+ # availability. Depending on performance needs, you can specify a
1427
+ # different Storage Class. Amazon S3 on Outposts only uses the
1428
+ # OUTPOSTS Storage Class. For more information, see [Storage
1422
1429
  # Classes][1] in the *Amazon S3 User Guide*.
1423
1430
  #
1424
1431
  #
@@ -1430,7 +1437,9 @@ module Aws::S3
1430
1437
  # If the bucket is configured as a website, redirects requests for
1431
1438
  # this object to another object in the same bucket or to an external
1432
1439
  # URL. Amazon S3 stores the value of this header in the object
1433
- # metadata.
1440
+ # metadata. This value is unique to each object and is not copied when
1441
+ # using the `x-amz-metadata-directive` header. Instead, you may opt to
1442
+ # provide this header in combination with the directive.
1434
1443
  # @return [String]
1435
1444
  #
1436
1445
  # @!attribute [rw] sse_customer_algorithm
@@ -1453,13 +1462,13 @@ module Aws::S3
1453
1462
  # @return [String]
1454
1463
  #
1455
1464
  # @!attribute [rw] ssekms_key_id
1456
- # Specifies the Amazon Web Services KMS key ID to use for object
1457
- # encryption. All GET and PUT requests for an object protected by
1458
- # Amazon Web Services KMS will fail if not made via SSL or using
1459
- # SigV4. For information about configuring using any of the officially
1460
- # supported Amazon Web Services SDKs and Amazon Web Services CLI, see
1461
- # [Specifying the Signature Version in Request Authentication][1] in
1462
- # the *Amazon S3 User Guide*.
1465
+ # Specifies the KMS ID (Key ID, Key ARN, or Key Alias) to use for
1466
+ # object encryption. All GET and PUT requests for an object protected
1467
+ # by KMS will fail if they're not made via SSL or using SigV4. For
1468
+ # information about configuring any of the officially supported Amazon
1469
+ # Web Services SDKs and Amazon Web Services CLI, see [Specifying the
1470
+ # Signature Version in Request Authentication][1] in the *Amazon S3
1471
+ # User Guide*.
1463
1472
  #
1464
1473
  #
1465
1474
  #
@@ -1475,9 +1484,9 @@ module Aws::S3
1475
1484
  #
1476
1485
  # @!attribute [rw] bucket_key_enabled
1477
1486
  # Specifies whether Amazon S3 should use an S3 Bucket Key for object
1478
- # encryption with server-side encryption using AWS KMS (SSE-KMS).
1479
- # Setting this header to `true` causes Amazon S3 to use an S3 Bucket
1480
- # Key for object encryption with SSE-KMS.
1487
+ # encryption with server-side encryption using Key Management Service
1488
+ # (KMS) keys (SSE-KMS). Setting this header to `true` causes Amazon S3
1489
+ # to use an S3 Bucket Key for object encryption with SSE-KMS.
1481
1490
  #
1482
1491
  # Specifying this header with a COPY action doesn’t affect
1483
1492
  # bucket-level settings for S3 Bucket Key.
@@ -1503,9 +1512,11 @@ module Aws::S3
1503
1512
  # @!attribute [rw] request_payer
1504
1513
  # Confirms that the requester knows that they will be charged for the
1505
1514
  # request. Bucket owners need not specify this parameter in their
1506
- # requests. For information about downloading objects from Requester
1507
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
1508
- # in the *Amazon S3 User Guide*.
1515
+ # requests. If either the source or destination Amazon S3 bucket has
1516
+ # Requester Pays enabled, the requester will pay for corresponding
1517
+ # charges to copy the object. For information about downloading
1518
+ # objects from Requester Pays buckets, see [Downloading Objects in
1519
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
1509
1520
  #
1510
1521
  #
1511
1522
  #
@@ -1855,7 +1866,7 @@ module Aws::S3
1855
1866
  # this header. The header indicates when the initiated multipart
1856
1867
  # upload becomes eligible for an abort operation. For more
1857
1868
  # information, see [ Aborting Incomplete Multipart Uploads Using a
1858
- # Bucket Lifecycle Policy][1].
1869
+ # Bucket Lifecycle Configuration][1].
1859
1870
  #
1860
1871
  # The response also includes the `x-amz-abort-rule-id` header that
1861
1872
  # provides the ID of the lifecycle configuration rule that defines
@@ -1885,14 +1896,14 @@ module Aws::S3
1885
1896
  # bucket name. For more information about access point ARNs, see
1886
1897
  # [Using access points][1] in the *Amazon S3 User Guide*.
1887
1898
  #
1888
- # When using this action with Amazon S3 on Outposts, you must direct
1899
+ # When you use this action with Amazon S3 on Outposts, you must direct
1889
1900
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
1890
1901
  # takes the form `
1891
1902
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1892
- # When using this action with S3 on Outposts through the Amazon Web
1893
- # Services SDKs, you provide the Outposts bucket ARN in place of the
1894
- # bucket name. For more information about S3 on Outposts ARNs, see
1895
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
1903
+ # When you use this action with S3 on Outposts through the Amazon Web
1904
+ # Services SDKs, you provide the Outposts access point ARN in place of
1905
+ # the bucket name. For more information about S3 on Outposts ARNs, see
1906
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
1896
1907
  #
1897
1908
  #
1898
1909
  #
@@ -1910,7 +1921,7 @@ module Aws::S3
1910
1921
  #
1911
1922
  # @!attribute [rw] server_side_encryption
1912
1923
  # The server-side encryption algorithm used when storing this object
1913
- # in Amazon S3 (for example, AES256, aws:kms).
1924
+ # in Amazon S3 (for example, `AES256`, `aws:kms`).
1914
1925
  # @return [String]
1915
1926
  #
1916
1927
  # @!attribute [rw] sse_customer_algorithm
@@ -1927,9 +1938,9 @@ module Aws::S3
1927
1938
  # @return [String]
1928
1939
  #
1929
1940
  # @!attribute [rw] ssekms_key_id
1930
- # If present, specifies the ID of the Amazon Web Services Key
1931
- # Management Service (Amazon Web Services KMS) symmetric customer
1932
- # managed key that was used for the object.
1941
+ # If present, specifies the ID of the Key Management Service (KMS)
1942
+ # symmetric encryption customer managed key that was used for the
1943
+ # object.
1933
1944
  # @return [String]
1934
1945
  #
1935
1946
  # @!attribute [rw] ssekms_encryption_context
@@ -1941,7 +1952,8 @@ module Aws::S3
1941
1952
  #
1942
1953
  # @!attribute [rw] bucket_key_enabled
1943
1954
  # Indicates whether the multipart upload uses an S3 Bucket Key for
1944
- # server-side encryption with Amazon Web Services KMS (SSE-KMS).
1955
+ # server-side encryption with Key Management Service (KMS) keys
1956
+ # (SSE-KMS).
1945
1957
  # @return [Boolean]
1946
1958
  #
1947
1959
  # @!attribute [rw] request_charged
@@ -1991,14 +2003,14 @@ module Aws::S3
1991
2003
  # bucket name. For more information about access point ARNs, see
1992
2004
  # [Using access points][1] in the *Amazon S3 User Guide*.
1993
2005
  #
1994
- # When using this action with Amazon S3 on Outposts, you must direct
2006
+ # When you use this action with Amazon S3 on Outposts, you must direct
1995
2007
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
1996
2008
  # takes the form `
1997
2009
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1998
- # When using this action with S3 on Outposts through the Amazon Web
1999
- # Services SDKs, you provide the Outposts bucket ARN in place of the
2000
- # bucket name. For more information about S3 on Outposts ARNs, see
2001
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
2010
+ # When you use this action with S3 on Outposts through the Amazon Web
2011
+ # Services SDKs, you provide the Outposts access point ARN in place of
2012
+ # the bucket name. For more information about S3 on Outposts ARNs, see
2013
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
2002
2014
  #
2003
2015
  #
2004
2016
  #
@@ -2067,7 +2079,7 @@ module Aws::S3
2067
2079
  #
2068
2080
  # @!attribute [rw] server_side_encryption
2069
2081
  # The server-side encryption algorithm used when storing this object
2070
- # in Amazon S3 (for example, AES256, aws:kms).
2082
+ # in Amazon S3 (for example, `AES256`, `aws:kms`).
2071
2083
  # @return [String]
2072
2084
  #
2073
2085
  # @!attribute [rw] storage_class
@@ -2110,13 +2122,13 @@ module Aws::S3
2110
2122
  # @return [String]
2111
2123
  #
2112
2124
  # @!attribute [rw] ssekms_key_id
2113
- # Specifies the ID of the symmetric customer managed key to use for
2114
- # object encryption. All GET and PUT requests for an object protected
2115
- # by Amazon Web Services KMS will fail if not made via SSL or using
2116
- # SigV4. For information about configuring using any of the officially
2117
- # supported Amazon Web Services SDKs and Amazon Web Services CLI, see
2118
- # [Specifying the Signature Version in Request Authentication][1] in
2119
- # the *Amazon S3 User Guide*.
2125
+ # Specifies the ID (Key ID, Key ARN, or Key Alias) of the symmetric
2126
+ # encryption customer managed key to use for object encryption. All
2127
+ # GET and PUT requests for an object protected by KMS will fail if
2128
+ # they're not made via SSL or using SigV4. For information about
2129
+ # configuring any of the officially supported Amazon Web Services SDKs
2130
+ # and Amazon Web Services CLI, see [Specifying the Signature Version
2131
+ # in Request Authentication][1] in the *Amazon S3 User Guide*.
2120
2132
  #
2121
2133
  #
2122
2134
  #
@@ -2132,9 +2144,9 @@ module Aws::S3
2132
2144
  #
2133
2145
  # @!attribute [rw] bucket_key_enabled
2134
2146
  # Specifies whether Amazon S3 should use an S3 Bucket Key for object
2135
- # encryption with server-side encryption using AWS KMS (SSE-KMS).
2136
- # Setting this header to `true` causes Amazon S3 to use an S3 Bucket
2137
- # Key for object encryption with SSE-KMS.
2147
+ # encryption with server-side encryption using Key Management Service
2148
+ # (KMS) keys (SSE-KMS). Setting this header to `true` causes Amazon S3
2149
+ # to use an S3 Bucket Key for object encryption with SSE-KMS.
2138
2150
  #
2139
2151
  # Specifying this header with an object action doesn’t affect
2140
2152
  # bucket-level settings for S3 Bucket Key.
@@ -2143,9 +2155,11 @@ module Aws::S3
2143
2155
  # @!attribute [rw] request_payer
2144
2156
  # Confirms that the requester knows that they will be charged for the
2145
2157
  # request. Bucket owners need not specify this parameter in their
2146
- # requests. For information about downloading objects from Requester
2147
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
2148
- # in the *Amazon S3 User Guide*.
2158
+ # requests. If either the source or destination Amazon S3 bucket has
2159
+ # Requester Pays enabled, the requester will pay for corresponding
2160
+ # charges to copy the object. For information about downloading
2161
+ # objects from Requester Pays buckets, see [Downloading Objects in
2162
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
2149
2163
  #
2150
2164
  #
2151
2165
  #
@@ -2264,7 +2278,7 @@ module Aws::S3
2264
2278
  # Container for the objects to delete.
2265
2279
  #
2266
2280
  # @!attribute [rw] objects
2267
- # The objects to delete.
2281
+ # The object to delete.
2268
2282
  # @return [Array<Types::ObjectIdentifier>]
2269
2283
  #
2270
2284
  # @!attribute [rw] quiet
@@ -2413,7 +2427,9 @@ module Aws::S3
2413
2427
  # @return [String]
2414
2428
  #
2415
2429
  # @!attribute [rw] id
2416
- # The ID used to identify the metrics configuration.
2430
+ # The ID used to identify the metrics configuration. The ID has a 64
2431
+ # character limit and can only contain letters, numbers, periods,
2432
+ # dashes, and underscores.
2417
2433
  # @return [String]
2418
2434
  #
2419
2435
  # @!attribute [rw] expected_bucket_owner
@@ -2622,8 +2638,10 @@ module Aws::S3
2622
2638
  end
2623
2639
 
2624
2640
  # @!attribute [rw] delete_marker
2625
- # Specifies whether the versioned object that was permanently deleted
2626
- # was (true) or was not (false) a delete marker.
2641
+ # Indicates whether the specified object version that was permanently
2642
+ # deleted was (true) or was not (false) a delete marker before
2643
+ # deletion. In a simple DELETE, this header indicates whether (true)
2644
+ # or not (false) the current version of the object is a delete marker.
2627
2645
  # @return [Boolean]
2628
2646
  #
2629
2647
  # @!attribute [rw] version_id
@@ -2658,14 +2676,14 @@ module Aws::S3
2658
2676
  # bucket name. For more information about access point ARNs, see
2659
2677
  # [Using access points][1] in the *Amazon S3 User Guide*.
2660
2678
  #
2661
- # When using this action with Amazon S3 on Outposts, you must direct
2679
+ # When you use this action with Amazon S3 on Outposts, you must direct
2662
2680
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2663
2681
  # takes the form `
2664
2682
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
2665
- # When using this action with S3 on Outposts through the Amazon Web
2666
- # Services SDKs, you provide the Outposts bucket ARN in place of the
2667
- # bucket name. For more information about S3 on Outposts ARNs, see
2668
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
2683
+ # When you use this action with S3 on Outposts through the Amazon Web
2684
+ # Services SDKs, you provide the Outposts access point ARN in place of
2685
+ # the bucket name. For more information about S3 on Outposts ARNs, see
2686
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
2669
2687
  #
2670
2688
  #
2671
2689
  #
@@ -2691,9 +2709,11 @@ module Aws::S3
2691
2709
  # @!attribute [rw] request_payer
2692
2710
  # Confirms that the requester knows that they will be charged for the
2693
2711
  # request. Bucket owners need not specify this parameter in their
2694
- # requests. For information about downloading objects from Requester
2695
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
2696
- # in the *Amazon S3 User Guide*.
2712
+ # requests. If either the source or destination Amazon S3 bucket has
2713
+ # Requester Pays enabled, the requester will pay for corresponding
2714
+ # charges to copy the object. For information about downloading
2715
+ # objects from Requester Pays buckets, see [Downloading Objects in
2716
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
2697
2717
  #
2698
2718
  #
2699
2719
  #
@@ -2751,14 +2771,14 @@ module Aws::S3
2751
2771
  # bucket name. For more information about access point ARNs, see
2752
2772
  # [Using access points][1] in the *Amazon S3 User Guide*.
2753
2773
  #
2754
- # When using this action with Amazon S3 on Outposts, you must direct
2774
+ # When you use this action with Amazon S3 on Outposts, you must direct
2755
2775
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2756
2776
  # takes the form `
2757
2777
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
2758
- # When using this action with S3 on Outposts through the Amazon Web
2759
- # Services SDKs, you provide the Outposts bucket ARN in place of the
2760
- # bucket name. For more information about S3 on Outposts ARNs, see
2761
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
2778
+ # When you use this action with S3 on Outposts through the Amazon Web
2779
+ # Services SDKs, you provide the Outposts access point ARN in place of
2780
+ # the bucket name. For more information about S3 on Outposts ARNs, see
2781
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
2762
2782
  #
2763
2783
  #
2764
2784
  #
@@ -2829,14 +2849,14 @@ module Aws::S3
2829
2849
  # bucket name. For more information about access point ARNs, see
2830
2850
  # [Using access points][1] in the *Amazon S3 User Guide*.
2831
2851
  #
2832
- # When using this action with Amazon S3 on Outposts, you must direct
2852
+ # When you use this action with Amazon S3 on Outposts, you must direct
2833
2853
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2834
2854
  # takes the form `
2835
2855
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
2836
- # When using this action with S3 on Outposts through the Amazon Web
2837
- # Services SDKs, you provide the Outposts bucket ARN in place of the
2838
- # bucket name. For more information about S3 on Outposts ARNs, see
2839
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
2856
+ # When you use this action with S3 on Outposts through the Amazon Web
2857
+ # Services SDKs, you provide the Outposts access point ARN in place of
2858
+ # the bucket name. For more information about S3 on Outposts ARNs, see
2859
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
2840
2860
  #
2841
2861
  #
2842
2862
  #
@@ -2858,9 +2878,11 @@ module Aws::S3
2858
2878
  # @!attribute [rw] request_payer
2859
2879
  # Confirms that the requester knows that they will be charged for the
2860
2880
  # request. Bucket owners need not specify this parameter in their
2861
- # requests. For information about downloading objects from Requester
2862
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
2863
- # in the *Amazon S3 User Guide*.
2881
+ # requests. If either the source or destination Amazon S3 bucket has
2882
+ # Requester Pays enabled, the requester will pay for corresponding
2883
+ # charges to copy the object. For information about downloading
2884
+ # objects from Requester Pays buckets, see [Downloading Objects in
2885
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
2864
2886
  #
2865
2887
  #
2866
2888
  #
@@ -2944,10 +2966,10 @@ module Aws::S3
2944
2966
  # @return [String]
2945
2967
  #
2946
2968
  # @!attribute [rw] delete_marker
2947
- # Specifies whether the versioned object that was permanently deleted
2948
- # was (true) or was not (false) a delete marker. In a simple DELETE,
2949
- # this header indicates whether (true) or not (false) a delete marker
2950
- # was created.
2969
+ # Indicates whether the specified object version that was permanently
2970
+ # deleted was (true) or was not (false) a delete marker before
2971
+ # deletion. In a simple DELETE, this header indicates whether (true)
2972
+ # or not (false) the current version of the object is a delete marker.
2951
2973
  # @return [Boolean]
2952
2974
  #
2953
2975
  # @!attribute [rw] delete_marker_version_id
@@ -3049,15 +3071,16 @@ module Aws::S3
3049
3071
  #
3050
3072
  # @!attribute [rw] encryption_type
3051
3073
  # The server-side encryption algorithm used when storing job results
3052
- # in Amazon S3 (for example, AES256, aws:kms).
3074
+ # in Amazon S3 (for example, AES256, `aws:kms`).
3053
3075
  # @return [String]
3054
3076
  #
3055
3077
  # @!attribute [rw] kms_key_id
3056
3078
  # If the encryption type is `aws:kms`, this optional value specifies
3057
- # the ID of the symmetric customer managed key to use for encryption
3058
- # of job results. Amazon S3 only supports symmetric keys. For more
3059
- # information, see [Using symmetric and asymmetric keys][1] in the
3060
- # *Amazon Web Services Key Management Service Developer Guide*.
3079
+ # the ID of the symmetric encryption customer managed key to use for
3080
+ # encryption of job results. Amazon S3 only supports symmetric
3081
+ # encryption KMS keys. For more information, see [Asymmetric keys in
3082
+ # KMS][1] in the *Amazon Web Services Key Management Service Developer
3083
+ # Guide*.
3061
3084
  #
3062
3085
  #
3063
3086
  #
@@ -3087,9 +3110,9 @@ module Aws::S3
3087
3110
  # Amazon Web Services KMS key stored in Amazon Web Services Key
3088
3111
  # Management Service (KMS) for the destination bucket. Amazon S3 uses
3089
3112
  # this key to encrypt replica objects. Amazon S3 only supports
3090
- # symmetric, customer managed KMS keys. For more information, see
3091
- # [Using symmetric and asymmetric keys][1] in the *Amazon Web Services
3092
- # Key Management Service Developer Guide*.
3113
+ # symmetric encryption KMS keys. For more information, see [Asymmetric
3114
+ # keys in Amazon Web Services KMS][1] in the *Amazon Web Services Key
3115
+ # Management Service Developer Guide*.
3093
3116
  #
3094
3117
  #
3095
3118
  #
@@ -3129,9 +3152,8 @@ module Aws::S3
3129
3152
  # @!attribute [rw] code
3130
3153
  # The error code is a string that uniquely identifies an error
3131
3154
  # condition. It is meant to be read and understood by programs that
3132
- # detect and handle errors by type.
3133
- #
3134
- # **Amazon S3 error codes**
3155
+ # detect and handle errors by type. The following is a list of Amazon
3156
+ # S3 error codes. For more information, see [Error responses][1].
3135
3157
  #
3136
3158
  # * * *Code:* AccessDenied
3137
3159
  #
@@ -3370,7 +3392,7 @@ module Aws::S3
3370
3392
  #
3371
3393
  # * *Description:* The specified location constraint is not valid.
3372
3394
  # For more information about Regions, see [How to Select a Region
3373
- # for Your Buckets][1].
3395
+ # for Your Buckets][2].
3374
3396
  #
3375
3397
  # * *HTTP Status Code:* 400 Bad Request
3376
3398
  #
@@ -3755,7 +3777,7 @@ module Aws::S3
3755
3777
  #
3756
3778
  # * *Description:* Your account is not signed up for the Amazon S3
3757
3779
  # service. You must sign up before you can use Amazon S3. You can
3758
- # sign up at the following URL: [Amazon S3][2]
3780
+ # sign up at the following URL: [Amazon S3][3]
3759
3781
  #
3760
3782
  # * *HTTP Status Code:* 403 Forbidden
3761
3783
  #
@@ -3846,7 +3868,7 @@ module Aws::S3
3846
3868
  # * *Description:* The request signature we calculated does not
3847
3869
  # match the signature you provided. Check your Amazon Web Services
3848
3870
  # secret access key and signing method. For more information, see
3849
- # [REST Authentication][3] and [SOAP Authentication][4] for
3871
+ # [REST Authentication][4] and [SOAP Authentication][5] for
3850
3872
  # details.
3851
3873
  #
3852
3874
  # * *HTTP Status Code:* 403 Forbidden
@@ -3855,7 +3877,7 @@ module Aws::S3
3855
3877
  #
3856
3878
  # * * *Code:* ServiceUnavailable
3857
3879
  #
3858
- # * *Description:* Reduce your request rate.
3880
+ # * *Description:* Service is unable to handle request.
3859
3881
  #
3860
3882
  # * *HTTP Status Code:* 503 Service Unavailable
3861
3883
  #
@@ -3925,10 +3947,11 @@ module Aws::S3
3925
3947
  #
3926
3948
  #
3927
3949
  #
3928
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro
3929
- # [2]: http://aws.amazon.com/s3
3930
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
3931
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/SOAPAuthentication.html
3950
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html
3951
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro
3952
+ # [3]: http://aws.amazon.com/s3
3953
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
3954
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/SOAPAuthentication.html
3932
3955
  # @return [String]
3933
3956
  #
3934
3957
  # @!attribute [rw] message
@@ -3991,6 +4014,8 @@ module Aws::S3
3991
4014
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-what-is-isnot-replicated.html#existing-object-replication
3992
4015
  #
3993
4016
  # @!attribute [rw] status
4017
+ # Specifies whether Amazon S3 replicates existing source bucket
4018
+ # objects.
3994
4019
  # @return [String]
3995
4020
  #
3996
4021
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ExistingObjectReplication AWS API Documentation
@@ -4033,10 +4058,16 @@ module Aws::S3
4033
4058
  # The accelerate configuration of the bucket.
4034
4059
  # @return [String]
4035
4060
  #
4061
+ # @!attribute [rw] request_charged
4062
+ # If present, indicates that the requester was successfully charged
4063
+ # for the request.
4064
+ # @return [String]
4065
+ #
4036
4066
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAccelerateConfigurationOutput AWS API Documentation
4037
4067
  #
4038
4068
  class GetBucketAccelerateConfigurationOutput < Struct.new(
4039
- :status)
4069
+ :status,
4070
+ :request_charged)
4040
4071
  SENSITIVE = []
4041
4072
  include Aws::Structure
4042
4073
  end
@@ -4052,11 +4083,26 @@ module Aws::S3
4052
4083
  # `403 Forbidden` (access denied).
4053
4084
  # @return [String]
4054
4085
  #
4086
+ # @!attribute [rw] request_payer
4087
+ # Confirms that the requester knows that they will be charged for the
4088
+ # request. Bucket owners need not specify this parameter in their
4089
+ # requests. If either the source or destination Amazon S3 bucket has
4090
+ # Requester Pays enabled, the requester will pay for corresponding
4091
+ # charges to copy the object. For information about downloading
4092
+ # objects from Requester Pays buckets, see [Downloading Objects in
4093
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
4094
+ #
4095
+ #
4096
+ #
4097
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
4098
+ # @return [String]
4099
+ #
4055
4100
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAccelerateConfigurationRequest AWS API Documentation
4056
4101
  #
4057
4102
  class GetBucketAccelerateConfigurationRequest < Struct.new(
4058
4103
  :bucket,
4059
- :expected_bucket_owner)
4104
+ :expected_bucket_owner,
4105
+ :request_payer)
4060
4106
  SENSITIVE = []
4061
4107
  include Aws::Structure
4062
4108
  end
@@ -4080,6 +4126,20 @@ module Aws::S3
4080
4126
 
4081
4127
  # @!attribute [rw] bucket
4082
4128
  # Specifies the S3 bucket whose ACL is being requested.
4129
+ #
4130
+ # To use this API operation against an access point, provide the alias
4131
+ # of the access point in place of the bucket name.
4132
+ #
4133
+ # To use this API operation against an Object Lambda access point,
4134
+ # provide the alias of the Object Lambda access point in place of the
4135
+ # bucket name. If the Object Lambda access point alias in a request is
4136
+ # not valid, the error code `InvalidAccessPointAliasError` is
4137
+ # returned. For more information about `InvalidAccessPointAliasError`,
4138
+ # see [List of Error Codes][1].
4139
+ #
4140
+ #
4141
+ #
4142
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
4083
4143
  # @return [String]
4084
4144
  #
4085
4145
  # @!attribute [rw] expected_bucket_owner
@@ -4149,6 +4209,20 @@ module Aws::S3
4149
4209
 
4150
4210
  # @!attribute [rw] bucket
4151
4211
  # The bucket name for which to get the cors configuration.
4212
+ #
4213
+ # To use this API operation against an access point, provide the alias
4214
+ # of the access point in place of the bucket name.
4215
+ #
4216
+ # To use this API operation against an Object Lambda access point,
4217
+ # provide the alias of the Object Lambda access point in place of the
4218
+ # bucket name. If the Object Lambda access point alias in a request is
4219
+ # not valid, the error code `InvalidAccessPointAliasError` is
4220
+ # returned. For more information about `InvalidAccessPointAliasError`,
4221
+ # see [List of Error Codes][1].
4222
+ #
4223
+ #
4224
+ #
4225
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
4152
4226
  # @return [String]
4153
4227
  #
4154
4228
  # @!attribute [rw] expected_bucket_owner
@@ -4348,6 +4422,20 @@ module Aws::S3
4348
4422
 
4349
4423
  # @!attribute [rw] bucket
4350
4424
  # The name of the bucket for which to get the location.
4425
+ #
4426
+ # To use this API operation against an access point, provide the alias
4427
+ # of the access point in place of the bucket name.
4428
+ #
4429
+ # To use this API operation against an Object Lambda access point,
4430
+ # provide the alias of the Object Lambda access point in place of the
4431
+ # bucket name. If the Object Lambda access point alias in a request is
4432
+ # not valid, the error code `InvalidAccessPointAliasError` is
4433
+ # returned. For more information about `InvalidAccessPointAliasError`,
4434
+ # see [List of Error Codes][1].
4435
+ #
4436
+ #
4437
+ #
4438
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
4351
4439
  # @return [String]
4352
4440
  #
4353
4441
  # @!attribute [rw] expected_bucket_owner
@@ -4420,7 +4508,9 @@ module Aws::S3
4420
4508
  # @return [String]
4421
4509
  #
4422
4510
  # @!attribute [rw] id
4423
- # The ID used to identify the metrics configuration.
4511
+ # The ID used to identify the metrics configuration. The ID has a 64
4512
+ # character limit and can only contain letters, numbers, periods,
4513
+ # dashes, and underscores.
4424
4514
  # @return [String]
4425
4515
  #
4426
4516
  # @!attribute [rw] expected_bucket_owner
@@ -4442,6 +4532,20 @@ module Aws::S3
4442
4532
  # @!attribute [rw] bucket
4443
4533
  # The name of the bucket for which to get the notification
4444
4534
  # configuration.
4535
+ #
4536
+ # To use this API operation against an access point, provide the alias
4537
+ # of the access point in place of the bucket name.
4538
+ #
4539
+ # To use this API operation against an Object Lambda access point,
4540
+ # provide the alias of the Object Lambda access point in place of the
4541
+ # bucket name. If the Object Lambda access point alias in a request is
4542
+ # not valid, the error code `InvalidAccessPointAliasError` is
4543
+ # returned. For more information about `InvalidAccessPointAliasError`,
4544
+ # see [List of Error Codes][1].
4545
+ #
4546
+ #
4547
+ #
4548
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
4445
4549
  # @return [String]
4446
4550
  #
4447
4551
  # @!attribute [rw] expected_bucket_owner
@@ -4506,6 +4610,20 @@ module Aws::S3
4506
4610
 
4507
4611
  # @!attribute [rw] bucket
4508
4612
  # The bucket name for which to get the bucket policy.
4613
+ #
4614
+ # To use this API operation against an access point, provide the alias
4615
+ # of the access point in place of the bucket name.
4616
+ #
4617
+ # To use this API operation against an Object Lambda access point,
4618
+ # provide the alias of the Object Lambda access point in place of the
4619
+ # bucket name. If the Object Lambda access point alias in a request is
4620
+ # not valid, the error code `InvalidAccessPointAliasError` is
4621
+ # returned. For more information about `InvalidAccessPointAliasError`,
4622
+ # see [List of Error Codes][1].
4623
+ #
4624
+ #
4625
+ #
4626
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
4509
4627
  # @return [String]
4510
4628
  #
4511
4629
  # @!attribute [rw] expected_bucket_owner
@@ -4791,9 +4909,11 @@ module Aws::S3
4791
4909
  # @!attribute [rw] request_payer
4792
4910
  # Confirms that the requester knows that they will be charged for the
4793
4911
  # request. Bucket owners need not specify this parameter in their
4794
- # requests. For information about downloading objects from Requester
4795
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
4796
- # in the *Amazon S3 User Guide*.
4912
+ # requests. If either the source or destination Amazon S3 bucket has
4913
+ # Requester Pays enabled, the requester will pay for corresponding
4914
+ # charges to copy the object. For information about downloading
4915
+ # objects from Requester Pays buckets, see [Downloading Objects in
4916
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
4797
4917
  #
4798
4918
  #
4799
4919
  #
@@ -4939,14 +5059,14 @@ module Aws::S3
4939
5059
  # bucket name. For more information about access point ARNs, see
4940
5060
  # [Using access points][1] in the *Amazon S3 User Guide*.
4941
5061
  #
4942
- # When using this action with Amazon S3 on Outposts, you must direct
5062
+ # When you use this action with Amazon S3 on Outposts, you must direct
4943
5063
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
4944
5064
  # takes the form `
4945
5065
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4946
- # When using this action with S3 on Outposts through the Amazon Web
4947
- # Services SDKs, you provide the Outposts bucket ARN in place of the
4948
- # bucket name. For more information about S3 on Outposts ARNs, see
4949
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
5066
+ # When you use this action with S3 on Outposts through the Amazon Web
5067
+ # Services SDKs, you provide the Outposts access point ARN in place of
5068
+ # the bucket name. For more information about S3 on Outposts ARNs, see
5069
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
4950
5070
  #
4951
5071
  #
4952
5072
  #
@@ -4993,9 +5113,11 @@ module Aws::S3
4993
5113
  # @!attribute [rw] request_payer
4994
5114
  # Confirms that the requester knows that they will be charged for the
4995
5115
  # request. Bucket owners need not specify this parameter in their
4996
- # requests. For information about downloading objects from Requester
4997
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
4998
- # in the *Amazon S3 User Guide*.
5116
+ # requests. If either the source or destination Amazon S3 bucket has
5117
+ # Requester Pays enabled, the requester will pay for corresponding
5118
+ # charges to copy the object. For information about downloading
5119
+ # objects from Requester Pays buckets, see [Downloading Objects in
5120
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
4999
5121
  #
5000
5122
  #
5001
5123
  #
@@ -5009,9 +5131,8 @@ module Aws::S3
5009
5131
  # @return [String]
5010
5132
  #
5011
5133
  # @!attribute [rw] object_attributes
5012
- # An XML header that specifies the fields at the root level that you
5013
- # want returned in the response. Fields that you do not specify are
5014
- # not returned.
5134
+ # Specifies the fields at the root level that you want returned in the
5135
+ # response. Fields that you do not specify are not returned.
5015
5136
  # @return [Array<String>]
5016
5137
  #
5017
5138
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectAttributesRequest AWS API Documentation
@@ -5075,9 +5196,11 @@ module Aws::S3
5075
5196
  # @!attribute [rw] request_payer
5076
5197
  # Confirms that the requester knows that they will be charged for the
5077
5198
  # request. Bucket owners need not specify this parameter in their
5078
- # requests. For information about downloading objects from Requester
5079
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
5080
- # in the *Amazon S3 User Guide*.
5199
+ # requests. If either the source or destination Amazon S3 bucket has
5200
+ # Requester Pays enabled, the requester will pay for corresponding
5201
+ # charges to copy the object. For information about downloading
5202
+ # objects from Requester Pays buckets, see [Downloading Objects in
5203
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
5081
5204
  #
5082
5205
  #
5083
5206
  #
@@ -5291,7 +5414,7 @@ module Aws::S3
5291
5414
  #
5292
5415
  # @!attribute [rw] server_side_encryption
5293
5416
  # The server-side encryption algorithm used when storing this object
5294
- # in Amazon S3 (for example, AES256, aws:kms).
5417
+ # in Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
5295
5418
  # @return [String]
5296
5419
  #
5297
5420
  # @!attribute [rw] metadata
@@ -5312,14 +5435,14 @@ module Aws::S3
5312
5435
  # @return [String]
5313
5436
  #
5314
5437
  # @!attribute [rw] ssekms_key_id
5315
- # If present, specifies the ID of the Amazon Web Services Key
5316
- # Management Service (Amazon Web Services KMS) symmetric customer
5317
- # managed key that was used for the object.
5438
+ # If present, specifies the ID of the Key Management Service (KMS)
5439
+ # symmetric encryption customer managed key that was used for the
5440
+ # object.
5318
5441
  # @return [String]
5319
5442
  #
5320
5443
  # @!attribute [rw] bucket_key_enabled
5321
5444
  # Indicates whether the object uses an S3 Bucket Key for server-side
5322
- # encryption with Amazon Web Services KMS (SSE-KMS).
5445
+ # encryption with Key Management Service (KMS) keys (SSE-KMS).
5323
5446
  # @return [Boolean]
5324
5447
  #
5325
5448
  # @!attribute [rw] storage_class
@@ -5421,14 +5544,14 @@ module Aws::S3
5421
5544
  # When using an Object Lambda access point the hostname takes the form
5422
5545
  # *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com.
5423
5546
  #
5424
- # When using this action with Amazon S3 on Outposts, you must direct
5547
+ # When you use this action with Amazon S3 on Outposts, you must direct
5425
5548
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5426
5549
  # takes the form `
5427
5550
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5428
- # When using this action with S3 on Outposts through the Amazon Web
5429
- # Services SDKs, you provide the Outposts bucket ARN in place of the
5430
- # bucket name. For more information about S3 on Outposts ARNs, see
5431
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
5551
+ # When you use this action with S3 on Outposts through the Amazon Web
5552
+ # Services SDKs, you provide the Outposts access point ARN in place of
5553
+ # the bucket name. For more information about S3 on Outposts ARNs, see
5554
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
5432
5555
  #
5433
5556
  #
5434
5557
  #
@@ -5463,7 +5586,7 @@ module Aws::S3
5463
5586
  # @!attribute [rw] range
5464
5587
  # Downloads the specified range bytes of an object. For more
5465
5588
  # information about the HTTP Range header, see
5466
- # [https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
5589
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-range][1].
5467
5590
  #
5468
5591
  # <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
5469
5592
  # `GET` request.
@@ -5472,7 +5595,7 @@ module Aws::S3
5472
5595
  #
5473
5596
  #
5474
5597
  #
5475
- # [1]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
5598
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-range
5476
5599
  # @return [String]
5477
5600
  #
5478
5601
  # @!attribute [rw] response_cache_control
@@ -5525,9 +5648,11 @@ module Aws::S3
5525
5648
  # @!attribute [rw] request_payer
5526
5649
  # Confirms that the requester knows that they will be charged for the
5527
5650
  # request. Bucket owners need not specify this parameter in their
5528
- # requests. For information about downloading objects from Requester
5529
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
5530
- # in the *Amazon S3 User Guide*.
5651
+ # requests. If either the source or destination Amazon S3 bucket has
5652
+ # Requester Pays enabled, the requester will pay for corresponding
5653
+ # charges to copy the object. For information about downloading
5654
+ # objects from Requester Pays buckets, see [Downloading Objects in
5655
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
5531
5656
  #
5532
5657
  #
5533
5658
  #
@@ -5622,9 +5747,11 @@ module Aws::S3
5622
5747
  # @!attribute [rw] request_payer
5623
5748
  # Confirms that the requester knows that they will be charged for the
5624
5749
  # request. Bucket owners need not specify this parameter in their
5625
- # requests. For information about downloading objects from Requester
5626
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
5627
- # in the *Amazon S3 User Guide*.
5750
+ # requests. If either the source or destination Amazon S3 bucket has
5751
+ # Requester Pays enabled, the requester will pay for corresponding
5752
+ # charges to copy the object. For information about downloading
5753
+ # objects from Requester Pays buckets, see [Downloading Objects in
5754
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
5628
5755
  #
5629
5756
  #
5630
5757
  #
@@ -5680,14 +5807,14 @@ module Aws::S3
5680
5807
  # bucket name. For more information about access point ARNs, see
5681
5808
  # [Using access points][1] in the *Amazon S3 User Guide*.
5682
5809
  #
5683
- # When using this action with Amazon S3 on Outposts, you must direct
5810
+ # When you use this action with Amazon S3 on Outposts, you must direct
5684
5811
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5685
5812
  # takes the form `
5686
5813
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5687
- # When using this action with S3 on Outposts through the Amazon Web
5688
- # Services SDKs, you provide the Outposts bucket ARN in place of the
5689
- # bucket name. For more information about S3 on Outposts ARNs, see
5690
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
5814
+ # When you use this action with S3 on Outposts through the Amazon Web
5815
+ # Services SDKs, you provide the Outposts access point ARN in place of
5816
+ # the bucket name. For more information about S3 on Outposts ARNs, see
5817
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
5691
5818
  #
5692
5819
  #
5693
5820
  #
@@ -5713,9 +5840,11 @@ module Aws::S3
5713
5840
  # @!attribute [rw] request_payer
5714
5841
  # Confirms that the requester knows that they will be charged for the
5715
5842
  # request. Bucket owners need not specify this parameter in their
5716
- # requests. For information about downloading objects from Requester
5717
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
5718
- # in the *Amazon S3 User Guide*.
5843
+ # requests. If either the source or destination Amazon S3 bucket has
5844
+ # Requester Pays enabled, the requester will pay for corresponding
5845
+ # charges to copy the object. For information about downloading
5846
+ # objects from Requester Pays buckets, see [Downloading Objects in
5847
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
5719
5848
  #
5720
5849
  #
5721
5850
  #
@@ -5764,9 +5893,11 @@ module Aws::S3
5764
5893
  # @!attribute [rw] request_payer
5765
5894
  # Confirms that the requester knows that they will be charged for the
5766
5895
  # request. Bucket owners need not specify this parameter in their
5767
- # requests. For information about downloading objects from Requester
5768
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
5769
- # in the *Amazon S3 User Guide*.
5896
+ # requests. If either the source or destination Amazon S3 bucket has
5897
+ # Requester Pays enabled, the requester will pay for corresponding
5898
+ # charges to copy the object. For information about downloading
5899
+ # objects from Requester Pays buckets, see [Downloading Objects in
5900
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
5770
5901
  #
5771
5902
  #
5772
5903
  #
@@ -5931,19 +6062,27 @@ module Aws::S3
5931
6062
  # bucket name. For more information about access point ARNs, see
5932
6063
  # [Using access points][1] in the *Amazon S3 User Guide*.
5933
6064
  #
5934
- # When using this action with Amazon S3 on Outposts, you must direct
6065
+ # When you use this action with an Object Lambda access point, provide
6066
+ # the alias of the Object Lambda access point in place of the bucket
6067
+ # name. If the Object Lambda access point alias in a request is not
6068
+ # valid, the error code `InvalidAccessPointAliasError` is returned.
6069
+ # For more information about `InvalidAccessPointAliasError`, see [List
6070
+ # of Error Codes][2].
6071
+ #
6072
+ # When you use this action with Amazon S3 on Outposts, you must direct
5935
6073
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5936
6074
  # takes the form `
5937
6075
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5938
- # When using this action with S3 on Outposts through the Amazon Web
5939
- # Services SDKs, you provide the Outposts bucket ARN in place of the
5940
- # bucket name. For more information about S3 on Outposts ARNs, see
5941
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
6076
+ # When you use this action with S3 on Outposts through the Amazon Web
6077
+ # Services SDKs, you provide the Outposts access point ARN in place of
6078
+ # the bucket name. For more information about S3 on Outposts ARNs, see
6079
+ # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
5942
6080
  #
5943
6081
  #
5944
6082
  #
5945
6083
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html
5946
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
6084
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList
6085
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
5947
6086
  # @return [String]
5948
6087
  #
5949
6088
  # @!attribute [rw] expected_bucket_owner
@@ -6120,11 +6259,8 @@ module Aws::S3
6120
6259
  # @return [String]
6121
6260
  #
6122
6261
  # @!attribute [rw] server_side_encryption
6123
- # If the object is stored using server-side encryption either with an
6124
- # Amazon Web Services KMS key or an Amazon S3-managed encryption key,
6125
- # the response includes this header with the value of the server-side
6126
- # encryption algorithm used when storing this object in Amazon S3 (for
6127
- # example, AES256, aws:kms).
6262
+ # The server-side encryption algorithm used when storing this object
6263
+ # in Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
6128
6264
  # @return [String]
6129
6265
  #
6130
6266
  # @!attribute [rw] metadata
@@ -6145,14 +6281,14 @@ module Aws::S3
6145
6281
  # @return [String]
6146
6282
  #
6147
6283
  # @!attribute [rw] ssekms_key_id
6148
- # If present, specifies the ID of the Amazon Web Services Key
6149
- # Management Service (Amazon Web Services KMS) symmetric customer
6150
- # managed key that was used for the object.
6284
+ # If present, specifies the ID of the Key Management Service (KMS)
6285
+ # symmetric encryption customer managed key that was used for the
6286
+ # object.
6151
6287
  # @return [String]
6152
6288
  #
6153
6289
  # @!attribute [rw] bucket_key_enabled
6154
6290
  # Indicates whether the object uses an S3 Bucket Key for server-side
6155
- # encryption with Amazon Web Services KMS (SSE-KMS).
6291
+ # encryption with Key Management Service (KMS) keys (SSE-KMS).
6156
6292
  # @return [Boolean]
6157
6293
  #
6158
6294
  # @!attribute [rw] storage_class
@@ -6306,14 +6442,14 @@ module Aws::S3
6306
6442
  # bucket name. For more information about access point ARNs, see
6307
6443
  # [Using access points][1] in the *Amazon S3 User Guide*.
6308
6444
  #
6309
- # When using this action with Amazon S3 on Outposts, you must direct
6445
+ # When you use this action with Amazon S3 on Outposts, you must direct
6310
6446
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
6311
6447
  # takes the form `
6312
6448
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
6313
- # When using this action with S3 on Outposts through the Amazon Web
6314
- # Services SDKs, you provide the Outposts bucket ARN in place of the
6315
- # bucket name. For more information about S3 on Outposts ARNs, see
6316
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
6449
+ # When you use this action with S3 on Outposts through the Amazon Web
6450
+ # Services SDKs, you provide the Outposts access point ARN in place of
6451
+ # the bucket name. For more information about S3 on Outposts ARNs, see
6452
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
6317
6453
  #
6318
6454
  #
6319
6455
  #
@@ -6346,8 +6482,10 @@ module Aws::S3
6346
6482
  # @return [String]
6347
6483
  #
6348
6484
  # @!attribute [rw] range
6349
- # Because `HeadObject` returns only the metadata for an object, this
6350
- # parameter has no effect.
6485
+ # HeadObject returns only the metadata for an object. If the Range is
6486
+ # satisfiable, only the `ContentLength` is affected in the response.
6487
+ # If the Range is not satisfiable, S3 returns a `416 - Requested Range
6488
+ # Not Satisfiable` error.
6351
6489
  # @return [String]
6352
6490
  #
6353
6491
  # @!attribute [rw] version_id
@@ -6376,9 +6514,11 @@ module Aws::S3
6376
6514
  # @!attribute [rw] request_payer
6377
6515
  # Confirms that the requester knows that they will be charged for the
6378
6516
  # request. Bucket owners need not specify this parameter in their
6379
- # requests. For information about downloading objects from Requester
6380
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
6381
- # in the *Amazon S3 User Guide*.
6517
+ # requests. If either the source or destination Amazon S3 bucket has
6518
+ # Requester Pays enabled, the requester will pay for corresponding
6519
+ # charges to copy the object. For information about downloading
6520
+ # objects from Requester Pays buckets, see [Downloading Objects in
6521
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
6382
6522
  #
6383
6523
  #
6384
6524
  #
@@ -6843,12 +6983,12 @@ module Aws::S3
6843
6983
  #
6844
6984
  # @!attribute [rw] filter
6845
6985
  # Specifies object key name filtering rules. For information about key
6846
- # name filtering, see [Configuring Event Notifications][1] in the
6847
- # *Amazon S3 User Guide*.
6986
+ # name filtering, see [Configuring event notifications using object
6987
+ # key name filtering][1] in the *Amazon S3 User Guide*.
6848
6988
  #
6849
6989
  #
6850
6990
  #
6851
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
6991
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-filtering.html
6852
6992
  # @return [Types::NotificationConfigurationFilter]
6853
6993
  #
6854
6994
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/LambdaFunctionConfiguration AWS API Documentation
@@ -6864,6 +7004,13 @@ module Aws::S3
6864
7004
 
6865
7005
  # Container for lifecycle rules. You can add as many as 1000 rules.
6866
7006
  #
7007
+ # For more information see, [Managing your storage lifecycle][1] in the
7008
+ # *Amazon S3 User Guide*.
7009
+ #
7010
+ #
7011
+ #
7012
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
7013
+ #
6867
7014
  # @!attribute [rw] rules
6868
7015
  # Specifies lifecycle configuration rules for an Amazon S3 bucket.
6869
7016
  # @return [Array<Types::Rule>]
@@ -6878,9 +7025,17 @@ module Aws::S3
6878
7025
 
6879
7026
  # Container for the expiration for the lifecycle of the object.
6880
7027
  #
7028
+ # For more information see, [Managing your storage lifecycle][1] in the
7029
+ # *Amazon S3 User Guide*.
7030
+ #
7031
+ #
7032
+ #
7033
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
7034
+ #
6881
7035
  # @!attribute [rw] date
6882
- # Indicates at what date the object is to be moved or deleted. Should
6883
- # be in GMT ISO 8601 Format.
7036
+ # Indicates at what date the object is to be moved or deleted. The
7037
+ # date value must conform to the ISO 8601 format. The time is always
7038
+ # midnight UTC.
6884
7039
  # @return [Time]
6885
7040
  #
6886
7041
  # @!attribute [rw] days
@@ -6907,6 +7062,13 @@ module Aws::S3
6907
7062
 
6908
7063
  # A lifecycle rule for individual objects in an Amazon S3 bucket.
6909
7064
  #
7065
+ # For more information see, [Managing your storage lifecycle][1] in the
7066
+ # *Amazon S3 User Guide*.
7067
+ #
7068
+ #
7069
+ #
7070
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
7071
+ #
6910
7072
  # @!attribute [rw] expiration
6911
7073
  # Specifies the expiration for the lifecycle of the object in the form
6912
7074
  # of date, days and, whether the object has a delete marker.
@@ -6969,8 +7131,8 @@ module Aws::S3
6969
7131
  # Specifies the days since the initiation of an incomplete multipart
6970
7132
  # upload that Amazon S3 will wait before permanently removing all
6971
7133
  # parts of the upload. For more information, see [ Aborting Incomplete
6972
- # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
6973
- # S3 User Guide*.
7134
+ # Multipart Uploads Using a Bucket Lifecycle Configuration][1] in the
7135
+ # *Amazon S3 User Guide*.
6974
7136
  #
6975
7137
  #
6976
7138
  #
@@ -7113,8 +7275,8 @@ module Aws::S3
7113
7275
  # @return [String]
7114
7276
  #
7115
7277
  # @!attribute [rw] continuation_token
7116
- # The ContinuationToken that represents a placeholder from where this
7117
- # request should begin.
7278
+ # The `ContinuationToken` that represents a placeholder from where
7279
+ # this request should begin.
7118
7280
  # @return [String]
7119
7281
  #
7120
7282
  # @!attribute [rw] expected_bucket_owner
@@ -7226,9 +7388,9 @@ module Aws::S3
7226
7388
  #
7227
7389
  # @!attribute [rw] continuation_token
7228
7390
  # The marker used to continue an inventory configuration listing that
7229
- # has been truncated. Use the NextContinuationToken from a previously
7230
- # truncated list response to continue the listing. The continuation
7231
- # token is an opaque value that Amazon S3 understands.
7391
+ # has been truncated. Use the `NextContinuationToken` from a
7392
+ # previously truncated list response to continue the listing. The
7393
+ # continuation token is an opaque value that Amazon S3 understands.
7232
7394
  # @return [String]
7233
7395
  #
7234
7396
  # @!attribute [rw] expected_bucket_owner
@@ -7289,7 +7451,7 @@ module Aws::S3
7289
7451
  #
7290
7452
  # @!attribute [rw] continuation_token
7291
7453
  # The marker that is used to continue a metrics configuration listing
7292
- # that has been truncated. Use the NextContinuationToken from a
7454
+ # that has been truncated. Use the `NextContinuationToken` from a
7293
7455
  # previously truncated list response to continue the listing. The
7294
7456
  # continuation token is an opaque value that Amazon S3 understands.
7295
7457
  # @return [String]
@@ -7392,13 +7554,18 @@ module Aws::S3
7392
7554
  # Encoding type used by Amazon S3 to encode object keys in the
7393
7555
  # response.
7394
7556
  #
7395
- # If you specify `encoding-type` request parameter, Amazon S3 includes
7396
- # this element in the response, and returns encoded key name values in
7397
- # the following response elements:
7557
+ # If you specify the `encoding-type` request parameter, Amazon S3
7558
+ # includes this element in the response, and returns encoded key name
7559
+ # values in the following response elements:
7398
7560
  #
7399
7561
  # `Delimiter`, `KeyMarker`, `Prefix`, `NextKeyMarker`, `Key`.
7400
7562
  # @return [String]
7401
7563
  #
7564
+ # @!attribute [rw] request_charged
7565
+ # If present, indicates that the requester was successfully charged
7566
+ # for the request.
7567
+ # @return [String]
7568
+ #
7402
7569
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploadsOutput AWS API Documentation
7403
7570
  #
7404
7571
  class ListMultipartUploadsOutput < Struct.new(
@@ -7413,7 +7580,8 @@ module Aws::S3
7413
7580
  :is_truncated,
7414
7581
  :uploads,
7415
7582
  :common_prefixes,
7416
- :encoding_type)
7583
+ :encoding_type,
7584
+ :request_charged)
7417
7585
  SENSITIVE = []
7418
7586
  include Aws::Structure
7419
7587
  end
@@ -7430,14 +7598,14 @@ module Aws::S3
7430
7598
  # bucket name. For more information about access point ARNs, see
7431
7599
  # [Using access points][1] in the *Amazon S3 User Guide*.
7432
7600
  #
7433
- # When using this action with Amazon S3 on Outposts, you must direct
7601
+ # When you use this action with Amazon S3 on Outposts, you must direct
7434
7602
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7435
7603
  # takes the form `
7436
7604
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7437
- # When using this action with S3 on Outposts through the Amazon Web
7438
- # Services SDKs, you provide the Outposts bucket ARN in place of the
7439
- # bucket name. For more information about S3 on Outposts ARNs, see
7440
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
7605
+ # When you use this action with S3 on Outposts through the Amazon Web
7606
+ # Services SDKs, you provide the Outposts access point ARN in place of
7607
+ # the bucket name. For more information about S3 on Outposts ARNs, see
7608
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
7441
7609
  #
7442
7610
  #
7443
7611
  #
@@ -7459,15 +7627,15 @@ module Aws::S3
7459
7627
  #
7460
7628
  # @!attribute [rw] encoding_type
7461
7629
  # Requests Amazon S3 to encode the object keys in the response and
7462
- # specifies the encoding method to use. An object key may contain any
7463
- # Unicode character; however, XML 1.0 parser cannot parse some
7630
+ # specifies the encoding method to use. An object key can contain any
7631
+ # Unicode character; however, the XML 1.0 parser cannot parse some
7464
7632
  # characters, such as characters with an ASCII value from 0 to 10. For
7465
7633
  # characters that are not supported in XML 1.0, you can add this
7466
7634
  # parameter to request that Amazon S3 encode the keys in the response.
7467
7635
  # @return [String]
7468
7636
  #
7469
7637
  # @!attribute [rw] key_marker
7470
- # Together with upload-id-marker, this parameter specifies the
7638
+ # Together with `upload-id-marker`, this parameter specifies the
7471
7639
  # multipart upload after which listing should begin.
7472
7640
  #
7473
7641
  # If `upload-id-marker` is not specified, only the keys
@@ -7489,8 +7657,8 @@ module Aws::S3
7489
7657
  # @!attribute [rw] prefix
7490
7658
  # Lists in-progress uploads only for those keys that begin with the
7491
7659
  # specified prefix. You can use prefixes to separate a bucket into
7492
- # different grouping of keys. (You can think of using prefix to make
7493
- # groups in the same way you'd use a folder in a file system.)
7660
+ # different grouping of keys. (You can think of using `prefix` to make
7661
+ # groups in the same way that you'd use a folder in a file system.)
7494
7662
  # @return [String]
7495
7663
  #
7496
7664
  # @!attribute [rw] upload_id_marker
@@ -7508,6 +7676,20 @@ module Aws::S3
7508
7676
  # `403 Forbidden` (access denied).
7509
7677
  # @return [String]
7510
7678
  #
7679
+ # @!attribute [rw] request_payer
7680
+ # Confirms that the requester knows that they will be charged for the
7681
+ # request. Bucket owners need not specify this parameter in their
7682
+ # requests. If either the source or destination Amazon S3 bucket has
7683
+ # Requester Pays enabled, the requester will pay for corresponding
7684
+ # charges to copy the object. For information about downloading
7685
+ # objects from Requester Pays buckets, see [Downloading Objects in
7686
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
7687
+ #
7688
+ #
7689
+ #
7690
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
7691
+ # @return [String]
7692
+ #
7511
7693
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploadsRequest AWS API Documentation
7512
7694
  #
7513
7695
  class ListMultipartUploadsRequest < Struct.new(
@@ -7518,7 +7700,8 @@ module Aws::S3
7518
7700
  :max_uploads,
7519
7701
  :prefix,
7520
7702
  :upload_id_marker,
7521
- :expected_bucket_owner)
7703
+ :expected_bucket_owner,
7704
+ :request_payer)
7522
7705
  SENSITIVE = []
7523
7706
  include Aws::Structure
7524
7707
  end
@@ -7526,9 +7709,9 @@ module Aws::S3
7526
7709
  # @!attribute [rw] is_truncated
7527
7710
  # A flag that indicates whether Amazon S3 returned all of the results
7528
7711
  # that satisfied the search criteria. If your results were truncated,
7529
- # you can make a follow-up paginated request using the NextKeyMarker
7530
- # and NextVersionIdMarker response parameters as a starting place in
7531
- # another request to return the rest of the results.
7712
+ # you can make a follow-up paginated request by using the
7713
+ # `NextKeyMarker` and `NextVersionIdMarker` response parameters as a
7714
+ # starting place in another request to return the rest of the results.
7532
7715
  # @return [Boolean]
7533
7716
  #
7534
7717
  # @!attribute [rw] key_marker
@@ -7550,7 +7733,7 @@ module Aws::S3
7550
7733
  # When the number of responses exceeds the value of `MaxKeys`,
7551
7734
  # `NextVersionIdMarker` specifies the first object version not
7552
7735
  # returned that satisfies the search criteria. Use this value for the
7553
- # version-id-marker request parameter in a subsequent request.
7736
+ # `version-id-marker` request parameter in a subsequent request.
7554
7737
  # @return [String]
7555
7738
  #
7556
7739
  # @!attribute [rw] versions
@@ -7575,7 +7758,7 @@ module Aws::S3
7575
7758
  # that you specify to group keys. All keys that contain the same
7576
7759
  # string between the prefix and the first occurrence of the delimiter
7577
7760
  # are grouped under a single result element in `CommonPrefixes`. These
7578
- # groups are counted as one result against the max-keys limitation.
7761
+ # groups are counted as one result against the `max-keys` limitation.
7579
7762
  # These keys are not returned elsewhere in the response.
7580
7763
  # @return [String]
7581
7764
  #
@@ -7592,13 +7775,18 @@ module Aws::S3
7592
7775
  # Encoding type used by Amazon S3 to encode object key names in the
7593
7776
  # XML response.
7594
7777
  #
7595
- # If you specify encoding-type request parameter, Amazon S3 includes
7596
- # this element in the response, and returns encoded key name values in
7597
- # the following response elements:
7778
+ # If you specify the `encoding-type` request parameter, Amazon S3
7779
+ # includes this element in the response, and returns encoded key name
7780
+ # values in the following response elements:
7598
7781
  #
7599
7782
  # `KeyMarker, NextKeyMarker, Prefix, Key`, and `Delimiter`.
7600
7783
  # @return [String]
7601
7784
  #
7785
+ # @!attribute [rw] request_charged
7786
+ # If present, indicates that the requester was successfully charged
7787
+ # for the request.
7788
+ # @return [String]
7789
+ #
7602
7790
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectVersionsOutput AWS API Documentation
7603
7791
  #
7604
7792
  class ListObjectVersionsOutput < Struct.new(
@@ -7614,7 +7802,8 @@ module Aws::S3
7614
7802
  :delimiter,
7615
7803
  :max_keys,
7616
7804
  :common_prefixes,
7617
- :encoding_type)
7805
+ :encoding_type,
7806
+ :request_charged)
7618
7807
  SENSITIVE = []
7619
7808
  include Aws::Structure
7620
7809
  end
@@ -7627,15 +7816,15 @@ module Aws::S3
7627
7816
  # A delimiter is a character that you specify to group keys. All keys
7628
7817
  # that contain the same string between the `prefix` and the first
7629
7818
  # occurrence of the delimiter are grouped under a single result
7630
- # element in CommonPrefixes. These groups are counted as one result
7631
- # against the max-keys limitation. These keys are not returned
7819
+ # element in `CommonPrefixes`. These groups are counted as one result
7820
+ # against the `max-keys` limitation. These keys are not returned
7632
7821
  # elsewhere in the response.
7633
7822
  # @return [String]
7634
7823
  #
7635
7824
  # @!attribute [rw] encoding_type
7636
7825
  # Requests Amazon S3 to encode the object keys in the response and
7637
- # specifies the encoding method to use. An object key may contain any
7638
- # Unicode character; however, XML 1.0 parser cannot parse some
7826
+ # specifies the encoding method to use. An object key can contain any
7827
+ # Unicode character; however, the XML 1.0 parser cannot parse some
7639
7828
  # characters, such as characters with an ASCII value from 0 to 10. For
7640
7829
  # characters that are not supported in XML 1.0, you can add this
7641
7830
  # parameter to request that Amazon S3 encode the keys in the response.
@@ -7646,22 +7835,22 @@ module Aws::S3
7646
7835
  # @return [String]
7647
7836
  #
7648
7837
  # @!attribute [rw] max_keys
7649
- # Sets the maximum number of keys returned in the response. By default
7650
- # the action returns up to 1,000 key names. The response might contain
7651
- # fewer keys but will never contain more. If additional keys satisfy
7652
- # the search criteria, but were not returned because max-keys was
7653
- # exceeded, the response contains
7654
- # &lt;isTruncated&gt;true&lt;/isTruncated&gt;. To return the
7655
- # additional keys, see key-marker and version-id-marker.
7838
+ # Sets the maximum number of keys returned in the response. By
7839
+ # default, the action returns up to 1,000 key names. The response
7840
+ # might contain fewer keys but will never contain more. If additional
7841
+ # keys satisfy the search criteria, but were not returned because
7842
+ # `max-keys` was exceeded, the response contains
7843
+ # `<isTruncated>true</isTruncated>`. To return the additional keys,
7844
+ # see `key-marker` and `version-id-marker`.
7656
7845
  # @return [Integer]
7657
7846
  #
7658
7847
  # @!attribute [rw] prefix
7659
7848
  # Use this parameter to select only those keys that begin with the
7660
7849
  # specified prefix. You can use prefixes to separate a bucket into
7661
- # different groupings of keys. (You can think of using prefix to make
7662
- # groups in the same way you'd use a folder in a file system.) You
7663
- # can use prefix with delimiter to roll up numerous objects into a
7664
- # single result under CommonPrefixes.
7850
+ # different groupings of keys. (You can think of using `prefix` to
7851
+ # make groups in the same way that you'd use a folder in a file
7852
+ # system.) You can use `prefix` with `delimiter` to roll up numerous
7853
+ # objects into a single result under `CommonPrefixes`.
7665
7854
  # @return [String]
7666
7855
  #
7667
7856
  # @!attribute [rw] version_id_marker
@@ -7674,6 +7863,25 @@ module Aws::S3
7674
7863
  # `403 Forbidden` (access denied).
7675
7864
  # @return [String]
7676
7865
  #
7866
+ # @!attribute [rw] request_payer
7867
+ # Confirms that the requester knows that they will be charged for the
7868
+ # request. Bucket owners need not specify this parameter in their
7869
+ # requests. If either the source or destination Amazon S3 bucket has
7870
+ # Requester Pays enabled, the requester will pay for corresponding
7871
+ # charges to copy the object. For information about downloading
7872
+ # objects from Requester Pays buckets, see [Downloading Objects in
7873
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
7874
+ #
7875
+ #
7876
+ #
7877
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
7878
+ # @return [String]
7879
+ #
7880
+ # @!attribute [rw] optional_object_attributes
7881
+ # Specifies the optional fields that you want returned in the
7882
+ # response. Fields that you do not specify are not returned.
7883
+ # @return [Array<String>]
7884
+ #
7677
7885
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectVersionsRequest AWS API Documentation
7678
7886
  #
7679
7887
  class ListObjectVersionsRequest < Struct.new(
@@ -7684,7 +7892,9 @@ module Aws::S3
7684
7892
  :max_keys,
7685
7893
  :prefix,
7686
7894
  :version_id_marker,
7687
- :expected_bucket_owner)
7895
+ :expected_bucket_owner,
7896
+ :request_payer,
7897
+ :optional_object_attributes)
7688
7898
  SENSITIVE = []
7689
7899
  include Aws::Structure
7690
7900
  end
@@ -7700,14 +7910,18 @@ module Aws::S3
7700
7910
  # @return [String]
7701
7911
  #
7702
7912
  # @!attribute [rw] next_marker
7703
- # When response is truncated (the IsTruncated element value in the
7704
- # response is true), you can use the key name in this field as marker
7705
- # in the subsequent request to get next set of objects. Amazon S3
7706
- # lists objects in alphabetical order Note: This element is returned
7707
- # only if you have delimiter request parameter specified. If response
7708
- # does not include the NextMarker and it is truncated, you can use the
7709
- # value of the last Key in the response as the marker in the
7710
- # subsequent request to get the next set of object keys.
7913
+ # When the response is truncated (the `IsTruncated` element value in
7914
+ # the response is `true`), you can use the key name in this field as
7915
+ # the `marker` parameter in the subsequent request to get the next set
7916
+ # of objects. Amazon S3 lists objects in alphabetical order.
7917
+ #
7918
+ # <note markdown="1"> This element is returned only if you have the `delimiter` request
7919
+ # parameter specified. If the response does not include the
7920
+ # `NextMarker` element and it is truncated, you can use the value of
7921
+ # the last `Key` element in the response as the `marker` parameter in
7922
+ # the subsequent request to get the next set of object keys.
7923
+ #
7924
+ # </note>
7711
7925
  # @return [String]
7712
7926
  #
7713
7927
  # @!attribute [rw] contents
@@ -7738,19 +7952,20 @@ module Aws::S3
7738
7952
  # All of the keys (up to 1,000) rolled up in a common prefix count as
7739
7953
  # a single return when calculating the number of returns.
7740
7954
  #
7741
- # A response can contain CommonPrefixes only if you specify a
7955
+ # A response can contain `CommonPrefixes` only if you specify a
7742
7956
  # delimiter.
7743
7957
  #
7744
- # CommonPrefixes contains all (if there are any) keys between Prefix
7745
- # and the next occurrence of the string specified by the delimiter.
7958
+ # `CommonPrefixes` contains all (if there are any) keys between
7959
+ # `Prefix` and the next occurrence of the string specified by the
7960
+ # delimiter.
7746
7961
  #
7747
- # CommonPrefixes lists keys that act like subdirectories in the
7748
- # directory specified by Prefix.
7962
+ # `CommonPrefixes` lists keys that act like subdirectories in the
7963
+ # directory specified by `Prefix`.
7749
7964
  #
7750
- # For example, if the prefix is notes/ and the delimiter is a slash
7751
- # (/) as in notes/summer/july, the common prefix is notes/summer/. All
7752
- # of the keys that roll up into a common prefix count as a single
7753
- # return when calculating the number of returns.
7965
+ # For example, if the prefix is `notes/` and the delimiter is a slash
7966
+ # (`/`), as in `notes/summer/july`, the common prefix is
7967
+ # `notes/summer/`. All of the keys that roll up into a common prefix
7968
+ # count as a single return when calculating the number of returns.
7754
7969
  # @return [Array<Types::CommonPrefix>]
7755
7970
  #
7756
7971
  # @!attribute [rw] encoding_type
@@ -7758,6 +7973,11 @@ module Aws::S3
7758
7973
  # response.
7759
7974
  # @return [String]
7760
7975
  #
7976
+ # @!attribute [rw] request_charged
7977
+ # If present, indicates that the requester was successfully charged
7978
+ # for the request.
7979
+ # @return [String]
7980
+ #
7761
7981
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsOutput AWS API Documentation
7762
7982
  #
7763
7983
  class ListObjectsOutput < Struct.new(
@@ -7770,7 +7990,8 @@ module Aws::S3
7770
7990
  :delimiter,
7771
7991
  :max_keys,
7772
7992
  :common_prefixes,
7773
- :encoding_type)
7993
+ :encoding_type,
7994
+ :request_charged)
7774
7995
  SENSITIVE = []
7775
7996
  include Aws::Structure
7776
7997
  end
@@ -7787,14 +8008,14 @@ module Aws::S3
7787
8008
  # bucket name. For more information about access point ARNs, see
7788
8009
  # [Using access points][1] in the *Amazon S3 User Guide*.
7789
8010
  #
7790
- # When using this action with Amazon S3 on Outposts, you must direct
8011
+ # When you use this action with Amazon S3 on Outposts, you must direct
7791
8012
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7792
8013
  # takes the form `
7793
8014
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7794
- # When using this action with S3 on Outposts through the Amazon Web
7795
- # Services SDKs, you provide the Outposts bucket ARN in place of the
7796
- # bucket name. For more information about S3 on Outposts ARNs, see
7797
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
8015
+ # When you use this action with S3 on Outposts through the Amazon Web
8016
+ # Services SDKs, you provide the Outposts access point ARN in place of
8017
+ # the bucket name. For more information about S3 on Outposts ARNs, see
8018
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
7798
8019
  #
7799
8020
  #
7800
8021
  #
@@ -7803,13 +8024,13 @@ module Aws::S3
7803
8024
  # @return [String]
7804
8025
  #
7805
8026
  # @!attribute [rw] delimiter
7806
- # A delimiter is a character you use to group keys.
8027
+ # A delimiter is a character that you use to group keys.
7807
8028
  # @return [String]
7808
8029
  #
7809
8030
  # @!attribute [rw] encoding_type
7810
8031
  # Requests Amazon S3 to encode the object keys in the response and
7811
- # specifies the encoding method to use. An object key may contain any
7812
- # Unicode character; however, XML 1.0 parser cannot parse some
8032
+ # specifies the encoding method to use. An object key can contain any
8033
+ # Unicode character; however, the XML 1.0 parser cannot parse some
7813
8034
  # characters, such as characters with an ASCII value from 0 to 10. For
7814
8035
  # characters that are not supported in XML 1.0, you can add this
7815
8036
  # parameter to request that Amazon S3 encode the keys in the response.
@@ -7822,9 +8043,9 @@ module Aws::S3
7822
8043
  # @return [String]
7823
8044
  #
7824
8045
  # @!attribute [rw] max_keys
7825
- # Sets the maximum number of keys returned in the response. By default
7826
- # the action returns up to 1,000 key names. The response might contain
7827
- # fewer keys but will never contain more.
8046
+ # Sets the maximum number of keys returned in the response. By
8047
+ # default, the action returns up to 1,000 key names. The response
8048
+ # might contain fewer keys but will never contain more.
7828
8049
  # @return [Integer]
7829
8050
  #
7830
8051
  # @!attribute [rw] prefix
@@ -7843,6 +8064,11 @@ module Aws::S3
7843
8064
  # `403 Forbidden` (access denied).
7844
8065
  # @return [String]
7845
8066
  #
8067
+ # @!attribute [rw] optional_object_attributes
8068
+ # Specifies the optional fields that you want returned in the
8069
+ # response. Fields that you do not specify are not returned.
8070
+ # @return [Array<String>]
8071
+ #
7846
8072
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsRequest AWS API Documentation
7847
8073
  #
7848
8074
  class ListObjectsRequest < Struct.new(
@@ -7853,15 +8079,17 @@ module Aws::S3
7853
8079
  :max_keys,
7854
8080
  :prefix,
7855
8081
  :request_payer,
7856
- :expected_bucket_owner)
8082
+ :expected_bucket_owner,
8083
+ :optional_object_attributes)
7857
8084
  SENSITIVE = []
7858
8085
  include Aws::Structure
7859
8086
  end
7860
8087
 
7861
8088
  # @!attribute [rw] is_truncated
7862
- # Set to false if all of the results were returned. Set to true if
8089
+ # Set to `false` if all of the results were returned. Set to `true` if
7863
8090
  # more keys are available to return. If the number of results exceeds
7864
- # that specified by MaxKeys, all of the results might not be returned.
8091
+ # that specified by `MaxKeys`, all of the results might not be
8092
+ # returned.
7865
8093
  # @return [Boolean]
7866
8094
  #
7867
8095
  # @!attribute [rw] contents
@@ -7880,14 +8108,14 @@ module Aws::S3
7880
8108
  # bucket name. For more information about access point ARNs, see
7881
8109
  # [Using access points][1] in the *Amazon S3 User Guide*.
7882
8110
  #
7883
- # When using this action with Amazon S3 on Outposts, you must direct
8111
+ # When you use this action with Amazon S3 on Outposts, you must direct
7884
8112
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7885
8113
  # takes the form `
7886
8114
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7887
- # When using this action with S3 on Outposts through the Amazon Web
7888
- # Services SDKs, you provide the Outposts bucket ARN in place of the
7889
- # bucket name. For more information about S3 on Outposts ARNs, see
7890
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
8115
+ # When you use this action with S3 on Outposts through the Amazon Web
8116
+ # Services SDKs, you provide the Outposts access point ARN in place of
8117
+ # the bucket name. For more information about S3 on Outposts ARNs, see
8118
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
7891
8119
  #
7892
8120
  #
7893
8121
  #
@@ -7900,17 +8128,17 @@ module Aws::S3
7900
8128
  # @return [String]
7901
8129
  #
7902
8130
  # @!attribute [rw] delimiter
7903
- # Causes keys that contain the same string between the prefix and the
7904
- # first occurrence of the delimiter to be rolled up into a single
7905
- # result element in the CommonPrefixes collection. These rolled-up
8131
+ # Causes keys that contain the same string between the `prefix` and
8132
+ # the first occurrence of the delimiter to be rolled up into a single
8133
+ # result element in the `CommonPrefixes` collection. These rolled-up
7906
8134
  # keys are not returned elsewhere in the response. Each rolled-up
7907
8135
  # result counts as only one return against the `MaxKeys` value.
7908
8136
  # @return [String]
7909
8137
  #
7910
8138
  # @!attribute [rw] max_keys
7911
- # Sets the maximum number of keys returned in the response. By default
7912
- # the action returns up to 1,000 key names. The response might contain
7913
- # fewer keys but will never contain more.
8139
+ # Sets the maximum number of keys returned in the response. By
8140
+ # default, the action returns up to 1,000 key names. The response
8141
+ # might contain fewer keys but will never contain more.
7914
8142
  # @return [Integer]
7915
8143
  #
7916
8144
  # @!attribute [rw] common_prefixes
@@ -7937,7 +8165,7 @@ module Aws::S3
7937
8165
  # Encoding type used by Amazon S3 to encode object key names in the
7938
8166
  # XML response.
7939
8167
  #
7940
- # If you specify the encoding-type request parameter, Amazon S3
8168
+ # If you specify the `encoding-type` request parameter, Amazon S3
7941
8169
  # includes this element in the response, and returns encoded key name
7942
8170
  # values in the following response elements:
7943
8171
  #
@@ -7945,13 +8173,14 @@ module Aws::S3
7945
8173
  # @return [String]
7946
8174
  #
7947
8175
  # @!attribute [rw] key_count
7948
- # KeyCount is the number of keys returned with this request. KeyCount
7949
- # will always be less than or equals to MaxKeys field. Say you ask for
7950
- # 50 keys, your result will include less than equals 50 keys
8176
+ # `KeyCount` is the number of keys returned with this request.
8177
+ # `KeyCount` will always be less than or equal to the `MaxKeys` field.
8178
+ # For example, if you ask for 50 keys, your result will include 50
8179
+ # keys or fewer.
7951
8180
  # @return [Integer]
7952
8181
  #
7953
8182
  # @!attribute [rw] continuation_token
7954
- # If ContinuationToken was sent with the request, it is included in
8183
+ # If `ContinuationToken` was sent with the request, it is included in
7955
8184
  # the response.
7956
8185
  # @return [String]
7957
8186
  #
@@ -7968,6 +8197,11 @@ module Aws::S3
7968
8197
  # response.
7969
8198
  # @return [String]
7970
8199
  #
8200
+ # @!attribute [rw] request_charged
8201
+ # If present, indicates that the requester was successfully charged
8202
+ # for the request.
8203
+ # @return [String]
8204
+ #
7971
8205
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsV2Output AWS API Documentation
7972
8206
  #
7973
8207
  class ListObjectsV2Output < Struct.new(
@@ -7982,7 +8216,8 @@ module Aws::S3
7982
8216
  :key_count,
7983
8217
  :continuation_token,
7984
8218
  :next_continuation_token,
7985
- :start_after)
8219
+ :start_after,
8220
+ :request_charged)
7986
8221
  SENSITIVE = []
7987
8222
  include Aws::Structure
7988
8223
  end
@@ -7999,14 +8234,14 @@ module Aws::S3
7999
8234
  # bucket name. For more information about access point ARNs, see
8000
8235
  # [Using access points][1] in the *Amazon S3 User Guide*.
8001
8236
  #
8002
- # When using this action with Amazon S3 on Outposts, you must direct
8237
+ # When you use this action with Amazon S3 on Outposts, you must direct
8003
8238
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
8004
8239
  # takes the form `
8005
8240
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8006
- # When using this action with S3 on Outposts through the Amazon Web
8007
- # Services SDKs, you provide the Outposts bucket ARN in place of the
8008
- # bucket name. For more information about S3 on Outposts ARNs, see
8009
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
8241
+ # When you use this action with S3 on Outposts through the Amazon Web
8242
+ # Services SDKs, you provide the Outposts access point ARN in place of
8243
+ # the bucket name. For more information about S3 on Outposts ARNs, see
8244
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
8010
8245
  #
8011
8246
  #
8012
8247
  #
@@ -8015,7 +8250,7 @@ module Aws::S3
8015
8250
  # @return [String]
8016
8251
  #
8017
8252
  # @!attribute [rw] delimiter
8018
- # A delimiter is a character you use to group keys.
8253
+ # A delimiter is a character that you use to group keys.
8019
8254
  # @return [String]
8020
8255
  #
8021
8256
  # @!attribute [rw] encoding_type
@@ -8024,9 +8259,9 @@ module Aws::S3
8024
8259
  # @return [String]
8025
8260
  #
8026
8261
  # @!attribute [rw] max_keys
8027
- # Sets the maximum number of keys returned in the response. By default
8028
- # the action returns up to 1,000 key names. The response might contain
8029
- # fewer keys but will never contain more.
8262
+ # Sets the maximum number of keys returned in the response. By
8263
+ # default, the action returns up to 1,000 key names. The response
8264
+ # might contain fewer keys but will never contain more.
8030
8265
  # @return [Integer]
8031
8266
  #
8032
8267
  # @!attribute [rw] prefix
@@ -8034,15 +8269,15 @@ module Aws::S3
8034
8269
  # @return [String]
8035
8270
  #
8036
8271
  # @!attribute [rw] continuation_token
8037
- # ContinuationToken indicates Amazon S3 that the list is being
8038
- # continued on this bucket with a token. ContinuationToken is
8272
+ # `ContinuationToken` indicates to Amazon S3 that the list is being
8273
+ # continued on this bucket with a token. `ContinuationToken` is
8039
8274
  # obfuscated and is not a real key.
8040
8275
  # @return [String]
8041
8276
  #
8042
8277
  # @!attribute [rw] fetch_owner
8043
- # The owner field is not present in listV2 by default, if you want to
8044
- # return owner field with each key in the result then set the fetch
8045
- # owner field to true.
8278
+ # The owner field is not present in `ListObjectsV2` by default. If you
8279
+ # want to return the owner field with each key in the result, then set
8280
+ # the `FetchOwner` field to `true`.
8046
8281
  # @return [Boolean]
8047
8282
  #
8048
8283
  # @!attribute [rw] start_after
@@ -8063,6 +8298,11 @@ module Aws::S3
8063
8298
  # `403 Forbidden` (access denied).
8064
8299
  # @return [String]
8065
8300
  #
8301
+ # @!attribute [rw] optional_object_attributes
8302
+ # Specifies the optional fields that you want returned in the
8303
+ # response. Fields that you do not specify are not returned.
8304
+ # @return [Array<String>]
8305
+ #
8066
8306
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsV2Request AWS API Documentation
8067
8307
  #
8068
8308
  class ListObjectsV2Request < Struct.new(
@@ -8075,7 +8315,8 @@ module Aws::S3
8075
8315
  :fetch_owner,
8076
8316
  :start_after,
8077
8317
  :request_payer,
8078
- :expected_bucket_owner)
8318
+ :expected_bucket_owner,
8319
+ :optional_object_attributes)
8079
8320
  SENSITIVE = []
8080
8321
  include Aws::Structure
8081
8322
  end
@@ -8087,7 +8328,7 @@ module Aws::S3
8087
8328
  # includes this header indicating when the initiated multipart upload
8088
8329
  # will become eligible for abort operation. For more information, see
8089
8330
  # [Aborting Incomplete Multipart Uploads Using a Bucket Lifecycle
8090
- # Policy][1].
8331
+ # Configuration][1].
8091
8332
  #
8092
8333
  # The response will also include the `x-amz-abort-rule-id` header that
8093
8334
  # will provide the ID of the lifecycle configuration rule that defines
@@ -8126,7 +8367,7 @@ module Aws::S3
8126
8367
  #
8127
8368
  # @!attribute [rw] next_part_number_marker
8128
8369
  # When a list is truncated, this element specifies the last part in
8129
- # the list, as well as the value to use for the part-number-marker
8370
+ # the list, as well as the value to use for the `part-number-marker`
8130
8371
  # request parameter in a subsequent request.
8131
8372
  # @return [Integer]
8132
8373
  #
@@ -8208,14 +8449,14 @@ module Aws::S3
8208
8449
  # bucket name. For more information about access point ARNs, see
8209
8450
  # [Using access points][1] in the *Amazon S3 User Guide*.
8210
8451
  #
8211
- # When using this action with Amazon S3 on Outposts, you must direct
8452
+ # When you use this action with Amazon S3 on Outposts, you must direct
8212
8453
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
8213
8454
  # takes the form `
8214
8455
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8215
- # When using this action with S3 on Outposts through the Amazon Web
8216
- # Services SDKs, you provide the Outposts bucket ARN in place of the
8217
- # bucket name. For more information about S3 on Outposts ARNs, see
8218
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
8456
+ # When you use this action with S3 on Outposts through the Amazon Web
8457
+ # Services SDKs, you provide the Outposts access point ARN in place of
8458
+ # the bucket name. For more information about S3 on Outposts ARNs, see
8459
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
8219
8460
  #
8220
8461
  #
8221
8462
  #
@@ -8244,9 +8485,11 @@ module Aws::S3
8244
8485
  # @!attribute [rw] request_payer
8245
8486
  # Confirms that the requester knows that they will be charged for the
8246
8487
  # request. Bucket owners need not specify this parameter in their
8247
- # requests. For information about downloading objects from Requester
8248
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
8249
- # in the *Amazon S3 User Guide*.
8488
+ # requests. If either the source or destination Amazon S3 bucket has
8489
+ # Requester Pays enabled, the requester will pay for corresponding
8490
+ # charges to copy the object. For information about downloading
8491
+ # objects from Requester Pays buckets, see [Downloading Objects in
8492
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
8250
8493
  #
8251
8494
  #
8252
8495
  #
@@ -8359,11 +8602,11 @@ module Aws::S3
8359
8602
  # A metadata key-value pair to store with an object.
8360
8603
  #
8361
8604
  # @!attribute [rw] name
8362
- # Name of the Object.
8605
+ # Name of the object.
8363
8606
  # @return [String]
8364
8607
  #
8365
8608
  # @!attribute [rw] value
8366
- # Value of the Object.
8609
+ # Value of the object.
8367
8610
  # @return [String]
8368
8611
  #
8369
8612
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MetadataEntry AWS API Documentation
@@ -8435,7 +8678,9 @@ module Aws::S3
8435
8678
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html
8436
8679
  #
8437
8680
  # @!attribute [rw] id
8438
- # The ID used to identify the metrics configuration.
8681
+ # The ID used to identify the metrics configuration. The ID has a 64
8682
+ # character limit and can only contain letters, numbers, periods,
8683
+ # dashes, and underscores.
8439
8684
  # @return [String]
8440
8685
  #
8441
8686
  # @!attribute [rw] filter
@@ -8705,12 +8950,12 @@ module Aws::S3
8705
8950
  end
8706
8951
 
8707
8952
  # Specifies object key name filtering rules. For information about key
8708
- # name filtering, see [Configuring Event Notifications][1] in the
8709
- # *Amazon S3 User Guide*.
8953
+ # name filtering, see [Configuring event notifications using object key
8954
+ # name filtering][1] in the *Amazon S3 User Guide*.
8710
8955
  #
8711
8956
  #
8712
8957
  #
8713
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
8958
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-filtering.html
8714
8959
  #
8715
8960
  # @!attribute [rw] key
8716
8961
  # A container for object key name prefix and suffix filtering rules.
@@ -8776,6 +9021,18 @@ module Aws::S3
8776
9021
  # The owner of the object
8777
9022
  # @return [Types::Owner]
8778
9023
  #
9024
+ # @!attribute [rw] restore_status
9025
+ # Specifies the restoration status of an object. Objects in certain
9026
+ # storage classes must be restored before they can be retrieved. For
9027
+ # more information about these storage classes and how to work with
9028
+ # archived objects, see [ Working with archived objects][1] in the
9029
+ # *Amazon S3 User Guide*.
9030
+ #
9031
+ #
9032
+ #
9033
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/archived-objects.html
9034
+ # @return [Types::RestoreStatus]
9035
+ #
8779
9036
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Object AWS API Documentation
8780
9037
  #
8781
9038
  class Object < Struct.new(
@@ -8785,7 +9042,8 @@ module Aws::S3
8785
9042
  :checksum_algorithm,
8786
9043
  :size,
8787
9044
  :storage_class,
8788
- :owner)
9045
+ :owner,
9046
+ :restore_status)
8789
9047
  SENSITIVE = []
8790
9048
  include Aws::Structure
8791
9049
  end
@@ -9020,6 +9278,18 @@ module Aws::S3
9020
9278
  # Specifies the owner of the object.
9021
9279
  # @return [Types::Owner]
9022
9280
  #
9281
+ # @!attribute [rw] restore_status
9282
+ # Specifies the restoration status of an object. Objects in certain
9283
+ # storage classes must be restored before they can be retrieved. For
9284
+ # more information about these storage classes and how to work with
9285
+ # archived objects, see [ Working with archived objects][1] in the
9286
+ # *Amazon S3 User Guide*.
9287
+ #
9288
+ #
9289
+ #
9290
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/archived-objects.html
9291
+ # @return [Types::RestoreStatus]
9292
+ #
9023
9293
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectVersion AWS API Documentation
9024
9294
  #
9025
9295
  class ObjectVersion < Struct.new(
@@ -9031,7 +9301,8 @@ module Aws::S3
9031
9301
  :version_id,
9032
9302
  :is_latest,
9033
9303
  :last_modified,
9034
- :owner)
9304
+ :owner,
9305
+ :restore_status)
9035
9306
  SENSITIVE = []
9036
9307
  include Aws::Structure
9037
9308
  end
@@ -9073,7 +9344,24 @@ module Aws::S3
9073
9344
  # Container for the owner's display name and ID.
9074
9345
  #
9075
9346
  # @!attribute [rw] display_name
9076
- # Container for the display name of the owner.
9347
+ # Container for the display name of the owner. This value is only
9348
+ # supported in the following Amazon Web Services Regions:
9349
+ #
9350
+ # * US East (N. Virginia)
9351
+ #
9352
+ # * US West (N. California)
9353
+ #
9354
+ # * US West (Oregon)
9355
+ #
9356
+ # * Asia Pacific (Singapore)
9357
+ #
9358
+ # * Asia Pacific (Sydney)
9359
+ #
9360
+ # * Asia Pacific (Tokyo)
9361
+ #
9362
+ # * Europe (Ireland)
9363
+ #
9364
+ # * South America (São Paulo)
9077
9365
  # @return [String]
9078
9366
  #
9079
9367
  # @!attribute [rw] id
@@ -9578,10 +9866,14 @@ module Aws::S3
9578
9866
 
9579
9867
  # @!attribute [rw] bucket
9580
9868
  # Specifies default encryption for a bucket using server-side
9581
- # encryption with Amazon S3-managed keys (SSE-S3) or customer managed
9582
- # keys (SSE-KMS). For information about the Amazon S3 default
9583
- # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
9584
- # the *Amazon S3 User Guide*.
9869
+ # encryption with different key options. By default, all buckets have
9870
+ # a default encryption configuration that uses server-side encryption
9871
+ # with Amazon S3 managed keys (SSE-S3). You can optionally configure
9872
+ # default encryption for a bucket by using server-side encryption with
9873
+ # an Amazon Web Services KMS key (SSE-KMS) or a customer-provided key
9874
+ # (SSE-C). For information about the bucket default encryption
9875
+ # feature, see [Amazon S3 Bucket Default Encryption][1] in the *Amazon
9876
+ # S3 User Guide*.
9585
9877
  #
9586
9878
  #
9587
9879
  #
@@ -9834,7 +10126,9 @@ module Aws::S3
9834
10126
  # @return [String]
9835
10127
  #
9836
10128
  # @!attribute [rw] id
9837
- # The ID used to identify the metrics configuration.
10129
+ # The ID used to identify the metrics configuration. The ID has a 64
10130
+ # character limit and can only contain letters, numbers, periods,
10131
+ # dashes, and underscores.
9838
10132
  # @return [String]
9839
10133
  #
9840
10134
  # @!attribute [rw] metrics_configuration
@@ -10457,14 +10751,14 @@ module Aws::S3
10457
10751
  # bucket name. For more information about access point ARNs, see
10458
10752
  # [Using access points][1] in the *Amazon S3 User Guide*.
10459
10753
  #
10460
- # When using this action with Amazon S3 on Outposts, you must direct
10754
+ # When you use this action with Amazon S3 on Outposts, you must direct
10461
10755
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
10462
10756
  # takes the form `
10463
10757
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10464
- # When using this action with S3 on Outposts through the Amazon Web
10465
- # Services SDKs, you provide the Outposts bucket ARN in place of the
10466
- # bucket name. For more information about S3 on Outposts ARNs, see
10467
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
10758
+ # When you use this action with S3 on Outposts through the Amazon Web
10759
+ # Services SDKs, you provide the Outposts access point ARN in place of
10760
+ # the bucket name. For more information about S3 on Outposts ARNs, see
10761
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
10468
10762
  #
10469
10763
  #
10470
10764
  #
@@ -10475,9 +10769,11 @@ module Aws::S3
10475
10769
  # @!attribute [rw] request_payer
10476
10770
  # Confirms that the requester knows that they will be charged for the
10477
10771
  # request. Bucket owners need not specify this parameter in their
10478
- # requests. For information about downloading objects from Requester
10479
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
10480
- # in the *Amazon S3 User Guide*.
10772
+ # requests. If either the source or destination Amazon S3 bucket has
10773
+ # Requester Pays enabled, the requester will pay for corresponding
10774
+ # charges to copy the object. For information about downloading
10775
+ # objects from Requester Pays buckets, see [Downloading Objects in
10776
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
10481
10777
  #
10482
10778
  #
10483
10779
  #
@@ -10558,9 +10854,11 @@ module Aws::S3
10558
10854
  # @!attribute [rw] request_payer
10559
10855
  # Confirms that the requester knows that they will be charged for the
10560
10856
  # request. Bucket owners need not specify this parameter in their
10561
- # requests. For information about downloading objects from Requester
10562
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
10563
- # in the *Amazon S3 User Guide*.
10857
+ # requests. If either the source or destination Amazon S3 bucket has
10858
+ # Requester Pays enabled, the requester will pay for corresponding
10859
+ # charges to copy the object. For information about downloading
10860
+ # objects from Requester Pays buckets, see [Downloading Objects in
10861
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
10564
10862
  #
10565
10863
  #
10566
10864
  #
@@ -10643,9 +10941,11 @@ module Aws::S3
10643
10941
  # @!attribute [rw] request_payer
10644
10942
  # Confirms that the requester knows that they will be charged for the
10645
10943
  # request. Bucket owners need not specify this parameter in their
10646
- # requests. For information about downloading objects from Requester
10647
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
10648
- # in the *Amazon S3 User Guide*.
10944
+ # requests. If either the source or destination Amazon S3 bucket has
10945
+ # Requester Pays enabled, the requester will pay for corresponding
10946
+ # charges to copy the object. For information about downloading
10947
+ # objects from Requester Pays buckets, see [Downloading Objects in
10948
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
10649
10949
  #
10650
10950
  #
10651
10951
  #
@@ -10770,10 +11070,8 @@ module Aws::S3
10770
11070
  # @return [String]
10771
11071
  #
10772
11072
  # @!attribute [rw] server_side_encryption
10773
- # If you specified server-side encryption either with an Amazon Web
10774
- # Services KMS key or Amazon S3-managed encryption key in your PUT
10775
- # request, the response includes this header. It confirms the
10776
- # encryption algorithm that Amazon S3 used to encrypt the object.
11073
+ # The server-side encryption algorithm used when storing this object
11074
+ # in Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
10777
11075
  # @return [String]
10778
11076
  #
10779
11077
  # @!attribute [rw] version_id
@@ -10794,22 +11092,25 @@ module Aws::S3
10794
11092
  # @return [String]
10795
11093
  #
10796
11094
  # @!attribute [rw] ssekms_key_id
10797
- # If `x-amz-server-side-encryption` is present and has the value of
10798
- # `aws:kms`, this header specifies the ID of the Amazon Web Services
10799
- # Key Management Service (Amazon Web Services KMS) symmetric customer
10800
- # managed key that was used for the object.
11095
+ # If `x-amz-server-side-encryption` has a valid value of `aws:kms` or
11096
+ # `aws:kms:dsse`, this header specifies the ID of the Key Management
11097
+ # Service (KMS) symmetric encryption customer managed key that was
11098
+ # used for the object.
10801
11099
  # @return [String]
10802
11100
  #
10803
11101
  # @!attribute [rw] ssekms_encryption_context
10804
11102
  # If present, specifies the Amazon Web Services KMS Encryption Context
10805
11103
  # to use for object encryption. The value of this header is a
10806
11104
  # base64-encoded UTF-8 string holding JSON with the encryption context
10807
- # key-value pairs.
11105
+ # key-value pairs. This value is stored as object metadata and
11106
+ # automatically gets passed on to Amazon Web Services KMS for future
11107
+ # `GetObject` or `CopyObject` operations on this object.
10808
11108
  # @return [String]
10809
11109
  #
10810
11110
  # @!attribute [rw] bucket_key_enabled
10811
11111
  # Indicates whether the uploaded object uses an S3 Bucket Key for
10812
- # server-side encryption with Amazon Web Services KMS (SSE-KMS).
11112
+ # server-side encryption with Key Management Service (KMS) keys
11113
+ # (SSE-KMS).
10813
11114
  # @return [Boolean]
10814
11115
  #
10815
11116
  # @!attribute [rw] request_charged
@@ -10865,14 +11166,14 @@ module Aws::S3
10865
11166
  # bucket name. For more information about access point ARNs, see
10866
11167
  # [Using access points][1] in the *Amazon S3 User Guide*.
10867
11168
  #
10868
- # When using this action with Amazon S3 on Outposts, you must direct
11169
+ # When you use this action with Amazon S3 on Outposts, you must direct
10869
11170
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
10870
11171
  # takes the form `
10871
11172
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10872
- # When using this action with S3 on Outposts through the Amazon Web
10873
- # Services SDKs, you provide the Outposts bucket ARN in place of the
10874
- # bucket name. For more information about S3 on Outposts ARNs, see
10875
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
11173
+ # When you use this action with S3 on Outposts through the Amazon Web
11174
+ # Services SDKs, you provide the Outposts access point ARN in place of
11175
+ # the bucket name. For more information about S3 on Outposts ARNs, see
11176
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
10876
11177
  #
10877
11178
  #
10878
11179
  #
@@ -10893,11 +11194,11 @@ module Aws::S3
10893
11194
  # @!attribute [rw] content_disposition
10894
11195
  # Specifies presentational information for the object. For more
10895
11196
  # information, see
10896
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1][1].
11197
+ # [https://www.rfc-editor.org/rfc/rfc6266#section-4][1].
10897
11198
  #
10898
11199
  #
10899
11200
  #
10900
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
11201
+ # [1]: https://www.rfc-editor.org/rfc/rfc6266#section-4
10901
11202
  # @return [String]
10902
11203
  #
10903
11204
  # @!attribute [rw] content_encoding
@@ -10905,11 +11206,11 @@ module Aws::S3
10905
11206
  # thus what decoding mechanisms must be applied to obtain the
10906
11207
  # media-type referenced by the Content-Type header field. For more
10907
11208
  # information, see
10908
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11][1].
11209
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding][1].
10909
11210
  #
10910
11211
  #
10911
11212
  #
10912
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
11213
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding
10913
11214
  # @return [String]
10914
11215
  #
10915
11216
  # @!attribute [rw] content_language
@@ -10920,11 +11221,11 @@ module Aws::S3
10920
11221
  # Size of the body in bytes. This parameter is useful when the size of
10921
11222
  # the body cannot be determined automatically. For more information,
10922
11223
  # see
10923
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13][1].
11224
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length][1].
10924
11225
  #
10925
11226
  #
10926
11227
  #
10927
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
11228
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
10928
11229
  # @return [Integer]
10929
11230
  #
10930
11231
  # @!attribute [rw] content_md5
@@ -10944,11 +11245,11 @@ module Aws::S3
10944
11245
  # @!attribute [rw] content_type
10945
11246
  # A standard MIME type describing the format of the contents. For more
10946
11247
  # information, see
10947
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17][1].
11248
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type][1].
10948
11249
  #
10949
11250
  #
10950
11251
  #
10951
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
11252
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type
10952
11253
  # @return [String]
10953
11254
  #
10954
11255
  # @!attribute [rw] checksum_algorithm
@@ -11019,11 +11320,11 @@ module Aws::S3
11019
11320
  # @!attribute [rw] expires
11020
11321
  # The date and time at which the object is no longer cacheable. For
11021
11322
  # more information, see
11022
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21][1].
11323
+ # [https://www.rfc-editor.org/rfc/rfc7234#section-5.3][1].
11023
11324
  #
11024
11325
  #
11025
11326
  #
11026
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
11327
+ # [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
11027
11328
  # @return [Time]
11028
11329
  #
11029
11330
  # @!attribute [rw] grant_full_control
@@ -11061,7 +11362,7 @@ module Aws::S3
11061
11362
  #
11062
11363
  # @!attribute [rw] server_side_encryption
11063
11364
  # The server-side encryption algorithm used when storing this object
11064
- # in Amazon S3 (for example, AES256, aws:kms).
11365
+ # in Amazon S3 (for example, `AES256`, `aws:kms`, `aws:kms:dsse`).
11065
11366
  # @return [String]
11066
11367
  #
11067
11368
  # @!attribute [rw] storage_class
@@ -11125,29 +11426,32 @@ module Aws::S3
11125
11426
  # @return [String]
11126
11427
  #
11127
11428
  # @!attribute [rw] ssekms_key_id
11128
- # If `x-amz-server-side-encryption` is present and has the value of
11129
- # `aws:kms`, this header specifies the ID of the Amazon Web Services
11130
- # Key Management Service (Amazon Web Services KMS) symmetrical
11429
+ # If `x-amz-server-side-encryption` has a valid value of `aws:kms` or
11430
+ # `aws:kms:dsse`, this header specifies the ID (Key ID, Key ARN, or
11431
+ # Key Alias) of the Key Management Service (KMS) symmetric encryption
11131
11432
  # customer managed key that was used for the object. If you specify
11132
- # `x-amz-server-side-encryption:aws:kms`, but do not provide`
11433
+ # `x-amz-server-side-encryption:aws:kms` or
11434
+ # `x-amz-server-side-encryption:aws:kms:dsse`, but do not provide`
11133
11435
  # x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
11134
- # Amazon Web Services managed key to protect the data. If the KMS key
11135
- # does not exist in the same account issuing the command, you must use
11136
- # the full ARN and not just the ID.
11436
+ # Amazon Web Services managed key (`aws/s3`) to protect the data. If
11437
+ # the KMS key does not exist in the same account that's issuing the
11438
+ # command, you must use the full ARN and not just the ID.
11137
11439
  # @return [String]
11138
11440
  #
11139
11441
  # @!attribute [rw] ssekms_encryption_context
11140
11442
  # Specifies the Amazon Web Services KMS Encryption Context to use for
11141
11443
  # object encryption. The value of this header is a base64-encoded
11142
11444
  # UTF-8 string holding JSON with the encryption context key-value
11143
- # pairs.
11445
+ # pairs. This value is stored as object metadata and automatically
11446
+ # gets passed on to Amazon Web Services KMS for future `GetObject` or
11447
+ # `CopyObject` operations on this object.
11144
11448
  # @return [String]
11145
11449
  #
11146
11450
  # @!attribute [rw] bucket_key_enabled
11147
11451
  # Specifies whether Amazon S3 should use an S3 Bucket Key for object
11148
- # encryption with server-side encryption using AWS KMS (SSE-KMS).
11149
- # Setting this header to `true` causes Amazon S3 to use an S3 Bucket
11150
- # Key for object encryption with SSE-KMS.
11452
+ # encryption with server-side encryption using Key Management Service
11453
+ # (KMS) keys (SSE-KMS). Setting this header to `true` causes Amazon S3
11454
+ # to use an S3 Bucket Key for object encryption with SSE-KMS.
11151
11455
  #
11152
11456
  # Specifying this header with a PUT action doesn’t affect bucket-level
11153
11457
  # settings for S3 Bucket Key.
@@ -11156,9 +11460,11 @@ module Aws::S3
11156
11460
  # @!attribute [rw] request_payer
11157
11461
  # Confirms that the requester knows that they will be charged for the
11158
11462
  # request. Bucket owners need not specify this parameter in their
11159
- # requests. For information about downloading objects from Requester
11160
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
11161
- # in the *Amazon S3 User Guide*.
11463
+ # requests. If either the source or destination Amazon S3 bucket has
11464
+ # Requester Pays enabled, the requester will pay for corresponding
11465
+ # charges to copy the object. For information about downloading
11466
+ # objects from Requester Pays buckets, see [Downloading Objects in
11467
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
11162
11468
  #
11163
11469
  #
11164
11470
  #
@@ -11281,9 +11587,11 @@ module Aws::S3
11281
11587
  # @!attribute [rw] request_payer
11282
11588
  # Confirms that the requester knows that they will be charged for the
11283
11589
  # request. Bucket owners need not specify this parameter in their
11284
- # requests. For information about downloading objects from Requester
11285
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
11286
- # in the *Amazon S3 User Guide*.
11590
+ # requests. If either the source or destination Amazon S3 bucket has
11591
+ # Requester Pays enabled, the requester will pay for corresponding
11592
+ # charges to copy the object. For information about downloading
11593
+ # objects from Requester Pays buckets, see [Downloading Objects in
11594
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
11287
11595
  #
11288
11596
  #
11289
11597
  #
@@ -11371,14 +11679,14 @@ module Aws::S3
11371
11679
  # bucket name. For more information about access point ARNs, see
11372
11680
  # [Using access points][1] in the *Amazon S3 User Guide*.
11373
11681
  #
11374
- # When using this action with Amazon S3 on Outposts, you must direct
11682
+ # When you use this action with Amazon S3 on Outposts, you must direct
11375
11683
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
11376
11684
  # takes the form `
11377
11685
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11378
- # When using this action with S3 on Outposts through the Amazon Web
11379
- # Services SDKs, you provide the Outposts bucket ARN in place of the
11380
- # bucket name. For more information about S3 on Outposts ARNs, see
11381
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
11686
+ # When you use this action with S3 on Outposts through the Amazon Web
11687
+ # Services SDKs, you provide the Outposts access point ARN in place of
11688
+ # the bucket name. For more information about S3 on Outposts ARNs, see
11689
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
11382
11690
  #
11383
11691
  #
11384
11692
  #
@@ -11432,9 +11740,11 @@ module Aws::S3
11432
11740
  # @!attribute [rw] request_payer
11433
11741
  # Confirms that the requester knows that they will be charged for the
11434
11742
  # request. Bucket owners need not specify this parameter in their
11435
- # requests. For information about downloading objects from Requester
11436
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
11437
- # in the *Amazon S3 User Guide*.
11743
+ # requests. If either the source or destination Amazon S3 bucket has
11744
+ # Requester Pays enabled, the requester will pay for corresponding
11745
+ # charges to copy the object. For information about downloading
11746
+ # objects from Requester Pays buckets, see [Downloading Objects in
11747
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
11438
11748
  #
11439
11749
  #
11440
11750
  #
@@ -11538,12 +11848,12 @@ module Aws::S3
11538
11848
  #
11539
11849
  # @!attribute [rw] filter
11540
11850
  # Specifies object key name filtering rules. For information about key
11541
- # name filtering, see [Configuring Event Notifications][1] in the
11542
- # *Amazon S3 User Guide*.
11851
+ # name filtering, see [Configuring event notifications using object
11852
+ # key name filtering][1] in the *Amazon S3 User Guide*.
11543
11853
  #
11544
11854
  #
11545
11855
  #
11546
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
11856
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-filtering.html
11547
11857
  # @return [Types::NotificationConfigurationFilter]
11548
11858
  #
11549
11859
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/QueueConfiguration AWS API Documentation
@@ -11807,6 +12117,13 @@ module Aws::S3
11807
12117
  # @return [Types::SourceSelectionCriteria]
11808
12118
  #
11809
12119
  # @!attribute [rw] existing_object_replication
12120
+ # Optional configuration to replicate existing source bucket objects.
12121
+ # For more information, see [Replicating Existing Objects][1] in the
12122
+ # *Amazon S3 User Guide*.
12123
+ #
12124
+ #
12125
+ #
12126
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-what-is-isnot-replicated.html#existing-object-replication
11810
12127
  # @return [Types::ExistingObjectReplication]
11811
12128
  #
11812
12129
  # @!attribute [rw] destination
@@ -12032,14 +12349,14 @@ module Aws::S3
12032
12349
  # bucket name. For more information about access point ARNs, see
12033
12350
  # [Using access points][1] in the *Amazon S3 User Guide*.
12034
12351
  #
12035
- # When using this action with Amazon S3 on Outposts, you must direct
12352
+ # When you use this action with Amazon S3 on Outposts, you must direct
12036
12353
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
12037
12354
  # takes the form `
12038
12355
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
12039
- # When using this action with S3 on Outposts through the Amazon Web
12040
- # Services SDKs, you provide the Outposts bucket ARN in place of the
12041
- # bucket name. For more information about S3 on Outposts ARNs, see
12042
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
12356
+ # When you use this action with S3 on Outposts through the Amazon Web
12357
+ # Services SDKs, you provide the Outposts access point ARN in place of
12358
+ # the bucket name. For more information about S3 on Outposts ARNs, see
12359
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
12043
12360
  #
12044
12361
  #
12045
12362
  #
@@ -12062,9 +12379,11 @@ module Aws::S3
12062
12379
  # @!attribute [rw] request_payer
12063
12380
  # Confirms that the requester knows that they will be charged for the
12064
12381
  # request. Bucket owners need not specify this parameter in their
12065
- # requests. For information about downloading objects from Requester
12066
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
12067
- # in the *Amazon S3 User Guide*.
12382
+ # requests. If either the source or destination Amazon S3 bucket has
12383
+ # Requester Pays enabled, the requester will pay for corresponding
12384
+ # charges to copy the object. For information about downloading
12385
+ # objects from Requester Pays buckets, see [Downloading Objects in
12386
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
12068
12387
  #
12069
12388
  #
12070
12389
  #
@@ -12157,6 +12476,49 @@ module Aws::S3
12157
12476
  include Aws::Structure
12158
12477
  end
12159
12478
 
12479
+ # Specifies the restoration status of an object. Objects in certain
12480
+ # storage classes must be restored before they can be retrieved. For
12481
+ # more information about these storage classes and how to work with
12482
+ # archived objects, see [ Working with archived objects][1] in the
12483
+ # *Amazon S3 User Guide*.
12484
+ #
12485
+ #
12486
+ #
12487
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/archived-objects.html
12488
+ #
12489
+ # @!attribute [rw] is_restore_in_progress
12490
+ # Specifies whether the object is currently being restored. If the
12491
+ # object restoration is in progress, the header returns the value
12492
+ # `TRUE`. For example:
12493
+ #
12494
+ # `x-amz-optional-object-attributes: IsRestoreInProgress="true"`
12495
+ #
12496
+ # If the object restoration has completed, the header returns the
12497
+ # value `FALSE`. For example:
12498
+ #
12499
+ # `x-amz-optional-object-attributes: IsRestoreInProgress="false",
12500
+ # RestoreExpiryDate="2012-12-21T00:00:00.000Z"`
12501
+ #
12502
+ # If the object hasn't been restored, there is no header response.
12503
+ # @return [Boolean]
12504
+ #
12505
+ # @!attribute [rw] restore_expiry_date
12506
+ # Indicates when the restored copy will expire. This value is
12507
+ # populated only if the object has already been restored. For example:
12508
+ #
12509
+ # `x-amz-optional-object-attributes: IsRestoreInProgress="false",
12510
+ # RestoreExpiryDate="2012-12-21T00:00:00.000Z"`
12511
+ # @return [Time]
12512
+ #
12513
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/RestoreStatus AWS API Documentation
12514
+ #
12515
+ class RestoreStatus < Struct.new(
12516
+ :is_restore_in_progress,
12517
+ :restore_expiry_date)
12518
+ SENSITIVE = []
12519
+ include Aws::Structure
12520
+ end
12521
+
12160
12522
  # Specifies the redirect behavior and when a redirect is applied. For
12161
12523
  # more information about routing rules, see [Configuring advanced
12162
12524
  # conditional redirects][1] in the *Amazon S3 User Guide*.
@@ -12261,8 +12623,8 @@ module Aws::S3
12261
12623
  # Specifies the days since the initiation of an incomplete multipart
12262
12624
  # upload that Amazon S3 will wait before permanently removing all
12263
12625
  # parts of the upload. For more information, see [ Aborting Incomplete
12264
- # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
12265
- # S3 User Guide*.
12626
+ # Multipart Uploads Using a Bucket Lifecycle Configuration][1] in the
12627
+ # *Amazon S3 User Guide*.
12266
12628
  #
12267
12629
  #
12268
12630
  #
@@ -12353,9 +12715,9 @@ module Aws::S3
12353
12715
  # Specifies the use of SSE-KMS to encrypt delivered inventory reports.
12354
12716
  #
12355
12717
  # @!attribute [rw] key_id
12356
- # Specifies the ID of the Amazon Web Services Key Management Service
12357
- # (Amazon Web Services KMS) symmetric customer managed key to use for
12358
- # encrypting inventory reports.
12718
+ # Specifies the ID of the Key Management Service (KMS) symmetric
12719
+ # encryption customer managed key to use for encrypting inventory
12720
+ # reports.
12359
12721
  # @return [String]
12360
12722
  #
12361
12723
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SSEKMS AWS API Documentation
@@ -12593,23 +12955,27 @@ module Aws::S3
12593
12955
  # parameter is allowed if and only if `SSEAlgorithm` is set to
12594
12956
  # `aws:kms`.
12595
12957
  #
12596
- # You can specify the key ID or the Amazon Resource Name (ARN) of the
12597
- # KMS key. However, if you are using encryption with cross-account or
12598
- # Amazon Web Services service operations you must use a fully
12599
- # qualified KMS key ARN. For more information, see [Using encryption
12600
- # for cross-account operations][1].
12601
- #
12602
- # **For example:**
12958
+ # You can specify the key ID, key alias, or the Amazon Resource Name
12959
+ # (ARN) of the KMS key.
12603
12960
  #
12604
12961
  # * Key ID: `1234abcd-12ab-34cd-56ef-1234567890ab`
12605
12962
  #
12606
12963
  # * Key ARN:
12607
12964
  # `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
12608
12965
  #
12609
- # Amazon S3 only supports symmetric KMS keys and not asymmetric KMS
12610
- # keys. For more information, see [Using symmetric and asymmetric
12611
- # keys][2] in the *Amazon Web Services Key Management Service
12612
- # Developer Guide*.
12966
+ # * Key Alias: `alias/alias-name`
12967
+ #
12968
+ # If you use a key ID, you can run into a LogDestination undeliverable
12969
+ # error when creating a VPC flow log.
12970
+ #
12971
+ # If you are using encryption with cross-account or Amazon Web
12972
+ # Services service operations you must use a fully qualified KMS key
12973
+ # ARN. For more information, see [Using encryption for cross-account
12974
+ # operations][1].
12975
+ #
12976
+ # Amazon S3 only supports symmetric encryption KMS keys. For more
12977
+ # information, see [Asymmetric keys in Amazon Web Services KMS][2] in
12978
+ # the *Amazon Web Services Key Management Service Developer Guide*.
12613
12979
  #
12614
12980
  #
12615
12981
  #
@@ -12925,12 +13291,12 @@ module Aws::S3
12925
13291
  #
12926
13292
  # @!attribute [rw] filter
12927
13293
  # Specifies object key name filtering rules. For information about key
12928
- # name filtering, see [Configuring Event Notifications][1] in the
12929
- # *Amazon S3 User Guide*.
13294
+ # name filtering, see [Configuring event notifications using object
13295
+ # key name filtering][1] in the *Amazon S3 User Guide*.
12930
13296
  #
12931
13297
  #
12932
13298
  #
12933
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
13299
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-how-to-filtering.html
12934
13300
  # @return [Types::NotificationConfigurationFilter]
12935
13301
  #
12936
13302
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/TopicConfiguration AWS API Documentation
@@ -13029,7 +13395,7 @@ module Aws::S3
13029
13395
  #
13030
13396
  # @!attribute [rw] server_side_encryption
13031
13397
  # The server-side encryption algorithm used when storing this object
13032
- # in Amazon S3 (for example, AES256, aws:kms).
13398
+ # in Amazon S3 (for example, `AES256`, `aws:kms`).
13033
13399
  # @return [String]
13034
13400
  #
13035
13401
  # @!attribute [rw] sse_customer_algorithm
@@ -13046,14 +13412,15 @@ module Aws::S3
13046
13412
  # @return [String]
13047
13413
  #
13048
13414
  # @!attribute [rw] ssekms_key_id
13049
- # If present, specifies the ID of the Amazon Web Services Key
13050
- # Management Service (Amazon Web Services KMS) symmetric customer
13051
- # managed key that was used for the object.
13415
+ # If present, specifies the ID of the Key Management Service (KMS)
13416
+ # symmetric encryption customer managed key that was used for the
13417
+ # object.
13052
13418
  # @return [String]
13053
13419
  #
13054
13420
  # @!attribute [rw] bucket_key_enabled
13055
13421
  # Indicates whether the multipart upload uses an S3 Bucket Key for
13056
- # server-side encryption with Amazon Web Services KMS (SSE-KMS).
13422
+ # server-side encryption with Key Management Service (KMS) keys
13423
+ # (SSE-KMS).
13057
13424
  # @return [Boolean]
13058
13425
  #
13059
13426
  # @!attribute [rw] request_charged
@@ -13088,14 +13455,14 @@ module Aws::S3
13088
13455
  # bucket name. For more information about access point ARNs, see
13089
13456
  # [Using access points][1] in the *Amazon S3 User Guide*.
13090
13457
  #
13091
- # When using this action with Amazon S3 on Outposts, you must direct
13458
+ # When you use this action with Amazon S3 on Outposts, you must direct
13092
13459
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
13093
13460
  # takes the form `
13094
13461
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
13095
- # When using this action with S3 on Outposts through the Amazon Web
13096
- # Services SDKs, you provide the Outposts bucket ARN in place of the
13097
- # bucket name. For more information about S3 on Outposts ARNs, see
13098
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
13462
+ # When you use this action with S3 on Outposts through the Amazon Web
13463
+ # Services SDKs, you provide the Outposts access point ARN in place of
13464
+ # the bucket name. For more information about S3 on Outposts ARNs, see
13465
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
13099
13466
  #
13100
13467
  #
13101
13468
  #
@@ -13233,9 +13600,11 @@ module Aws::S3
13233
13600
  # @!attribute [rw] request_payer
13234
13601
  # Confirms that the requester knows that they will be charged for the
13235
13602
  # request. Bucket owners need not specify this parameter in their
13236
- # requests. For information about downloading objects from Requester
13237
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
13238
- # in the *Amazon S3 User Guide*.
13603
+ # requests. If either the source or destination Amazon S3 bucket has
13604
+ # Requester Pays enabled, the requester will pay for corresponding
13605
+ # charges to copy the object. For information about downloading
13606
+ # objects from Requester Pays buckets, see [Downloading Objects in
13607
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
13239
13608
  #
13240
13609
  #
13241
13610
  #
@@ -13282,7 +13651,7 @@ module Aws::S3
13282
13651
 
13283
13652
  # @!attribute [rw] server_side_encryption
13284
13653
  # The server-side encryption algorithm used when storing this object
13285
- # in Amazon S3 (for example, AES256, aws:kms).
13654
+ # in Amazon S3 (for example, `AES256`, `aws:kms`).
13286
13655
  # @return [String]
13287
13656
  #
13288
13657
  # @!attribute [rw] etag
@@ -13355,14 +13724,14 @@ module Aws::S3
13355
13724
  # @return [String]
13356
13725
  #
13357
13726
  # @!attribute [rw] ssekms_key_id
13358
- # If present, specifies the ID of the Amazon Web Services Key
13359
- # Management Service (Amazon Web Services KMS) symmetric customer
13360
- # managed key was used for the object.
13727
+ # If present, specifies the ID of the Key Management Service (KMS)
13728
+ # symmetric encryption customer managed key was used for the object.
13361
13729
  # @return [String]
13362
13730
  #
13363
13731
  # @!attribute [rw] bucket_key_enabled
13364
13732
  # Indicates whether the multipart upload uses an S3 Bucket Key for
13365
- # server-side encryption with Amazon Web Services KMS (SSE-KMS).
13733
+ # server-side encryption with Key Management Service (KMS) keys
13734
+ # (SSE-KMS).
13366
13735
  # @return [Boolean]
13367
13736
  #
13368
13737
  # @!attribute [rw] request_charged
@@ -13404,14 +13773,14 @@ module Aws::S3
13404
13773
  # bucket name. For more information about access point ARNs, see
13405
13774
  # [Using access points][1] in the *Amazon S3 User Guide*.
13406
13775
  #
13407
- # When using this action with Amazon S3 on Outposts, you must direct
13776
+ # When you use this action with Amazon S3 on Outposts, you must direct
13408
13777
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
13409
13778
  # takes the form `
13410
13779
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
13411
- # When using this action with S3 on Outposts through the Amazon Web
13412
- # Services SDKs, you provide the Outposts bucket ARN in place of the
13413
- # bucket name. For more information about S3 on Outposts ARNs, see
13414
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
13780
+ # When you use this action with S3 on Outposts through the Amazon Web
13781
+ # Services SDKs, you provide the Outposts access point ARN in place of
13782
+ # the bucket name. For more information about S3 on Outposts ARNs, see
13783
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
13415
13784
  #
13416
13785
  #
13417
13786
  #
@@ -13536,9 +13905,11 @@ module Aws::S3
13536
13905
  # @!attribute [rw] request_payer
13537
13906
  # Confirms that the requester knows that they will be charged for the
13538
13907
  # request. Bucket owners need not specify this parameter in their
13539
- # requests. For information about downloading objects from Requester
13540
- # Pays buckets, see [Downloading Objects in Requester Pays Buckets][1]
13541
- # in the *Amazon S3 User Guide*.
13908
+ # requests. If either the source or destination Amazon S3 bucket has
13909
+ # Requester Pays enabled, the requester will pay for corresponding
13910
+ # charges to copy the object. For information about downloading
13911
+ # objects from Requester Pays buckets, see [Downloading Objects in
13912
+ # Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
13542
13913
  #
13543
13914
  #
13544
13915
  #
@@ -13651,9 +14022,7 @@ module Aws::S3
13651
14022
  #
13652
14023
  # @!attribute [rw] status_code
13653
14024
  # The integer status code for an HTTP response of a corresponding
13654
- # `GetObject` request.
13655
- #
13656
- # **Status Codes**
14025
+ # `GetObject` request. The following is a list of status codes.
13657
14026
  #
13658
14027
  # * `200 - OK`
13659
14028
  #
@@ -13895,7 +14264,7 @@ module Aws::S3
13895
14264
  #
13896
14265
  # @!attribute [rw] server_side_encryption
13897
14266
  # The server-side encryption algorithm used when storing requested
13898
- # object in Amazon S3 (for example, AES256, aws:kms).
14267
+ # object in Amazon S3 (for example, AES256, `aws:kms`).
13899
14268
  # @return [String]
13900
14269
  #
13901
14270
  # @!attribute [rw] sse_customer_algorithm
@@ -13905,9 +14274,10 @@ module Aws::S3
13905
14274
  # @return [String]
13906
14275
  #
13907
14276
  # @!attribute [rw] ssekms_key_id
13908
- # If present, specifies the ID of the Amazon Web Services Key
13909
- # Management Service (Amazon Web Services KMS) symmetric customer
13910
- # managed key that was used for stored in Amazon S3 object.
14277
+ # If present, specifies the ID (Key ID, Key ARN, or Key Alias) of the
14278
+ # Amazon Web Services Key Management Service (Amazon Web Services KMS)
14279
+ # symmetric encryption customer managed key that was used for stored
14280
+ # in Amazon S3 object.
13911
14281
  # @return [String]
13912
14282
  #
13913
14283
  # @!attribute [rw] sse_customer_key_md5