aws-sdk-s3 1.178.0 → 1.183.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -59,34 +59,36 @@ module Aws::S3
59
59
  # requests are not supported. Directory bucket names must be unique in
60
60
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
61
61
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
62
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
62
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
63
63
  # naming restrictions, see [Directory bucket naming rules][1] in the
64
64
  # *Amazon S3 User Guide*.
65
65
  #
66
- # **Access points** - When you use this action with an access point,
67
- # you must provide the alias of the access point in place of the
68
- # bucket name or specify the access point ARN. When using the access
69
- # point ARN, you must direct requests to the access point hostname.
70
- # The access point hostname takes the form
66
+ # **Access points** - When you use this action with an access point
67
+ # for general purpose buckets, you must provide the alias of the
68
+ # access point in place of the bucket name or specify the access point
69
+ # ARN. When you use this action with an access point for directory
70
+ # buckets, you must provide the access point name in place of the
71
+ # bucket name. When using the access point ARN, you must direct
72
+ # requests to the access point hostname. The access point hostname
73
+ # takes the form
71
74
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
72
75
  # When using this action with an access point through the Amazon Web
73
76
  # Services SDKs, you provide the access point ARN in place of the
74
77
  # bucket name. For more information about access point ARNs, see
75
78
  # [Using access points][2] in the *Amazon S3 User Guide*.
76
79
  #
77
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
78
- # directory buckets.
80
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
79
81
  #
80
82
  # </note>
81
83
  #
82
- # **S3 on Outposts** - When you use this action with Amazon S3 on
83
- # Outposts, you must direct requests to the S3 on Outposts hostname.
84
- # The S3 on Outposts hostname takes the form `
84
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
85
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
86
+ # Outposts hostname takes the form `
85
87
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
86
- # When you use this action with S3 on Outposts through the Amazon Web
87
- # Services SDKs, you provide the Outposts access point ARN in place of
88
- # the bucket name. For more information about S3 on Outposts ARNs, see
89
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
88
+ # When you use this action with S3 on Outposts, the destination bucket
89
+ # must be the Outposts access point ARN or the access point alias. For
90
+ # more information about S3 on Outposts, see [What is S3 on
91
+ # Outposts?][3] in the *Amazon S3 User Guide*.
90
92
  #
91
93
  #
92
94
  #
@@ -655,7 +657,7 @@ module Aws::S3
655
657
  # Contains all the possible checksum or digest values for an object.
656
658
  #
657
659
  # @!attribute [rw] checksum_crc32
658
- # The Base64 encoded, 32-bit `CRC-32 checksum` of the object. This
660
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
659
661
  # checksum is only be present if the checksum was uploaded with the
660
662
  # object. When you use an API operation on an object that was uploaded
661
663
  # using multipart uploads, this value may not be a direct checksum
@@ -670,7 +672,7 @@ module Aws::S3
670
672
  # @return [String]
671
673
  #
672
674
  # @!attribute [rw] checksum_crc32c
673
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the object. This
675
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
674
676
  # checksum is only present if the checksum was uploaded with the
675
677
  # object. When you use an API operation on an object that was uploaded
676
678
  # using multipart uploads, this value may not be a direct checksum
@@ -685,10 +687,10 @@ module Aws::S3
685
687
  # @return [String]
686
688
  #
687
689
  # @!attribute [rw] checksum_crc64nvme
688
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the object. This
689
- # checksum is present if the object was uploaded with the `CRC-64NVME`
690
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. This
691
+ # checksum is present if the object was uploaded with the `CRC64NVME`
690
692
  # checksum algorithm, or if the object was uploaded without a checksum
691
- # (and Amazon S3 added the default checksum, `CRC-64NVME`, to the
693
+ # (and Amazon S3 added the default checksum, `CRC64NVME`, to the
692
694
  # uploaded object). For more information, see [Checking object
693
695
  # integrity][1] in the *Amazon S3 User Guide*.
694
696
  #
@@ -698,7 +700,7 @@ module Aws::S3
698
700
  # @return [String]
699
701
  #
700
702
  # @!attribute [rw] checksum_sha1
701
- # The Base64 encoded, 160-bit `SHA-1` digest of the object. This will
703
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
702
704
  # only be present if the object was uploaded with the object. When you
703
705
  # use the API operation on an object that was uploaded using multipart
704
706
  # uploads, this value may not be a direct checksum value of the full
@@ -713,14 +715,14 @@ module Aws::S3
713
715
  # @return [String]
714
716
  #
715
717
  # @!attribute [rw] checksum_sha256
716
- # The Base64 encoded, 256-bit `SHA-256` digest of the object. This
717
- # will only be present if the object was uploaded with the object.
718
- # When you use an API operation on an object that was uploaded using
719
- # multipart uploads, this value may not be a direct checksum value of
720
- # the full object. Instead, it's a calculation based on the checksum
721
- # values of each individual part. For more information about how
722
- # checksums are calculated with multipart uploads, see [ Checking
723
- # object integrity][1] in the *Amazon S3 User Guide*.
718
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
719
+ # only be present if the object was uploaded with the object. When you
720
+ # use an API operation on an object that was uploaded using multipart
721
+ # uploads, this value may not be a direct checksum value of the full
722
+ # object. Instead, it's a calculation based on the checksum values of
723
+ # each individual part. For more information about how checksums are
724
+ # calculated with multipart uploads, see [ Checking object
725
+ # integrity][1] in the *Amazon S3 User Guide*.
724
726
  #
725
727
  #
726
728
  #
@@ -849,7 +851,7 @@ module Aws::S3
849
851
  # @return [String]
850
852
  #
851
853
  # @!attribute [rw] checksum_crc32
852
- # The Base64 encoded, 32-bit `CRC-32 checksum` of the object. This
854
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
853
855
  # checksum is only be present if the checksum was uploaded with the
854
856
  # object. When you use an API operation on an object that was uploaded
855
857
  # using multipart uploads, this value may not be a direct checksum
@@ -864,7 +866,7 @@ module Aws::S3
864
866
  # @return [String]
865
867
  #
866
868
  # @!attribute [rw] checksum_crc32c
867
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the object. This
869
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
868
870
  # checksum is only present if the checksum was uploaded with the
869
871
  # object. When you use an API operation on an object that was uploaded
870
872
  # using multipart uploads, this value may not be a direct checksum
@@ -881,8 +883,8 @@ module Aws::S3
881
883
  # @!attribute [rw] checksum_crc64nvme
882
884
  # This header can be used as a data integrity check to verify that the
883
885
  # data received is the same data that was originally sent. This header
884
- # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
885
- # object. The `CRC-64NVME` checksum is always a full object checksum.
886
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
887
+ # object. The `CRC64NVME` checksum is always a full object checksum.
886
888
  # For more information, see [Checking object integrity in the Amazon
887
889
  # S3 User Guide][1].
888
890
  #
@@ -892,7 +894,7 @@ module Aws::S3
892
894
  # @return [String]
893
895
  #
894
896
  # @!attribute [rw] checksum_sha1
895
- # The Base64 encoded, 160-bit `SHA-1` digest of the object. This will
897
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
896
898
  # only be present if the object was uploaded with the object. When you
897
899
  # use the API operation on an object that was uploaded using multipart
898
900
  # uploads, this value may not be a direct checksum value of the full
@@ -907,14 +909,14 @@ module Aws::S3
907
909
  # @return [String]
908
910
  #
909
911
  # @!attribute [rw] checksum_sha256
910
- # The Base64 encoded, 256-bit `SHA-256` digest of the object. This
911
- # will only be present if the object was uploaded with the object.
912
- # When you use an API operation on an object that was uploaded using
913
- # multipart uploads, this value may not be a direct checksum value of
914
- # the full object. Instead, it's a calculation based on the checksum
915
- # values of each individual part. For more information about how
916
- # checksums are calculated with multipart uploads, see [ Checking
917
- # object integrity][1] in the *Amazon S3 User Guide*.
912
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
913
+ # only be present if the object was uploaded with the object. When you
914
+ # use an API operation on an object that was uploaded using multipart
915
+ # uploads, this value may not be a direct checksum value of the full
916
+ # object. Instead, it's a calculation based on the checksum values of
917
+ # each individual part. For more information about how checksums are
918
+ # calculated with multipart uploads, see [ Checking object
919
+ # integrity][1] in the *Amazon S3 User Guide*.
918
920
  #
919
921
  #
920
922
  #
@@ -1001,34 +1003,36 @@ module Aws::S3
1001
1003
  # requests are not supported. Directory bucket names must be unique in
1002
1004
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
1003
1005
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
1004
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1006
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
1005
1007
  # naming restrictions, see [Directory bucket naming rules][1] in the
1006
1008
  # *Amazon S3 User Guide*.
1007
1009
  #
1008
- # **Access points** - When you use this action with an access point,
1009
- # you must provide the alias of the access point in place of the
1010
- # bucket name or specify the access point ARN. When using the access
1011
- # point ARN, you must direct requests to the access point hostname.
1012
- # The access point hostname takes the form
1010
+ # **Access points** - When you use this action with an access point
1011
+ # for general purpose buckets, you must provide the alias of the
1012
+ # access point in place of the bucket name or specify the access point
1013
+ # ARN. When you use this action with an access point for directory
1014
+ # buckets, you must provide the access point name in place of the
1015
+ # bucket name. When using the access point ARN, you must direct
1016
+ # requests to the access point hostname. The access point hostname
1017
+ # takes the form
1013
1018
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
1014
1019
  # When using this action with an access point through the Amazon Web
1015
1020
  # Services SDKs, you provide the access point ARN in place of the
1016
1021
  # bucket name. For more information about access point ARNs, see
1017
1022
  # [Using access points][2] in the *Amazon S3 User Guide*.
1018
1023
  #
1019
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
1020
- # directory buckets.
1024
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
1021
1025
  #
1022
1026
  # </note>
1023
1027
  #
1024
- # **S3 on Outposts** - When you use this action with Amazon S3 on
1025
- # Outposts, you must direct requests to the S3 on Outposts hostname.
1026
- # The S3 on Outposts hostname takes the form `
1028
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
1029
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
1030
+ # Outposts hostname takes the form `
1027
1031
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1028
- # When you use this action with S3 on Outposts through the Amazon Web
1029
- # Services SDKs, you provide the Outposts access point ARN in place of
1030
- # the bucket name. For more information about S3 on Outposts ARNs, see
1031
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
1032
+ # When you use this action with S3 on Outposts, the destination bucket
1033
+ # must be the Outposts access point ARN or the access point alias. For
1034
+ # more information about S3 on Outposts, see [What is S3 on
1035
+ # Outposts?][3] in the *Amazon S3 User Guide*.
1032
1036
  #
1033
1037
  #
1034
1038
  #
@@ -1052,9 +1056,9 @@ module Aws::S3
1052
1056
  # @!attribute [rw] checksum_crc32
1053
1057
  # This header can be used as a data integrity check to verify that the
1054
1058
  # data received is the same data that was originally sent. This header
1055
- # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the
1056
- # object. For more information, see [Checking object integrity][1] in
1057
- # the *Amazon S3 User Guide*.
1059
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
1060
+ # For more information, see [Checking object integrity][1] in the
1061
+ # *Amazon S3 User Guide*.
1058
1062
  #
1059
1063
  #
1060
1064
  #
@@ -1064,7 +1068,7 @@ module Aws::S3
1064
1068
  # @!attribute [rw] checksum_crc32c
1065
1069
  # This header can be used as a data integrity check to verify that the
1066
1070
  # data received is the same data that was originally sent. This header
1067
- # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the
1071
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the
1068
1072
  # object. For more information, see [Checking object integrity][1] in
1069
1073
  # the *Amazon S3 User Guide*.
1070
1074
  #
@@ -1076,8 +1080,8 @@ module Aws::S3
1076
1080
  # @!attribute [rw] checksum_crc64nvme
1077
1081
  # This header can be used as a data integrity check to verify that the
1078
1082
  # data received is the same data that was originally sent. This header
1079
- # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
1080
- # object. The `CRC-64NVME` checksum is always a full object checksum.
1083
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
1084
+ # object. The `CRC64NVME` checksum is always a full object checksum.
1081
1085
  # For more information, see [Checking object integrity in the Amazon
1082
1086
  # S3 User Guide][1].
1083
1087
  #
@@ -1089,7 +1093,7 @@ module Aws::S3
1089
1093
  # @!attribute [rw] checksum_sha1
1090
1094
  # This header can be used as a data integrity check to verify that the
1091
1095
  # data received is the same data that was originally sent. This header
1092
- # specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
1096
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object.
1093
1097
  # For more information, see [Checking object integrity][1] in the
1094
1098
  # *Amazon S3 User Guide*.
1095
1099
  #
@@ -1101,9 +1105,9 @@ module Aws::S3
1101
1105
  # @!attribute [rw] checksum_sha256
1102
1106
  # This header can be used as a data integrity check to verify that the
1103
1107
  # data received is the same data that was originally sent. This header
1104
- # specifies the Base64 encoded, 256-bit `SHA-256` digest of the
1105
- # object. For more information, see [Checking object integrity][1] in
1106
- # the *Amazon S3 User Guide*.
1108
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
1109
+ # For more information, see [Checking object integrity][1] in the
1110
+ # *Amazon S3 User Guide*.
1107
1111
  #
1108
1112
  #
1109
1113
  #
@@ -1292,9 +1296,9 @@ module Aws::S3
1292
1296
  # @return [String]
1293
1297
  #
1294
1298
  # @!attribute [rw] checksum_crc32
1295
- # The Base64 encoded, 32-bit `CRC-32` checksum of the part. This
1299
+ # The Base64 encoded, 32-bit `CRC32` checksum of the part. This
1296
1300
  # checksum is present if the multipart upload request was created with
1297
- # the `CRC-32` checksum algorithm. For more information, see [Checking
1301
+ # the `CRC32` checksum algorithm. For more information, see [Checking
1298
1302
  # object integrity][1] in the *Amazon S3 User Guide*.
1299
1303
  #
1300
1304
  #
@@ -1303,10 +1307,10 @@ module Aws::S3
1303
1307
  # @return [String]
1304
1308
  #
1305
1309
  # @!attribute [rw] checksum_crc32c
1306
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the part. This
1310
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the part. This
1307
1311
  # checksum is present if the multipart upload request was created with
1308
- # the `CRC-32C` checksum algorithm. For more information, see
1309
- # [Checking object integrity][1] in the *Amazon S3 User Guide*.
1312
+ # the `CRC32C` checksum algorithm. For more information, see [Checking
1313
+ # object integrity][1] in the *Amazon S3 User Guide*.
1310
1314
  #
1311
1315
  #
1312
1316
  #
@@ -1314,11 +1318,11 @@ module Aws::S3
1314
1318
  # @return [String]
1315
1319
  #
1316
1320
  # @!attribute [rw] checksum_crc64nvme
1317
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the part. This
1321
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This
1318
1322
  # checksum is present if the multipart upload request was created with
1319
- # the `CRC-64NVME` checksum algorithm to the uploaded object). For
1320
- # more information, see [Checking object integrity][1] in the *Amazon
1321
- # S3 User Guide*.
1323
+ # the `CRC64NVME` checksum algorithm to the uploaded object). For more
1324
+ # information, see [Checking object integrity][1] in the *Amazon S3
1325
+ # User Guide*.
1322
1326
  #
1323
1327
  #
1324
1328
  #
@@ -1326,9 +1330,9 @@ module Aws::S3
1326
1330
  # @return [String]
1327
1331
  #
1328
1332
  # @!attribute [rw] checksum_sha1
1329
- # The Base64 encoded, 160-bit `SHA-1` checksum of the part. This
1333
+ # The Base64 encoded, 160-bit `SHA1` checksum of the part. This
1330
1334
  # checksum is present if the multipart upload request was created with
1331
- # the `SHA-1` checksum algorithm. For more information, see [Checking
1335
+ # the `SHA1` checksum algorithm. For more information, see [Checking
1332
1336
  # object integrity][1] in the *Amazon S3 User Guide*.
1333
1337
  #
1334
1338
  #
@@ -1337,10 +1341,10 @@ module Aws::S3
1337
1341
  # @return [String]
1338
1342
  #
1339
1343
  # @!attribute [rw] checksum_sha256
1340
- # The Base64 encoded, 256-bit `SHA-256` checksum of the part. This
1344
+ # The Base64 encoded, 256-bit `SHA256` checksum of the part. This
1341
1345
  # checksum is present if the multipart upload request was created with
1342
- # the `SHA-256` checksum algorithm. For more information, see
1343
- # [Checking object integrity][1] in the *Amazon S3 User Guide*.
1346
+ # the `SHA256` checksum algorithm. For more information, see [Checking
1347
+ # object integrity][1] in the *Amazon S3 User Guide*.
1344
1348
  #
1345
1349
  #
1346
1350
  #
@@ -1577,7 +1581,7 @@ module Aws::S3
1577
1581
  # requests are not supported. Directory bucket names must be unique in
1578
1582
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
1579
1583
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
1580
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
1584
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
1581
1585
  # naming restrictions, see [Directory bucket naming rules][1] in the
1582
1586
  # *Amazon S3 User Guide*.
1583
1587
  #
@@ -1589,30 +1593,37 @@ module Aws::S3
1589
1593
  #
1590
1594
  # </note>
1591
1595
  #
