@aws-sdk/client-s3 3.465.0 → 3.468.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.
@@ -155,28 +155,28 @@ export interface DeleteObjectCommandOutput extends DeleteObjectOutput, __Metadat
155
155
  * @throws {@link S3ServiceException}
156
156
  * <p>Base exception class for all service exceptions from S3 service.</p>
157
157
  *
158
- * @example To delete an object (from a non-versioned bucket)
158
+ * @example To delete an object
159
159
  * ```javascript
160
- * // The following example deletes an object from a non-versioned bucket.
160
+ * // The following example deletes an object from an S3 bucket.
161
161
  * const input = {
162
- * "Bucket": "ExampleBucket",
163
- * "Key": "HappyFace.jpg"
162
+ * "Bucket": "examplebucket",
163
+ * "Key": "objectkey.jpg"
164
164
  * };
165
165
  * const command = new DeleteObjectCommand(input);
166
166
  * await client.send(command);
167
- * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
167
+ * // example id: to-delete-an-object-1472850136595
168
168
  * ```
169
169
  *
170
- * @example To delete an object
170
+ * @example To delete an object (from a non-versioned bucket)
171
171
  * ```javascript
172
- * // The following example deletes an object from an S3 bucket.
172
+ * // The following example deletes an object from a non-versioned bucket.
173
173
  * const input = {
174
- * "Bucket": "examplebucket",
175
- * "Key": "objectkey.jpg"
174
+ * "Bucket": "ExampleBucket",
175
+ * "Key": "HappyFace.jpg"
176
176
  * };
177
177
  * const command = new DeleteObjectCommand(input);
178
178
  * await client.send(command);
179
- * // example id: to-delete-an-object-1472850136595
179
+ * // example id: to-delete-an-object-from-a-non-versioned-bucket-1481588533089
180
180
  * ```
181
181
  *
182
182
  */
@@ -75,39 +75,39 @@ export interface DeleteObjectTaggingCommandOutput extends DeleteObjectTaggingOut
75
75
  * @throws {@link S3ServiceException}
76
76
  * <p>Base exception class for all service exceptions from S3 service.</p>
77
77
  *
78
- * @example To remove tag set from an object
78
+ * @example To remove tag set from an object version
79
79
  * ```javascript
80
- * // The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.
80
+ * // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
81
81
  * const input = {
82
82
  * "Bucket": "examplebucket",
83
- * "Key": "HappyFace.jpg"
83
+ * "Key": "HappyFace.jpg",
84
+ * "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
84
85
  * };
85
86
  * const command = new DeleteObjectTaggingCommand(input);
86
87
  * const response = await client.send(command);
87
88
  * /* response ==
88
89
  * {
89
- * "VersionId": "null"
90
+ * "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
90
91
  * }
91
92
  * *\/
92
- * // example id: to-remove-tag-set-from-an-object-1483145342862
93
+ * // example id: to-remove-tag-set-from-an-object-version-1483145285913
93
94
  * ```
94
95
  *
95
- * @example To remove tag set from an object version
96
+ * @example To remove tag set from an object
96
97
  * ```javascript
97
- * // The following example removes tag set associated with the specified object version. The request specifies both the object key and object version.
98
+ * // The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the operation removes tag set from the latest object version.
98
99
  * const input = {
99
100
  * "Bucket": "examplebucket",
100
- * "Key": "HappyFace.jpg",
101
- * "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
101
+ * "Key": "HappyFace.jpg"
102
102
  * };
103
103
  * const command = new DeleteObjectTaggingCommand(input);
104
104
  * const response = await client.send(command);
105
105
  * /* response ==
106
106
  * {
107
- * "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
107
+ * "VersionId": "null"
108
108
  * }
109
109
  * *\/
110
- * // example id: to-remove-tag-set-from-an-object-version-1483145285913
110
+ * // example id: to-remove-tag-set-from-an-object-1483145342862
111
111
  * ```
112
112
  *
113
113
  */
@@ -91,13 +91,12 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
91
91
  * @throws {@link S3ServiceException}
92
92
  * <p>Base exception class for all service exceptions from S3 service.</p>
93
93
  *
