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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +25 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +35 -37
- data/lib/aws-sdk-s3/bucket_acl.rb +1 -1
- data/lib/aws-sdk-s3/bucket_cors.rb +1 -1
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +1 -1
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +1 -1
- data/lib/aws-sdk-s3/bucket_logging.rb +1 -1
- data/lib/aws-sdk-s3/bucket_policy.rb +6 -6
- data/lib/aws-sdk-s3/bucket_request_payment.rb +1 -1
- data/lib/aws-sdk-s3/bucket_tagging.rb +1 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +3 -3
- data/lib/aws-sdk-s3/bucket_website.rb +1 -1
- data/lib/aws-sdk-s3/client.rb +844 -782
- data/lib/aws-sdk-s3/client_api.rb +1 -0
- data/lib/aws-sdk-s3/endpoint_provider.rb +369 -281
- data/lib/aws-sdk-s3/multipart_upload.rb +14 -12
- data/lib/aws-sdk-s3/multipart_upload_part.rb +23 -23
- data/lib/aws-sdk-s3/object.rb +86 -90
- data/lib/aws-sdk-s3/object_summary.rb +74 -85
- data/lib/aws-sdk-s3/object_version.rb +6 -15
- data/lib/aws-sdk-s3/resource.rb +1 -1
- data/lib/aws-sdk-s3/types.rb +779 -660
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +1 -1
- data/sig/client.rbs +3 -2
- data/sig/object.rbs +3 -0
- data/sig/resource.rbs +1 -1
- data/sig/types.rbs +3 -2
- metadata +2 -2
data/lib/aws-sdk-s3/types.rb
CHANGED
@@ -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
|
-
#
|
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
|
68
|
-
# bucket name or specify the access point
|
69
|
-
#
|
70
|
-
#
|
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">
|
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
|
83
|
-
#
|
84
|
-
#
|
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
|
87
|
-
#
|
88
|
-
#
|
89
|
-
#
|
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 `
|
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 `
|
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 `
|
689
|
-
# checksum is present if the object was uploaded with the `
|
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, `
|
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 `
|
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 `
|
717
|
-
#
|
718
|
-
#
|
719
|
-
#
|
720
|
-
#
|
721
|
-
#
|
722
|
-
#
|
723
|
-
#
|
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 `
|
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 `
|
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 `
|
885
|
-
# object. The `
|
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 `
|
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 `
|
911
|
-
#
|
912
|
-
#
|
913
|
-
#
|
914
|
-
#
|
915
|
-
#
|
916
|
-
#
|
917
|
-
#
|
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
|
-
#
|
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
|
1010
|
-
# bucket name or specify the access point
|
1011
|
-
#
|
1012
|
-
#
|
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">
|
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
|
1025
|
-
#
|
1026
|
-
#
|
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
|
1029
|
-
#
|
1030
|
-
#
|
1031
|
-
#
|
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 `
|
1056
|
-
#
|
1057
|
-
#
|
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 `
|
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 `
|
1080
|
-
# object. The `
|
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 `
|
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 `
|
1105
|
-
#
|
1106
|
-
#
|
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 `
|
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 `
|
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 `
|
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 `
|
1309
|
-
#
|
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 `
|
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 `
|
1320
|
-
#
|
1321
|
-
#
|
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 `
|
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 `
|
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 `
|
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 `
|
1343
|
-
#
|
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
|
-
#
|
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
|
1594
|
-
# bucket name or specify the access point
|
1595
|
-
#
|
1596
|
-
#
|
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">
|
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
|
1609
|
-
#
|
1610
|
-
#
|
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
|
-
#
|
1613
|
-
#
|
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> -
|
2029
|
-
# Express One Zone storage class
|
2030
|
-
#
|
2031
|
-
#
|
2032
|
-
#
|
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** -
|
2133
|
-
# `x-amz-server-side-encryption`
|
2134
|
-
# x-amz-server-side-encryption-aws-kms-key-id`
|
2135
|
-
#
|
2136
|
-
#
|
2137
|
-
#
|
2138
|
-
#
|
2139
|
-
#
|
2140
|
-
#
|
2141
|
-
#
|
2142
|
-
#
|
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 `
|
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 `
|
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 `
|
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
|
-
# `
|
2463
|
+
# `CRC64NVME` checksum algorithm, or if the object was uploaded
|
2456
2464
|
# without a checksum (and Amazon S3 added the default checksum,
|
2457
|
-
# `
|
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 `
|
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 `
|
2478
|
-
#
|
2479
|
-
#
|
2480
|
-
#
|
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 `
|
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 `
|
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 `
|
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 `
|
2540
|
-
#
|
2541
|
-
#
|
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 `
|
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 `
|
2564
|
-
#
|
2565
|
-
#
|
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.
|
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/
|
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.
|
2613
|
-
# must be
|
2614
|
-
#
|
2615
|
-
#
|
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
|
-
#
|
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
|
3015
|
-
# bucket name or specify the access point
|
3016
|
-
#
|
3017
|
-
#
|
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">
|
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
|
3030
|
-
#
|
3031
|
-
#
|
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
|
3034
|
-
#
|
3035
|
-
#
|
3036
|
-
#
|
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"> *
|
3405
|
-
#
|
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** -
|
3475
|
-
# `x-amz-server-side-encryption`
|
3476
|
-
# x-amz-server-side-encryption-aws-kms-key-id`
|
3477
|
-
#
|
3478
|
-
#
|
3479
|
-
#
|
3480
|
-
#
|
3481
|
-
#
|
3482
|
-
#
|
3483
|
-
#
|
3484
|
-
#
|
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/
|
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
|
3738
|
-
#
|
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
|
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
|
-
#
|
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
|
4366
|
-
# bucket name or specify the access point
|
4367
|
-
#
|
4368
|
-
#
|
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">
|
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
|
4381
|
-
#
|
4382
|
-
#
|
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
|
4385
|
-
#
|
4386
|
-
#
|
4387
|
-
#
|
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://
|
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
|
4536
|
-
# bucket name or specify the access point
|
4537
|
-
#
|
4538
|
-
#
|
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
|
4546
|
-
#
|
4547
|
-
#
|
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
|
4550
|
-
#
|
4551
|
-
#
|
4552
|
-
#
|
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
|
-
#
|
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
|
4631
|
-
# bucket name or specify the access point
|
4632
|
-
#
|
4633
|
-
#
|
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">
|
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
|
4646
|
-
#
|
4647
|
-
#
|
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
|
4650
|
-
#
|
4651
|
-
#
|
4652
|
-
#
|
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
|
-
# * `
|
4760
|
+
# * `CRC32`
|
4737
4761
|
#
|
4738
|
-
# * `
|
4762
|
+
# * `CRC32C`
|
4739
4763
|
#
|
4740
|
-
# * `
|
4764
|
+
# * `CRC64NVME`
|
4741
4765
|
#
|
4742
|
-
# * `
|
4766
|
+
# * `SHA1`
|
4743
4767
|
#
|
4744
|
-
# * `
|
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].
|
6367
|
-
#
|
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">
|
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
|
6955
|
-
# bucket name or specify the access point
|
6956
|
-
#
|
6957
|
-
#
|
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** -
|
7070
|
-
#
|
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
|
-
#
|
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
|
7171
|
-
# bucket name or specify the access point
|
7172
|
-
#
|
7173
|
-
#
|
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">
|
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
|
7186
|
-
#
|
7187
|
-
#
|
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
|
7190
|
-
#
|
7191
|
-
#
|
7192
|
-
#
|
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
|
7322
|
-
# bucket name or specify the access point
|
7323
|
-
#
|
7324
|
-
#
|
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
|
7400
|
-
# bucket name or specify the access point
|
7401
|
-
#
|
7402
|
-
#
|
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.
|
7477
|
-
#
|
7478
|
-
#
|
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 `
|
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 `
|
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 `
|
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 `
|
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 `
|
7546
|
-
#
|
7547
|
-
#
|
7548
|
-
#
|
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> -
|
7678
|
-
#
|
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
|
-
#
|
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
|
7810
|
-
# bucket name or specify the access point
|
7811
|
-
#
|
7812
|
-
#
|
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">
|
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
|
7831
|
-
#
|
7832
|
-
#
|
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
|
7835
|
-
#
|
7836
|
-
#
|
7837
|
-
#
|
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
|
8168
|
-
# bucket name or specify the access point
|
8169
|
-
#
|
8170
|
-
#
|
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
|
8253
|
-
# bucket name or specify the access point
|
8254
|
-
#
|
8255
|
-
#
|
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
|
8263
|
-
#
|
8264
|
-
#
|
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
|
8267
|
-
#
|
8268
|
-
#
|
8269
|
-
#
|
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
|
-
#
|
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
|
8579
|
-
# bucket name or specify the access point
|
8580
|
-
#
|
8581
|
-
#
|
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">
|
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
|
8601
|
-
#
|
8602
|
-
#
|
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
|
8605
|
-
#
|
8606
|
-
#
|
8607
|
-
#
|
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.
|
8684
|
-
#
|
8685
|
-
#
|
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 `
|
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 `
|
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 `
|
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 `
|
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 `
|
8768
|
-
#
|
8769
|
-
#
|
8770
|
-
#
|
8771
|
-
#
|
8772
|
-
#
|
8773
|
-
#
|
8774
|
-
#
|
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> -
|
8907
|
-
#
|
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
|
-
#
|
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
|
9080
|
-
# bucket name or specify the access point
|
9081
|
-
#
|
9082
|
-
#
|
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">
|
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
|
9095
|
-
#
|
9096
|
-
#
|
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
|
9099
|
-
#
|
9100
|
-
#
|
9101
|
-
#
|
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
|
-
#
|
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
|
10614
|
-
# bucket name or specify the access point
|
10615
|
-
#
|
10616
|
-
#
|
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">
|
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
|
10629
|
-
#
|
10630
|
-
#
|
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
|
10633
|
-
#
|
10634
|
-
#
|
10635
|
-
#
|
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
|
-
#
|
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
|
11136
|
-
# bucket name or specify the access point
|
11137
|
-
#
|
11138
|
-
#
|
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">
|
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
|
11151
|
-
#
|
11152
|
-
#
|
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
|
11155
|
-
#
|
11156
|
-
#
|
11157
|
-
#
|
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
|
-
#
|
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
|
11407
|
-
# bucket name or specify the access point
|
11408
|
-
#
|
11409
|
-
#
|
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">
|
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
|
11422
|
-
#
|
11423
|
-
#
|
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
|
11426
|
-
#
|
11427
|
-
#
|
11428
|
-
#
|
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** -
|
11663
|
-
#
|
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
|
-
#
|
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
|
11732
|
-
# bucket name or specify the access point
|
11733
|
-
#
|
11734
|
-
#
|
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">
|
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
|
11747
|
-
#
|
11748
|
-
#
|
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
|
11751
|
-
#
|
11752
|
-
#
|
11753
|
-
#
|
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 [
|
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** -
|
12152
|
-
#
|
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** -
|
12464
|
-
#
|
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.
|
12486
|
-
#
|
12487
|
-
#
|
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 `
|
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 `
|
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 `
|
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 `
|
12690
|
-
#
|
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 `
|
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 `
|
12784
|
+
# the `CRC64NVME` checksum algorithm, or if the object was uploaded
|
12701
12785
|
# without a checksum (and Amazon S3 added the default checksum,
|
12702
|
-
# `
|
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 `
|
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 `
|
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 `
|
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 `
|
12725
|
-
#
|
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 `
|
12989
|
-
# checksum is present if the object was uploaded with the `
|
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 `
|
13000
|
-
# checksum is present if the object was uploaded with the `
|
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 `
|
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 `
|
13096
|
+
# the `CRC64NVME` checksum algorithm, or if the object was uploaded
|
13013
13097
|
# without a checksum (and Amazon S3 added the default checksum,
|
13014
|
-
# `
|
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 `
|
13024
|
-
# checksum is present if the object was uploaded with the `
|
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 `
|
13035
|
-
# checksum is present if the object was uploaded with the `
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
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
|
-
# * `
|
14067
|
+
# * `CRC32`
|
13984
14068
|
#
|
13985
|
-
# * `
|
14069
|
+
# * `CRC32C`
|
13986
14070
|
#
|
13987
|
-
# * `
|
14071
|
+
# * `CRC64NVME`
|
13988
14072
|
#
|
13989
|
-
# * `
|
14073
|
+
# * `SHA1`
|
13990
14074
|
#
|
13991
|
-
# * `
|
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
|
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
|
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
|
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
|
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
|
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
|
14399
|
-
# bucket name or specify the access point
|
14400
|
-
#
|
14401
|
-
#
|
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
|
14409
|
-
#
|
14410
|
-
#
|
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
|
14413
|
-
#
|
14414
|
-
#
|
14415
|
-
#
|
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
|
14568
|
-
# bucket name or specify the access point
|
14569
|
-
#
|
14570
|
-
#
|
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 `
|
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 `
|
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 `
|
14818
|
-
# header is present if the object was uploaded with the `
|
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, `
|
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 `
|
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 `
|
14847
|
-
#
|
14848
|
-
#
|
14849
|
-
#
|
14850
|
-
#
|
14851
|
-
#
|
14852
|
-
#
|
14853
|
-
#
|
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
|
-
#
|
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
|
15045
|
-
# bucket name or specify the access point
|
15046
|
-
#
|
15047
|
-
#
|
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">
|
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
|
15060
|
-
#
|
15061
|
-
#
|
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
|
15064
|
-
#
|
15065
|
-
#
|
15066
|
-
#
|
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
|
-
# * `
|
15262
|
+
# * `CRC32`
|
15171
15263
|
#
|
15172
|
-
# * `
|
15264
|
+
# * `CRC32C`
|
15173
15265
|
#
|
15174
|
-
# * `
|
15266
|
+
# * `CRC64NVME`
|
15175
15267
|
#
|
15176
|
-
# * `
|
15268
|
+
# * `SHA1`
|
15177
15269
|
#
|
15178
|
-
# * `
|
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 `
|
15210
|
-
#
|
15211
|
-
#
|
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 `
|
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 `
|
15234
|
-
# object. The `
|
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 `
|
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 `
|
15259
|
-
#
|
15260
|
-
#
|
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"> *
|
15454
|
-
#
|
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** -
|
15544
|
-
# `x-amz-server-side-encryption`
|
15545
|
-
# x-amz-server-side-encryption-aws-kms-key-id`
|
15546
|
-
#
|
15547
|
-
#
|
15548
|
-
#
|
15549
|
-
#
|
15550
|
-
#
|
15551
|
-
#
|
15552
|
-
#
|
15553
|
-
#
|
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
|
15753
|
-
# bucket name or specify the access point
|
15754
|
-
#
|
15755
|
-
#
|
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
|
15869
|
-
# bucket name or specify the access point
|
15870
|
-
#
|
15871
|
-
#
|
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
|
15879
|
-
#
|
15880
|
-
#
|
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
|
15883
|
-
#
|
15884
|
-
#
|
15885
|
-
#
|
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
|
-
#
|
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
|
16563
|
-
# bucket name or specify the access point
|
16564
|
-
#
|
16565
|
-
#
|
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
|
16573
|
-
#
|
16574
|
-
#
|
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
|
16577
|
-
#
|
16578
|
-
#
|
16579
|
-
#
|
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.
|
16727
|
-
#
|
16728
|
-
#
|
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
|
17300
|
-
#
|
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.
|
17880
|
-
#
|
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
|
-
#
|
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
|
17995
|
-
# bucket name or specify the access point
|
17996
|
-
#
|
17997
|
-
#
|
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">
|
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
|
18010
|
-
#
|
18011
|
-
#
|
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
|
18014
|
-
#
|
18015
|
-
#
|
18016
|
-
#
|
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 `
|
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 `
|
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 `
|
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 `
|
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 `
|
18369
|
-
#
|
18370
|
-
#
|
18371
|
-
#
|
18372
|
-
#
|
18373
|
-
#
|
18374
|
-
#
|
18375
|
-
#
|
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
|
-
#
|
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
|
18461
|
-
# bucket name or specify the access point
|
18462
|
-
#
|
18463
|
-
#
|
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">
|
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
|
18476
|
-
#
|
18477
|
-
#
|
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
|
18480
|
-
#
|
18481
|
-
#
|
18482
|
-
#
|
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 `
|
18530
|
-
#
|
18531
|
-
#
|
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 `
|
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 `
|
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 `
|
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 `
|
18578
|
-
#
|
18579
|
-
#
|
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 `
|
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 `
|
18866
|
-
#
|
18867
|
-
#
|
18868
|
-
#
|
18869
|
-
#
|
18870
|
-
#
|
18871
|
-
#
|
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 `
|
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 `
|
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 `
|
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
|