@aws-sdk/client-s3 3.917.0 → 3.919.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.
Files changed (112) hide show
  1. package/dist-cjs/endpoint/ruleset.js +1 -1
  2. package/dist-cjs/index.js +2 -0
  3. package/dist-es/endpoint/ruleset.js +1 -1
  4. package/dist-es/protocols/Aws_restXml.js +2 -0
  5. package/dist-types/commands/AbortMultipartUploadCommand.d.ts +3 -0
  6. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +3 -0
  7. package/dist-types/commands/CopyObjectCommand.d.ts +10 -8
  8. package/dist-types/commands/CreateBucketCommand.d.ts +6 -13
  9. package/dist-types/commands/CreateBucketMetadataConfigurationCommand.d.ts +3 -0
  10. package/dist-types/commands/CreateBucketMetadataTableConfigurationCommand.d.ts +3 -0
  11. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +6 -6
  12. package/dist-types/commands/CreateSessionCommand.d.ts +3 -0
  13. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +3 -0
  14. package/dist-types/commands/DeleteBucketCommand.d.ts +3 -0
  15. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +3 -0
  16. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +3 -0
  17. package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +3 -0
  18. package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +3 -0
  19. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +3 -0
  20. package/dist-types/commands/DeleteBucketMetadataConfigurationCommand.d.ts +3 -0
  21. package/dist-types/commands/DeleteBucketMetadataTableConfigurationCommand.d.ts +3 -0
  22. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +3 -0
  23. package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +3 -0
  24. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +3 -0
  25. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +3 -0
  26. package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +3 -0
  27. package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +3 -0
  28. package/dist-types/commands/DeleteObjectCommand.d.ts +6 -0
  29. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +3 -0
  30. package/dist-types/commands/DeleteObjectsCommand.d.ts +3 -0
  31. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +3 -0
  32. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +3 -0
  33. package/dist-types/commands/GetBucketAclCommand.d.ts +4 -1
  34. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +3 -0
  35. package/dist-types/commands/GetBucketCorsCommand.d.ts +3 -0
  36. package/dist-types/commands/GetBucketEncryptionCommand.d.ts +3 -0
  37. package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +3 -0
  38. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +3 -0
  39. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +3 -0
  40. package/dist-types/commands/GetBucketLocationCommand.d.ts +19 -5
  41. package/dist-types/commands/GetBucketLoggingCommand.d.ts +4 -1
  42. package/dist-types/commands/GetBucketMetadataConfigurationCommand.d.ts +3 -0
  43. package/dist-types/commands/GetBucketMetadataTableConfigurationCommand.d.ts +3 -0
  44. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +3 -0
  45. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +3 -0
  46. package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +3 -0
  47. package/dist-types/commands/GetBucketPolicyCommand.d.ts +3 -0
  48. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +3 -0
  49. package/dist-types/commands/GetBucketReplicationCommand.d.ts +3 -0
  50. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +3 -0
  51. package/dist-types/commands/GetBucketTaggingCommand.d.ts +3 -0
  52. package/dist-types/commands/GetBucketVersioningCommand.d.ts +3 -0
  53. package/dist-types/commands/GetBucketWebsiteCommand.d.ts +3 -0
  54. package/dist-types/commands/GetObjectAclCommand.d.ts +11 -1
  55. package/dist-types/commands/GetObjectAttributesCommand.d.ts +3 -0
  56. package/dist-types/commands/GetObjectCommand.d.ts +3 -0
  57. package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +3 -0
  58. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +3 -0
  59. package/dist-types/commands/GetObjectRetentionCommand.d.ts +3 -0
  60. package/dist-types/commands/GetObjectTaggingCommand.d.ts +3 -0
  61. package/dist-types/commands/GetObjectTorrentCommand.d.ts +3 -0
  62. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +3 -0
  63. package/dist-types/commands/HeadBucketCommand.d.ts +12 -6
  64. package/dist-types/commands/HeadObjectCommand.d.ts +3 -0
  65. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +3 -0
  66. package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +3 -0
  67. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +4 -1
  68. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +3 -0
  69. package/dist-types/commands/ListBucketsCommand.d.ts +4 -1
  70. package/dist-types/commands/ListDirectoryBucketsCommand.d.ts +3 -0
  71. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +4 -1
  72. package/dist-types/commands/ListObjectVersionsCommand.d.ts +4 -1
  73. package/dist-types/commands/ListObjectsCommand.d.ts +4 -1
  74. package/dist-types/commands/ListObjectsV2Command.d.ts +11 -1
  75. package/dist-types/commands/ListPartsCommand.d.ts +4 -1
  76. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +3 -0
  77. package/dist-types/commands/PutBucketAclCommand.d.ts +6 -6
  78. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +3 -0
  79. package/dist-types/commands/PutBucketCorsCommand.d.ts +3 -0
  80. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +3 -0
  81. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +3 -0
  82. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +3 -0
  83. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +3 -0
  84. package/dist-types/commands/PutBucketLoggingCommand.d.ts +6 -6
  85. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +3 -0
  86. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +3 -0
  87. package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +3 -0
  88. package/dist-types/commands/PutBucketPolicyCommand.d.ts +3 -0
  89. package/dist-types/commands/PutBucketReplicationCommand.d.ts +3 -0
  90. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +3 -0
  91. package/dist-types/commands/PutBucketTaggingCommand.d.ts +3 -0
  92. package/dist-types/commands/PutBucketVersioningCommand.d.ts +3 -0
  93. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +3 -0
  94. package/dist-types/commands/PutObjectAclCommand.d.ts +9 -1
  95. package/dist-types/commands/PutObjectCommand.d.ts +6 -6
  96. package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +3 -0
  97. package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +3 -0
  98. package/dist-types/commands/PutObjectRetentionCommand.d.ts +3 -0
  99. package/dist-types/commands/PutObjectTaggingCommand.d.ts +3 -0
  100. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +3 -0
  101. package/dist-types/commands/RenameObjectCommand.d.ts +3 -0
  102. package/dist-types/commands/RestoreObjectCommand.d.ts +3 -0
  103. package/dist-types/commands/SelectObjectContentCommand.d.ts +3 -0
  104. package/dist-types/commands/UpdateBucketMetadataInventoryTableConfigurationCommand.d.ts +3 -0
  105. package/dist-types/commands/UpdateBucketMetadataJournalTableConfigurationCommand.d.ts +3 -0
  106. package/dist-types/commands/UploadPartCommand.d.ts +3 -0
  107. package/dist-types/commands/UploadPartCopyCommand.d.ts +3 -0
  108. package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +3 -0
  109. package/dist-types/models/models_0.d.ts +57 -27
  110. package/dist-types/models/models_1.d.ts +10 -17
  111. package/dist-types/ts3.4/models/models_0.d.ts +2 -0
  112. package/package.json +4 -4