1592
- # **Access points** - When you use this action with an access point,
1593
- # you must provide the alias of the access point in place of the
1594
- # bucket name or specify the access point ARN. When using the access
1595
- # point ARN, you must direct requests to the access point hostname.
1596
- # The access point hostname takes the form
1596
+ # **Access points** - When you use this action with an access point
1597
+ # for general purpose buckets, you must provide the alias of the
1598
+ # access point in place of the bucket name or specify the access point
1599
+ # ARN. When you use this action with an access point for directory
1600
+ # buckets, you must provide the access point name in place of the
1601
+ # bucket name. When using the access point ARN, you must direct
1602
+ # requests to the access point hostname. The access point hostname
1603
+ # takes the form
1597
1604
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
1598
1605
  # When using this action with an access point through the Amazon Web
1599
1606
  # Services SDKs, you provide the access point ARN in place of the
1600
1607
  # bucket name. For more information about access point ARNs, see
1601
1608
  # [Using access points][2] in the *Amazon S3 User Guide*.
1602
1609
  #
1603
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
1604
- # directory buckets.
1610
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
1605
1611
  #
1606
1612
  # </note>
1607
1613
  #
1608
- # **S3 on Outposts** - When you use this action with Amazon S3 on
1609
- # Outposts, you must direct requests to the S3 on Outposts hostname.
1610
- # The S3 on Outposts hostname takes the form `
1614
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
1615
+ # you must use the Outpost bucket access point ARN or the access point
1616
+ # alias for the destination bucket. You can only copy objects within
1617
+ # the same Outpost bucket. It's not supported to copy objects across
1618
+ # different Amazon Web Services Outposts, between buckets on the same
1619
+ # Outposts, or between Outposts buckets and any other bucket types.
1620
+ # For more information about S3 on Outposts, see [What is S3 on
1621
+ # Outposts?][3] in the *S3 on Outposts guide*. When you use this
1622
+ # action with S3 on Outposts through the REST API, you must direct
1623
+ # requests to the S3 on Outposts hostname, in the format `
1611
1624
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1612
- # When you use this action with S3 on Outposts through the Amazon Web
1613
- # Services SDKs, you provide the Outposts access point ARN in place of
1614
- # the bucket name. For more information about S3 on Outposts ARNs, see
1615
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
1625
+ # The hostname isn't required when you use the Amazon Web Services
1626
+ # CLI or SDKs.
1616
1627
  #
1617
1628
  #
1618
1629
  #
@@ -2025,11 +2036,12 @@ module Aws::S3
2025
2036
  # availability. Depending on performance needs, you can specify a
2026
2037
  # different Storage Class.
2027
2038
  #
2028
- # <note markdown="1"> * <b>Directory buckets </b> - For directory buckets, only the S3
2029
- # Express One Zone storage class is supported to store newly created
2030
- # objects. Unsupported storage class values won't write a
2031
- # destination object and will respond with the HTTP status code `400
2032
- # Bad Request`.
2039
+ # <note markdown="1"> * <b>Directory buckets </b> - Directory buckets only support
2040
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
2041
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
2042
+ # Access storage class) in Dedicated Local Zones. Unsupported
2043
+ # storage class values won't write a destination object and will
2044
+ # respond with the HTTP status code `400 Bad Request`.
2033
2045
  #
2034
2046
  # * <b>Amazon S3 on Outposts </b> - S3 on Outposts only uses the
2035
2047
  # `OUTPOSTS` Storage Class.
@@ -2129,21 +2141,17 @@ module Aws::S3
2129
2141
  # Signature Version in Request Authentication][1] in the *Amazon S3
2130
2142
  # User Guide*.
2131
2143
  #
2132
- # **Directory buckets** - If you specify
2133
- # `x-amz-server-side-encryption` with `aws:kms`, the `
2134
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
2135
- # assigned the ID of the KMS symmetric encryption customer managed key
2136
- # that's configured for your directory bucket's default encryption
2137
- # setting. If you want to specify the `
2138
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
2139
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
2140
- # customer managed key that's configured for your directory bucket's
2141
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
2142
- # Request` error. Only use the key ID or key ARN. The key alias format
2143
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
2144
- # support 1 [customer managed key][2] per directory bucket for the
2145
- # lifetime of the bucket. The [Amazon Web Services managed key][3]
2146
- # (`aws/s3`) isn't supported.
2144
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
2145
+ # recommended to specify the `x-amz-server-side-encryption` header to
2146
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
2147
+ # header implicitly uses the bucket's default KMS customer managed
2148
+ # key ID. If you want to explicitly set the `
2149
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
2150
+ # the bucket's default customer managed key (using key ID or ARN, not
2151
+ # alias). Your SSE-KMS configuration can only support 1 [customer
2152
+ # managed key][2] per directory bucket's lifetime. The [Amazon Web
2153
+ # Services managed key][3] (`aws/s3`) isn't supported. Incorrect key
2154
+ # specification results in an HTTP `400 Bad Request` error.
2147
2155
  #
2148
2156
  #
2149
2157
  #
@@ -2428,7 +2436,7 @@ module Aws::S3
2428
2436
  # @return [String]
2429
2437
  #
2430
2438
  # @!attribute [rw] checksum_crc32
2431
- # The Base64 encoded, 32-bit `CRC-32` checksum of the object. This
2439
+ # The Base64 encoded, 32-bit `CRC32` checksum of the object. This
2432
2440
  # checksum is only present if the object was uploaded with the object.
2433
2441
  # For more information, see [ Checking object integrity][1] in the
2434
2442
  # *Amazon S3 User Guide*.
@@ -2439,7 +2447,7 @@ module Aws::S3
2439
2447
  # @return [String]
2440
2448
  #
2441
2449
  # @!attribute [rw] checksum_crc32c
2442
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the object. This
2450
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
2443
2451
  # will only be present if the object was uploaded with the object. For
2444
2452
  # more information, see [ Checking object integrity][1] in the *Amazon
2445
2453
  # S3 User Guide*.
@@ -2450,11 +2458,11 @@ module Aws::S3
2450
2458
  # @return [String]
2451
2459
  #
2452
2460
  # @!attribute [rw] checksum_crc64nvme
2453
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the object. This
2461
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. This
2454
2462
  # checksum is present if the object being copied was uploaded with the
2455
- # `CRC-64NVME` checksum algorithm, or if the object was uploaded
2463
+ # `CRC64NVME` checksum algorithm, or if the object was uploaded
2456
2464
  # without a checksum (and Amazon S3 added the default checksum,
2457
- # `CRC-64NVME`, to the uploaded object). For more information, see
2465
+ # `CRC64NVME`, to the uploaded object). For more information, see
2458
2466
  # [Checking object integrity][1] in the *Amazon S3 User Guide*.
2459
2467
  #
2460
2468
  #
@@ -2463,7 +2471,7 @@ module Aws::S3
2463
2471
  # @return [String]
2464
2472
  #
2465
2473
  # @!attribute [rw] checksum_sha1
2466
- # The Base64 encoded, 160-bit `SHA-1` digest of the object. This will
2474
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
2467
2475
  # only be present if the object was uploaded with the object. For more
2468
2476
  # information, see [ Checking object integrity][1] in the *Amazon S3
2469
2477
  # User Guide*.
@@ -2474,10 +2482,10 @@ module Aws::S3
2474
2482
  # @return [String]
2475
2483
  #
2476
2484
  # @!attribute [rw] checksum_sha256
2477
- # The Base64 encoded, 256-bit `SHA-256` digest of the object. This
2478
- # will only be present if the object was uploaded with the object. For
2479
- # more information, see [ Checking object integrity][1] in the *Amazon
2480
- # S3 User Guide*.
2485
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
2486
+ # only be present if the object was uploaded with the object. For more
2487
+ # information, see [ Checking object integrity][1] in the *Amazon S3
2488
+ # User Guide*.
2481
2489
  #
2482
2490
  #
2483
2491
  #
@@ -2512,7 +2520,7 @@ module Aws::S3
2512
2520
  # @!attribute [rw] checksum_crc32
2513
2521
  # This header can be used as a data integrity check to verify that the
2514
2522
  # data received is the same data that was originally sent. This header
2515
- # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the part.
2523
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the part.
2516
2524
  # For more information, see [Checking object integrity][1] in the
2517
2525
  # *Amazon S3 User Guide*.
2518
2526
  #
@@ -2524,7 +2532,7 @@ module Aws::S3
2524
2532
  # @!attribute [rw] checksum_crc32c
2525
2533
  # This header can be used as a data integrity check to verify that the
2526
2534
  # data received is the same data that was originally sent. This header
2527
- # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the part.
2535
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the part.
2528
2536
  # For more information, see [Checking object integrity][1] in the
2529
2537
  # *Amazon S3 User Guide*.
2530
2538
  #
@@ -2534,11 +2542,11 @@ module Aws::S3
2534
2542
  # @return [String]
2535
2543
  #
2536
2544
  # @!attribute [rw] checksum_crc64nvme
2537
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the part. This
2545
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This
2538
2546
  # checksum is present if the multipart upload request was created with
2539
- # the `CRC-64NVME` checksum algorithm to the uploaded object). For
2540
- # more information, see [Checking object integrity][1] in the *Amazon
2541
- # S3 User Guide*.
2547
+ # the `CRC64NVME` checksum algorithm to the uploaded object). For more
2548
+ # information, see [Checking object integrity][1] in the *Amazon S3
2549
+ # User Guide*.
2542
2550
  #
2543
2551
  #
2544
2552
  #
@@ -2548,7 +2556,7 @@ module Aws::S3
2548
2556
  # @!attribute [rw] checksum_sha1
2549
2557
  # This header can be used as a data integrity check to verify that the
2550
2558
  # data received is the same data that was originally sent. This header
2551
- # specifies the Base64 encoded, 160-bit `SHA-1` checksum of the part.
2559
+ # specifies the Base64 encoded, 160-bit `SHA1` checksum of the part.
2552
2560
  # For more information, see [Checking object integrity][1] in the
2553
2561
  # *Amazon S3 User Guide*.
2554
2562
  #
@@ -2560,9 +2568,9 @@ module Aws::S3
2560
2568
  # @!attribute [rw] checksum_sha256
2561
2569
  # This header can be used as a data integrity check to verify that the
2562
2570
  # data received is the same data that was originally sent. This header
2563
- # specifies the Base64 encoded, 256-bit `SHA-256` checksum of the
2564
- # part. For more information, see [Checking object integrity][1] in
2565
- # the *Amazon S3 User Guide*.
2571
+ # specifies the Base64 encoded, 256-bit `SHA256` checksum of the part.
2572
+ # For more information, see [Checking object integrity][1] in the
2573
+ # *Amazon S3 User Guide*.
2566
2574
  #
2567
2575
  #
2568
2576
  #
@@ -2590,11 +2598,14 @@ module Aws::S3
2590
2598
  # choose a Region to optimize latency, minimize costs, or address
2591
2599
  # regulatory requirements. For example, if you reside in Europe, you
2592
2600
  # will probably find it advantageous to create buckets in the Europe
2593
- # (Ireland) Region. For more information, see [Accessing a bucket][1]
2594
- # in the *Amazon S3 User Guide*.
2601
+ # (Ireland) Region.
2595
2602
  #
2596
2603
  # If you don't specify a Region, the bucket is created in the US East
2597
- # (N. Virginia) Region (us-east-1) by default.
2604
+ # (N. Virginia) Region (us-east-1) by default. Configurations using
2605
+ # the value `EU` will create a bucket in `eu-west-1`.
2606
+ #
2607
+ # For a list of the valid values for all of the Amazon Web Services
2608
+ # Regions, see [Regions and Endpoints][1].
2598
2609
  #
2599
2610
  # <note markdown="1"> This functionality is not supported for directory buckets.
2600
2611
  #
@@ -2602,17 +2613,17 @@ module Aws::S3
2602
2613
  #
2603
2614
  #
2604
2615
  #
2605
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro
2616
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
2606
2617
  # @return [String]
2607
2618
  #
2608
2619
  # @!attribute [rw] location
2609
2620
  # Specifies the location where the bucket will be created.
2610
2621
  #
2611
2622
  # <b>Directory buckets </b> - The location type is Availability Zone
2612
- # or Local Zone. When the location type is Local Zone, your Local Zone
2613
- # must be in opt-in status. Otherwise, you get an HTTP `400 Bad
2614
- # Request` error with the error code `Access denied`. To learn more
2615
- # about opt-in Local Zones, see [Opt-in Dedicated Local Zones][1]in
2623
+ # or Local Zone. To use the Local Zone location type, your account
2624
+ # must be enabled for Dedicated Local Zones. Otherwise, you get an
2625
+ # HTTP `403 Forbidden` error with the error code `AccessDenied`. To
2626
+ # learn more, see [Enable accounts for Dedicated Local Zones][1] in
2616
2627
  # the *Amazon S3 User Guide*.
2617
2628
  #
2618
2629
  # <note markdown="1"> This functionality is only supported by directory buckets.
@@ -3006,34 +3017,36 @@ module Aws::S3
3006
3017
  # requests are not supported. Directory bucket names must be unique in
3007
3018
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
3008
3019
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
3009
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
3020
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
3010
3021
  # naming restrictions, see [Directory bucket naming rules][1] in the
3011
3022
  # *Amazon S3 User Guide*.
3012
3023
  #
3013
- # **Access points** - When you use this action with an access point,
3014
- # you must provide the alias of the access point in place of the
3015
- # bucket name or specify the access point ARN. When using the access
3016
- # point ARN, you must direct requests to the access point hostname.
3017
- # The access point hostname takes the form
3024
+ # **Access points** - When you use this action with an access point
3025
+ # for general purpose buckets, you must provide the alias of the
3026
+ # access point in place of the bucket name or specify the access point
3027
+ # ARN. When you use this action with an access point for directory
3028
+ # buckets, you must provide the access point name in place of the
3029
+ # bucket name. When using the access point ARN, you must direct
3030
+ # requests to the access point hostname. The access point hostname
3031
+ # takes the form
3018
3032
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
3019
3033
  # When using this action with an access point through the Amazon Web
3020
3034
  # Services SDKs, you provide the access point ARN in place of the
3021
3035
  # bucket name. For more information about access point ARNs, see
3022
3036
  # [Using access points][2] in the *Amazon S3 User Guide*.
3023
3037
  #
3024
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
3025
- # directory buckets.
3038
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
3026
3039
  #
3027
3040
  # </note>
3028
3041
  #
3029
- # **S3 on Outposts** - When you use this action with Amazon S3 on
3030
- # Outposts, you must direct requests to the S3 on Outposts hostname.
3031
- # The S3 on Outposts hostname takes the form `
3042
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
3043
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
3044
+ # Outposts hostname takes the form `
3032
3045
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
3033
- # When you use this action with S3 on Outposts through the Amazon Web
3034
- # Services SDKs, you provide the Outposts access point ARN in place of
3035
- # the bucket name. For more information about S3 on Outposts ARNs, see
3036
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
3046
+ # When you use this action with S3 on Outposts, the destination bucket
3047
+ # must be the Outposts access point ARN or the access point alias. For
3048
+ # more information about S3 on Outposts, see [What is S3 on
3049
+ # Outposts?][3] in the *Amazon S3 User Guide*.
3037
3050
  #
3038
3051
  #
3039
3052
  #
@@ -3401,8 +3414,10 @@ module Aws::S3
3401
3414
  # specify a different Storage Class. For more information, see
3402
3415
  # [Storage Classes][1] in the *Amazon S3 User Guide*.
3403
3416
  #
3404
- # <note markdown="1"> * For directory buckets, only the S3 Express One Zone storage class
3405
- # is supported to store newly created objects.
3417
+ # <note markdown="1"> * Directory buckets only support `EXPRESS_ONEZONE` (the S3 Express
3418
+ # One Zone storage class) in Availability Zones and `ONEZONE_IA`
3419
+ # (the S3 One Zone-Infrequent Access storage class) in Dedicated
3420
+ # Local Zones.
3406
3421
  #
3407
3422
  # * Amazon S3 on Outposts only uses the OUTPOSTS Storage Class.
3408
3423
  #
@@ -3471,21 +3486,17 @@ module Aws::S3
3471
3486
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
3472
3487
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
3473
3488
  #
3474
- # **Directory buckets** - If you specify
3475
- # `x-amz-server-side-encryption` with `aws:kms`, the `
3476
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
3477
- # assigned the ID of the KMS symmetric encryption customer managed key
3478
- # that's configured for your directory bucket's default encryption
3479
- # setting. If you want to specify the `
3480
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
3481
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
3482
- # customer managed key that's configured for your directory bucket's
3483
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
3484
- # Request` error. Only use the key ID or key ARN. The key alias format
3485
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
3486
- # support 1 [customer managed key][1] per directory bucket for the
3487
- # lifetime of the bucket. The [Amazon Web Services managed key][2]
3488
- # (`aws/s3`) isn't supported.
3489
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
3490
+ # recommended to specify the `x-amz-server-side-encryption` header to
3491
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
3492
+ # header implicitly uses the bucket's default KMS customer managed
3493
+ # key ID. If you want to explicitly set the `
3494
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
3495
+ # the bucket's default customer managed key (using key ID or ARN, not
3496
+ # alias). Your SSE-KMS configuration can only support 1 [customer
3497
+ # managed key][1] per directory bucket's lifetime. The [Amazon Web
3498
+ # Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
3499
+ # specification results in an HTTP `400 Bad Request` error.
3489
3500
  #