94
- * @example To retrieve tag set of a specific object version
94
+ * @example To retrieve tag set of an object
95
95
  * ```javascript
96
- * // The following example retrieves tag set of an object. The request specifies object version.
96
+ * // The following example retrieves tag set of an object.
97
97
  * const input = {
98
98
  * "Bucket": "examplebucket",
99
- * "Key": "exampleobject",
100
- * "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
99
+ * "Key": "HappyFace.jpg"
101
100
  * };
102
101
  * const command = new GetObjectTaggingCommand(input);
103
102
  * const response = await client.send(command);
@@ -105,22 +104,27 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
105
104
  * {
106
105
  * "TagSet": [
107
106
  * {
108
- * "Key": "Key1",
109
- * "Value": "Value1"
107
+ * "Key": "Key4",
108
+ * "Value": "Value4"
109
+ * },
110
+ * {
111
+ * "Key": "Key3",
112
+ * "Value": "Value3"
110
113
  * }
111
114
  * ],
112
- * "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
115
+ * "VersionId": "null"
113
116
  * }
114
117
  * *\/
115
- * // example id: to-retrieve-tag-set-of-a-specific-object-version-1483400283663
118
+ * // example id: to-retrieve-tag-set-of-an-object-1481833847896
116
119
  * ```
117
120
  *
118
- * @example To retrieve tag set of an object
121
+ * @example To retrieve tag set of a specific object version
119
122
  * ```javascript
120
- * // The following example retrieves tag set of an object.
123
+ * // The following example retrieves tag set of an object. The request specifies object version.
121
124
  * const input = {
122
125
  * "Bucket": "examplebucket",
123
- * "Key": "HappyFace.jpg"
126
+ * "Key": "exampleobject",
127
+ * "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
124
128
  * };
125
129
  * const command = new GetObjectTaggingCommand(input);
126
130
  * const response = await client.send(command);
@@ -128,18 +132,14 @@ export interface GetObjectTaggingCommandOutput extends GetObjectTaggingOutput, _
128
132
  * {
129
133
  * "TagSet": [
130
134
  * {
131
- * "Key": "Key4",
132
- * "Value": "Value4"
133
- * },
134
- * {
135
- * "Key": "Key3",
136
- * "Value": "Value3"
135
+ * "Key": "Key1",
136
+ * "Value": "Value1"
137
137
  * }
138
138
  * ],
139
- * "VersionId": "null"
139
+ * "VersionId": "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI"
140
140
  * }
141
141
  * *\/
142
- * // example id: to-retrieve-tag-set-of-an-object-1481833847896
142
+ * // example id: to-retrieve-tag-set-of-a-specific-object-version-1483400283663
143
143
  * ```
144
144
  *
145
145
  */
@@ -203,104 +203,104 @@ export interface ListMultipartUploadsCommandOutput extends ListMultipartUploadsO
203
203
  * @throws {@link S3ServiceException}
204
204
  * <p>Base exception class for all service exceptions from S3 service.</p>
205
205
  *
