@aws-sdk/client-s3 3.697.0 → 3.698.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 (103) hide show
  1. package/dist-cjs/index.js +152 -5
  2. package/dist-es/models/models_1.js +48 -0
  3. package/dist-es/protocols/Aws_restXml.js +75 -4
  4. package/dist-types/commands/AbortMultipartUploadCommand.d.ts +16 -13
  5. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +47 -42
  6. package/dist-types/commands/CopyObjectCommand.d.ts +77 -57
  7. package/dist-types/commands/CreateBucketCommand.d.ts +60 -45
  8. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +92 -66
  9. package/dist-types/commands/CreateSessionCommand.d.ts +30 -16
  10. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +1 -1
  11. package/dist-types/commands/DeleteBucketCommand.d.ts +10 -3
  12. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +1 -1
  13. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +18 -10
  14. package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  15. package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +1 -1
  16. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +52 -9
  17. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +1 -1
  18. package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +1 -1
  19. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +25 -21
  20. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +1 -1
  21. package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +1 -1
  22. package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +1 -1
  23. package/dist-types/commands/DeleteObjectCommand.d.ts +3 -0
  24. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +1 -1
  25. package/dist-types/commands/DeleteObjectsCommand.d.ts +41 -27
  26. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +1 -1
  27. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +1 -1
  28. package/dist-types/commands/GetBucketAclCommand.d.ts +1 -1
  29. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +1 -1
  30. package/dist-types/commands/GetBucketCorsCommand.d.ts +1 -1
  31. package/dist-types/commands/GetBucketEncryptionCommand.d.ts +18 -10
  32. package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  33. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +1 -1
  34. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +61 -17
  35. package/dist-types/commands/GetBucketLocationCommand.d.ts +1 -1
  36. package/dist-types/commands/GetBucketLoggingCommand.d.ts +1 -1
  37. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +1 -1
  38. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +1 -1
  39. package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +1 -1
  40. package/dist-types/commands/GetBucketPolicyCommand.d.ts +30 -21
  41. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +1 -1
  42. package/dist-types/commands/GetBucketReplicationCommand.d.ts +1 -1
  43. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +1 -1
  44. package/dist-types/commands/GetBucketTaggingCommand.d.ts +1 -1
  45. package/dist-types/commands/GetBucketVersioningCommand.d.ts +1 -1
  46. package/dist-types/commands/GetBucketWebsiteCommand.d.ts +1 -1
  47. package/dist-types/commands/GetObjectAclCommand.d.ts +1 -1
  48. package/dist-types/commands/GetObjectAttributesCommand.d.ts +62 -44
  49. package/dist-types/commands/GetObjectCommand.d.ts +79 -60
  50. package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +1 -1
  51. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +1 -1
  52. package/dist-types/commands/GetObjectRetentionCommand.d.ts +1 -1
  53. package/dist-types/commands/GetObjectTaggingCommand.d.ts +1 -1
  54. package/dist-types/commands/GetObjectTorrentCommand.d.ts +1 -1
  55. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +1 -1
  56. package/dist-types/commands/HeadBucketCommand.d.ts +32 -16
  57. package/dist-types/commands/HeadObjectCommand.d.ts +60 -38
  58. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +1 -1
  59. package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +1 -1
  60. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +1 -1
  61. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +1 -1
  62. package/dist-types/commands/ListBucketsCommand.d.ts +6 -6
  63. package/dist-types/commands/ListDirectoryBucketsCommand.d.ts +10 -4
  64. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +50 -33
  65. package/dist-types/commands/ListObjectVersionsCommand.d.ts +1 -1
  66. package/dist-types/commands/ListObjectsCommand.d.ts +1 -1
  67. package/dist-types/commands/ListObjectsV2Command.d.ts +23 -14
  68. package/dist-types/commands/ListPartsCommand.d.ts +22 -17
  69. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +1 -1
  70. package/dist-types/commands/PutBucketAclCommand.d.ts +1 -1
  71. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +1 -1
  72. package/dist-types/commands/PutBucketCorsCommand.d.ts +1 -1
  73. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +47 -32
  74. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +1 -1
  75. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +1 -1
  76. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +84 -45
  77. package/dist-types/commands/PutBucketLoggingCommand.d.ts +1 -1
  78. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +1 -1
  79. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +1 -1
  80. package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +1 -1
  81. package/dist-types/commands/PutBucketPolicyCommand.d.ts +30 -21
  82. package/dist-types/commands/PutBucketReplicationCommand.d.ts +3 -4
  83. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +1 -1
  84. package/dist-types/commands/PutBucketTaggingCommand.d.ts +1 -1
  85. package/dist-types/commands/PutBucketVersioningCommand.d.ts +3 -6
  86. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +1 -1
  87. package/dist-types/commands/PutObjectAclCommand.d.ts +1 -1
  88. package/dist-types/commands/PutObjectCommand.d.ts +83 -35
  89. package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +1 -1
  90. package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +3 -3
  91. package/dist-types/commands/PutObjectRetentionCommand.d.ts +2 -2
  92. package/dist-types/commands/PutObjectTaggingCommand.d.ts +1 -1
  93. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -1
  94. package/dist-types/commands/RestoreObjectCommand.d.ts +1 -1
  95. package/dist-types/commands/SelectObjectContentCommand.d.ts +1 -1
  96. package/dist-types/commands/UploadPartCommand.d.ts +52 -41
  97. package/dist-types/commands/UploadPartCopyCommand.d.ts +53 -39
  98. package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +1 -1
  99. package/dist-types/models/models_0.d.ts +938 -632
  100. package/dist-types/models/models_1.d.ts +230 -135
  101. package/dist-types/ts3.4/models/models_0.d.ts +7 -0
  102. package/dist-types/ts3.4/models/models_1.d.ts +24 -0
  103. package/package.json +1 -1