3490
3501
  #
3491
3502
  #
@@ -3720,7 +3731,7 @@ module Aws::S3
3720
3731
  #
3721
3732
  #
3722
3733
  #
3723
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-serv-side-encryption.html
3734
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/serv-side-encryption.html
3724
3735
  # @return [String]
3725
3736
  #
3726
3737
  # @!attribute [rw] ssekms_key_id
@@ -3734,8 +3745,8 @@ module Aws::S3
3734
3745
  # must use the full Key ARN not the Key ID.
3735
3746
  #
3736
3747
  # Your SSE-KMS configuration can only support 1 [customer managed
3737
- # key][1] per directory bucket for the lifetime of the bucket. The
3738
- # [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
3748
+ # key][1] per directory bucket's lifetime. The [Amazon Web Services
3749
+ # managed key][2] (`aws/s3`) isn't supported.
3739
3750
  #
3740
3751
  #
3741
3752
  #
@@ -4238,7 +4249,7 @@ module Aws::S3
4238
4249
  # Information about the delete marker.
4239
4250
  #
4240
4251
  # @!attribute [rw] owner
4241
- # The account that created the delete marker.&gt;
4252
+ # The account that created the delete marker.
4242
4253
  # @return [Types::Owner]
4243
4254
  #
4244
4255
  # @!attribute [rw] key
@@ -4314,10 +4325,16 @@ module Aws::S3
4314
4325
  # deleted was (true) or was not (false) a delete marker before
4315
4326
  # deletion. In a simple DELETE, this header indicates whether (true)
4316
4327
  # or not (false) the current version of the object is a delete marker.
4328
+ # To learn more about delete markers, see [Working with delete
4329
+ # markers][1].
4317
4330
  #
4318
4331
  # <note markdown="1"> This functionality is not supported for directory buckets.
4319
4332
  #
4320
4333
  # </note>
4334
+ #
4335
+ #
4336
+ #
4337
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
4321
4338
  # @return [Boolean]
4322
4339
  #
4323
4340
  # @!attribute [rw] version_id
@@ -4357,34 +4374,36 @@ module Aws::S3
4357
4374
  # requests are not supported. Directory bucket names must be unique in
4358
4375
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
4359
4376
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
4360
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4377
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
4361
4378
  # naming restrictions, see [Directory bucket naming rules][1] in the
4362
4379
  # *Amazon S3 User Guide*.
4363
4380
  #
4364
- # **Access points** - When you use this action with an access point,
4365
- # you must provide the alias of the access point in place of the
4366
- # bucket name or specify the access point ARN. When using the access
4367
- # point ARN, you must direct requests to the access point hostname.
4368
- # The access point hostname takes the form
4381
+ # **Access points** - When you use this action with an access point
4382
+ # for general purpose buckets, you must provide the alias of the
4383
+ # access point in place of the bucket name or specify the access point
4384
+ # ARN. When you use this action with an access point for directory
4385
+ # buckets, you must provide the access point name in place of the
4386
+ # bucket name. When using the access point ARN, you must direct
4387
+ # requests to the access point hostname. The access point hostname
4388
+ # takes the form
4369
4389
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
4370
4390
  # When using this action with an access point through the Amazon Web
4371
4391
  # Services SDKs, you provide the access point ARN in place of the
4372
4392
  # bucket name. For more information about access point ARNs, see
4373
4393
  # [Using access points][2] in the *Amazon S3 User Guide*.
4374
4394
  #
4375
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
4376
- # directory buckets.
4395
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
4377
4396
  #
4378
4397
  # </note>
4379
4398
  #
4380
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4381
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4382
- # The S3 on Outposts hostname takes the form `
4399
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4400
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4401
+ # Outposts hostname takes the form `
4383
4402
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4384
- # When you use this action with S3 on Outposts through the Amazon Web
4385
- # Services SDKs, you provide the Outposts access point ARN in place of
4386
- # the bucket name. For more information about S3 on Outposts ARNs, see
4387
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
4403
+ # When you use this action with S3 on Outposts, the destination bucket
4404
+ # must be the Outposts access point ARN or the access point alias. For
4405
+ # more information about S3 on Outposts, see [What is S3 on
4406
+ # Outposts?][3] in the *Amazon S3 User Guide*.
4388
4407
  #
4389
4408
  #
4390
4409
  #
@@ -4467,7 +4486,7 @@ module Aws::S3
4467
4486
  #
4468
4487
  #
4469
4488
  #
4470
- # [1]: https://docs.aws.amazon.com/https:/tools.ietf.org/html/rfc7232
4489
+ # [1]: https://tools.ietf.org/html/rfc7232
4471
4490
  # @return [String]
4472
4491
  #
4473
4492
  # @!attribute [rw] if_match_last_modified_time
@@ -4531,25 +4550,28 @@ module Aws::S3
4531
4550
  # The bucket name containing the objects from which to remove the
4532
4551
  # tags.
4533
4552
  #
4534
- # **Access points** - When you use this action with an access point,
4535
- # you must provide the alias of the access point in place of the
4536
- # bucket name or specify the access point ARN. When using the access
4537
- # point ARN, you must direct requests to the access point hostname.
4538
- # The access point hostname takes the form
4553
+ # **Access points** - When you use this action with an access point
4554
+ # for general purpose buckets, you must provide the alias of the
4555
+ # access point in place of the bucket name or specify the access point
4556
+ # ARN. When you use this action with an access point for directory
4557
+ # buckets, you must provide the access point name in place of the
4558
+ # bucket name. When using the access point ARN, you must direct
4559
+ # requests to the access point hostname. The access point hostname
4560
+ # takes the form
4539
4561
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
4540
4562
  # When using this action with an access point through the Amazon Web
4541
4563
  # Services SDKs, you provide the access point ARN in place of the
4542
4564
  # bucket name. For more information about access point ARNs, see
4543
4565
  # [Using access points][1] in the *Amazon S3 User Guide*.
4544
4566
  #
4545
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4546
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4547
- # The S3 on Outposts hostname takes the form `
4567
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4568
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4569
+ # Outposts hostname takes the form `
4548
4570
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4549
- # When you use this action with S3 on Outposts through the Amazon Web
4550
- # Services SDKs, you provide the Outposts access point ARN in place of
4551
- # the bucket name. For more information about S3 on Outposts ARNs, see
4552
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
4571
+ # When you use this action with S3 on Outposts, the destination bucket
4572
+ # must be the Outposts access point ARN or the access point alias. For
4573
+ # more information about S3 on Outposts, see [What is S3 on
4574
+ # Outposts?][2] in the *Amazon S3 User Guide*.
4553
4575
  #
4554
4576
  #
4555
4577
  #
@@ -4622,34 +4644,36 @@ module Aws::S3
4622
4644
  # requests are not supported. Directory bucket names must be unique in
4623
4645
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
4624
4646
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
4625
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
4647
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
4626
4648
  # naming restrictions, see [Directory bucket naming rules][1] in the
4627
4649
  # *Amazon S3 User Guide*.
4628
4650
  #
4629
- # **Access points** - When you use this action with an access point,
4630
- # you must provide the alias of the access point in place of the
4631
- # bucket name or specify the access point ARN. When using the access
4632
- # point ARN, you must direct requests to the access point hostname.
4633
- # The access point hostname takes the form
4651
+ # **Access points** - When you use this action with an access point
4652
+ # for general purpose buckets, you must provide the alias of the
4653
+ # access point in place of the bucket name or specify the access point
4654
+ # ARN. When you use this action with an access point for directory
4655
+ # buckets, you must provide the access point name in place of the
4656
+ # bucket name. When using the access point ARN, you must direct
4657
+ # requests to the access point hostname. The access point hostname
4658
+ # takes the form
4634
4659
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
4635
4660
  # When using this action with an access point through the Amazon Web
4636
4661
  # Services SDKs, you provide the access point ARN in place of the
4637
4662
  # bucket name. For more information about access point ARNs, see
4638
4663
  # [Using access points][2] in the *Amazon S3 User Guide*.
4639
4664
  #
4640
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
4641
- # directory buckets.
4665
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
4642
4666
  #
4643
4667
  # </note>
4644
4668
  #
4645
- # **S3 on Outposts** - When you use this action with Amazon S3 on
4646
- # Outposts, you must direct requests to the S3 on Outposts hostname.
4647
- # The S3 on Outposts hostname takes the form `
4669
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
4670
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
4671
+ # Outposts hostname takes the form `
4648
4672
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4649
- # When you use this action with S3 on Outposts through the Amazon Web
4650
- # Services SDKs, you provide the Outposts access point ARN in place of
4651
- # the bucket name. For more information about S3 on Outposts ARNs, see
4652
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
4673
+ # When you use this action with S3 on Outposts, the destination bucket
4674
+ # must be the Outposts access point ARN or the access point alias. For
4675
+ # more information about S3 on Outposts, see [What is S3 on
4676
+ # Outposts?][3] in the *Amazon S3 User Guide*.
4653
4677
  #
4654
4678
  #
4655
4679
  #
@@ -4733,15 +4757,15 @@ module Aws::S3
4733
4757
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm `
4734
4758
  # with the supported algorithm from the following list:
4735
4759
  #
4736
- # * `CRC-32`
4760
+ # * `CRC32`
4737
4761
  #
4738
- # * `CRC-32C`
4762
+ # * `CRC32C`
4739
4763
  #
4740
- # * `CRC-64NVME`
4764
+ # * `CRC64NVME`
4741
4765
  #
4742
- # * `SHA-1`
4766
+ # * `SHA1`
4743
4767
  #
4744
- # * `SHA-256`
4768
+ # * `SHA256`
4745
4769
  #
4746
4770
  # For more information, see [Checking object integrity][1] in the
4747
4771
  # *Amazon S3 User Guide*.
@@ -4813,10 +4837,16 @@ module Aws::S3
4813
4837
  # deleted was (true) or was not (false) a delete marker before
4814
4838
  # deletion. In a simple DELETE, this header indicates whether (true)
4815
4839
  # or not (false) the current version of the object is a delete marker.
4840
+ # To learn more about delete markers, see [Working with delete
4841
+ # markers][1].
4816
4842
  #
4817
4843
  # <note markdown="1"> This functionality is not supported for directory buckets.
4818
4844
  #
4819
4845
  # </note>
4846
+ #
4847
+ #
4848
+ #
4849
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
4820
4850
  # @return [Boolean]
4821
4851
  #
4822
4852
  # @!attribute [rw] delete_marker_version_id
@@ -6363,8 +6393,10 @@ module Aws::S3
6363
6393
  # @!attribute [rw] location_constraint
6364
6394
  # Specifies the Region where the bucket resides. For a list of all the
6365
6395
  # Amazon S3 supported location constraints by Region, see [Regions and
6366
- # Endpoints][1]. Buckets in Region `us-east-1` have a
6367
- # LocationConstraint of `null`.
6396
+ # Endpoints][1].
6397
+ #
6398
+ # Buckets in Region `us-east-1` have a LocationConstraint of `null`.
6399
+ # Buckets with a LocationConstraint of `EU` reside in `eu-west-1`.
6368
6400
  #
6369
6401
  #
6370
6402
  #
@@ -6664,8 +6696,7 @@ module Aws::S3
6664
6696
  # `InvalidAccessPointAliasError` is returned. For more information
6665
6697
  # about `InvalidAccessPointAliasError`, see [List of Error Codes][2].
6666
6698
  #
6667
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
6668
- # directory buckets.
6699
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
6669
6700
  #
6670
6701
  # </note>
6671
6702
  #
@@ -6950,11 +6981,14 @@ module Aws::S3
6950
6981
  # The bucket name that contains the object for which to get the ACL
6951
6982
  # information.
6952
6983
  #
6953
- # **Access points** - When you use this action with an access point,
6954
- # you must provide the alias of the access point in place of the
6955
- # bucket name or specify the access point ARN. When using the access
6956
- # point ARN, you must direct requests to the access point hostname.
6957
- # The access point hostname takes the form
6984
+ # **Access points** - When you use this action with an access point
6985
+ # for general purpose buckets, you must provide the alias of the
6986
+ # access point in place of the bucket name or specify the access point
6987
+ # ARN. When you use this action with an access point for directory
6988
+ # buckets, you must provide the access point name in place of the
6989
+ # bucket name. When using the access point ARN, you must direct
6990
+ # requests to the access point hostname. The access point hostname
6991
+ # takes the form
6958
6992
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
6959
6993
  # When using this action with an access point through the Amazon Web
6960
6994
  # Services SDKs, you provide the access point ARN in place of the
@@ -7018,11 +7052,16 @@ module Aws::S3
7018
7052
  # @!attribute [rw] delete_marker
7019
7053
  # Specifies whether the object retrieved was (`true`) or was not
7020
7054
  # (`false`) a delete marker. If `false`, this response header does not
7021
- # appear in the response.
7055
+ # appear in the response. To learn more about delete markers, see
7056
+ # [Working with delete markers][1].
7022
7057
  #
7023
7058
  # <note markdown="1"> This functionality is not supported for directory buckets.
7024
7059
  #
7025
7060
  # </note>
7061
+ #
7062
+ #
7063
+ #
7064
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
7026
7065
  # @return [Boolean]
7027
7066
  #
7028
7067
  # @!attribute [rw] last_modified
@@ -7066,8 +7105,10 @@ module Aws::S3
7066
7105
  #
7067
7106
  # For more information, see [Storage Classes][1].
7068
7107
  #
7069
- # <note markdown="1"> **Directory buckets** - Only the S3 Express One Zone storage class
7070
- # is supported by directory buckets to store objects.
7108
+ # <note markdown="1"> **Directory buckets** - Directory buckets only support
7109
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
7110
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
7111
+ # Access storage class) in Dedicated Local Zones.
7071
7112
  #
7072
7113
  # </note>
7073
7114
  #
@@ -7162,34 +7203,36 @@ module Aws::S3
7162
7203
  # requests are not supported. Directory bucket names must be unique in
7163
7204
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
7164
7205
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
7165
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7206
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
7166
7207
  # naming restrictions, see [Directory bucket naming rules][1] in the
7167
7208
  # *Amazon S3 User Guide*.
7168
7209
  #
7169
- # **Access points** - When you use this action with an access point,
7170
- # you must provide the alias of the access point in place of the
7171
- # bucket name or specify the access point ARN. When using the access
7172
- # point ARN, you must direct requests to the access point hostname.
7173
- # The access point hostname takes the form
7210
+ # **Access points** - When you use this action with an access point
7211
+ # for general purpose buckets, you must provide the alias of the
7212
+ # access point in place of the bucket name or specify the access point
7213
+ # ARN. When you use this action with an access point for directory
7214
+ # buckets, you must provide the access point name in place of the
7215
+ # bucket name. When using the access point ARN, you must direct
7216
+ # requests to the access point hostname. The access point hostname
7217
+ # takes the form
7174
7218
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7175
7219
  # When using this action with an access point through the Amazon Web
7176
7220
  # Services SDKs, you provide the access point ARN in place of the
7177
7221
  # bucket name. For more information about access point ARNs, see
7178
7222
  # [Using access points][2] in the *Amazon S3 User Guide*.
7179
7223
  #
7180
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
7181
- # directory buckets.
7224
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
7182
7225
  #
7183
7226
  # </note>
7184
7227
  #
7185
- # **S3 on Outposts** - When you use this action with Amazon S3 on
7186
- # Outposts, you must direct requests to the S3 on Outposts hostname.
7187
- # The S3 on Outposts hostname takes the form `
7228
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
7229
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
7230
+ # Outposts hostname takes the form `
7188
7231
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7189
- # When you use this action with S3 on Outposts through the Amazon Web
7190
- # Services SDKs, you provide the Outposts access point ARN in place of
7191
- # the bucket name. For more information about S3 on Outposts ARNs, see
7192
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
7232
+ # When you use this action with S3 on Outposts, the destination bucket
7233
+ # must be the Outposts access point ARN or the access point alias. For
7234
+ # more information about S3 on Outposts, see [What is S3 on
7235
+ # Outposts?][3] in the *Amazon S3 User Guide*.
7193
7236
  #
7194
7237
  #
7195
7238
  #
@@ -7317,11 +7360,14 @@ module Aws::S3
7317
7360
  # The bucket name containing the object whose legal hold status you
7318
7361
  # want to retrieve.
7319
7362
  #
7320
- # **Access points** - When you use this action with an access point,
7321
- # you must provide the alias of the access point in place of the
7322
- # bucket name or specify the access point ARN. When using the access
7323
- # point ARN, you must direct requests to the access point hostname.
7324
- # The access point hostname takes the form
7363
+ # **Access points** - When you use this action with an access point
7364
+ # for general purpose buckets, you must provide the alias of the
7365
+ # access point in place of the bucket name or specify the access point
7366
+ # ARN. When you use this action with an access point for directory
7367
+ # buckets, you must provide the access point name in place of the
7368
+ # bucket name. When using the access point ARN, you must direct
7369
+ # requests to the access point hostname. The access point hostname
7370
+ # takes the form
7325
7371
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7326
7372
  # When using this action with an access point through the Amazon Web
7327
7373
  # Services SDKs, you provide the access point ARN in place of the
@@ -7395,11 +7441,14 @@ module Aws::S3
7395
7441
  # @!attribute [rw] bucket