@@ -169,7 +169,14 @@ export declare const Type: {
169
169
  */
170
170
  export type Type = (typeof Type)[keyof typeof Type];
171
171
  /**
172
- * <p>Container for the person being granted permissions.</p>
172
+ * <important>
173
+ * <p>End of support notice: Beginning November 21, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
174
+ * Amazon Web Services accounts), Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of <code>DisplayName</code>.
175
+ * </p>
176
+ * <p>This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N. California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
177
+ * Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.</p>
178
+ * </important>
179
+ * <p>Container for the person being granted permissions.</p>
173
180
  * @public
174
181
  */
175
182
  export interface Grantee {
@@ -262,7 +269,7 @@ export interface Grant {
262
269
  }
263
270
  /**
264
271
  * <important>
265
- * <p>End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
272
+ * <p>End of support notice: Beginning November 21, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
266
273
  * Amazon Web Services accounts), Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of <code>DisplayName</code>.
267
274
  * </p>
268
275
  * <p>This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N. California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
@@ -422,7 +429,7 @@ export interface CompleteMultipartUploadOutput {
422
429
  */
423
430
  ETag?: string | undefined;
424
431
  /**
425
- * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only be present if the checksum was uploaded
432
+ * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only present if the checksum was uploaded
426
433
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
427
434
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
428
435
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -447,7 +454,7 @@ export interface CompleteMultipartUploadOutput {
447
454
  */
448
455
  ChecksumCRC64NVME?: string | undefined;
449
456
  /**
450
- * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This will only be present if the object was uploaded
457
+ * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This checksum is only present if the checksum was uploaded
451
458
  * with the object. When you use the API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
452
459
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
453
460
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -455,7 +462,7 @@ export interface CompleteMultipartUploadOutput {
455
462
  */
456
463
  ChecksumSHA1?: string | undefined;
457
464
  /**
458
- * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This will only be present if the object was uploaded
465
+ * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This checksum is only present if the checksum was uploaded
459
466
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
460
467
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
461
468
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -807,7 +814,7 @@ export interface CopyObjectResult {
807
814
  */
808
815
  ChecksumCRC32?: string | undefined;
809
816
  /**
810
- * <p>The Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. This will only be present if the object was uploaded
817
+ * <p>The Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. This checksum is only present if the checksum was uploaded
811
818
  * with the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">
812
819
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
813
820
  * @public
@@ -823,14 +830,14 @@ export interface CopyObjectResult {
823
830
  */
824
831
  ChecksumCRC64NVME?: string | undefined;
825
832
  /**
826
- * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This will only be present if the object was uploaded
833
+ * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This checksum is only present if the checksum was uploaded
827
834
  * with the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">
828
835
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
829
836
  * @public
830
837
  */
831
838
  ChecksumSHA1?: string | undefined;
832
839
  /**
833
- * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This will only be present if the object was uploaded
840
+ * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This checksum is only present if the checksum was uploaded
834
841
  * with the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">
835
842
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
836
843
  * @public
@@ -1333,6 +1340,27 @@ export interface CopyObjectRequest {
1333
1340
  * @public
1334
1341
  */
1335
1342
  GrantWriteACP?: string | undefined;
1343
+ /**
1344
+ * <p>Copies the object if the entity tag (ETag) of the destination object matches the specified
1345
+ * tag. If the ETag values do not match, the operation returns a <code>412 Precondition
1346
+ * Failed</code> error. If a concurrent operation occurs during the upload S3 returns a
1347
+ * <code>409 ConditionalRequestConflict</code> response. On a 409 failure you should fetch the
1348
+ * object's ETag and retry the upload.</p>
1349
+ * <p>Expects the ETag value as a string.</p>
1350
+ * <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>.</p>
1351
+ * @public
1352
+ */
1353
+ IfMatch?: string | undefined;
1354
+ /**
1355
+ * <p>Copies the object only if the object key name at the destination does not already exist in
1356
+ * the bucket specified. Otherwise, Amazon S3 returns a <code>412 Precondition Failed</code> error. If a
1357
+ * concurrent operation occurs during the upload S3 returns a <code>409 ConditionalRequestConflict</code>
1358
+ * response. On a 409 failure you should retry the upload.</p>
1359
+ * <p>Expects the '*' (asterisk) character.</p>
1360
+ * <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>.</p>
1361
+ * @public
1362
+ */
1363
+ IfNoneMatch?: string | undefined;
1336
1364
  /**
1337
1365
  * <p>The key of the destination object.</p>
1338
1366
  * @public
@@ -1988,8 +2016,15 @@ export interface CreateBucketConfiguration {
1988
2016
  * <p>An array of tags that you can apply to the bucket that you're creating. Tags are key-value pairs of
1989
2017
  * metadata used to categorize and organize your buckets, track costs, and control access. </p>
1990
2018
  * <note>
1991
- * <p>This parameter is only supported for S3 directory buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html">Using tags with
2019
+ * <ul>
2020
+ * <li>
2021
+ * <p>This parameter is only supported for S3 directory buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html">Using tags with
1992
2022
  * directory buckets</a>.</p>
2023
+ * </li>
2024
+ * <li>
2025
+ * <p>You must have the <code>s3express:TagResource</code> permission to create a directory bucket with tags.</p>
2026
+ * </li>
2027
+ * </ul>
1993
2028
  * </note>
1994
2029
  * @public
1995
2030
  */
@@ -3690,14 +3725,10 @@ export interface DeleteObjectRequest {
3690
3725
  */
3691
3726
  ExpectedBucketOwner?: string | undefined;
3692
3727
  /**
3693
- * <p>The <code>If-Match</code> header field makes the request method conditional on ETags. If the ETag
3694
- * value does not match, the operation returns a <code>412 Precondition Failed</code> error. If the ETag
3695
- * matches or if the object doesn't exist, the operation will return a <code>204 Success (No Content)
3696
- * response</code>.</p>
3728
+ * <p>Deletes the object if the ETag (entity tag) value provided during the delete operation matches the ETag of the object in S3.
3729
+ * If the ETag values do not match, the operation returns a <code>412 Precondition Failed</code> error.</p>
3730
+ * <p>Expects the ETag value as a string. <code>If-Match</code> does accept a string value of an '*' (asterisk) character to denote a match of any ETag.</p>
3697
3731
  * <p>For more information about conditional requests, see <a href="https://tools.ietf.org/html/rfc7232">RFC 7232</a>.</p>
3698
- * <note>
3699
- * <p>This functionality is only supported for directory buckets.</p>
3700
- * </note>
3701
3732
  * @public
3702
3733
  */
3703
3734
  IfMatch?: string | undefined;
@@ -7163,8 +7194,7 @@ export interface LifecycleRule {
7163
7194
  */
7164
7195
  ID?: string | undefined;
7165
7196
  /**
7166
- * <p>Prefix identifying one or more objects to which the rule applies. This is no
7167
- * longer used; use <code>Filter</code> instead.</p>
7197
+ * <p> The general purpose bucket prefix that identifies one or more objects to which the rule applies. We recommend using <code>Filter</code> instead of <code>Prefix</code> for new PUTs. Previous configurations where a prefix is defined will continue to operate as before.</p>
7168
7198
  * <important>
7169
7199
  * <p>Replacement must be made for object keys containing special characters (such as carriage returns) when using
7170
7200
  * XML requests. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-keys.html#object-key-xml-related-constraints">
@@ -9637,7 +9667,7 @@ export interface GetObjectOutput {
9637
9667
  */
9638
9668
  ChecksumCRC32?: string | undefined;
9639
9669
  /**
9640
- * <p>The Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. This will only be present if the object was uploaded
9670
+ * <p>The Base64 encoded, 32-bit <code>CRC32C</code> checksum of the object. This checksum is only present if the checksum was uploaded
9641
9671
  * with the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">
9642
9672
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
9643
9673
  * @public
@@ -9651,14 +9681,14 @@ export interface GetObjectOutput {
9651
9681
  */
9652
9682
  ChecksumCRC64NVME?: string | undefined;
9653
9683
  /**
9654
- * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This will only be present if the object was uploaded
9684
+ * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This checksum is only present if the checksum was uploaded
9655
9685
  * with the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">
9656
9686
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
9657
9687
  * @public
9658
9688
  */
9659
9689
  ChecksumSHA1?: string | undefined;
9660
9690
  /**
9661
- * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This will only be present if the object was uploaded
9691
+ * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This checksum is only present if the checksum was uploaded
9662
9692
  * with the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">
9663
9693
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
9664
9694
  * @public
@@ -10249,7 +10279,7 @@ export interface GetObjectAclRequest {
10249
10279
  */
10250
10280
  export interface Checksum {
10251
10281
  /**
10252
- * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only be present if the checksum was uploaded
10282
+ * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only present if the checksum was uploaded
10253
10283
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
10254
10284
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
10255
10285
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -10274,7 +10304,7 @@ export interface Checksum {
10274
10304
  */
10275
10305
  ChecksumCRC64NVME?: string | undefined;
10276
10306
  /**
10277
- * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This will only be present if the object was uploaded
10307
+ * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This checksum is only present if the checksum was uploaded
10278
10308
  * with the object. When you use the API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
10279
10309
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
10280
10310
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -10282,7 +10312,7 @@ export interface Checksum {
10282
10312
  */
10283
10313
  ChecksumSHA1?: string | undefined;
10284
10314
  /**
10285
- * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This will only be present if the object was uploaded
10315
+ * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This checksum is only present if the checksum was uploaded
10286
10316
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
10287
10317
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
10288
10318
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -11229,7 +11259,7 @@ export interface HeadObjectOutput {
11229
11259
  */
11230
11260
  ContentLength?: number | undefined;
11231
11261
  /**
11232
- * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only be present if the checksum was uploaded
11262
+ * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only present if the checksum was uploaded
11233
11263
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
11234
11264
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
11235
11265
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -11252,7 +11282,7 @@ export interface HeadObjectOutput {
11252
11282
  */
11253
11283
  ChecksumCRC64NVME?: string | undefined;
11254
11284
  /**
11255
- * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This will only be present if the object was uploaded
11285
+ * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This checksum is only present if the checksum was uploaded
11256
11286
  * with the object. When you use the API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
11257
11287
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
11258
11288
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -11260,7 +11290,7 @@ export interface HeadObjectOutput {
11260
11290
  */
11261
11291
  ChecksumSHA1?: string | undefined;
11262
11292
  /**
11263
- * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This will only be present if the object was uploaded
11293
+ * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This checksum is only present if the checksum was uploaded
11264
11294
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
11265
11295
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
11266
11296
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -2034,8 +2034,7 @@ export interface PutBucketVersioningRequest {
2034
2034
  */
2035
2035
  ChecksumAlgorithm?: ChecksumAlgorithm | undefined;
2036
2036
  /**
2037
- * <p>The concatenation of the authentication device's serial number, a space, and the value that is
2038
- * displayed on your authentication device.</p>
2037
+ * <p>The concatenation of the authentication device's serial number, a space, and the value that is displayed on your authentication device. The serial number is the number that uniquely identifies the MFA device. For physical MFA devices, this is the unique serial number that's provided with the device. For virtual MFA devices, the serial number is the device ARN. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html">Enabling versioning on buckets</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html">Configuring MFA delete</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
2039
2038
  * @public
2040
2039
  */
2041
2040
  MFA?: string | undefined;
@@ -2201,7 +2200,7 @@ export interface PutObjectOutput {
2201
2200
  */
2202
2201
  ETag?: string | undefined;
2203
2202
  /**
2204
- * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only be present if the checksum was uploaded
2203
+ * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only present if the checksum was uploaded
2205
2204
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
2206
2205
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
2207
2206
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -2226,7 +2225,7 @@ export interface PutObjectOutput {
2226
2225
  */
2227
2226
  ChecksumCRC64NVME?: string | undefined;
2228
2227
  /**
2229
- * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This will only be present if the object was uploaded
2228
+ * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This checksum is only present if the checksum was uploaded
2230
2229
  * with the object. When you use the API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
2231
2230
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
2232
2231
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -2234,7 +2233,7 @@ export interface PutObjectOutput {
2234
2233
  */
2235
2234
  ChecksumSHA1?: string | undefined;
2236
2235
  /**
2237
- * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This will only be present if the object was uploaded
2236
+ * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This checksum is only present if the checksum was uploaded
2238
2237
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
2239
2238
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
2240
2239
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -3304,14 +3303,8 @@ export interface PutObjectTaggingRequest {
3304
3303
  */
3305
3304
  ExpectedBucketOwner?: string | undefined;
3306
3305
  /**
3307
- * <p>Confirms that the requester knows that they will be charged for the request. Bucket owners need not
3308
- * specify this parameter in their requests. If either the source or destination S3 bucket has Requester
3309
- * Pays enabled, the requester will pay for corresponding charges to copy the object. For information about
3310
- * downloading objects from Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in Requester Pays
3311
- * Buckets</a> in the <i>Amazon S3 User Guide</i>.</p>
3312
- * <note>
3313
- * <p>This functionality is not supported for directory buckets.</p>
3314
- * </note>
3306
+ * <p>Confirms that the requester knows that she or he will be charged for the tagging object
3307
+ * request. Bucket owners need not specify this parameter in their requests.</p>
3315
3308
  * @public
3316
3309
  */
3317
3310
  RequestPayer?: RequestPayer | undefined;
@@ -4103,7 +4096,7 @@ export interface RecordsEvent {
4103
4096
  * <p>The byte array of partial, one or more result records. S3 Select doesn't guarantee that a record
4104
4097
  * will be self-contained in one record frame. To ensure continuous streaming of data, S3 Select might
4105
4098
  * split the same record across multiple record frames instead of aggregating the results in memory. Some
4106
- * S3 clients (for example, the SDK for Java) handle this behavior by creating a
4099
+ * S3 clients (for example, the SDKforJava) handle this behavior by creating a
4107
4100
  * <code>ByteStream</code> out of the response by default. Other clients might not handle this behavior
4108
4101
  * by default. In those cases, you must aggregate the results on the client side and parse the
4109
4102
  * response.</p>
@@ -4534,7 +4527,7 @@ export interface UploadPartOutput {
4534
4527
  */
4535
4528
  ETag?: string | undefined;
4536
4529
  /**
4537
- * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only be present if the checksum was uploaded
4530
+ * <p>The Base64 encoded, 32-bit <code>CRC32 checksum</code> of the object. This checksum is only present if the checksum was uploaded
4538
4531
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
4539
4532
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
4540
4533
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -4558,7 +4551,7 @@ export interface UploadPartOutput {
4558
4551
  */
4559
4552
  ChecksumCRC64NVME?: string | undefined;
4560
4553
  /**
4561
- * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This will only be present if the object was uploaded
4554
+ * <p>The Base64 encoded, 160-bit <code>SHA1</code> digest of the object. This checksum is only present if the checksum was uploaded
4562
4555
  * with the object. When you use the API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
4563
4556
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
4564
4557
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -4566,7 +4559,7 @@ export interface UploadPartOutput {
4566
4559
  */
4567
4560
  ChecksumSHA1?: string | undefined;
4568
4561
  /**
4569
- * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This will only be present if the object was uploaded
4562
+ * <p>The Base64 encoded, 256-bit <code>SHA256</code> digest of the object. This checksum is only present if the checksum was uploaded
4570
4563
  * with the object. When you use an API operation on an object that was uploaded using multipart uploads, this value may not be a direct checksum value of the full object. Instead, it's a calculation based on the checksum values of each individual part. For more information about how checksums are calculated
4571
4564
  * with multipart uploads, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html#large-object-checksums">
4572
4565
  * Checking object integrity</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -242,6 +242,8 @@ export interface CopyObjectRequest {
242
242
  GrantRead?: string | undefined;
243
243
  GrantReadACP?: string | undefined;
244
244
  GrantWriteACP?: string | undefined;
245
+ IfMatch?: string | undefined;
246
+ IfNoneMatch?: string | undefined;
245
247
  Key: string | undefined;
246
248
  Metadata?: Record<string, string> | undefined;
247
249
  MetadataDirective?: MetadataDirective | undefined;
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "@aws-sdk/client-s3",
3
3
  "description": "AWS SDK for JavaScript S3 Client for Node.js, Browser and React Native",
4
- "version": "3.917.0",
4
+ "version": "3.919.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-s3",
@@ -30,14 +30,14 @@
30
30
  "@aws-crypto/sha256-browser": "5.2.0",
31
31
  "@aws-crypto/sha256-js": "5.2.0",
32
32
  "@aws-sdk/core": "3.916.0",
33
- "@aws-sdk/credential-provider-node": "3.917.0",
33
+ "@aws-sdk/credential-provider-node": "3.919.0",
34
34
  "@aws-sdk/middleware-bucket-endpoint": "3.914.0",
35
35
  "@aws-sdk/middleware-expect-continue": "3.917.0",
36
- "@aws-sdk/middleware-flexible-checksums": "3.916.0",
36
+ "@aws-sdk/middleware-flexible-checksums": "3.919.0",
37
37
  "@aws-sdk/middleware-host-header": "3.914.0",
38
38
  "@aws-sdk/middleware-location-constraint": "3.914.0",
39
39
  "@aws-sdk/middleware-logger": "3.914.0",
40
- "@aws-sdk/middleware-recursion-detection": "3.914.0",
40
+ "@aws-sdk/middleware-recursion-detection": "3.919.0",
41
41
  "@aws-sdk/middleware-sdk-s3": "3.916.0",
42
42
  "@aws-sdk/middleware-ssec": "3.914.0",
43
43
  "@aws-sdk/middleware-user-agent": "3.916.0",