206
- * @example To list in-progress multipart uploads on a bucket
206
+ * @example List next set of multipart uploads when previous result is truncated
207
207
  * ```javascript
208
- * // The following example lists in-progress multipart uploads on a specific bucket.
208
+ * // The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next setup of multipart uploads.
209
209
  * const input = {
210
- * "Bucket": "examplebucket"
210
+ * "Bucket": "examplebucket",
211
+ * "KeyMarker": "nextkeyfrompreviousresponse",
212
+ * "MaxUploads": "2",
213
+ * "UploadIdMarker": "valuefrompreviousresponse"
211
214
  * };
212
215
  * const command = new ListMultipartUploadsCommand(input);
213
216
  * const response = await client.send(command);
214
217
  * /* response ==
215
218
  * {
219
+ * "Bucket": "acl1",
220
+ * "IsTruncated": true,
221
+ * "KeyMarker": "",
222
+ * "MaxUploads": "2",
223
+ * "NextKeyMarker": "someobjectkey",
224
+ * "NextUploadIdMarker": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
225
+ * "UploadIdMarker": "",
216
226
  * "Uploads": [
217
227
  * {
218
228
  * "Initiated": "2014-05-01T05:40:58.000Z",
219
229
  * "Initiator": {
220
- * "DisplayName": "display-name",
230
+ * "DisplayName": "ownder-display-name",
221
231
  * "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
222
232
  * },
223
233
  * "Key": "JavaFile",
224
234
  * "Owner": {
225
- * "DisplayName": "display-name",
226
- * "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
235
+ * "DisplayName": "mohanataws",
236
+ * "ID": "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
227
237
  * },
228
238
  * "StorageClass": "STANDARD",
229
- * "UploadId": "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
239
+ * "UploadId": "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
230
240
  * },
231
241
  * {
232
242
  * "Initiated": "2014-05-01T05:41:27.000Z",
233
243
  * "Initiator": {
234
- * "DisplayName": "display-name",
244
+ * "DisplayName": "ownder-display-name",
235
245
  * "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
236
246
  * },
237
247
  * "Key": "JavaFile",
238
248
  * "Owner": {
239
- * "DisplayName": "display-name",
249
+ * "DisplayName": "ownder-display-name",
240
250
  * "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
241
251
  * },
242
252
  * "StorageClass": "STANDARD",
243
- * "UploadId": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
253
+ * "UploadId": "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
244
254
  * }
245
255
  * ]
246
256
  * }
247
257
  * *\/
248
- * // example id: to-list-in-progress-multipart-uploads-on-a-bucket-1481852775260
258
+ * // example id: list-next-set-of-multipart-uploads-when-previous-result-is-truncated-1482428106748
249
259
  * ```
250
260
  *
251
- * @example List next set of multipart uploads when previous result is truncated
261
+ * @example To list in-progress multipart uploads on a bucket
252
262
  * ```javascript
253
- * // The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next setup of multipart uploads.
263
+ * // The following example lists in-progress multipart uploads on a specific bucket.
254
264
  * const input = {
255
- * "Bucket": "examplebucket",
256
- * "KeyMarker": "nextkeyfrompreviousresponse",
257
- * "MaxUploads": "2",
258
- * "UploadIdMarker": "valuefrompreviousresponse"
265
+ * "Bucket": "examplebucket"
259
266
  * };
260
267
  * const command = new ListMultipartUploadsCommand(input);
261
268
  * const response = await client.send(command);
262
269
  * /* response ==
263
270
  * {
264
- * "Bucket": "acl1",
265
- * "IsTruncated": true,
266
- * "KeyMarker": "",
267
- * "MaxUploads": "2",
268
- * "NextKeyMarker": "someobjectkey",
269
- * "NextUploadIdMarker": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
270
- * "UploadIdMarker": "",
271
271
  * "Uploads": [
272
272
  * {
273
273
  * "Initiated": "2014-05-01T05:40:58.000Z",
274
274
  * "Initiator": {
275
- * "DisplayName": "ownder-display-name",
275
+ * "DisplayName": "display-name",
276
276
  * "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
277
277
  * },
278
278
  * "Key": "JavaFile",
279
279
  * "Owner": {
280
- * "DisplayName": "mohanataws",
281
- * "ID": "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
280
+ * "DisplayName": "display-name",
281
+ * "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
282
282
  * },
283
283
  * "StorageClass": "STANDARD",
284
- * "UploadId": "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
284
+ * "UploadId": "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--"
285
285
  * },
286
286
  * {
287
287
  * "Initiated": "2014-05-01T05:41:27.000Z",
288
288
  * "Initiator": {
289
- * "DisplayName": "ownder-display-name",
289
+ * "DisplayName": "display-name",
290
290
  * "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
291
291
  * },
292
292
  * "Key": "JavaFile",
293
293
  * "Owner": {
294
- * "DisplayName": "ownder-display-name",
294
+ * "DisplayName": "display-name",
295
295
  * "ID": "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc"
296
296
  * },
297
297
  * "StorageClass": "STANDARD",
298
- * "UploadId": "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
298
+ * "UploadId": "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--"
299
299
  * }
300
300
  * ]
301
301
  * }
302
302
  * *\/
303
- * // example id: list-next-set-of-multipart-uploads-when-previous-result-is-truncated-1482428106748
303
+ * // example id: to-list-in-progress-multipart-uploads-on-a-bucket-1481852775260
304
304
  * ```