7396
7442
  # The bucket whose Object Lock configuration you want to retrieve.
7397
7443
  #
7398
- # **Access points** - When you use this action with an access point,
7399
- # you must provide the alias of the access point in place of the
7400
- # bucket name or specify the access point ARN. When using the access
7401
- # point ARN, you must direct requests to the access point hostname.
7402
- # The access point hostname takes the form
7444
+ # **Access points** - When you use this action with an access point
7445
+ # for general purpose buckets, you must provide the alias of the
7446
+ # access point in place of the bucket name or specify the access point
7447
+ # ARN. When you use this action with an access point for directory
7448
+ # buckets, you must provide the access point name in place of the
7449
+ # bucket name. When using the access point ARN, you must direct
7450
+ # requests to the access point hostname. The access point hostname
7451
+ # takes the form
7403
7452
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7404
7453
  # When using this action with an access point through the Amazon Web
7405
7454
  # Services SDKs, you provide the access point ARN in place of the
@@ -7473,9 +7522,10 @@ module Aws::S3
7473
7522
  # Provides information about object restoration action and expiration
7474
7523
  # time of the restored object copy.
7475
7524
  #
7476
- # <note markdown="1"> This functionality is not supported for directory buckets. Only the
7477
- # S3 Express One Zone storage class is supported by directory buckets
7478
- # to store objects.
7525
+ # <note markdown="1"> This functionality is not supported for directory buckets. Directory
7526
+ # buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone
7527
+ # storage class) in Availability Zones and `ONEZONE_IA` (the S3 One
7528
+ # Zone-Infrequent Access storage class) in Dedicated Local Zones.
7479
7529
  #
7480
7530
  # </note>
7481
7531
  # @return [String]
@@ -7499,7 +7549,7 @@ module Aws::S3
7499
7549
  # @return [String]
7500
7550
  #
7501
7551
  # @!attribute [rw] checksum_crc32
7502
- # The Base64 encoded, 32-bit `CRC-32` checksum of the object. This
7552
+ # The Base64 encoded, 32-bit `CRC32` checksum of the object. This
7503
7553
  # checksum is only present if the object was uploaded with the object.
7504
7554
  # For more information, see [ Checking object integrity][1] in the
7505
7555
  # *Amazon S3 User Guide*.
@@ -7510,7 +7560,7 @@ module Aws::S3
7510
7560
  # @return [String]
7511
7561
  #
7512
7562
  # @!attribute [rw] checksum_crc32c
7513
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the object. This
7563
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
7514
7564
  # will only be present if the object was uploaded with the object. For
7515
7565
  # more information, see [ Checking object integrity][1] in the *Amazon
7516
7566
  # S3 User Guide*.
@@ -7521,7 +7571,7 @@ module Aws::S3
7521
7571
  # @return [String]
7522
7572
  #
7523
7573
  # @!attribute [rw] checksum_crc64nvme
7524
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the object. For
7574
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. For
7525
7575
  # more information, see [Checking object integrity in the Amazon S3
7526
7576
  # User Guide][1].
7527
7577
  #
@@ -7531,7 +7581,7 @@ module Aws::S3
7531
7581
  # @return [String]
7532
7582
  #
7533
7583
  # @!attribute [rw] checksum_sha1
7534
- # The Base64 encoded, 160-bit `SHA-1` digest of the object. This will
7584
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
7535
7585
  # only be present if the object was uploaded with the object. For more
7536
7586
  # information, see [ Checking object integrity][1] in the *Amazon S3
7537
7587
  # User Guide*.
@@ -7542,10 +7592,10 @@ module Aws::S3
7542
7592
  # @return [String]
7543
7593
  #
7544
7594
  # @!attribute [rw] checksum_sha256
7545
- # The Base64 encoded, 256-bit `SHA-256` digest of the object. This
7546
- # will only be present if the object was uploaded with the object. For
7547
- # more information, see [ Checking object integrity][1] in the *Amazon
7548
- # S3 User Guide*.
7595
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
7596
+ # only be present if the object was uploaded with the object. For more
7597
+ # information, see [ Checking object integrity][1] in the *Amazon S3
7598
+ # User Guide*.
7549
7599
  #
7550
7600
  #
7551
7601
  #
@@ -7674,8 +7724,10 @@ module Aws::S3
7674
7724
  # this header for all objects except for S3 Standard storage class
7675
7725
  # objects.
7676
7726
  #
7677
- # <note markdown="1"> <b>Directory buckets </b> - Only the S3 Express One Zone storage
7678
- # class is supported by directory buckets to store objects.
7727
+ # <note markdown="1"> <b>Directory buckets </b> - Directory buckets only support
7728
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
7729
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
7730
+ # Access storage class) in Dedicated Local Zones.
7679
7731
  #
7680
7732
  # </note>
7681
7733
  # @return [String]
@@ -7801,15 +7853,18 @@ module Aws::S3
7801
7853
  # requests are not supported. Directory bucket names must be unique in
7802
7854
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
7803
7855
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
7804
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
7856
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
7805
7857
  # naming restrictions, see [Directory bucket naming rules][1] in the
7806
7858
  # *Amazon S3 User Guide*.
7807
7859
  #
7808
- # **Access points** - When you use this action with an access point,
7809
- # you must provide the alias of the access point in place of the
7810
- # bucket name or specify the access point ARN. When using the access
7811
- # point ARN, you must direct requests to the access point hostname.
7812
- # The access point hostname takes the form
7860
+ # **Access points** - When you use this action with an access point
7861
+ # for general purpose buckets, you must provide the alias of the
7862
+ # access point in place of the bucket name or specify the access point
7863
+ # ARN. When you use this action with an access point for directory
7864
+ # buckets, you must provide the access point name in place of the
7865
+ # bucket name. When using the access point ARN, you must direct
7866
+ # requests to the access point hostname. The access point hostname
7867
+ # takes the form
7813
7868
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
7814
7869
  # When using this action with an access point through the Amazon Web
7815
7870
  # Services SDKs, you provide the access point ARN in place of the
@@ -7822,19 +7877,18 @@ module Aws::S3
7822
7877
  # hostname takes the form
7823
7878
  # *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com.
7824
7879
  #
7825
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
7826
- # directory buckets.
7880
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
7827
7881
  #
7828
7882
  # </note>
7829
7883
  #
7830
- # **S3 on Outposts** - When you use this action with Amazon S3 on
7831
- # Outposts, you must direct requests to the S3 on Outposts hostname.
7832
- # The S3 on Outposts hostname takes the form `
7884
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
7885
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
7886
+ # Outposts hostname takes the form `
7833
7887
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7834
- # When you use this action with S3 on Outposts through the Amazon Web
7835
- # Services SDKs, you provide the Outposts access point ARN in place of
7836
- # the bucket name. For more information about S3 on Outposts ARNs, see
7837
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
7888
+ # When you use this action with S3 on Outposts, the destination bucket
7889
+ # must be the Outposts access point ARN or the access point alias. For
7890
+ # more information about S3 on Outposts, see [What is S3 on
7891
+ # Outposts?][3] in the *Amazon S3 User Guide*.
7838
7892
  #
7839
7893
  #
7840
7894
  #
@@ -8108,15 +8162,6 @@ module Aws::S3
8108
8162
  #
8109
8163
  # @!attribute [rw] checksum_mode
8110
8164
  # To retrieve the checksum, this mode must be enabled.
8111
- #
8112
- # **General purpose buckets** - In addition, if you enable checksum
8113
- # mode and the object is uploaded with a [checksum][1] and encrypted
8114
- # with an Key Management Service (KMS) key, you must have permission
8115
- # to use the `kms:Decrypt` action to retrieve the checksum.
8116
- #
8117
- #
8118
- #
8119
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_Checksum.html
8120
8165
  # @return [String]
8121
8166
  #
8122
8167
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectRequest AWS API Documentation
@@ -8163,11 +8208,14 @@ module Aws::S3
8163
8208
  # The bucket name containing the object whose retention settings you
8164
8209
  # want to retrieve.
8165
8210
  #
8166
- # **Access points** - When you use this action with an access point,
8167
- # you must provide the alias of the access point in place of the
8168
- # bucket name or specify the access point ARN. When using the access
8169
- # point ARN, you must direct requests to the access point hostname.
8170
- # The access point hostname takes the form
8211
+ # **Access points** - When you use this action with an access point
8212
+ # for general purpose buckets, you must provide the alias of the
8213
+ # access point in place of the bucket name or specify the access point
8214
+ # ARN. When you use this action with an access point for directory
8215
+ # buckets, you must provide the access point name in place of the
8216
+ # bucket name. When using the access point ARN, you must direct
8217
+ # requests to the access point hostname. The access point hostname
8218
+ # takes the form
8171
8219
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8172
8220
  # When using this action with an access point through the Amazon Web
8173
8221
  # Services SDKs, you provide the access point ARN in place of the
@@ -8248,25 +8296,28 @@ module Aws::S3
8248
8296
  # The bucket name containing the object for which to get the tagging
8249
8297
  # information.
8250
8298
  #
8251
- # **Access points** - When you use this action with an access point,
8252
- # you must provide the alias of the access point in place of the
8253
- # bucket name or specify the access point ARN. When using the access
8254
- # point ARN, you must direct requests to the access point hostname.
8255
- # The access point hostname takes the form
8299
+ # **Access points** - When you use this action with an access point
8300
+ # for general purpose buckets, you must provide the alias of the
8301
+ # access point in place of the bucket name or specify the access point
8302
+ # ARN. When you use this action with an access point for directory
8303
+ # buckets, you must provide the access point name in place of the
8304
+ # bucket name. When using the access point ARN, you must direct
8305
+ # requests to the access point hostname. The access point hostname
8306
+ # takes the form
8256
8307
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8257
8308
  # When using this action with an access point through the Amazon Web
8258
8309
  # Services SDKs, you provide the access point ARN in place of the
8259
8310
  # bucket name. For more information about access point ARNs, see
8260
8311
  # [Using access points][1] in the *Amazon S3 User Guide*.
8261
8312
  #
8262
- # **S3 on Outposts** - When you use this action with Amazon S3 on
8263
- # Outposts, you must direct requests to the S3 on Outposts hostname.
8264
- # The S3 on Outposts hostname takes the form `
8313
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
8314
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
8315
+ # Outposts hostname takes the form `
8265
8316
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8266
- # When you use this action with S3 on Outposts through the Amazon Web
8267
- # Services SDKs, you provide the Outposts access point ARN in place of
8268
- # the bucket name. For more information about S3 on Outposts ARNs, see
8269
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
8317
+ # When you use this action with S3 on Outposts, the destination bucket
8318
+ # must be the Outposts access point ARN or the access point alias. For
8319
+ # more information about S3 on Outposts, see [What is S3 on
8320
+ # Outposts?][2] in the *Amazon S3 User Guide*.
8270
8321
  #
8271
8322
  #
8272
8323
  #
@@ -8570,15 +8621,18 @@ module Aws::S3
8570
8621
  # requests are not supported. Directory bucket names must be unique in
8571
8622
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
8572
8623
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
8573
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
8624
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
8574
8625
  # naming restrictions, see [Directory bucket naming rules][1] in the
8575
8626
  # *Amazon S3 User Guide*.
8576
8627
  #
8577
- # **Access points** - When you use this action with an access point,
8578
- # you must provide the alias of the access point in place of the
8579
- # bucket name or specify the access point ARN. When using the access
8580
- # point ARN, you must direct requests to the access point hostname.
8581
- # The access point hostname takes the form
8628
+ # **Access points** - When you use this action with an access point
8629
+ # for general purpose buckets, you must provide the alias of the
8630
+ # access point in place of the bucket name or specify the access point
8631
+ # ARN. When you use this action with an access point for directory
8632
+ # buckets, you must provide the access point name in place of the
8633
+ # bucket name. When using the access point ARN, you must direct
8634
+ # requests to the access point hostname. The access point hostname
8635
+ # takes the form
8582
8636
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
8583
8637
  # When using this action with an access point through the Amazon Web
8584
8638
  # Services SDKs, you provide the access point ARN in place of the
@@ -8592,19 +8646,18 @@ module Aws::S3
8592
8646
  # `InvalidAccessPointAliasError` is returned. For more information
8593
8647
  # about `InvalidAccessPointAliasError`, see [List of Error Codes][3].
8594
8648
  #
8595
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
8596
- # directory buckets.
8649
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
8597
8650
  #
8598
8651
  # </note>
8599
8652
  #
8600
- # **S3 on Outposts** - When you use this action with Amazon S3 on
8601
- # Outposts, you must direct requests to the S3 on Outposts hostname.
8602
- # The S3 on Outposts hostname takes the form `
8653
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
8654
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
8655
+ # Outposts hostname takes the form `
8603
8656
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8604
- # When you use this action with S3 on Outposts through the Amazon Web
8605
- # Services SDKs, you provide the Outposts access point ARN in place of
8606
- # the bucket name. For more information about S3 on Outposts ARNs, see
8607
- # [What is S3 on Outposts?][4] in the *Amazon S3 User Guide*.
8657
+ # When you use this action with S3 on Outposts, the destination bucket
8658
+ # must be the Outposts access point ARN or the access point alias. For
8659
+ # more information about S3 on Outposts, see [What is S3 on
8660
+ # Outposts?][4] in the *Amazon S3 User Guide*.
8608
8661
  #
8609
8662
  #
8610
8663
  #
@@ -8680,9 +8733,10 @@ module Aws::S3
8680
8733
  # For more information about archiving objects, see [Transitioning
8681
8734
  # Objects: General Considerations][2].
8682
8735
  #
8683
- # <note markdown="1"> This functionality is not supported for directory buckets. Only the
8684
- # S3 Express One Zone storage class is supported by directory buckets
8685
- # to store objects.
8736
+ # <note markdown="1"> This functionality is not supported for directory buckets. Directory
8737
+ # buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone
8738
+ # storage class) in Availability Zones and `ONEZONE_IA` (the S3 One
8739
+ # Zone-Infrequent Access storage class) in Dedicated Local Zones.
8686
8740
  #
8687
8741
  # </note>
8688
8742
  #
@@ -8709,7 +8763,7 @@ module Aws::S3
8709
8763
  # @return [Integer]
8710
8764
  #
8711
8765
  # @!attribute [rw] checksum_crc32
8712
- # The Base64 encoded, 32-bit `CRC-32 checksum` of the object. This
8766
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
8713
8767
  # checksum is only be present if the checksum was uploaded with the
8714
8768
  # object. When you use an API operation on an object that was uploaded
8715
8769
  # using multipart uploads, this value may not be a direct checksum
@@ -8724,7 +8778,7 @@ module Aws::S3
8724
8778
  # @return [String]
8725
8779
  #
8726
8780
  # @!attribute [rw] checksum_crc32c
8727
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the object. This
8781
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
8728
8782
  # checksum is only present if the checksum was uploaded with the
8729
8783
  # object. When you use an API operation on an object that was uploaded
8730
8784
  # using multipart uploads, this value may not be a direct checksum
@@ -8739,7 +8793,7 @@ module Aws::S3
8739
8793
  # @return [String]
8740
8794
  #
8741
8795
  # @!attribute [rw] checksum_crc64nvme
8742
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the object. For
8796
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. For
8743
8797
  # more information, see [Checking object integrity in the Amazon S3
8744
8798
  # User Guide][1].
8745
8799
  #
@@ -8749,7 +8803,7 @@ module Aws::S3
8749
8803
  # @return [String]
8750
8804
  #
8751
8805
  # @!attribute [rw] checksum_sha1
8752
- # The Base64 encoded, 160-bit `SHA-1` digest of the object. This will
8806
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
8753
8807
  # only be present if the object was uploaded with the object. When you
8754
8808
  # use the API operation on an object that was uploaded using multipart
8755
8809
  # uploads, this value may not be a direct checksum value of the full
@@ -8764,14 +8818,14 @@ module Aws::S3
8764
8818
  # @return [String]
8765
8819
  #
8766
8820
  # @!attribute [rw] checksum_sha256
8767
- # The Base64 encoded, 256-bit `SHA-256` digest of the object. This
8768
- # will only be present if the object was uploaded with the object.
8769
- # When you use an API operation on an object that was uploaded using
8770
- # multipart uploads, this value may not be a direct checksum value of
8771
- # the full object. Instead, it's a calculation based on the checksum
8772
- # values of each individual part. For more information about how
8773
- # checksums are calculated with multipart uploads, see [ Checking
8774
- # object integrity][1] in the *Amazon S3 User Guide*.
8821
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
8822
+ # only be present if the object was uploaded with the object. When you
8823
+ # use an API operation on an object that was uploaded using multipart
8824
+ # uploads, this value may not be a direct checksum value of the full
8825
+ # object. Instead, it's a calculation based on the checksum values of
8826
+ # each individual part. For more information about how checksums are
8827
+ # calculated with multipart uploads, see [ Checking object
8828
+ # integrity][1] in the *Amazon S3 User Guide*.
8775
8829
  #
8776
8830
  #
8777
8831
  #
@@ -8838,6 +8892,11 @@ module Aws::S3
8838
8892
  # A standard MIME type describing the format of the object data.
8839
8893
  # @return [String]
8840
8894
  #
8895
+ # @!attribute [rw] content_range
8896
+ # The portion of the object returned in the response for a `GET`
8897
+ # request.
8898
+ # @return [String]
8899
+ #
8841
8900
  # @!attribute [rw] expires