@@ -28,16 +28,13 @@ declare const PutBucketVersioningCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <note>
34
34
  * <p>When you enable versioning on a bucket for the first time, it might take a short
35
35
  * amount of time for the change to be fully propagated. We recommend that you wait for 15
36
- * minutes after enabling versioning before issuing write operations
37
- * (<code>PUT</code>
38
- * or
39
- * <code>DELETE</code>)
40
- * on objects in the bucket. </p>
36
+ * minutes after enabling versioning before issuing write operations (<code>PUT</code> or
37
+ * <code>DELETE</code>) on objects in the bucket. </p>
41
38
  * </note>
42
39
  * <p>Sets the versioning state of an existing bucket.</p>
43
40
  * <p>You can set the versioning state with one of the following values:</p>
@@ -28,7 +28,7 @@ declare const PutBucketWebsiteCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Sets the configuration of the website that is specified in the <code>website</code>
34
34
  * subresource. To configure a bucket as a website, you can add this subresource on the bucket
@@ -28,7 +28,7 @@ declare const PutObjectAclCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Uses the <code>acl</code> subresource to set the access control list (ACL) permissions
34
34
  * for a new or existing object in an S3 bucket. You must have the <code>WRITE_ACP</code>
@@ -32,46 +32,49 @@ declare const PutObjectCommand_base: {
32
32
  * <note>
33
33
  * <ul>
34
34
  * <li>
35
- * <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the
36
- * entire object to the bucket. You cannot use <code>PutObject</code> to only update a
37
- * single piece of metadata for an existing object. You must put the entire object with
38
- * updated metadata if you want to update some values.</p>
35
+ * <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added
36
+ * the entire object to the bucket. You cannot use <code>PutObject</code> to only
37
+ * update a single piece of metadata for an existing object. You must put the entire
38
+ * object with updated metadata if you want to update some values.</p>
39
39
  * </li>
40
40
  * <li>
41
- * <p>If your bucket uses the bucket owner enforced setting for Object Ownership, ACLs are disabled and no longer affect permissions. All
42
- * objects written to the bucket by any account will be owned by the bucket owner.</p>
41
+ * <p>If your bucket uses the bucket owner enforced setting for Object Ownership,
42
+ * ACLs are disabled and no longer affect permissions. All objects written to the
43
+ * bucket by any account will be owned by the bucket owner.</p>
43
44
  * </li>
44
45
  * <li>
45
46
  * <p>
46
- * <b>Directory buckets</b> - For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
47
+ * <b>Directory buckets</b> -
48
+ * For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
47
49
  * </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
48
50
  * <i>Amazon S3 User Guide</i>.</p>
49
51
  * </li>
50
52
  * </ul>
51
53
  * </note>
52
54
  * <p>Amazon S3 is a distributed system. If it receives multiple write requests for the same object
53
- * simultaneously, it overwrites all but the last object written. However, Amazon S3 provides features that can modify this behavior:</p>
55
+ * simultaneously, it overwrites all but the last object written. However, Amazon S3 provides
56
+ * features that can modify this behavior:</p>
54
57
  * <ul>
55
58
  * <li>
56
59
  * <p>
57
60
  * <b>S3 Object Lock</b> - To prevent objects from
58
- * being deleted or overwritten, you can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html">Amazon S3 Object
59
- * Lock</a> in the <i>Amazon S3 User Guide</i>.</p>
61
+ * being deleted or overwritten, you can use <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock.html">Amazon S3 Object
62
+ * Lock</a> in the <i>Amazon S3 User Guide</i>.</p>
60
63
  * <note>
61
64
  * <p>This functionality is not supported for directory buckets.</p>
62
65
  * </note>
63
66
  * </li>
64
67
  * <li>
65
68
  * <p>
66
- * <b>S3 Versioning</b> - When you enable
67
- * versioning for a bucket, if Amazon S3 receives multiple write requests for the same object
68
- * simultaneously, it stores all versions of the objects. For each write request that is made to the same object, Amazon S3 automatically generates a unique version ID
69
- * of that object being stored in Amazon S3.
70
- * You can retrieve, replace, or delete any version of the object. For more information about versioning, see
71
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html">Adding Objects to
72
- * Versioning-Enabled Buckets</a> in the <i>Amazon S3
73
- * User Guide</i>. For information about returning the versioning state
74
- * of a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>. </p>
69
+ * <b>S3 Versioning</b> - When you enable versioning
70
+ * for a bucket, if Amazon S3 receives multiple write requests for the same object
71
+ * simultaneously, it stores all versions of the objects. For each write request that is
72
+ * made to the same object, Amazon S3 automatically generates a unique version ID of that
73
+ * object being stored in Amazon S3. You can retrieve, replace, or delete any version of the
74
+ * object. For more information about versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html">Adding
75
+ * Objects to Versioning-Enabled Buckets</a> in the <i>Amazon S3 User
76
+ * Guide</i>. For information about returning the versioning state of a
77
+ * bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>. </p>
75
78
  * <note>
76
79
  * <p>This functionality is not supported for directory buckets.</p>
77
80
  * </note>
@@ -83,28 +86,34 @@ declare const PutObjectCommand_base: {
83
86
  * <ul>
84
87
  * <li>
85
88
  * <p>
86
- * <b>General purpose bucket permissions</b> - The following permissions are required in your policies when your
87
- * <code>PutObject</code> request includes specific headers.</p>
89
+ * <b>General purpose bucket permissions</b> - The
90
+ * following permissions are required in your policies when your
91
+ * <code>PutObject</code> request includes specific headers.</p>
88
92
  * <ul>
89
93
  * <li>
90
94
  * <p>
91
95
  * <b>
92
96
  * <code>s3:PutObject</code>
93
- * </b> - To successfully complete the <code>PutObject</code> request, you must always have the <code>s3:PutObject</code> permission on a bucket to add an object
94
- * to it.</p>
97
+ * </b> -
98
+ * To successfully complete the <code>PutObject</code> request, you must
99
+ * always have the <code>s3:PutObject</code> permission on a bucket to
100
+ * add an object to it.</p>
95
101
  * </li>
96
102
  * <li>
97
103
  * <p>
98
104
  * <b>
99
105
  * <code>s3:PutObjectAcl</code>
100
- * </b> - To successfully change the objects ACL of your <code>PutObject</code> request, you must have the <code>s3:PutObjectAcl</code>.</p>
106
+ * </b> - To successfully change the objects ACL of your
107
+ * <code>PutObject</code> request, you must have the
108
+ * <code>s3:PutObjectAcl</code>.</p>
101
109
  * </li>
102
110
  * <li>
103
111
  * <p>
104
112
  * <b>
105
113
  * <code>s3:PutObjectTagging</code>
106
- * </b> - To successfully set the tag-set with your <code>PutObject</code> request, you
107
- * must have the <code>s3:PutObjectTagging</code>.</p>
114
+ * </b> - To successfully set the tag-set with your
115
+ * <code>PutObject</code> request, you must have the
116
+ * <code>s3:PutObjectTagging</code>.</p>
108
117
  * </li>
109
118
  * </ul>
110
119
  * </li>
@@ -116,9 +125,10 @@ declare const PutObjectCommand_base: {
116
125
  * Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
117
126
  * <code>CreateSession</code>
118
127
  * </a>.</p>
119
- * <p>If the object is encrypted with
120
- * SSE-KMS, you must also have the
121
- * <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions in IAM identity-based policies and KMS key policies for the KMS key.</p>
128
+ * <p>If the object is encrypted with SSE-KMS, you must also have the
129
+ * <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions
130
+ * in IAM identity-based policies and KMS key policies for the KMS
131
+ * key.</p>
122
132
  * </li>
123
133
  * </ul>
124
134
  * </dd>
@@ -127,15 +137,18 @@ declare const PutObjectCommand_base: {
127
137
  * <ul>
128
138
  * <li>
129
139
  * <p>
130
- * <b>General purpose bucket</b> - To ensure that data is not corrupted traversing the network, use the
131
- * <code>Content-MD5</code> header. When you use this header, Amazon S3 checks the object
132
- * against the provided MD5 value and, if they do not match, Amazon S3 returns an error. Alternatively, when the object's ETag is its MD5 digest,
133
- * you can calculate the MD5 while putting the object to Amazon S3 and compare the returned ETag to
134
- * the calculated MD5 value.</p>
140
+ * <b>General purpose bucket</b> - To ensure that
141
+ * data is not corrupted traversing the network, use the
142
+ * <code>Content-MD5</code> header. When you use this header, Amazon S3 checks
143
+ * the object against the provided MD5 value and, if they do not match, Amazon S3
144
+ * returns an error. Alternatively, when the object's ETag is its MD5 digest,
145
+ * you can calculate the MD5 while putting the object to Amazon S3 and compare the
146
+ * returned ETag to the calculated MD5 value.</p>
135
147
  * </li>
136
148
  * <li>
137
149
  * <p>
138
- * <b>Directory bucket</b> - This functionality is not supported for directory buckets.</p>
150
+ * <b>Directory bucket</b> -
151
+ * This functionality is not supported for directory buckets.</p>
139
152
  * </li>
140
153
  * </ul>
141
154
  * </dd>
@@ -188,6 +201,7 @@ declare const PutObjectCommand_base: {
188
201
  * GrantReadACP: "STRING_VALUE",
189
202
  * GrantWriteACP: "STRING_VALUE",
190
203
  * Key: "STRING_VALUE", // required
204
+ * WriteOffsetBytes: Number("long"),
191
205
  * Metadata: { // Metadata
192
206
  * "<keys>": "STRING_VALUE",
193
207
  * },
@@ -223,6 +237,7 @@ declare const PutObjectCommand_base: {
223
237
  * // SSEKMSKeyId: "STRING_VALUE",
224
238
  * // SSEKMSEncryptionContext: "STRING_VALUE",
225
239
  * // BucketKeyEnabled: true || false,
240
+ * // Size: Number("long"),
226
241
  * // RequestCharged: "requester",
227
242
  * // };
228
243
  *
@@ -234,6 +249,39 @@ declare const PutObjectCommand_base: {
234
249
  * @see {@link PutObjectCommandOutput} for command's `response` shape.
235
250
  * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
236
251
  *
252
+ * @throws {@link EncryptionTypeMismatch} (client fault)
253
+ * <p>
254
+ * The existing object was created with a different encryption type.
255
+ * Subsequent write requests must include the appropriate encryption
256
+ * parameters in the request or while creating the session.
257
+ * </p>
258
+ *
259
+ * @throws {@link InvalidRequest} (client fault)
260
+ * <p>You may receive this error in multiple cases. Depending on the reason for the error, you may receive one of the messages below:</p>
261
+ * <ul>
262
+ * <li>
263
+ * <p>Cannot specify both a write offset value and user-defined object metadata for existing objects.</p>
264
+ * </li>
265
+ * <li>
266
+ * <p>Checksum Type mismatch occurred, expected checksum Type: sha1, actual checksum Type: crc32c.</p>
267
+ * </li>
268
+ * <li>
269
+ * <p>Request body cannot be empty when 'write offset' is specified.</p>
270
+ * </li>
271
+ * </ul>
272
+ *
273
+ * @throws {@link InvalidWriteOffset} (client fault)
274
+ * <p>
275
+ * The write offset value that you specified does not match the current object size.
276
+ * </p>
277
+ *
278
+ * @throws {@link TooManyParts} (client fault)
279
+ * <p>
280
+ * You have attempted to add more parts than the maximum of 10000
281
+ * that are allowed for this object. You can use the CopyObject operation
282
+ * to copy this object to another and then add more data to the newly copied object.
283
+ * </p>
284
+ *
237
285
  * @throws {@link S3ServiceException}
238
286
  * <p>Base exception class for all service exceptions from S3 service.</p>
239
287
  *
@@ -28,7 +28,7 @@ declare const PutObjectLegalHoldCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Applies a legal hold configuration to the specified object. For more information, see
34
34
  * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking
@@ -28,7 +28,7 @@ declare const PutObjectLockConfigurationCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Places an Object Lock configuration on the specified bucket. The rule specified in the
34
34
  * Object Lock configuration will be applied by default to every new object placed in the
@@ -45,8 +45,8 @@ declare const PutObjectLockConfigurationCommand_base: {
45
45
  * <code>Days</code> and <code>Years</code> at the same time.</p>
46
46
  * </li>
47
47
  * <li>
48
- * <p>You can enable Object Lock for new or existing buckets. For more
49
- * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-configure.html">Configuring Object
48
+ * <p>You can enable Object Lock for new or existing buckets. For more information,
49
+ * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-configure.html">Configuring Object
50
50
  * Lock</a>.</p>
51
51
  * </li>
52
52
  * </ul>
@@ -24,11 +24,11 @@ export interface PutObjectRetentionCommandOutput extends PutObjectRetentionOutpu
24
24
  declare const PutObjectRetentionCommand_base: {
25
25
  new (input: PutObjectRetentionCommandInput): import("@smithy/smithy-client").CommandImpl<PutObjectRetentionCommandInput, PutObjectRetentionCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
26
26
  new (__0_0: PutObjectRetentionCommandInput): import("@smithy/smithy-client").CommandImpl<PutObjectRetentionCommandInput, PutObjectRetentionCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
27
- getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
27
+ getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions; /** @internal type navigation helper, not in runtime. */
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Places an Object Retention configuration on an object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html">Locking Objects</a>.
34
34
  * Users or accounts require the <code>s3:PutObjectRetention</code> permission in order to
@@ -28,7 +28,7 @@ declare const PutObjectTaggingCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Sets the supplied tag-set to an object that already exists in a bucket. A tag is a
34
34
  * key-value pair. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object Tagging</a>.</p>
@@ -28,7 +28,7 @@ declare const PutPublicAccessBlockCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Creates or modifies the <code>PublicAccessBlock</code> configuration for an Amazon S3 bucket.
34
34
  * To use this operation, you must have the <code>s3:PutBucketPublicAccessBlock</code>
@@ -28,7 +28,7 @@ declare const RestoreObjectCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>Restores an archived copy of an object back into Amazon S3</p>
34
34
  * <p>This functionality is not supported for Amazon S3 on Outposts.</p>
@@ -28,7 +28,7 @@ declare const SelectObjectContentCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <note>
31
- * <p>This operation is not supported by directory buckets.</p>
31
+ * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
33
  * <p>This action filters the contents of an Amazon S3 object based on a simple structured query
34
34
  * language (SQL) statement. In the request, along with the SQL expression, you must also
@@ -30,10 +30,9 @@ declare const UploadPartCommand_base: {
30
30
  /**
31
31
  * <p>Uploads a part in a multipart upload.</p>
32
32
  * <note>
33
- * <p>In this operation, you provide new data as a part of an object in your request. However, you have an option
34
- * to specify your existing Amazon S3 object as a data source for the part you are uploading. To
35
- * upload a part from an existing object, you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a> operation.
36
- * </p>
33
+ * <p>In this operation, you provide new data as a part of an object in your request.
34
+ * However, you have an option to specify your existing Amazon S3 object as a data source for
35
+ * the part you are uploading. To upload a part from an existing object, you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html">UploadPartCopy</a> operation. </p>
37
36
  * </note>
38
37
  * <p>You must initiate a multipart upload (see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>)
39
38
  * before you can upload any part. In response to your initiate request, Amazon S3 returns an
@@ -45,17 +44,17 @@ declare const UploadPartCommand_base: {
45
44
  * <p>For information about maximum and minimum part sizes and other multipart upload
46
45
  * specifications, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html">Multipart upload limits</a> in the <i>Amazon S3 User Guide</i>.</p>
47
46
  * <note>
48
- * <p>After you initiate multipart upload and upload
49
- * one or more parts, you must either complete or abort multipart upload in order to stop
50
- * getting charged for storage of the uploaded parts. Only after you either complete or abort
51
- * multipart upload, Amazon S3 frees up the parts storage and stops charging you for the parts
52
- * storage.</p>
47
+ * <p>After you initiate multipart upload and upload one or more parts, you must either
48
+ * complete or abort multipart upload in order to stop getting charged for storage of the
49
+ * uploaded parts. Only after you either complete or abort multipart upload, Amazon S3 frees up
50
+ * the parts storage and stops charging you for the parts storage.</p>
53
51
  * </note>
54
52
  * <p>For more information on multipart uploads, go to <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html">Multipart Upload Overview</a> in the
55
- * <i>Amazon S3 User Guide </i>.</p>
53
+ * <i>Amazon S3 User Guide </i>.</p>
56
54
  * <note>
57
55
  * <p>
58
- * <b>Directory buckets</b> - For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
56
+ * <b>Directory buckets</b> -
57
+ * For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
59
58
  * </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
60
59
  * <i>Amazon S3 User Guide</i>.</p>
61
60
  * </note>
@@ -89,20 +88,24 @@ declare const UploadPartCommand_base: {
89
88
  * Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
90
89
  * <code>CreateSession</code>
91
90
  * </a>.</p>
92
- * <p>If the object is encrypted with
93
- * SSE-KMS, you must also have the
94
- * <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions in IAM identity-based policies and KMS key policies for the KMS key.</p>
91
+ * <p>If the object is encrypted with SSE-KMS, you must also have the
92
+ * <code>kms:GenerateDataKey</code> and <code>kms:Decrypt</code> permissions
93
+ * in IAM identity-based policies and KMS key policies for the KMS
94
+ * key.</p>
95
95
  * </li>
96
96
  * </ul>
97
97
  * </dd>
98
98
  * <dt>Data integrity</dt>
99
99
  * <dd>
100
100
  * <p>
101
- * <b>General purpose bucket</b> - To ensure that data is not corrupted traversing the network, specify the
102
- * <code>Content-MD5</code> header in the upload part request. Amazon S3 checks the part data against the provided MD5 value. If they do not match, Amazon S3 returns an error. If the upload request is signed with Signature Version 4, then Amazon Web Services S3 uses the
103
- * <code>x-amz-content-sha256</code> header as a checksum instead of
104
- * <code>Content-MD5</code>. For more information see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html">Authenticating
105
- * Requests: Using the Authorization Header (Amazon Web Services Signature Version 4)</a>. </p>
101
+ * <b>General purpose bucket</b> - To ensure that data
102
+ * is not corrupted traversing the network, specify the <code>Content-MD5</code>
103
+ * header in the upload part request. Amazon S3 checks the part data against the provided
104
+ * MD5 value. If they do not match, Amazon S3 returns an error. If the upload request is
105
+ * signed with Signature Version 4, then Amazon Web Services S3 uses the
106
+ * <code>x-amz-content-sha256</code> header as a checksum instead of
107
+ * <code>Content-MD5</code>. For more information see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html">Authenticating Requests: Using the Authorization Header (Amazon Web Services Signature
108
+ * Version 4)</a>. </p>
106
109
  * <note>
107
110
  * <p>
108
111
  * <b>Directory buckets</b> - MD5 is not supported by directory buckets. You can use checksum algorithms to check object integrity.</p>
@@ -113,23 +116,28 @@ declare const UploadPartCommand_base: {
113
116
  * <ul>
114
117
  * <li>
115
118
  * <p>
116
- * <b>General purpose bucket</b> - Server-side encryption is for data encryption at rest. Amazon S3 encrypts your data as it
117
- * writes it to disks in its data centers and decrypts it when you access it. You have
118
- * mutually exclusive options to protect data using server-side encryption in Amazon S3, depending
119
- * on how you choose to manage the encryption keys. Specifically, the encryption key options
120
- * are Amazon S3 managed keys (SSE-S3), Amazon Web Services KMS keys (SSE-KMS), and Customer-Provided Keys
121
- * (SSE-C). Amazon S3 encrypts data with server-side encryption using Amazon S3 managed keys (SSE-S3) by
122
- * default. You can optionally tell Amazon S3 to encrypt data at rest using server-side encryption
123
- * with other key options. The option you use depends on whether you want to use KMS keys
124
- * (SSE-KMS) or provide your own encryption key (SSE-C).</p>
125
- * <p>Server-side encryption is supported by the S3 Multipart Upload operations. Unless you are
126
- * using a customer-provided encryption key (SSE-C), you don't need to specify the encryption
127
- * parameters in each UploadPart request. Instead, you only need to specify the server-side
128
- * encryption parameters in the initial Initiate Multipart request. For more information, see
129
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>.</p>
130
- * <p>If you request server-side encryption using a customer-provided encryption key (SSE-C)
131
- * in your initiate multipart upload request, you must provide identical encryption
132
- * information in each part upload using the following request headers.</p>
119
+ * <b>General purpose bucket</b> - Server-side
120
+ * encryption is for data encryption at rest. Amazon S3 encrypts your data as it
121
+ * writes it to disks in its data centers and decrypts it when you access it.
122
+ * You have mutually exclusive options to protect data using server-side
123
+ * encryption in Amazon S3, depending on how you choose to manage the encryption
124
+ * keys. Specifically, the encryption key options are Amazon S3 managed keys
125
+ * (SSE-S3), Amazon Web Services KMS keys (SSE-KMS), and Customer-Provided Keys (SSE-C).
126
+ * Amazon S3 encrypts data with server-side encryption using Amazon S3 managed keys
127
+ * (SSE-S3) by default. You can optionally tell Amazon S3 to encrypt data at rest
128
+ * using server-side encryption with other key options. The option you use
129
+ * depends on whether you want to use KMS keys (SSE-KMS) or provide your own
130
+ * encryption key (SSE-C).</p>
131
+ * <p>Server-side encryption is supported by the S3 Multipart Upload
132
+ * operations. Unless you are using a customer-provided encryption key (SSE-C),
133
+ * you don't need to specify the encryption parameters in each UploadPart
134
+ * request. Instead, you only need to specify the server-side encryption
135
+ * parameters in the initial Initiate Multipart request. For more information,
136
+ * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html">CreateMultipartUpload</a>.</p>
137
+ * <p>If you request server-side encryption using a customer-provided
138
+ * encryption key (SSE-C) in your initiate multipart upload request, you must
139
+ * provide identical encryption information in each part upload using the
140
+ * following request headers.</p>
133
141
  * <ul>
134
142
  * <li>
135
143
  * <p>x-amz-server-side-encryption-customer-algorithm</p>
@@ -141,13 +149,14 @@ declare const UploadPartCommand_base: {
141
149
  * <p>x-amz-server-side-encryption-customer-key-MD5</p>
142
150
  * </li>
143
151
  * </ul>
144
- * <p>
145
- * For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html">Using Server-Side
146
- * Encryption</a> in the <i>Amazon S3 User Guide</i>.</p>
152
+ * <p> For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html">Using
153
+ * Server-Side Encryption</a> in the
154
+ * <i>Amazon S3 User Guide</i>.</p>
147
155
  * </li>
148
156
  * <li>
149
157
  * <p>
150
- * <b>Directory buckets </b> - For directory buckets, there are only two supported options for server-side encryption: server-side encryption with Amazon S3 managed keys (SSE-S3) (<code>AES256</code>) and server-side encryption with KMS keys (SSE-KMS) (<code>aws:kms</code>).</p>
158
+ * <b>Directory buckets </b> -
159
+ * For directory buckets, there are only two supported options for server-side encryption: server-side encryption with Amazon S3 managed keys (SSE-S3) (<code>AES256</code>) and server-side encryption with KMS keys (SSE-KMS) (<code>aws:kms</code>).</p>
151
160
  * </li>
152
161
  * </ul>
153
162
  * </dd>
@@ -159,7 +168,9 @@ declare const UploadPartCommand_base: {
159
168
  * </p>
160
169
  * <ul>
161
170
  * <li>
162
- * <p>Description: The specified multipart upload does not exist. The upload ID might be invalid, or the multipart upload might have been aborted or completed.</p>
171
+ * <p>Description: The specified multipart upload does not exist. The
172
+ * upload ID might be invalid, or the multipart upload might have been
173
+ * aborted or completed.</p>
163
174
  * </li>
164
175
  * <li>
165
176
  * <p>HTTP Status Code: 404 Not Found </p>