305
305
  *
306
306
  */
@@ -229,43 +229,42 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
229
229
  * @throws {@link S3ServiceException}
230
230
  * <p>Base exception class for all service exceptions from S3 service.</p>
231
231
  *
232
- * @example To upload an object and specify optional tags
232
+ * @example To create an object.
233
233
  * ```javascript
234
- * // The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object.
234
+ * // The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
235
235
  * const input = {
236
- * "Body": "c:\\HappyFace.jpg",
236
+ * "Body": "filetoupload",
237
237
  * "Bucket": "examplebucket",
238
- * "Key": "HappyFace.jpg",
239
- * "Tagging": "key1=value1&key2=value2"
238
+ * "Key": "objectkey"
240
239
  * };
241
240
  * const command = new PutObjectCommand(input);
242
241
  * const response = await client.send(command);
243
242
  * /* response ==
244
243
  * {
245
244
  * "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
246
- * "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
245
+ * "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
247
246
  * }
248
247
  * *\/
249
- * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
248
+ * // example id: to-create-an-object-1483147613675
250
249
  * ```
251
250
  *
252
- * @example To create an object.
251
+ * @example To upload an object
253
252
  * ```javascript
254
- * // The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
253
+ * // The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file syntax. S3 returns VersionId of the newly created object.
255
254
  * const input = {
256
- * "Body": "filetoupload",
255
+ * "Body": "HappyFace.jpg",
257
256
  * "Bucket": "examplebucket",
258
- * "Key": "objectkey"
257
+ * "Key": "HappyFace.jpg"
259
258
  * };
260
259
  * const command = new PutObjectCommand(input);
261
260
  * const response = await client.send(command);
262
261
  * /* response ==
263
262
  * {
264
263
  * "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
265
- * "VersionId": "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ"
264
+ * "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
266
265
  * }
267
266
  * *\/
268
- * // example id: to-create-an-object-1483147613675
267
+ * // example id: to-upload-an-object-1481760101010
269
268
  * ```
270
269
  *
271
270
  * @example To upload object and specify user-defined metadata
@@ -291,23 +290,46 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
291
290
  * // example id: to-upload-object-and-specify-user-defined-metadata-1483396974757
292
291
  * ```
293
292
  *
294
- * @example To upload an object
293
+ * @example To upload an object and specify optional tags
295
294
  * ```javascript
296
- * // The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file syntax. S3 returns VersionId of the newly created object.
295
+ * // The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore S3 returns version ID of the newly created object.
296
+ * const input = {
297
+ * "Body": "c:\\HappyFace.jpg",
298
+ * "Bucket": "examplebucket",
299
+ * "Key": "HappyFace.jpg",
300
+ * "Tagging": "key1=value1&key2=value2"
301
+ * };
302
+ * const command = new PutObjectCommand(input);
303
+ * const response = await client.send(command);
304
+ * /* response ==
305
+ * {
306
+ * "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
307
+ * "VersionId": "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a"
308
+ * }
309
+ * *\/
310
+ * // example id: to-upload-an-object-and-specify-optional-tags-1481762310955
311
+ * ```
312
+ *
313
+ * @example To upload an object (specify optional headers)
314
+ * ```javascript
315
+ * // The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption.
297
316
  * const input = {
298
317
  * "Body": "HappyFace.jpg",
299
318
  * "Bucket": "examplebucket",
300
- * "Key": "HappyFace.jpg"
319
+ * "Key": "HappyFace.jpg",
320
+ * "ServerSideEncryption": "AES256",
321
+ * "StorageClass": "STANDARD_IA"
301
322
  * };
302
323
  * const command = new PutObjectCommand(input);
303
324
  * const response = await client.send(command);
304
325
  * /* response ==
305
326
  * {
306
327
  * "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
307
- * "VersionId": "tpf3zF08nBplQK1XLOefGskR7mGDwcDk"
328
+ * "ServerSideEncryption": "AES256",
329
+ * "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
308
330
  * }
309
331
  * *\/
310
- * // example id: to-upload-an-object-1481760101010
332
+ * // example id: to-upload-an-object-(specify-optional-headers)
311
333
  * ```
312
334
  *
313
335
  * @example To upload an object and specify server-side encryption and object tags
@@ -352,28 +374,6 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
352
374
  * // example id: to-upload-an-object-and-specify-canned-acl-1483397779571
353
375
  * ```
354
376
  *
355
- * @example To upload an object (specify optional headers)
356
- * ```javascript
357
- * // The following example uploads an object. The request specifies optional request headers to directs S3 to use specific storage class and use server-side encryption.
358
- * const input = {
359
- * "Body": "HappyFace.jpg",
360
- * "Bucket": "examplebucket",
361
- * "Key": "HappyFace.jpg",
362
- * "ServerSideEncryption": "AES256",
363
- * "StorageClass": "STANDARD_IA"
364
- * };
365
- * const command = new PutObjectCommand(input);
366
- * const response = await client.send(command);
367
- * /* response ==
368
- * {
369
- * "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
370
- * "ServerSideEncryption": "AES256",
371
- * "VersionId": "CG612hodqujkf8FaaNfp8U..FIhLROcp"
372
- * }
373
- * *\/
374
- * // example id: to-upload-an-object-(specify-optional-headers)
375
- * ```
376
- *
377
377
  */