8842
8901
  # The date and time at which the object is no longer cacheable.
8843
8902
  # @return [Time]
@@ -8903,8 +8962,10 @@ module Aws::S3
8903
8962
  #
8904
8963
  # For more information, see [Storage Classes][1].
8905
8964
  #
8906
- # <note markdown="1"> <b>Directory buckets </b> - Only the S3 Express One Zone storage
8907
- # class is supported by directory buckets to store objects.
8965
+ # <note markdown="1"> <b>Directory buckets </b> - Directory buckets only support
8966
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
8967
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
8968
+ # Access storage class) in Dedicated Local Zones.
8908
8969
  #
8909
8970
  # </note>
8910
8971
  #
@@ -9042,6 +9103,7 @@ module Aws::S3
9042
9103
  :content_encoding,
9043
9104
  :content_language,
9044
9105
  :content_type,
9106
+ :content_range,
9045
9107
  :expires,
9046
9108
  :expires_string,
9047
9109
  :website_redirect_location,
@@ -9071,34 +9133,36 @@ module Aws::S3
9071
9133
  # requests are not supported. Directory bucket names must be unique in
9072
9134
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
9073
9135
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
9074
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
9136
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
9075
9137
  # naming restrictions, see [Directory bucket naming rules][1] in the
9076
9138
  # *Amazon S3 User Guide*.
9077
9139
  #
9078
- # **Access points** - When you use this action with an access point,
9079
- # you must provide the alias of the access point in place of the
9080
- # bucket name or specify the access point ARN. When using the access
9081
- # point ARN, you must direct requests to the access point hostname.
9082
- # The access point hostname takes the form
9140
+ # **Access points** - When you use this action with an access point
9141
+ # for general purpose buckets, you must provide the alias of the
9142
+ # access point in place of the bucket name or specify the access point
9143
+ # ARN. When you use this action with an access point for directory
9144
+ # buckets, you must provide the access point name in place of the
9145
+ # bucket name. When using the access point ARN, you must direct
9146
+ # requests to the access point hostname. The access point hostname
9147
+ # takes the form
9083
9148
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
9084
9149
  # When using this action with an access point through the Amazon Web
9085
9150
  # Services SDKs, you provide the access point ARN in place of the
9086
9151
  # bucket name. For more information about access point ARNs, see
9087
9152
  # [Using access points][2] in the *Amazon S3 User Guide*.
9088
9153
  #
9089
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
9090
- # directory buckets.
9154
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
9091
9155
  #
9092
9156
  # </note>
9093
9157
  #
9094
- # **S3 on Outposts** - When you use this action with Amazon S3 on
9095
- # Outposts, you must direct requests to the S3 on Outposts hostname.
9096
- # The S3 on Outposts hostname takes the form `
9158
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
9159
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
9160
+ # Outposts hostname takes the form `
9097
9161
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
9098
- # When you use this action with S3 on Outposts through the Amazon Web
9099
- # Services SDKs, you provide the Outposts access point ARN in place of
9100
- # the bucket name. For more information about S3 on Outposts ARNs, see
9101
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
9162
+ # When you use this action with S3 on Outposts, the destination bucket
9163
+ # must be the Outposts access point ARN or the access point alias. For
9164
+ # more information about S3 on Outposts, see [What is S3 on
9165
+ # Outposts?][3] in the *Amazon S3 User Guide*.
9102
9166
  #
9103
9167
  #
9104
9168
  #
@@ -10605,34 +10669,36 @@ module Aws::S3
10605
10669
  # requests are not supported. Directory bucket names must be unique in
10606
10670
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
10607
10671
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
10608
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
10672
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
10609
10673
  # naming restrictions, see [Directory bucket naming rules][1] in the
10610
10674
  # *Amazon S3 User Guide*.
10611
10675
  #
10612
- # **Access points** - When you use this action with an access point,
10613
- # you must provide the alias of the access point in place of the
10614
- # bucket name or specify the access point ARN. When using the access
10615
- # point ARN, you must direct requests to the access point hostname.
10616
- # The access point hostname takes the form
10676
+ # **Access points** - When you use this action with an access point
10677
+ # for general purpose buckets, you must provide the alias of the
10678
+ # access point in place of the bucket name or specify the access point
10679
+ # ARN. When you use this action with an access point for directory
10680
+ # buckets, you must provide the access point name in place of the
10681
+ # bucket name. When using the access point ARN, you must direct
10682
+ # requests to the access point hostname. The access point hostname
10683
+ # takes the form
10617
10684
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
10618
10685
  # When using this action with an access point through the Amazon Web
10619
10686
  # Services SDKs, you provide the access point ARN in place of the
10620
10687
  # bucket name. For more information about access point ARNs, see
10621
10688
  # [Using access points][2] in the *Amazon S3 User Guide*.
10622
10689
  #
10623
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
10624
- # directory buckets.
10690
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
10625
10691
  #
10626
10692
  # </note>
10627
10693
  #
10628
- # **S3 on Outposts** - When you use this action with Amazon S3 on
10629
- # Outposts, you must direct requests to the S3 on Outposts hostname.
10630
- # The S3 on Outposts hostname takes the form `
10694
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
10695
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
10696
+ # Outposts hostname takes the form `
10631
10697
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10632
- # When you use this action with S3 on Outposts through the Amazon Web
10633
- # Services SDKs, you provide the Outposts access point ARN in place of
10634
- # the bucket name. For more information about S3 on Outposts ARNs, see
10635
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
10698
+ # When you use this action with S3 on Outposts, the destination bucket
10699
+ # must be the Outposts access point ARN or the access point alias. For
10700
+ # more information about S3 on Outposts, see [What is S3 on
10701
+ # Outposts?][3] in the *Amazon S3 User Guide*.
10636
10702
  #
10637
10703
  #
10638
10704
  #
@@ -10818,7 +10884,12 @@ module Aws::S3
10818
10884
  # @return [Array<Types::ObjectVersion>]
10819
10885
  #
10820
10886
  # @!attribute [rw] delete_markers
10821
- # Container for an object that is a delete marker.
10887
+ # Container for an object that is a delete marker. To learn more about
10888
+ # delete markers, see [Working with delete markers][1].
10889
+ #
10890
+ #
10891
+ #
10892
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
10822
10893
  # @return [Array<Types::DeleteMarkerEntry>]
10823
10894
  #
10824
10895
  # @!attribute [rw] name
@@ -11127,34 +11198,36 @@ module Aws::S3
11127
11198
  # requests are not supported. Directory bucket names must be unique in
11128
11199
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11129
11200
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11130
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11201
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11131
11202
  # naming restrictions, see [Directory bucket naming rules][1] in the
11132
11203
  # *Amazon S3 User Guide*.
11133
11204
  #
11134
- # **Access points** - When you use this action with an access point,
11135
- # you must provide the alias of the access point in place of the
11136
- # bucket name or specify the access point ARN. When using the access
11137
- # point ARN, you must direct requests to the access point hostname.
11138
- # The access point hostname takes the form
11205
+ # **Access points** - When you use this action with an access point
11206
+ # for general purpose buckets, you must provide the alias of the
11207
+ # access point in place of the bucket name or specify the access point
11208
+ # ARN. When you use this action with an access point for directory
11209
+ # buckets, you must provide the access point name in place of the
11210
+ # bucket name. When using the access point ARN, you must direct
11211
+ # requests to the access point hostname. The access point hostname
11212
+ # takes the form
11139
11213
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11140
11214
  # When using this action with an access point through the Amazon Web
11141
11215
  # Services SDKs, you provide the access point ARN in place of the
11142
11216
  # bucket name. For more information about access point ARNs, see
11143
11217
  # [Using access points][2] in the *Amazon S3 User Guide*.
11144
11218
  #
11145
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
11146
- # directory buckets.
11219
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
11147
11220
  #
11148
11221
  # </note>
11149
11222
  #
11150
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11151
- # Outposts, you must direct requests to the S3 on Outposts hostname.
11152
- # The S3 on Outposts hostname takes the form `
11223
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11224
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11225
+ # Outposts hostname takes the form `
11153
11226
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11154
- # When you use this action with S3 on Outposts through the Amazon Web
11155
- # Services SDKs, you provide the Outposts access point ARN in place of
11156
- # the bucket name. For more information about S3 on Outposts ARNs, see
11157
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11227
+ # When you use this action with S3 on Outposts, the destination bucket
11228
+ # must be the Outposts access point ARN or the access point alias. For
11229
+ # more information about S3 on Outposts, see [What is S3 on
11230
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11158
11231
  #
11159
11232
  #
11160
11233
  #
@@ -11398,34 +11471,36 @@ module Aws::S3
11398
11471
  # requests are not supported. Directory bucket names must be unique in
11399
11472
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11400
11473
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11401
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11474
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11402
11475
  # naming restrictions, see [Directory bucket naming rules][1] in the
11403
11476
  # *Amazon S3 User Guide*.
11404
11477
  #
11405
- # **Access points** - When you use this action with an access point,
11406
- # you must provide the alias of the access point in place of the
11407
- # bucket name or specify the access point ARN. When using the access
11408
- # point ARN, you must direct requests to the access point hostname.
11409
- # The access point hostname takes the form
11478
+ # **Access points** - When you use this action with an access point
11479
+ # for general purpose buckets, you must provide the alias of the
11480
+ # access point in place of the bucket name or specify the access point
11481
+ # ARN. When you use this action with an access point for directory
11482
+ # buckets, you must provide the access point name in place of the
11483
+ # bucket name. When using the access point ARN, you must direct
11484
+ # requests to the access point hostname. The access point hostname
11485
+ # takes the form
11410
11486
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11411
11487
  # When using this action with an access point through the Amazon Web
11412
11488
  # Services SDKs, you provide the access point ARN in place of the
11413
11489
  # bucket name. For more information about access point ARNs, see
11414
11490
  # [Using access points][2] in the *Amazon S3 User Guide*.
11415
11491
  #
11416
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
11417
- # directory buckets.
11492
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
11418
11493
  #
11419
11494
  # </note>
11420
11495
  #
11421
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11422
- # Outposts, you must direct requests to the S3 on Outposts hostname.
11423
- # The S3 on Outposts hostname takes the form `
11496
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11497
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11498
+ # Outposts hostname takes the form `
11424
11499
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11425
- # When you use this action with S3 on Outposts through the Amazon Web
11426
- # Services SDKs, you provide the Outposts access point ARN in place of
11427
- # the bucket name. For more information about S3 on Outposts ARNs, see
11428
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11500
+ # When you use this action with S3 on Outposts, the destination bucket
11501
+ # must be the Outposts access point ARN or the access point alias. For
11502
+ # more information about S3 on Outposts, see [What is S3 on
11503
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11429
11504
  #
11430
11505
  #
11431
11506
  #
@@ -11659,8 +11734,10 @@ module Aws::S3
11659
11734
  # @!attribute [rw] storage_class
11660
11735
  # The class of storage used to store the uploaded object.
11661
11736
  #
11662
- # <note markdown="1"> **Directory buckets** - Only the S3 Express One Zone storage class
11663
- # is supported by directory buckets to store objects.
11737
+ # <note markdown="1"> **Directory buckets** - Directory buckets only support
11738
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
11739
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
11740
+ # Access storage class) in Dedicated Local Zones.
11664
11741
  #
11665
11742
  # </note>
11666
11743
  # @return [String]
@@ -11723,34 +11800,36 @@ module Aws::S3
11723
11800
  # requests are not supported. Directory bucket names must be unique in
11724
11801
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
11725
11802
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
11726
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
11803
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
11727
11804
  # naming restrictions, see [Directory bucket naming rules][1] in the
11728
11805
  # *Amazon S3 User Guide*.
11729
11806
  #
11730
- # **Access points** - When you use this action with an access point,
11731
- # you must provide the alias of the access point in place of the
11732
- # bucket name or specify the access point ARN. When using the access
11733
- # point ARN, you must direct requests to the access point hostname.
11734
- # The access point hostname takes the form
11807
+ # **Access points** - When you use this action with an access point
11808
+ # for general purpose buckets, you must provide the alias of the
11809
+ # access point in place of the bucket name or specify the access point
11810
+ # ARN. When you use this action with an access point for directory
11811
+ # buckets, you must provide the access point name in place of the
11812
+ # bucket name. When using the access point ARN, you must direct
11813
+ # requests to the access point hostname. The access point hostname
11814
+ # takes the form
11735
11815
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
11736
11816
  # When using this action with an access point through the Amazon Web
11737
11817
  # Services SDKs, you provide the access point ARN in place of the
11738
11818
  # bucket name. For more information about access point ARNs, see
11739
11819
  # [Using access points][2] in the *Amazon S3 User Guide*.
11740
11820
  #
11741
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
11742
- # directory buckets.
11821
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
11743
11822
  #
11744
11823
  # </note>
11745
11824
  #
11746
- # **S3 on Outposts** - When you use this action with Amazon S3 on
11747
- # Outposts, you must direct requests to the S3 on Outposts hostname.
11748
- # The S3 on Outposts hostname takes the form `
11825
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
11826
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
11827
+ # Outposts hostname takes the form `
11749
11828
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11750
- # When you use this action with S3 on Outposts through the Amazon Web
11751
- # Services SDKs, you provide the Outposts access point ARN in place of
11752
- # the bucket name. For more information about S3 on Outposts ARNs, see
11753
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
11829
+ # When you use this action with S3 on Outposts, the destination bucket
11830
+ # must be the Outposts access point ARN or the access point alias. For
11831
+ # more information about S3 on Outposts, see [What is S3 on
11832
+ # Outposts?][3] in the *Amazon S3 User Guide*.
11754
11833
  #
11755
11834
  #
11756
11835
  #
@@ -11867,8 +11946,8 @@ module Aws::S3
11867
11946
  # Specifies the location where the bucket will be created.
11868
11947
  #
11869
11948
  # For directory buckets, the location type is Availability Zone or Local
11870
- # Zone. For more information about directory buckets, see [Directory
11871
- # buckets][1] in the *Amazon S3 User Guide*.
11949
+ # Zone. For more information about directory buckets, see [Working with
11950
+ # directory buckets][1] in the *Amazon S3 User Guide*.
11872
11951
  #
11873
11952
  # <note markdown="1"> This functionality is only supported by directory buckets.
11874
11953
  #
@@ -12148,8 +12227,10 @@ module Aws::S3
12148
12227
  # @!attribute [rw] storage_class
12149
12228
  # The class of storage used to store the object.
12150
12229
  #
12151
- # <note markdown="1"> **Directory buckets** - Only the S3 Express One Zone storage class
12152
- # is supported by directory buckets to store objects.
12230
+ # <note markdown="1"> **Directory buckets** - Directory buckets only support
12231
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
12232
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
12233
+ # Access storage class) in Dedicated Local Zones.
12153
12234
  #
12154
12235
  # </note>
12155
12236
  # @return [String]
@@ -12460,8 +12541,10 @@ module Aws::S3
12460
12541
  # @!attribute [rw] storage_class
12461
12542
  # The class of storage used to store the object.
12462
12543
  #
12463
- # <note markdown="1"> **Directory buckets** - Only the S3 Express One Zone storage class
12464
- # is supported by directory buckets to store objects.
12544
+ # <note markdown="1"> **Directory buckets** - Directory buckets only support
12545
+ # `EXPRESS_ONEZONE` (the S3 Express One Zone storage class) in
12546
+ # Availability Zones and `ONEZONE_IA` (the S3 One Zone-Infrequent
12547
+ # Access storage class) in Dedicated Local Zones.
12465
12548
  #
12466
12549
  # </note>
12467
12550
  # @return [String]
@@ -12482,9 +12565,10 @@ module Aws::S3
12482
12565
  # archived objects, see [ Working with archived objects][1] in the
12483
12566
  # *Amazon S3 User Guide*.
12484
12567
  #
12485
- # <note markdown="1"> This functionality is not supported for directory buckets. Only the
12486
- # S3 Express One Zone storage class is supported by directory buckets
12487
- # to store objects.
12568
+ # <note markdown="1"> This functionality is not supported for directory buckets. Directory
12569
+ # buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone
12570
+ # storage class) in Availability Zones and `ONEZONE_IA` (the S3 One
12571
+ # Zone-Infrequent Access storage class) in Dedicated Local Zones.
12488
12572
  #
12489
12573
  # </note>
12490
12574
  #
@@ -12673,9 +12757,9 @@ module Aws::S3
12673
12757
  # @return [Integer]
12674
12758
  #
12675
12759
  # @!attribute [rw] checksum_crc32
12676
- # The Base64 encoded, 32-bit `CRC-32` checksum of the part. This
12760
+ # The Base64 encoded, 32-bit `CRC32` checksum of the part. This
12677
12761
  # checksum is present if the multipart upload request was created with
12678
- # the `CRC-32` checksum algorithm. For more information, see [Checking
12762
+ # the `CRC32` checksum algorithm. For more information, see [Checking
12679
12763
  # object integrity][1] in the *Amazon S3 User Guide*.
12680
12764
  #
12681
12765
  #
@@ -12684,10 +12768,10 @@ module Aws::S3
12684
12768
  # @return [String]
12685
12769
  #
12686
12770
  # @!attribute [rw] checksum_crc32c
12687
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the part. This
12771
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the part. This
12688
12772
  # checksum is present if the multipart upload request was created with
12689
- # the `CRC-32C` checksum algorithm. For more information, see
12690
- # [Checking object integrity][1] in the *Amazon S3 User Guide*.
12773
+ # the `CRC32C` checksum algorithm. For more information, see [Checking
12774
+ # object integrity][1] in the *Amazon S3 User Guide*.
12691
12775
  #
12692
12776
  #
12693
12777
  #
@@ -12695,11 +12779,11 @@ module Aws::S3
12695
12779
  # @return [String]
12696
12780
  #
12697
12781
  # @!attribute [rw] checksum_crc64nvme
12698
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the part. This
12782
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This
12699
12783
  # checksum is present if the multipart upload request was created with
12700
- # the `CRC-64NVME` checksum algorithm, or if the object was uploaded
12784
+ # the `CRC64NVME` checksum algorithm, or if the object was uploaded
12701
12785
  # without a checksum (and Amazon S3 added the default checksum,
12702
- # `CRC-64NVME`, to the uploaded object). For more information, see
12786
+ # `CRC64NVME`, to the uploaded object). For more information, see
12703
12787
  # [Checking object integrity][1] in the *Amazon S3 User Guide*.
12704
12788
  #
12705
12789
  #
@@ -12708,9 +12792,9 @@ module Aws::S3
12708
12792
  # @return [String]
12709
12793
  #
12710
12794
  # @!attribute [rw] checksum_sha1
12711
- # The Base64 encoded, 160-bit `SHA-1` checksum of the part. This
12795
+ # The Base64 encoded, 160-bit `SHA1` checksum of the part. This
12712
12796
  # checksum is present if the multipart upload request was created with
12713
- # the `SHA-1` checksum algorithm. For more information, see [Checking
12797
+ # the `SHA1` checksum algorithm. For more information, see [Checking
12714
12798
  # object integrity][1] in the *Amazon S3 User Guide*.
12715
12799
  #
12716
12800
  #
@@ -12719,10 +12803,10 @@ module Aws::S3
12719
12803
  # @return [String]
12720
12804
  #
12721
12805
  # @!attribute [rw] checksum_sha256
12722
- # The Base64 encoded, 256-bit `SHA-256` checksum of the part. This
12806
+ # The Base64 encoded, 256-bit `SHA256` checksum of the part. This
12723
12807
  # checksum is present if the multipart upload request was created with
12724
- # the `SHA-256` checksum algorithm. For more information, see
12725
- # [Checking object integrity][1] in the *Amazon S3 User Guide*.
12808
+ # the `SHA256` checksum algorithm. For more information, see [Checking
12809
+ # object integrity][1] in the *Amazon S3 User Guide*.
12726
12810
  #
12727
12811
  #
12728
12812
  #
@@ -12985,8 +13069,8 @@ module Aws::S3
12985
13069
  # @return [Integer]
12986
13070
  #
12987
13071
  # @!attribute [rw] checksum_crc32
12988
- # The Base64 encoded, 32-bit `CRC-32` checksum of the part. This
12989
- # checksum is present if the object was uploaded with the `CRC-32`
13072
+ # The Base64 encoded, 32-bit `CRC32` checksum of the part. This
13073
+ # checksum is present if the object was uploaded with the `CRC32`
12990
13074
  # checksum algorithm. For more information, see [Checking object
12991
13075
  # integrity][1] in the *Amazon S3 User Guide*.
12992
13076
  #
@@ -12996,8 +13080,8 @@ module Aws::S3
12996
13080
  # @return [String]
12997
13081
  #
12998
13082
  # @!attribute [rw] checksum_crc32c
12999
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the part. This
13000
- # checksum is present if the object was uploaded with the `CRC-32C`
13083
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the part. This
13084
+ # checksum is present if the object was uploaded with the `CRC32C`
13001
13085
  # checksum algorithm. For more information, see [Checking object
13002
13086
  # integrity][1] in the *Amazon S3 User Guide*.
13003
13087
  #
@@ -13007,11 +13091,11 @@ module Aws::S3
13007
13091
  # @return [String]
13008
13092
  #
13009
13093
  # @!attribute [rw] checksum_crc64nvme
13010
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the part. This
13094
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the part. This
13011
13095
  # checksum is present if the multipart upload request was created with
13012
- # the `CRC-64NVME` checksum algorithm, or if the object was uploaded
13096
+ # the `CRC64NVME` checksum algorithm, or if the object was uploaded
13013
13097
  # without a checksum (and Amazon S3 added the default checksum,
13014
- # `CRC-64NVME`, to the uploaded object). For more information, see
13098
+ # `CRC64NVME`, to the uploaded object). For more information, see
13015
13099
  # [Checking object integrity][1] in the *Amazon S3 User Guide*.
13016
13100
  #
13017
13101
  #
@@ -13020,8 +13104,8 @@ module Aws::S3
13020
13104
  # @return [String]
13021
13105
  #
13022
13106
  # @!attribute [rw] checksum_sha1
13023
- # The Base64 encoded, 160-bit `SHA-1` checksum of the part. This
13024
- # checksum is present if the object was uploaded with the `SHA-1`
13107
+ # The Base64 encoded, 160-bit `SHA1` checksum of the part. This
13108
+ # checksum is present if the object was uploaded with the `SHA1`
13025
13109
  # checksum algorithm. For more information, see [Checking object
13026
13110
  # integrity][1] in the *Amazon S3 User Guide*.
13027
13111
  #
@@ -13031,8 +13115,8 @@ module Aws::S3
13031
13115
  # @return [String]
13032
13116
  #
13033
13117
  # @!attribute [rw] checksum_sha256
13034
- # The Base64 encoded, 256-bit `SHA-256` checksum of the part. This
13035
- # checksum is present if the object was uploaded with the `SHA-256`
13118
+ # The Base64 encoded, 256-bit `SHA256` checksum of the part. This
13119
+ # checksum is present if the object was uploaded with the `SHA256`
13036
13120
  # checksum algorithm. For more information, see [Checking object
13037
13121
  # integrity][1] in the *Amazon S3 User Guide*.
13038
13122
  #
@@ -13226,7 +13310,7 @@ module Aws::S3
13226
13310
  # @return [String]
13227
13311
  #
13228
13312
  # @!attribute [rw] checksum_algorithm
13229
- # Indicates the algorithm used to create the checksum for the object
13313
+ # Indicates the algorithm used to create the checksum for the request
13230
13314
  # when you use the SDK. This header will not provide any additional
13231
13315
  # functionality if you don't use the SDK. When you send this header,
13232
13316
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13282,7 +13366,7 @@ module Aws::S3
13282
13366
  # @return [String]
13283
13367
  #
13284
13368
  # @!attribute [rw] checksum_algorithm
13285
- # Indicates the algorithm used to create the checksum for the object
13369
+ # Indicates the algorithm used to create the checksum for the request
13286
13370
  # when you use the SDK. This header will not provide any additional
13287
13371
  # functionality if you don't use the SDK. When you send this header,
13288
13372
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13408,7 +13492,7 @@ module Aws::S3
13408
13492
  # @return [String]
13409
13493
  #
13410
13494
  # @!attribute [rw] checksum_algorithm
13411
- # Indicates the algorithm used to create the checksum for the object
13495
+ # Indicates the algorithm used to create the checksum for the request
13412
13496
  # when you use the SDK. This header will not provide any additional
13413
13497
  # functionality if you don't use the SDK. When you send this header,
13414
13498
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13477,7 +13561,7 @@ module Aws::S3
13477
13561
  # @return [String]
13478
13562
  #
13479
13563
  # @!attribute [rw] checksum_algorithm
13480
- # Indicates the algorithm used to create the checksum for the object
13564
+ # Indicates the algorithm used to create the checksum for the request
13481
13565
  # when you use the SDK. This header will not provide any additional
13482
13566
  # functionality if you don't use the SDK. When you send this header,
13483
13567
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13618,7 +13702,7 @@ module Aws::S3
13618
13702
  # @return [String]
13619
13703
  #
13620
13704
  # @!attribute [rw] checksum_algorithm
13621
- # Indicates the algorithm used to create the checksum for the object
13705
+ # Indicates the algorithm used to create the checksum for the request
13622
13706
  # when you use the SDK. This header will not provide any additional
13623
13707
  # functionality if you don't use the SDK. When you send this header,
13624
13708
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13695,7 +13779,7 @@ module Aws::S3
13695
13779
  # @return [String]
13696
13780
  #
13697
13781
  # @!attribute [rw] checksum_algorithm
13698
- # Indicates the algorithm used to create the checksum for the object
13782
+ # Indicates the algorithm used to create the checksum for the request
13699
13783
  # when you use the SDK. This header will not provide any additional
13700
13784
  # functionality if you don't use the SDK. When you send this header,
13701
13785
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13750,7 +13834,7 @@ module Aws::S3
13750
13834
  # @return [String]
13751
13835
  #
13752
13836
  # @!attribute [rw] checksum_algorithm
13753
- # Indicates the algorithm used to create the checksum for the object
13837
+ # Indicates the algorithm used to create the checksum for the request
13754
13838
  # when you use the SDK. This header will not provide any additional
13755
13839
  # functionality if you don't use the SDK. When you send this header,
13756
13840
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13863,7 +13947,7 @@ module Aws::S3
13863
13947
  # @return [String]
13864
13948
  #
13865
13949
  # @!attribute [rw] checksum_algorithm
13866
- # Indicates the algorithm used to create the checksum for the object
13950
+ # Indicates the algorithm used to create the checksum for the request
13867
13951
  # when you use the SDK. This header will not provide any additional
13868
13952
  # functionality if you don't use the SDK. When you send this header,
13869
13953
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -13970,7 +14054,7 @@ module Aws::S3
13970
14054
  # @return [String]
13971
14055
  #
13972
14056
  # @!attribute [rw] checksum_algorithm
13973
- # Indicates the algorithm used to create the checksum for the object
14057
+ # Indicates the algorithm used to create the checksum for the request
13974
14058
  # when you use the SDK. This header will not provide any additional
13975
14059
  # functionality if you don't use the SDK. When you send this header,
13976
14060
  # there must be a corresponding `x-amz-checksum-algorithm ` or
@@ -13980,15 +14064,15 @@ module Aws::S3
13980
14064
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm `
13981
14065
  # with the supported algorithm from the following list:
13982
14066
  #
13983
- # * `CRC-32`
14067
+ # * `CRC32`
13984
14068
  #
13985
- # * `CRC-32C`
14069
+ # * `CRC32C`
13986
14070
  #
13987
- # * `CRC-64NVME`
14071
+ # * `CRC64NVME`
13988
14072
  #
13989
- # * `SHA-1`
14073
+ # * `SHA1`
13990
14074
  #
13991
- # * `SHA-256`
14075
+ # * `SHA256`
13992
14076
  #
13993
14077
  # For more information, see [Checking object integrity][1] in the
13994
14078
  # *Amazon S3 User Guide*.
@@ -14071,7 +14155,7 @@ module Aws::S3
14071
14155
  # @return [String]
14072
14156
  #
14073
14157
  # @!attribute [rw] checksum_algorithm
14074
- # Indicates the algorithm used to create the checksum for the object
14158
+ # Indicates the algorithm used to create the checksum for the request
14075
14159
  # when you use the SDK. This header will not provide any additional
14076
14160
  # functionality if you don't use the SDK. When you send this header,
14077
14161
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14136,7 +14220,7 @@ module Aws::S3
14136
14220
  # @return [String]
14137
14221
  #
14138
14222
  # @!attribute [rw] checksum_algorithm
14139
- # Indicates the algorithm used to create the checksum for the object
14223
+ # Indicates the algorithm used to create the checksum for the request
14140
14224
  # when you use the SDK. This header will not provide any additional
14141
14225
  # functionality if you don't use the SDK. When you send this header,
14142
14226
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14195,7 +14279,7 @@ module Aws::S3
14195
14279
  # @return [String]
14196
14280
  #
14197
14281
  # @!attribute [rw] checksum_algorithm
14198
- # Indicates the algorithm used to create the checksum for the object
14282
+ # Indicates the algorithm used to create the checksum for the request
14199
14283
  # when you use the SDK. This header will not provide any additional
14200
14284
  # functionality if you don't use the SDK. When you send this header,
14201
14285
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14254,7 +14338,7 @@ module Aws::S3
14254
14338
  # @return [String]
14255
14339
  #
14256
14340
  # @!attribute [rw] checksum_algorithm
14257
- # Indicates the algorithm used to create the checksum for the object
14341
+ # Indicates the algorithm used to create the checksum for the request
14258
14342
  # when you use the SDK. This header will not provide any additional
14259
14343
  # functionality if you don't use the SDK. When you send this header,
14260
14344
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14320,7 +14404,7 @@ module Aws::S3
14320
14404
  # @return [String]
14321
14405
  #
14322
14406
  # @!attribute [rw] checksum_algorithm
14323
- # Indicates the algorithm used to create the checksum for the object
14407
+ # Indicates the algorithm used to create the checksum for the request
14324
14408
  # when you use the SDK. This header will not provide any additional
14325
14409
  # functionality if you don't use the SDK. When you send this header,
14326
14410
  # there must be a corresponding `x-amz-checksum` or `x-amz-trailer`
@@ -14394,25 +14478,28 @@ module Aws::S3
14394
14478
  # The bucket name that contains the object to which you want to attach
14395
14479
  # the ACL.
14396
14480
  #
14397
- # **Access points** - When you use this action with an access point,
14398
- # you must provide the alias of the access point in place of the
14399
- # bucket name or specify the access point ARN. When using the access
14400
- # point ARN, you must direct requests to the access point hostname.
14401
- # The access point hostname takes the form
14481
+ # **Access points** - When you use this action with an access point
14482
+ # for general purpose buckets, you must provide the alias of the
14483
+ # access point in place of the bucket name or specify the access point
14484
+ # ARN. When you use this action with an access point for directory
14485
+ # buckets, you must provide the access point name in place of the
14486
+ # bucket name. When using the access point ARN, you must direct
14487
+ # requests to the access point hostname. The access point hostname
14488
+ # takes the form
14402
14489
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
14403
14490
  # When using this action with an access point through the Amazon Web
14404
14491
  # Services SDKs, you provide the access point ARN in place of the
14405
14492
  # bucket name. For more information about access point ARNs, see
14406
14493
  # [Using access points][1] in the *Amazon S3 User Guide*.
14407
14494
  #
14408
- # **S3 on Outposts** - When you use this action with Amazon S3 on
14409
- # Outposts, you must direct requests to the S3 on Outposts hostname.
14410
- # The S3 on Outposts hostname takes the form `
14495
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
14496
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
14497
+ # Outposts hostname takes the form `
14411
14498
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
14412
- # When you use this action with S3 on Outposts through the Amazon Web
14413
- # Services SDKs, you provide the Outposts access point ARN in place of
14414
- # the bucket name. For more information about S3 on Outposts ARNs, see
14415
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
14499
+ # When you use this action with S3 on Outposts, the destination bucket
14500
+ # must be the Outposts access point ARN or the access point alias. For
14501
+ # more information about S3 on Outposts, see [What is S3 on
14502
+ # Outposts?][2] in the *Amazon S3 User Guide*.
14416
14503
  #
14417
14504
  #
14418
14505
  #
@@ -14563,11 +14650,14 @@ module Aws::S3
14563
14650
  # The bucket name containing the object that you want to place a legal
14564
14651
  # hold on.
14565
14652
  #
14566
- # **Access points** - When you use this action with an access point,
14567
- # you must provide the alias of the access point in place of the
14568
- # bucket name or specify the access point ARN. When using the access
14569
- # point ARN, you must direct requests to the access point hostname.
14570
- # The access point hostname takes the form
14653
+ # **Access points** - When you use this action with an access point
14654
+ # for general purpose buckets, you must provide the alias of the
14655
+ # access point in place of the bucket name or specify the access point
14656
+ # ARN. When you use this action with an access point for directory
14657
+ # buckets, you must provide the access point name in place of the
14658
+ # bucket name. When using the access point ARN, you must direct
14659
+ # requests to the access point hostname. The access point hostname
14660
+ # takes the form
14571
14661
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
14572
14662
  # When using this action with an access point through the Amazon Web
14573
14663
  # Services SDKs, you provide the access point ARN in place of the
@@ -14784,7 +14874,7 @@ module Aws::S3
14784
14874
  # @return [String]
14785
14875
  #
14786
14876
  # @!attribute [rw] checksum_crc32
14787
- # The Base64 encoded, 32-bit `CRC-32 checksum` of the object. This
14877
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
14788
14878
  # checksum is only be present if the checksum was uploaded with the
14789
14879
  # object. When you use an API operation on an object that was uploaded
14790
14880
  # using multipart uploads, this value may not be a direct checksum
@@ -14799,7 +14889,7 @@ module Aws::S3
14799
14889
  # @return [String]
14800
14890
  #
14801
14891
  # @!attribute [rw] checksum_crc32c
14802
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the object. This
14892
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
14803
14893
  # checksum is only present if the checksum was uploaded with the
14804
14894
  # object. When you use an API operation on an object that was uploaded
14805
14895
  # using multipart uploads, this value may not be a direct checksum
@@ -14814,10 +14904,10 @@ module Aws::S3
14814
14904
  # @return [String]
14815
14905
  #
14816
14906
  # @!attribute [rw] checksum_crc64nvme