378
378
  export declare class PutObjectCommand extends $Command<PutObjectCommandInput, PutObjectCommandOutput, S3ClientResolvedConfig> {
379
379
  readonly input: PutObjectCommandInput;
@@ -259,15 +259,14 @@ export interface UploadPartCopyCommandOutput extends UploadPartCopyOutput, __Met
259
259
  * @throws {@link S3ServiceException}
260
260
  * <p>Base exception class for all service exceptions from S3 service.</p>
261
261
  *
262
- * @example To upload a part by copying byte range from an existing object as data source
262
+ * @example To upload a part by copying data from an existing object as data source
263
263
  * ```javascript
264
- * // The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as data source.
264
+ * // The following example uploads a part of a multipart upload by copying data from an existing object as data source.
265
265
  * const input = {
266
266
  * "Bucket": "examplebucket",
267
267
  * "CopySource": "/bucketname/sourceobjectkey",
268
- * "CopySourceRange": "bytes=1-100000",
269
268
  * "Key": "examplelargeobject",
270
- * "PartNumber": "2",
269
+ * "PartNumber": "1",
271
270
  * "UploadId": "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--"
272
271
  * };
273
272
  * const command = new UploadPartCopyCommand(input);
@@ -275,22 +274,23 @@ export interface UploadPartCopyCommandOutput extends UploadPartCopyOutput, __Met
275
274
  * /* response ==
276
275
  * {
277
276
  * "CopyPartResult": {
278
- * "ETag": "\"65d16d19e65a7508a51f043180edcc36\"",
279
- * "LastModified": "2016-12-29T21:44:28.000Z"
277
+ * "ETag": "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
278
+ * "LastModified": "2016-12-29T21:24:43.000Z"
280
279
  * }
281
280
  * }
282
281
  * *\/
283
- * // example id: to-upload-a-part-by-copying-byte-range-from-an-existing-object-as-data-source-1483048068594
282
+ * // example id: to-upload-a-part-by-copying-data-from-an-existing-object-as-data-source-1483046746348
284
283
  * ```
285
284
  *
286
- * @example To upload a part by copying data from an existing object as data source
285
+ * @example To upload a part by copying byte range from an existing object as data source
287
286
  * ```javascript
288
- * // The following example uploads a part of a multipart upload by copying data from an existing object as data source.
287
+ * // The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as data source.
289
288
  * const input = {
290
289
  * "Bucket": "examplebucket",
291
290
  * "CopySource": "/bucketname/sourceobjectkey",
291
+ * "CopySourceRange": "bytes=1-100000",
292
292
  * "Key": "examplelargeobject",
293
- * "PartNumber": "1",
293
+ * "PartNumber": "2",
294
294
  * "UploadId": "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--"
295
295
  * };
296
296
  * const command = new UploadPartCopyCommand(input);
@@ -298,12 +298,12 @@ export interface UploadPartCopyCommandOutput extends UploadPartCopyOutput, __Met
298
298
  * /* response ==
299
299
  * {
300
300
  * "CopyPartResult": {
301
- * "ETag": "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
302
- * "LastModified": "2016-12-29T21:24:43.000Z"
301
+ * "ETag": "\"65d16d19e65a7508a51f043180edcc36\"",
302
+ * "LastModified": "2016-12-29T21:44:28.000Z"
303
303
  * }
304
304
  * }
305
305
  * *\/
306
- * // example id: to-upload-a-part-by-copying-data-from-an-existing-object-as-data-source-1483046746348
306
+ * // example id: to-upload-a-part-by-copying-byte-range-from-an-existing-object-as-data-source-1483048068594
307
307
  * ```
308
308
  *
309
309
  */
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.465.0",
4
+ "version": "3.468.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "tsc -p tsconfig.cjs.json",
@@ -26,58 +26,58 @@
26
26
  "@aws-crypto/sha1-browser": "3.0.0",
27
27
  "@aws-crypto/sha256-browser": "3.0.0",
28
28
  "@aws-crypto/sha256-js": "3.0.0",
29
- "@aws-sdk/client-sts": "3.465.0",
30
- "@aws-sdk/core": "3.465.0",
31
- "@aws-sdk/credential-provider-node": "3.465.0",
32
- "@aws-sdk/middleware-bucket-endpoint": "3.465.0",
33
- "@aws-sdk/middleware-expect-continue": "3.465.0",
34
- "@aws-sdk/middleware-flexible-checksums": "3.465.0",
35
- "@aws-sdk/middleware-host-header": "3.465.0",
36
- "@aws-sdk/middleware-location-constraint": "3.465.0",
37
- "@aws-sdk/middleware-logger": "3.465.0",
38
- "@aws-sdk/middleware-recursion-detection": "3.465.0",
39
- "@aws-sdk/middleware-sdk-s3": "3.465.0",
40
- "@aws-sdk/middleware-signing": "3.465.0",
41
- "@aws-sdk/middleware-ssec": "3.465.0",
42
- "@aws-sdk/middleware-user-agent": "3.465.0",
43
- "@aws-sdk/region-config-resolver": "3.465.0",
44
- "@aws-sdk/signature-v4-multi-region": "3.465.0",
45
- "@aws-sdk/types": "3.465.0",
46
- "@aws-sdk/util-endpoints": "3.465.0",
47
- "@aws-sdk/util-user-agent-browser": "3.465.0",
48
- "@aws-sdk/util-user-agent-node": "3.465.0",
29
+ "@aws-sdk/client-sts": "3.468.0",
30
+ "@aws-sdk/core": "3.468.0",
31
+ "@aws-sdk/credential-provider-node": "3.468.0",
32
+ "@aws-sdk/middleware-bucket-endpoint": "3.468.0",
33
+ "@aws-sdk/middleware-expect-continue": "3.468.0",
34
+ "@aws-sdk/middleware-flexible-checksums": "3.468.0",
35
+ "@aws-sdk/middleware-host-header": "3.468.0",
36
+ "@aws-sdk/middleware-location-constraint": "3.468.0",
37
+ "@aws-sdk/middleware-logger": "3.468.0",
38
+ "@aws-sdk/middleware-recursion-detection": "3.468.0",
39
+ "@aws-sdk/middleware-sdk-s3": "3.468.0",
40
+ "@aws-sdk/middleware-signing": "3.468.0",
41
+ "@aws-sdk/middleware-ssec": "3.468.0",
42
+ "@aws-sdk/middleware-user-agent": "3.468.0",
43
+ "@aws-sdk/region-config-resolver": "3.468.0",
44
+ "@aws-sdk/signature-v4-multi-region": "3.468.0",
45
+ "@aws-sdk/types": "3.468.0",
46
+ "@aws-sdk/util-endpoints": "3.468.0",
47
+ "@aws-sdk/util-user-agent-browser": "3.468.0",
48
+ "@aws-sdk/util-user-agent-node": "3.468.0",
49
49
  "@aws-sdk/xml-builder": "3.465.0",
50
- "@smithy/config-resolver": "^2.0.18",
51
- "@smithy/eventstream-serde-browser": "^2.0.13",
52
- "@smithy/eventstream-serde-config-resolver": "^2.0.13",
53
- "@smithy/eventstream-serde-node": "^2.0.13",
54
- "@smithy/fetch-http-handler": "^2.2.6",
55
- "@smithy/hash-blob-browser": "^2.0.14",
56
- "@smithy/hash-node": "^2.0.15",
57
- "@smithy/hash-stream-node": "^2.0.15",
58
- "@smithy/invalid-dependency": "^2.0.13",
59
- "@smithy/md5-js": "^2.0.15",
60
- "@smithy/middleware-content-length": "^2.0.15",
61
- "@smithy/middleware-endpoint": "^2.2.0",
62
- "@smithy/middleware-retry": "^2.0.20",
63
- "@smithy/middleware-serde": "^2.0.13",
64
- "@smithy/middleware-stack": "^2.0.7",
65
- "@smithy/node-config-provider": "^2.1.5",
66
- "@smithy/node-http-handler": "^2.1.9",
67
- "@smithy/protocol-http": "^3.0.9",
68
- "@smithy/smithy-client": "^2.1.15",
69
- "@smithy/types": "^2.5.0",
70
- "@smithy/url-parser": "^2.0.13",
50
+ "@smithy/config-resolver": "^2.0.20",
51
+ "@smithy/eventstream-serde-browser": "^2.0.15",
52
+ "@smithy/eventstream-serde-config-resolver": "^2.0.15",
53
+ "@smithy/eventstream-serde-node": "^2.0.15",
54
+ "@smithy/fetch-http-handler": "^2.3.1",
55
+ "@smithy/hash-blob-browser": "^2.0.16",
56
+ "@smithy/hash-node": "^2.0.17",
57
+ "@smithy/hash-stream-node": "^2.0.17",
58
+ "@smithy/invalid-dependency": "^2.0.15",
59
+ "@smithy/md5-js": "^2.0.17",
60
+ "@smithy/middleware-content-length": "^2.0.17",
61
+ "@smithy/middleware-endpoint": "^2.2.2",
62
+ "@smithy/middleware-retry": "^2.0.23",
63
+ "@smithy/middleware-serde": "^2.0.15",
64
+ "@smithy/middleware-stack": "^2.0.9",
65
+ "@smithy/node-config-provider": "^2.1.7",
66
+ "@smithy/node-http-handler": "^2.2.1",
67
+ "@smithy/protocol-http": "^3.0.11",
68
+ "@smithy/smithy-client": "^2.1.18",
69
+ "@smithy/types": "^2.7.0",
70
+ "@smithy/url-parser": "^2.0.15",
71
71
  "@smithy/util-base64": "^2.0.1",
72
- "@smithy/util-body-length-browser": "^2.0.0",
72
+ "@smithy/util-body-length-browser": "^2.0.1",
73
73
  "@smithy/util-body-length-node": "^2.1.0",
74
- "@smithy/util-defaults-mode-browser": "^2.0.19",
75
- "@smithy/util-defaults-mode-node": "^2.0.25",
76
- "@smithy/util-endpoints": "^1.0.4",
77
- "@smithy/util-retry": "^2.0.6",
78
- "@smithy/util-stream": "^2.0.20",
74
+ "@smithy/util-defaults-mode-browser": "^2.0.22",
75
+ "@smithy/util-defaults-mode-node": "^2.0.28",
76
+ "@smithy/util-endpoints": "^1.0.6",
77
+ "@smithy/util-retry": "^2.0.8",
78
+ "@smithy/util-stream": "^2.0.23",
79
79
  "@smithy/util-utf8": "^2.0.2",
80
- "@smithy/util-waiter": "^2.0.13",
80
+ "@smithy/util-waiter": "^2.0.15",
81
81
  "fast-xml-parser": "4.2.5",
82
82
  "tslib": "^2.5.0"
83
83
  },