14817
- # The Base64 encoded, 64-bit `CRC-64NVME` checksum of the object. This
14818
- # header is present if the object was uploaded with the `CRC-64NVME`
14907
+ # The Base64 encoded, 64-bit `CRC64NVME` checksum of the object. This
14908
+ # header is present if the object was uploaded with the `CRC64NVME`
14819
14909
  # checksum algorithm, or if it was uploaded without a checksum (and
14820
- # Amazon S3 added the default checksum, `CRC-64NVME`, to the uploaded
14910
+ # Amazon S3 added the default checksum, `CRC64NVME`, to the uploaded
14821
14911
  # object). For more information about how checksums are calculated
14822
14912
  # with multipart uploads, see [Checking object integrity in the Amazon
14823
14913
  # S3 User Guide][1].
@@ -14828,7 +14918,7 @@ module Aws::S3
14828
14918
  # @return [String]
14829
14919
  #
14830
14920
  # @!attribute [rw] checksum_sha1
14831
- # The Base64 encoded, 160-bit `SHA-1` digest of the object. This will
14921
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
14832
14922
  # only be present if the object was uploaded with the object. When you
14833
14923
  # use the API operation on an object that was uploaded using multipart
14834
14924
  # uploads, this value may not be a direct checksum value of the full
@@ -14843,14 +14933,14 @@ module Aws::S3
14843
14933
  # @return [String]
14844
14934
  #
14845
14935
  # @!attribute [rw] checksum_sha256
14846
- # The Base64 encoded, 256-bit `SHA-256` digest of the object. This
14847
- # will only be present if the object was uploaded with the object.
14848
- # When you use an API operation on an object that was uploaded using
14849
- # multipart uploads, this value may not be a direct checksum value of
14850
- # the full object. Instead, it's a calculation based on the checksum
14851
- # values of each individual part. For more information about how
14852
- # checksums are calculated with multipart uploads, see [ Checking
14853
- # object integrity][1] in the *Amazon S3 User Guide*.
14936
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
14937
+ # only be present if the object was uploaded with the object. When you
14938
+ # use an API operation on an object that was uploaded using multipart
14939
+ # uploads, this value may not be a direct checksum value of the full
14940
+ # object. Instead, it's a calculation based on the checksum values of
14941
+ # each individual part. For more information about how checksums are
14942
+ # calculated with multipart uploads, see [ Checking object
14943
+ # integrity][1] in the *Amazon S3 User Guide*.
14854
14944
  #
14855
14945
  #
14856
14946
  #
@@ -15036,34 +15126,36 @@ module Aws::S3
15036
15126
  # requests are not supported. Directory bucket names must be unique in
15037
15127
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
15038
15128
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
15039
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
15129
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
15040
15130
  # naming restrictions, see [Directory bucket naming rules][1] in the
15041
15131
  # *Amazon S3 User Guide*.
15042
15132
  #
15043
- # **Access points** - When you use this action with an access point,
15044
- # you must provide the alias of the access point in place of the
15045
- # bucket name or specify the access point ARN. When using the access
15046
- # point ARN, you must direct requests to the access point hostname.
15047
- # The access point hostname takes the form
15133
+ # **Access points** - When you use this action with an access point
15134
+ # for general purpose buckets, you must provide the alias of the
15135
+ # access point in place of the bucket name or specify the access point
15136
+ # ARN. When you use this action with an access point for directory
15137
+ # buckets, you must provide the access point name in place of the
15138
+ # bucket name. When using the access point ARN, you must direct
15139
+ # requests to the access point hostname. The access point hostname
15140
+ # takes the form
15048
15141
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
15049
15142
  # When using this action with an access point through the Amazon Web
15050
15143
  # Services SDKs, you provide the access point ARN in place of the
15051
15144
  # bucket name. For more information about access point ARNs, see
15052
15145
  # [Using access points][2] in the *Amazon S3 User Guide*.
15053
15146
  #
15054
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
15055
- # directory buckets.
15147
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
15056
15148
  #
15057
15149
  # </note>
15058
15150
  #
15059
- # **S3 on Outposts** - When you use this action with Amazon S3 on
15060
- # Outposts, you must direct requests to the S3 on Outposts hostname.
15061
- # The S3 on Outposts hostname takes the form `
15151
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
15152
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
15153
+ # Outposts hostname takes the form `
15062
15154
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
15063
- # When you use this action with S3 on Outposts through the Amazon Web
15064
- # Services SDKs, you provide the Outposts access point ARN in place of
15065
- # the bucket name. For more information about S3 on Outposts ARNs, see
15066
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
15155
+ # When you use this action with S3 on Outposts, the destination bucket
15156
+ # must be the Outposts access point ARN or the access point alias. For
15157
+ # more information about S3 on Outposts, see [What is S3 on
15158
+ # Outposts?][3] in the *Amazon S3 User Guide*.
15067
15159
  #
15068
15160
  #
15069
15161
  #
@@ -15167,15 +15259,15 @@ module Aws::S3
15167
15259
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm `
15168
15260
  # with the supported algorithm from the following list:
15169
15261
  #
15170
- # * `CRC-32`
15262
+ # * `CRC32`
15171
15263
  #
15172
- # * `CRC-32C`
15264
+ # * `CRC32C`
15173
15265
  #
15174
- # * `CRC-64NVME`
15266
+ # * `CRC64NVME`
15175
15267
  #
15176
- # * `SHA-1`
15268
+ # * `SHA1`
15177
15269
  #
15178
- # * `SHA-256`
15270
+ # * `SHA256`
15179
15271
  #
15180
15272
  # For more information, see [Checking object integrity][1] in the
15181
15273
  # *Amazon S3 User Guide*.
@@ -15206,9 +15298,9 @@ module Aws::S3
15206
15298
  # @!attribute [rw] checksum_crc32
15207
15299
  # This header can be used as a data integrity check to verify that the
15208
15300
  # data received is the same data that was originally sent. This header
15209
- # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the
15210
- # object. For more information, see [Checking object integrity][1] in
15211
- # the *Amazon S3 User Guide*.
15301
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
15302
+ # For more information, see [Checking object integrity][1] in the
15303
+ # *Amazon S3 User Guide*.
15212
15304
  #
15213
15305
  #
15214
15306
  #
@@ -15218,7 +15310,7 @@ module Aws::S3
15218
15310
  # @!attribute [rw] checksum_crc32c
15219
15311
  # This header can be used as a data integrity check to verify that the
15220
15312
  # data received is the same data that was originally sent. This header
15221
- # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the
15313
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the
15222
15314
  # object. For more information, see [Checking object integrity][1] in
15223
15315
  # the *Amazon S3 User Guide*.
15224
15316
  #
@@ -15230,8 +15322,8 @@ module Aws::S3
15230
15322
  # @!attribute [rw] checksum_crc64nvme
15231
15323
  # This header can be used as a data integrity check to verify that the
15232
15324
  # data received is the same data that was originally sent. This header
15233
- # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
15234
- # object. The `CRC-64NVME` checksum is always a full object checksum.
15325
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
15326
+ # object. The `CRC64NVME` checksum is always a full object checksum.
15235
15327
  # For more information, see [Checking object integrity in the Amazon
15236
15328
  # S3 User Guide][1].
15237
15329
  #
@@ -15243,7 +15335,7 @@ module Aws::S3
15243
15335
  # @!attribute [rw] checksum_sha1
15244
15336
  # This header can be used as a data integrity check to verify that the
15245
15337
  # data received is the same data that was originally sent. This header
15246
- # specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
15338
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object.
15247
15339
  # For more information, see [Checking object integrity][1] in the
15248
15340
  # *Amazon S3 User Guide*.
15249
15341
  #
@@ -15255,9 +15347,9 @@ module Aws::S3
15255
15347
  # @!attribute [rw] checksum_sha256
15256
15348
  # This header can be used as a data integrity check to verify that the
15257
15349
  # data received is the same data that was originally sent. This header
15258
- # specifies the Base64 encoded, 256-bit `SHA-256` digest of the
15259
- # object. For more information, see [Checking object integrity][1] in
15260
- # the *Amazon S3 User Guide*.
15350
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
15351
+ # For more information, see [Checking object integrity][1] in the
15352
+ # *Amazon S3 User Guide*.
15261
15353
  #
15262
15354
  #
15263
15355
  #
@@ -15450,8 +15542,10 @@ module Aws::S3
15450
15542
  # specify a different Storage Class. For more information, see
15451
15543
  # [Storage Classes][1] in the *Amazon S3 User Guide*.
15452
15544
  #
15453
- # <note markdown="1"> * For directory buckets, only the S3 Express One Zone storage class
15454
- # is supported to store newly created objects.
15545
+ # <note markdown="1"> * Directory buckets only support `EXPRESS_ONEZONE` (the S3 Express
15546
+ # One Zone storage class) in Availability Zones and `ONEZONE_IA`
15547
+ # (the S3 One Zone-Infrequent Access storage class) in Dedicated
15548
+ # Local Zones.
15455
15549
  #
15456
15550
  # * Amazon S3 on Outposts only uses the OUTPOSTS Storage Class.
15457
15551
  #
@@ -15540,21 +15634,17 @@ module Aws::S3
15540
15634
  # `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
15541
15635
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
15542
15636
  #
15543
- # **Directory buckets** - If you specify
15544
- # `x-amz-server-side-encryption` with `aws:kms`, the `
15545
- # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
15546
- # assigned the ID of the KMS symmetric encryption customer managed key
15547
- # that's configured for your directory bucket's default encryption
15548
- # setting. If you want to specify the `
15549
- # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
15550
- # can only specify it with the ID (Key ID or Key ARN) of the KMS
15551
- # customer managed key that's configured for your directory bucket's
15552
- # default encryption setting. Otherwise, you get an HTTP `400 Bad
15553
- # Request` error. Only use the key ID or key ARN. The key alias format
15554
- # of the KMS key isn't supported. Your SSE-KMS configuration can only
15555
- # support 1 [customer managed key][1] per directory bucket for the
15556
- # lifetime of the bucket. The [Amazon Web Services managed key][2]
15557
- # (`aws/s3`) isn't supported.
15637
+ # **Directory buckets** - To encrypt data using SSE-KMS, it's
15638
+ # recommended to specify the `x-amz-server-side-encryption` header to
15639
+ # `aws:kms`. Then, the `x-amz-server-side-encryption-aws-kms-key-id`
15640
+ # header implicitly uses the bucket's default KMS customer managed
15641
+ # key ID. If you want to explicitly set the `
15642
+ # x-amz-server-side-encryption-aws-kms-key-id` header, it must match
15643
+ # the bucket's default customer managed key (using key ID or ARN, not
15644
+ # alias). Your SSE-KMS configuration can only support 1 [customer
15645
+ # managed key][1] per directory bucket's lifetime. The [Amazon Web
15646
+ # Services managed key][2] (`aws/s3`) isn't supported. Incorrect key
15647
+ # specification results in an HTTP `400 Bad Request` error.
15558
15648
  #
15559
15649
  #
15560
15650
  #
@@ -15748,11 +15838,14 @@ module Aws::S3
15748
15838
  # The bucket name that contains the object you want to apply this
15749
15839
  # Object Retention configuration to.
15750
15840
  #
15751
- # **Access points** - When you use this action with an access point,
15752
- # you must provide the alias of the access point in place of the
15753
- # bucket name or specify the access point ARN. When using the access
15754
- # point ARN, you must direct requests to the access point hostname.
15755
- # The access point hostname takes the form
15841
+ # **Access points** - When you use this action with an access point
15842
+ # for general purpose buckets, you must provide the alias of the
15843
+ # access point in place of the bucket name or specify the access point
15844
+ # ARN. When you use this action with an access point for directory
15845
+ # buckets, you must provide the access point name in place of the
15846
+ # bucket name. When using the access point ARN, you must direct
15847
+ # requests to the access point hostname. The access point hostname
15848
+ # takes the form
15756
15849
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
15757
15850
  # When using this action with an access point through the Amazon Web
15758
15851
  # Services SDKs, you provide the access point ARN in place of the
@@ -15864,25 +15957,28 @@ module Aws::S3
15864
15957
  # @!attribute [rw] bucket
15865
15958
  # The bucket name containing the object.
15866
15959
  #
15867
- # **Access points** - When you use this action with an access point,
15868
- # you must provide the alias of the access point in place of the
15869
- # bucket name or specify the access point ARN. When using the access
15870
- # point ARN, you must direct requests to the access point hostname.
15871
- # The access point hostname takes the form
15960
+ # **Access points** - When you use this action with an access point
15961
+ # for general purpose buckets, you must provide the alias of the
15962
+ # access point in place of the bucket name or specify the access point
15963
+ # ARN. When you use this action with an access point for directory
15964
+ # buckets, you must provide the access point name in place of the
15965
+ # bucket name. When using the access point ARN, you must direct
15966
+ # requests to the access point hostname. The access point hostname
15967
+ # takes the form
15872
15968
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
15873
15969
  # When using this action with an access point through the Amazon Web
15874
15970
  # Services SDKs, you provide the access point ARN in place of the
15875
15971
  # bucket name. For more information about access point ARNs, see
15876
15972
  # [Using access points][1] in the *Amazon S3 User Guide*.
15877
15973
  #
15878
- # **S3 on Outposts** - When you use this action with Amazon S3 on
15879
- # Outposts, you must direct requests to the S3 on Outposts hostname.
15880
- # The S3 on Outposts hostname takes the form `
15974
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
15975
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
15976
+ # Outposts hostname takes the form `
15881
15977
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
15882
- # When you use this action with S3 on Outposts through the Amazon Web
15883
- # Services SDKs, you provide the Outposts access point ARN in place of
15884
- # the bucket name. For more information about S3 on Outposts ARNs, see
15885
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
15978
+ # When you use this action with S3 on Outposts, the destination bucket
15979
+ # must be the Outposts access point ARN or the access point alias. For
15980
+ # more information about S3 on Outposts, see [What is S3 on
15981
+ # Outposts?][2] in the *Amazon S3 User Guide*.
15886
15982
  #
15887
15983
  #
15888
15984
  #
@@ -16117,7 +16213,7 @@ module Aws::S3
16117
16213
  # record frame. To ensure continuous streaming of data, S3 Select
16118
16214
  # might split the same record across multiple record frames instead of
16119
16215
  # aggregating the results in memory. Some S3 clients (for example, the
16120
- # SDK for Java) handle this behavior by creating a `ByteStream` out of
16216
+ # SDKforJava) handle this behavior by creating a `ByteStream` out of
16121
16217
  # the response by default. Other clients might not handle this
16122
16218
  # behavior by default. In those cases, you must aggregate the results
16123
16219
  # on the client side and parse the response.
@@ -16558,25 +16654,28 @@ module Aws::S3
16558
16654
  # @!attribute [rw] bucket
16559
16655
  # The bucket name containing the object to restore.
16560
16656
  #
16561
- # **Access points** - When you use this action with an access point,
16562
- # you must provide the alias of the access point in place of the
16563
- # bucket name or specify the access point ARN. When using the access
16564
- # point ARN, you must direct requests to the access point hostname.
16565
- # The access point hostname takes the form
16657
+ # **Access points** - When you use this action with an access point
16658
+ # for general purpose buckets, you must provide the alias of the
16659
+ # access point in place of the bucket name or specify the access point
16660
+ # ARN. When you use this action with an access point for directory
16661
+ # buckets, you must provide the access point name in place of the
16662
+ # bucket name. When using the access point ARN, you must direct
16663
+ # requests to the access point hostname. The access point hostname
16664
+ # takes the form
16566
16665
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
16567
16666
  # When using this action with an access point through the Amazon Web
16568
16667
  # Services SDKs, you provide the access point ARN in place of the
16569
16668
  # bucket name. For more information about access point ARNs, see
16570
16669
  # [Using access points][1] in the *Amazon S3 User Guide*.
16571
16670
  #
16572
- # **S3 on Outposts** - When you use this action with Amazon S3 on
16573
- # Outposts, you must direct requests to the S3 on Outposts hostname.
16574
- # The S3 on Outposts hostname takes the form `
16671
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
16672
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
16673
+ # Outposts hostname takes the form `
16575
16674
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
16576
- # When you use this action with S3 on Outposts through the Amazon Web
16577
- # Services SDKs, you provide the Outposts access point ARN in place of
16578
- # the bucket name. For more information about S3 on Outposts ARNs, see
16579
- # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
16675
+ # When you use this action with S3 on Outposts, the destination bucket
16676
+ # must be the Outposts access point ARN or the access point alias. For
16677
+ # more information about S3 on Outposts, see [What is S3 on
16678
+ # Outposts?][2] in the *Amazon S3 User Guide*.
16580
16679
  #
16581
16680
  #
16582
16681
  #
@@ -16723,9 +16822,10 @@ module Aws::S3
16723
16822
  # archived objects, see [ Working with archived objects][1] in the
16724
16823
  # *Amazon S3 User Guide*.
16725
16824
  #
16726
- # <note markdown="1"> This functionality is not supported for directory buckets. Only the S3
16727
- # Express One Zone storage class is supported by directory buckets to
16728
- # store objects.
16825
+ # <note markdown="1"> This functionality is not supported for directory buckets. Directory
16826
+ # buckets only support `EXPRESS_ONEZONE` (the S3 Express One Zone
16827
+ # storage class) in Availability Zones and `ONEZONE_IA` (the S3 One
16828
+ # Zone-Infrequent Access storage class) in Dedicated Local Zones.
16729
16829
  #
16730
16830
  # </note>
16731
16831
  #
@@ -17296,9 +17396,8 @@ module Aws::S3
17296
17396
  # to a bucket. By default, Amazon S3 uses this KMS key for SSE-KMS.
17297
17397
  #
17298
17398
  # * **Directory buckets** - Your SSE-KMS configuration can only support
17299
- # 1 [customer managed key][2] per directory bucket for the lifetime of
17300
- # the bucket. The [Amazon Web Services managed key][3] (`aws/s3`)
17301
- # isn't supported.
17399
+ # 1 [customer managed key][2] per directory bucket's lifetime. The
17400
+ # [Amazon Web Services managed key][3] (`aws/s3`) isn't supported.
17302
17401
  #
17303
17402
  # * **Directory buckets** - For directory buckets, there are only two
17304
17403
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
@@ -17876,8 +17975,19 @@ module Aws::S3
17876
17975
  #
17877
17976
  # @!attribute [rw] days
17878
17977
  # Indicates the number of days after creation when objects are
17879
- # transitioned to the specified storage class. The value must be a
17880
- # positive integer.
17978
+ # transitioned to the specified storage class. If the specified
17979
+ # storage class is `INTELLIGENT_TIERING`, `GLACIER_IR`, `GLACIER`, or
17980
+ # `DEEP_ARCHIVE`, valid values are `0` or positive integers. If the
17981
+ # specified storage class is `STANDARD_IA` or `ONEZONE_IA`, valid
17982
+ # values are positive integers greater than `30`. Be aware that some
17983
+ # storage classes have a minimum storage duration and that you're
17984
+ # charged for transitioning objects before their minimum storage
17985
+ # duration. For more information, see [ Constraints and considerations
17986
+ # for transitions][1] in the *Amazon S3 User Guide*.
17987
+ #
17988
+ #
17989
+ #
17990
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/lifecycle-transition-general-considerations.html#lifecycle-configuration-constraints
17881
17991
  # @return [Integer]
17882
17992
  #
17883
17993
  # @!attribute [rw] storage_class
@@ -17978,7 +18088,7 @@ module Aws::S3
17978
18088
  # requests are not supported. Directory bucket names must be unique in
17979
18089
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
17980
18090
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
17981
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18091
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
17982
18092
  # naming restrictions, see [Directory bucket naming rules][1] in the
17983
18093
  # *Amazon S3 User Guide*.
17984
18094
  #
@@ -17990,30 +18100,32 @@ module Aws::S3
17990
18100
  #
17991
18101
  # </note>
17992
18102
  #
17993
- # **Access points** - When you use this action with an access point,
17994
- # you must provide the alias of the access point in place of the
17995
- # bucket name or specify the access point ARN. When using the access
17996
- # point ARN, you must direct requests to the access point hostname.
17997
- # The access point hostname takes the form
18103
+ # **Access points** - When you use this action with an access point
18104
+ # for general purpose buckets, you must provide the alias of the
18105
+ # access point in place of the bucket name or specify the access point
18106
+ # ARN. When you use this action with an access point for directory
18107
+ # buckets, you must provide the access point name in place of the
18108
+ # bucket name. When using the access point ARN, you must direct
18109
+ # requests to the access point hostname. The access point hostname
18110
+ # takes the form
17998
18111
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
17999
18112
  # When using this action with an access point through the Amazon Web
18000
18113
  # Services SDKs, you provide the access point ARN in place of the
18001
18114
  # bucket name. For more information about access point ARNs, see
18002
18115
  # [Using access points][2] in the *Amazon S3 User Guide*.
18003
18116
  #
18004
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
18005
- # directory buckets.
18117
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
18006
18118
  #
18007
18119
  # </note>
18008
18120
  #
18009
- # **S3 on Outposts** - When you use this action with Amazon S3 on
18010
- # Outposts, you must direct requests to the S3 on Outposts hostname.
18011
- # The S3 on Outposts hostname takes the form `
18121
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
18122
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
18123
+ # Outposts hostname takes the form `
18012
18124
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
18013
- # When you use this action with S3 on Outposts through the Amazon Web
18014
- # Services SDKs, you provide the Outposts access point ARN in place of
18015
- # the bucket name. For more information about S3 on Outposts ARNs, see
18016
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
18125
+ # When you use this action with S3 on Outposts, the destination bucket
18126
+ # must be the Outposts access point ARN or the access point alias. For
18127
+ # more information about S3 on Outposts, see [What is S3 on
18128
+ # Outposts?][3] in the *Amazon S3 User Guide*.
18017
18129
  #
18018
18130
  #
18019
18131
  #
@@ -18308,7 +18420,7 @@ module Aws::S3
18308
18420
  # @return [String]
18309
18421
  #
18310
18422
  # @!attribute [rw] checksum_crc32
18311
- # The Base64 encoded, 32-bit `CRC-32 checksum` of the object. This
18423
+ # The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
18312
18424
  # checksum is only be present if the checksum was uploaded with the
18313
18425
  # object. When you use an API operation on an object that was uploaded
18314
18426
  # using multipart uploads, this value may not be a direct checksum
@@ -18323,7 +18435,7 @@ module Aws::S3
18323
18435
  # @return [String]
18324
18436
  #
18325
18437
  # @!attribute [rw] checksum_crc32c
18326
- # The Base64 encoded, 32-bit `CRC-32C` checksum of the object. This
18438
+ # The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
18327
18439
  # checksum is only present if the checksum was uploaded with the
18328
18440
  # object. When you use an API operation on an object that was uploaded
18329
18441
  # using multipart uploads, this value may not be a direct checksum
@@ -18340,7 +18452,7 @@ module Aws::S3
18340
18452
  # @!attribute [rw] checksum_crc64nvme
18341
18453
  # This header can be used as a data integrity check to verify that the
18342
18454
  # data received is the same data that was originally sent. This header
18343
- # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
18455
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
18344
18456
  # part. For more information, see [Checking object integrity][1] in
18345
18457
  # the *Amazon S3 User Guide*.
18346
18458
  #
@@ -18350,7 +18462,7 @@ module Aws::S3
18350
18462
  # @return [String]
18351
18463
  #
18352
18464
  # @!attribute [rw] checksum_sha1
18353
- # The Base64 encoded, 160-bit `SHA-1` digest of the object. This will
18465
+ # The Base64 encoded, 160-bit `SHA1` digest of the object. This will
18354
18466
  # only be present if the object was uploaded with the object. When you
18355
18467
  # use the API operation on an object that was uploaded using multipart
18356
18468
  # uploads, this value may not be a direct checksum value of the full
@@ -18365,14 +18477,14 @@ module Aws::S3
18365
18477
  # @return [String]
18366
18478
  #
18367
18479
  # @!attribute [rw] checksum_sha256
18368
- # The Base64 encoded, 256-bit `SHA-256` digest of the object. This
18369
- # will only be present if the object was uploaded with the object.
18370
- # When you use an API operation on an object that was uploaded using
18371
- # multipart uploads, this value may not be a direct checksum value of
18372
- # the full object. Instead, it's a calculation based on the checksum
18373
- # values of each individual part. For more information about how
18374
- # checksums are calculated with multipart uploads, see [ Checking
18375
- # object integrity][1] in the *Amazon S3 User Guide*.
18480
+ # The Base64 encoded, 256-bit `SHA256` digest of the object. This will
18481
+ # only be present if the object was uploaded with the object. When you
18482
+ # use an API operation on an object that was uploaded using multipart
18483
+ # uploads, this value may not be a direct checksum value of the full
18484
+ # object. Instead, it's a calculation based on the checksum values of
18485
+ # each individual part. For more information about how checksums are
18486
+ # calculated with multipart uploads, see [ Checking object
18487
+ # integrity][1] in the *Amazon S3 User Guide*.
18376
18488
  #
18377
18489
  #
18378
18490
  #
@@ -18452,34 +18564,36 @@ module Aws::S3
18452
18564
  # requests are not supported. Directory bucket names must be unique in
18453
18565
  # the chosen Zone (Availability Zone or Local Zone). Bucket names must
18454
18566
  # follow the format ` bucket-base-name--zone-id--x-s3` (for example, `
18455
- # DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
18567
+ # amzn-s3-demo-bucket--usw2-az1--x-s3`). For information about bucket
18456
18568
  # naming restrictions, see [Directory bucket naming rules][1] in the
18457
18569
  # *Amazon S3 User Guide*.
18458
18570
  #
18459
- # **Access points** - When you use this action with an access point,
18460
- # you must provide the alias of the access point in place of the
18461
- # bucket name or specify the access point ARN. When using the access
18462
- # point ARN, you must direct requests to the access point hostname.
18463
- # The access point hostname takes the form
18571
+ # **Access points** - When you use this action with an access point
18572
+ # for general purpose buckets, you must provide the alias of the
18573
+ # access point in place of the bucket name or specify the access point
18574
+ # ARN. When you use this action with an access point for directory
18575
+ # buckets, you must provide the access point name in place of the
18576
+ # bucket name. When using the access point ARN, you must direct
18577
+ # requests to the access point hostname. The access point hostname
18578
+ # takes the form
18464
18579
  # *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
18465
18580
  # When using this action with an access point through the Amazon Web
18466
18581
  # Services SDKs, you provide the access point ARN in place of the
18467
18582
  # bucket name. For more information about access point ARNs, see
18468
18583
  # [Using access points][2] in the *Amazon S3 User Guide*.
18469
18584
  #
18470
- # <note markdown="1"> Access points and Object Lambda access points are not supported by
18471
- # directory buckets.
18585
+ # <note markdown="1"> Object Lambda access points are not supported by directory buckets.
18472
18586
  #
18473
18587
  # </note>
18474
18588
  #
18475
- # **S3 on Outposts** - When you use this action with Amazon S3 on
18476
- # Outposts, you must direct requests to the S3 on Outposts hostname.
18477
- # The S3 on Outposts hostname takes the form `
18589
+ # **S3 on Outposts** - When you use this action with S3 on Outposts,
18590
+ # you must direct requests to the S3 on Outposts hostname. The S3 on
18591
+ # Outposts hostname takes the form `
18478
18592
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
18479
- # When you use this action with S3 on Outposts through the Amazon Web
18480
- # Services SDKs, you provide the Outposts access point ARN in place of
18481
- # the bucket name. For more information about S3 on Outposts ARNs, see
18482
- # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
18593
+ # When you use this action with S3 on Outposts, the destination bucket
18594
+ # must be the Outposts access point ARN or the access point alias. For
18595
+ # more information about S3 on Outposts, see [What is S3 on
18596
+ # Outposts?][3] in the *Amazon S3 User Guide*.
18483
18597
  #
18484
18598
  #
18485
18599
  #
@@ -18526,9 +18640,9 @@ module Aws::S3
18526
18640
  # @!attribute [rw] checksum_crc32
18527
18641
  # This header can be used as a data integrity check to verify that the
18528
18642
  # data received is the same data that was originally sent. This header
18529
- # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the
18530
- # object. For more information, see [Checking object integrity][1] in
18531
- # the *Amazon S3 User Guide*.
18643
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
18644
+ # For more information, see [Checking object integrity][1] in the
18645
+ # *Amazon S3 User Guide*.
18532
18646
  #
18533
18647
  #
18534
18648
  #
@@ -18538,7 +18652,7 @@ module Aws::S3
18538
18652
  # @!attribute [rw] checksum_crc32c
18539
18653
  # This header can be used as a data integrity check to verify that the
18540
18654
  # data received is the same data that was originally sent. This header
18541
- # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the
18655
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the
18542
18656
  # object. For more information, see [Checking object integrity][1] in
18543
18657
  # the *Amazon S3 User Guide*.
18544
18658
  #
@@ -18550,7 +18664,7 @@ module Aws::S3
18550
18664
  # @!attribute [rw] checksum_crc64nvme
18551
18665
  # This header can be used as a data integrity check to verify that the
18552
18666
  # data received is the same data that was originally sent. This header
18553
- # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
18667
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
18554
18668
  # part. For more information, see [Checking object integrity][1] in
18555
18669
  # the *Amazon S3 User Guide*.
18556
18670
  #
@@ -18562,7 +18676,7 @@ module Aws::S3
18562
18676
  # @!attribute [rw] checksum_sha1
18563
18677
  # This header can be used as a data integrity check to verify that the
18564
18678
  # data received is the same data that was originally sent. This header
18565
- # specifies the Base64 encoded, 160-bit `SHA-1` digest of the object.
18679
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object.
18566
18680
  # For more information, see [Checking object integrity][1] in the
18567
18681
  # *Amazon S3 User Guide*.
18568
18682
  #
@@ -18574,9 +18688,9 @@ module Aws::S3
18574
18688
  # @!attribute [rw] checksum_sha256
18575
18689
  # This header can be used as a data integrity check to verify that the
18576
18690
  # data received is the same data that was originally sent. This header
18577
- # specifies the Base64 encoded, 256-bit `SHA-256` digest of the
18578
- # object. For more information, see [Checking object integrity][1] in
18579
- # the *Amazon S3 User Guide*.
18691
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
18692
+ # For more information, see [Checking object integrity][1] in the
18693
+ # *Amazon S3 User Guide*.
18580
18694
  #
18581
18695
  #
18582
18696
  #
@@ -18841,7 +18955,7 @@ module Aws::S3
18841
18955
  # @!attribute [rw] checksum_crc32
18842
18956
  # This header can be used as a data integrity check to verify that the
18843
18957
  # data received is the same data that was originally sent. This
18844
- # specifies the Base64 encoded, 32-bit `CRC-32` checksum of the object
18958
+ # specifies the Base64 encoded, 32-bit `CRC32` checksum of the object
18845
18959
  # returned by the Object Lambda function. This may not match the
18846
18960
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
18847
18961
  # validation of the checksum values only when the original `GetObject`
@@ -18862,13 +18976,13 @@ module Aws::S3
18862
18976
  # @!attribute [rw] checksum_crc32c
18863
18977
  # This header can be used as a data integrity check to verify that the
18864
18978
  # data received is the same data that was originally sent. This
18865
- # specifies the Base64 encoded, 32-bit `CRC-32C` checksum of the
18866
- # object returned by the Object Lambda function. This may not match
18867
- # the checksum for the object stored in Amazon S3. Amazon S3 will
18868
- # perform validation of the checksum values only when the original
18869
- # `GetObject` request required checksum validation. For more
18870
- # information about checksums, see [Checking object integrity][1] in
18871
- # the *Amazon S3 User Guide*.
18979
+ # specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object
18980
+ # returned by the Object Lambda function. This may not match the
18981
+ # checksum for the object stored in Amazon S3. Amazon S3 will perform
18982
+ # validation of the checksum values only when the original `GetObject`
18983
+ # request required checksum validation. For more information about
18984
+ # checksums, see [Checking object integrity][1] in the *Amazon S3 User
18985
+ # Guide*.
18872
18986
  #
18873
18987
  # Only one checksum header can be specified at a time. If you supply
18874
18988
  # multiple checksum headers, this request will fail.
@@ -18881,7 +18995,7 @@ module Aws::S3
18881
18995
  # @!attribute [rw] checksum_crc64nvme
18882
18996
  # This header can be used as a data integrity check to verify that the
18883
18997
  # data received is the same data that was originally sent. This header
18884
- # specifies the Base64 encoded, 64-bit `CRC-64NVME` checksum of the
18998
+ # specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
18885
18999
  # part. For more information, see [Checking object integrity][1] in
18886
19000
  # the *Amazon S3 User Guide*.
18887
19001
  #
@@ -18893,7 +19007,7 @@ module Aws::S3
18893
19007
  # @!attribute [rw] checksum_sha1
18894
19008
  # This header can be used as a data integrity check to verify that the
18895
19009
  # data received is the same data that was originally sent. This
18896
- # specifies the Base64 encoded, 160-bit `SHA-1` digest of the object
19010
+ # specifies the Base64 encoded, 160-bit `SHA1` digest of the object
18897
19011
  # returned by the Object Lambda function. This may not match the
18898
19012
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
18899
19013
  # validation of the checksum values only when the original `GetObject`
@@ -18912,7 +19026,7 @@ module Aws::S3
18912
19026
  # @!attribute [rw] checksum_sha256
18913
19027
  # This header can be used as a data integrity check to verify that the
18914
19028
  # data received is the same data that was originally sent. This
18915
- # specifies the Base64 encoded, 256-bit `SHA-256` digest of the object
19029
+ # specifies the Base64 encoded, 256-bit `SHA256` digest of the object
18916
19030
  # returned by the Object Lambda function. This may not match the
18917
19031
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
18918
19032
  # validation of the checksum values only when the original `GetObject`
@@ -18930,7 +19044,12 @@ module Aws::S3
18930
19044
  #
18931
19045
  # @!attribute [rw] delete_marker
18932
19046
  # Specifies whether an object stored in Amazon S3 is (`true`) or is
18933
- # not (`false`) a delete marker.
19047
+ # not (`false`) a delete marker. To learn more about delete markers,
19048
+ # see [Working with delete markers][1].
19049
+ #
19050
+ #
19051
+ #
19052
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeleteMarker.html
18934
19053
  # @return [Boolean]
18935
19054
  #
18936
19055
  # @!attribute [rw] etag