@aws-sdk/client-s3 3.774.0 → 3.777.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 (105) hide show
  1. package/dist-cjs/auth/httpAuthSchemeProvider.js +1 -3
  2. package/dist-cjs/index.js +17 -18
  3. package/dist-es/S3Client.js +2 -1
  4. package/dist-es/auth/httpAuthSchemeProvider.js +1 -3
  5. package/dist-es/endpoint/EndpointParameters.js +2 -3
  6. package/dist-es/runtimeExtensions.js +2 -14
  7. package/dist-types/commands/AbortMultipartUploadCommand.d.ts +9 -6
  8. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +16 -16
  9. package/dist-types/commands/CopyObjectCommand.d.ts +9 -9
  10. package/dist-types/commands/CreateBucketCommand.d.ts +15 -16
  11. package/dist-types/commands/CreateBucketMetadataTableConfigurationCommand.d.ts +1 -0
  12. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +8 -8
  13. package/dist-types/commands/CreateSessionCommand.d.ts +1 -0
  14. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +1 -0
  15. package/dist-types/commands/DeleteBucketCommand.d.ts +7 -4
  16. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +7 -4
  17. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +1 -0
  18. package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +1 -0
  19. package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +1 -0
  20. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +7 -4
  21. package/dist-types/commands/DeleteBucketMetadataTableConfigurationCommand.d.ts +1 -0
  22. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +1 -0
  23. package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +1 -0
  24. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +7 -4
  25. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +7 -4
  26. package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +7 -4
  27. package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +7 -4
  28. package/dist-types/commands/DeleteObjectCommand.d.ts +18 -13
  29. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +11 -12
  30. package/dist-types/commands/DeleteObjectsCommand.d.ts +30 -31
  31. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +1 -0
  32. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +1 -0
  33. package/dist-types/commands/GetBucketAclCommand.d.ts +1 -0
  34. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +1 -0
  35. package/dist-types/commands/GetBucketCorsCommand.d.ts +9 -9
  36. package/dist-types/commands/GetBucketEncryptionCommand.d.ts +1 -0
  37. package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +1 -0
  38. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +1 -0
  39. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +11 -11
  40. package/dist-types/commands/GetBucketLocationCommand.d.ts +5 -5
  41. package/dist-types/commands/GetBucketLoggingCommand.d.ts +1 -0
  42. package/dist-types/commands/GetBucketMetadataTableConfigurationCommand.d.ts +1 -0
  43. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +1 -0
  44. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +1 -0
  45. package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +1 -0
  46. package/dist-types/commands/GetBucketPolicyCommand.d.ts +5 -5
  47. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +1 -0
  48. package/dist-types/commands/GetBucketReplicationCommand.d.ts +12 -12
  49. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +5 -5
  50. package/dist-types/commands/GetBucketTaggingCommand.d.ts +9 -9
  51. package/dist-types/commands/GetBucketVersioningCommand.d.ts +6 -6
  52. package/dist-types/commands/GetBucketWebsiteCommand.d.ts +8 -8
  53. package/dist-types/commands/GetObjectAclCommand.d.ts +29 -29
  54. package/dist-types/commands/GetObjectAttributesCommand.d.ts +1 -0
  55. package/dist-types/commands/GetObjectCommand.d.ts +44 -30
  56. package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +1 -0
  57. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +1 -0
  58. package/dist-types/commands/GetObjectRetentionCommand.d.ts +1 -0
  59. package/dist-types/commands/GetObjectTaggingCommand.d.ts +19 -20
  60. package/dist-types/commands/GetObjectTorrentCommand.d.ts +18 -5
  61. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +1 -0
  62. package/dist-types/commands/HeadBucketCommand.d.ts +7 -4
  63. package/dist-types/commands/HeadObjectCommand.d.ts +12 -12
  64. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +1 -0
  65. package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +1 -0
  66. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +1 -0
  67. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +1 -0
  68. package/dist-types/commands/ListBucketsCommand.d.ts +14 -14
  69. package/dist-types/commands/ListDirectoryBucketsCommand.d.ts +1 -0
  70. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +62 -63
  71. package/dist-types/commands/ListObjectVersionsCommand.d.ts +26 -26
  72. package/dist-types/commands/ListObjectsCommand.d.ts +23 -23
  73. package/dist-types/commands/ListObjectsV2Command.d.ts +22 -22
  74. package/dist-types/commands/ListPartsCommand.d.ts +22 -22
  75. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +1 -0
  76. package/dist-types/commands/PutBucketAclCommand.d.ts +9 -6
  77. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +1 -0
  78. package/dist-types/commands/PutBucketCorsCommand.d.ts +19 -16
  79. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +1 -0
  80. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +1 -0
  81. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +1 -0
  82. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +18 -15
  83. package/dist-types/commands/PutBucketLoggingCommand.d.ts +16 -13
  84. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +1 -0
  85. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +11 -8
  86. package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +1 -0
  87. package/dist-types/commands/PutBucketPolicyCommand.d.ts +8 -5
  88. package/dist-types/commands/PutBucketReplicationCommand.d.ts +15 -12
  89. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +9 -6
  90. package/dist-types/commands/PutBucketTaggingCommand.d.ts +13 -10
  91. package/dist-types/commands/PutBucketVersioningCommand.d.ts +10 -7
  92. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +13 -10
  93. package/dist-types/commands/PutObjectAclCommand.d.ts +11 -8
  94. package/dist-types/commands/PutObjectCommand.d.ts +68 -74
  95. package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +1 -0
  96. package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +1 -0
  97. package/dist-types/commands/PutObjectRetentionCommand.d.ts +1 -0
  98. package/dist-types/commands/PutObjectTaggingCommand.d.ts +12 -12
  99. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -0
  100. package/dist-types/commands/RestoreObjectCommand.d.ts +12 -9
  101. package/dist-types/commands/SelectObjectContentCommand.d.ts +1 -0
  102. package/dist-types/commands/UploadPartCommand.d.ts +9 -9
  103. package/dist-types/commands/UploadPartCopyCommand.d.ts +21 -22
  104. package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +1 -0
  105. package/package.json +50 -50
@@ -120,8 +120,6 @@ exports.defaultS3HttpAuthSchemeProvider = createEndpointRuleSetHttpAuthSchemePro
120
120
  const resolveHttpAuthSchemeConfig = (config) => {
121
121
  const config_0 = (0, core_1.resolveAwsSdkSigV4Config)(config);
122
122
  const config_1 = (0, core_1.resolveAwsSdkSigV4AConfig)(config_0);
123
- return {
124
- ...config_1,
125
- };
123
+ return Object.assign(config_1, {});
126
124
  };
127
125
  exports.resolveHttpAuthSchemeConfig = resolveHttpAuthSchemeConfig;
package/dist-cjs/index.js CHANGED
@@ -289,8 +289,7 @@ var import_middleware_serde = require("@smithy/middleware-serde");
289
289
 
290
290
  // src/endpoint/EndpointParameters.ts
291
291
  var resolveClientEndpointParameters = /* @__PURE__ */ __name((options) => {
292
- return {
293
- ...options,
292
+ return Object.assign(options, {
294
293
  useFipsEndpoint: options.useFipsEndpoint ?? false,
295
294
  useDualstackEndpoint: options.useDualstackEndpoint ?? false,
296
295
  forcePathStyle: options.forcePathStyle ?? false,
@@ -298,7 +297,7 @@ var resolveClientEndpointParameters = /* @__PURE__ */ __name((options) => {
298
297
  useGlobalEndpoint: options.useGlobalEndpoint ?? false,
299
298
  disableMultiregionAccessPoints: options.disableMultiregionAccessPoints ?? false,
300
299
  defaultSigningName: "s3"
301
- };
300
+ });
302
301
  }, "resolveClientEndpointParameters");
303
302
  var commonParams = {
304
303
  ForcePathStyle: { type: "clientContextParams", name: "forcePathStyle" },
@@ -8777,22 +8776,21 @@ var resolveHttpAuthRuntimeConfig = /* @__PURE__ */ __name((config) => {
8777
8776
  }, "resolveHttpAuthRuntimeConfig");
8778
8777
 
8779
8778
  // src/runtimeExtensions.ts
8780
- var asPartial = /* @__PURE__ */ __name((t) => t, "asPartial");
8781
8779
  var resolveRuntimeExtensions = /* @__PURE__ */ __name((runtimeConfig, extensions) => {
8782
- const extensionConfiguration = {
8783
- ...asPartial((0, import_region_config_resolver.getAwsRegionExtensionConfiguration)(runtimeConfig)),
8784
- ...asPartial((0, import_smithy_client.getDefaultExtensionConfiguration)(runtimeConfig)),
8785
- ...asPartial((0, import_protocol_http.getHttpHandlerExtensionConfiguration)(runtimeConfig)),
8786
- ...asPartial(getHttpAuthExtensionConfiguration(runtimeConfig))
8787
- };
8780
+ const extensionConfiguration = Object.assign(
8781
+ (0, import_region_config_resolver.getAwsRegionExtensionConfiguration)(runtimeConfig),
8782
+ (0, import_smithy_client.getDefaultExtensionConfiguration)(runtimeConfig),
8783
+ (0, import_protocol_http.getHttpHandlerExtensionConfiguration)(runtimeConfig),
8784
+ getHttpAuthExtensionConfiguration(runtimeConfig)
8785
+ );
8788
8786
  extensions.forEach((extension) => extension.configure(extensionConfiguration));
8789
- return {
8790
- ...runtimeConfig,
8791
- ...(0, import_region_config_resolver.resolveAwsRegionExtensionConfiguration)(extensionConfiguration),
8792
- ...(0, import_smithy_client.resolveDefaultRuntimeConfig)(extensionConfiguration),
8793
- ...(0, import_protocol_http.resolveHttpHandlerRuntimeConfig)(extensionConfiguration),
8794
- ...resolveHttpAuthRuntimeConfig(extensionConfiguration)
8795
- };
8787
+ return Object.assign(
8788
+ runtimeConfig,
8789
+ (0, import_region_config_resolver.resolveAwsRegionExtensionConfiguration)(extensionConfiguration),
8790
+ (0, import_smithy_client.resolveDefaultRuntimeConfig)(extensionConfiguration),
8791
+ (0, import_protocol_http.resolveHttpHandlerRuntimeConfig)(extensionConfiguration),
8792
+ resolveHttpAuthRuntimeConfig(extensionConfiguration)
8793
+ );
8796
8794
  }, "resolveRuntimeExtensions");
8797
8795
 
8798
8796
  // src/S3Client.ts
@@ -8806,6 +8804,8 @@ var S3Client = class extends import_smithy_client.Client {
8806
8804
  config;
8807
8805
  constructor(...[configuration]) {
8808
8806
  const _config_0 = (0, import_runtimeConfig.getRuntimeConfig)(configuration || {});
8807
+ super(_config_0);
8808
+ this.initConfig = _config_0;
8809
8809
  const _config_1 = resolveClientEndpointParameters(_config_0);
8810
8810
  const _config_2 = (0, import_middleware_user_agent.resolveUserAgentConfig)(_config_1);
8811
8811
  const _config_3 = (0, import_middleware_flexible_checksums.resolveFlexibleChecksumsConfig)(_config_2);
@@ -8817,7 +8817,6 @@ var S3Client = class extends import_smithy_client.Client {
8817
8817
  const _config_9 = (0, import_httpAuthSchemeProvider.resolveHttpAuthSchemeConfig)(_config_8);
8818
8818
  const _config_10 = (0, import_middleware_sdk_s32.resolveS3Config)(_config_9, { session: [() => this, CreateSessionCommand] });
8819
8819
  const _config_11 = resolveRuntimeExtensions(_config_10, configuration?.extensions || []);
8820
- super(_config_11);
8821
8820
  this.config = _config_11;
8822
8821
  this.middlewareStack.use((0, import_middleware_user_agent.getUserAgentPlugin)(this.config));
8823
8822
  this.middlewareStack.use((0, import_middleware_retry.getRetryPlugin)(this.config));
@@ -22,6 +22,8 @@ export class S3Client extends __Client {
22
22
  config;
23
23
  constructor(...[configuration]) {
24
24
  const _config_0 = __getRuntimeConfig(configuration || {});
25
+ super(_config_0);
26
+ this.initConfig = _config_0;
25
27
  const _config_1 = resolveClientEndpointParameters(_config_0);
26
28
  const _config_2 = resolveUserAgentConfig(_config_1);
27
29
  const _config_3 = resolveFlexibleChecksumsConfig(_config_2);
@@ -33,7 +35,6 @@ export class S3Client extends __Client {
33
35
  const _config_9 = resolveHttpAuthSchemeConfig(_config_8);
34
36
  const _config_10 = resolveS3Config(_config_9, { session: [() => this, CreateSessionCommand] });
35
37
  const _config_11 = resolveRuntimeExtensions(_config_10, configuration?.extensions || []);
36
- super(_config_11);
37
38
  this.config = _config_11;
38
39
  this.middlewareStack.use(getUserAgentPlugin(this.config));
39
40
  this.middlewareStack.use(getRetryPlugin(this.config));
@@ -117,7 +117,5 @@ export const defaultS3HttpAuthSchemeProvider = createEndpointRuleSetHttpAuthSche
117
117
  export const resolveHttpAuthSchemeConfig = (config) => {
118
118
  const config_0 = resolveAwsSdkSigV4Config(config);
119
119
  const config_1 = resolveAwsSdkSigV4AConfig(config_0);
120
- return {
121
- ...config_1,
122
- };
120
+ return Object.assign(config_1, {});
123
121
  };
@@ -1,6 +1,5 @@
1
1
  export const resolveClientEndpointParameters = (options) => {
2
- return {
3
- ...options,
2
+ return Object.assign(options, {
4
3
  useFipsEndpoint: options.useFipsEndpoint ?? false,
5
4
  useDualstackEndpoint: options.useDualstackEndpoint ?? false,
6
5
  forcePathStyle: options.forcePathStyle ?? false,
@@ -8,7 +7,7 @@ export const resolveClientEndpointParameters = (options) => {
8
7
  useGlobalEndpoint: options.useGlobalEndpoint ?? false,
9
8
  disableMultiregionAccessPoints: options.disableMultiregionAccessPoints ?? false,
10
9
  defaultSigningName: "s3",
11
- };
10
+ });
12
11
  };
13
12
  export const commonParams = {
14
13
  ForcePathStyle: { type: "clientContextParams", name: "forcePathStyle" },
@@ -2,20 +2,8 @@ import { getAwsRegionExtensionConfiguration, resolveAwsRegionExtensionConfigurat
2
2
  import { getHttpHandlerExtensionConfiguration, resolveHttpHandlerRuntimeConfig } from "@smithy/protocol-http";
3
3
  import { getDefaultExtensionConfiguration, resolveDefaultRuntimeConfig } from "@smithy/smithy-client";
4
4
  import { getHttpAuthExtensionConfiguration, resolveHttpAuthRuntimeConfig } from "./auth/httpAuthExtensionConfiguration";
5
- const asPartial = (t) => t;
6
5
  export const resolveRuntimeExtensions = (runtimeConfig, extensions) => {
7
- const extensionConfiguration = {
8
- ...asPartial(getAwsRegionExtensionConfiguration(runtimeConfig)),
9
- ...asPartial(getDefaultExtensionConfiguration(runtimeConfig)),
10
- ...asPartial(getHttpHandlerExtensionConfiguration(runtimeConfig)),
11
- ...asPartial(getHttpAuthExtensionConfiguration(runtimeConfig)),
12
- };
6
+ const extensionConfiguration = Object.assign(getAwsRegionExtensionConfiguration(runtimeConfig), getDefaultExtensionConfiguration(runtimeConfig), getHttpHandlerExtensionConfiguration(runtimeConfig), getHttpAuthExtensionConfiguration(runtimeConfig));
13
7
  extensions.forEach((extension) => extension.configure(extensionConfiguration));
14
- return {
15
- ...runtimeConfig,
16
- ...resolveAwsRegionExtensionConfiguration(extensionConfiguration),
17
- ...resolveDefaultRuntimeConfig(extensionConfiguration),
18
- ...resolveHttpHandlerRuntimeConfig(extensionConfiguration),
19
- ...resolveHttpAuthRuntimeConfig(extensionConfiguration),
20
- };
8
+ return Object.assign(runtimeConfig, resolveAwsRegionExtensionConfiguration(extensionConfiguration), resolveDefaultRuntimeConfig(extensionConfiguration), resolveHttpHandlerRuntimeConfig(extensionConfiguration), resolveHttpAuthRuntimeConfig(extensionConfiguration));
21
9
  };
@@ -149,20 +149,23 @@ declare const AbortMultipartUploadCommand_base: {
149
149
  * @throws {@link S3ServiceException}
150
150
  * <p>Base exception class for all service exceptions from S3 service.</p>
151
151
  *
152
- * @public
152
+ *
153
153
  * @example To abort a multipart upload
154
154
  * ```javascript
155
155
  * // The following example aborts a multipart upload.
156
156
  * const input = {
157
- * "Bucket": "examplebucket",
158
- * "Key": "bigobject",
159
- * "UploadId": "xadcOB_7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"
157
+ * Bucket: "examplebucket",
158
+ * Key: "bigobject",
159
+ * UploadId: "xadcOB_7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"
160
160
  * };
161
161
  * const command = new AbortMultipartUploadCommand(input);
162
- * await client.send(command);
163
- * // example id: to-abort-a-multipart-upload-1481853354987
162
+ * const response = await client.send(command);
163
+ * /* response is
164
+ * { /* empty *\/ }
165
+ * *\/
164
166
  * ```
165
167
  *
168
+ * @public
166
169
  */
167
170
  export declare class AbortMultipartUploadCommand extends AbortMultipartUploadCommand_base {
168
171
  /** @internal type navigation helper, not in runtime. */
@@ -267,40 +267,40 @@ declare const CompleteMultipartUploadCommand_base: {
267
267
  * @throws {@link S3ServiceException}
268
268
  * <p>Base exception class for all service exceptions from S3 service.</p>
269
269
  *
270
- * @public
270
+ *
271
271
  * @example To complete multipart upload
272
272
  * ```javascript
273
273
  * // The following example completes a multipart upload.
274
274
  * const input = {
275
- * "Bucket": "examplebucket",
276
- * "Key": "bigobject",
277
- * "MultipartUpload": {
278
- * "Parts": [
275
+ * Bucket: "examplebucket",
276
+ * Key: "bigobject",
277
+ * MultipartUpload: {
278
+ * Parts: [
279
279
  * {
280
- * "ETag": "\"d8c2eafd90c266e19ab9dcacc479f8af\"",
281
- * "PartNumber": "1"
280
+ * ETag: `"d8c2eafd90c266e19ab9dcacc479f8af"`,
281
+ * PartNumber: 1
282
282
  * },
283
283
  * {
284
- * "ETag": "\"d8c2eafd90c266e19ab9dcacc479f8af\"",
285
- * "PartNumber": "2"
284
+ * ETag: `"d8c2eafd90c266e19ab9dcacc479f8af"`,
285
+ * PartNumber: 2
286
286
  * }
287
287
  * ]
288
288
  * },
289
- * "UploadId": "7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"
289
+ * UploadId: "7YPBOJuoFiQ9cz4P3Pe6FIZwO4f7wN93uHsNBEw97pl5eNwzExg0LAT2dUN91cOmrEQHDsP3WA60CEg--"
290
290
  * };
291
291
  * const command = new CompleteMultipartUploadCommand(input);
292
292
  * const response = await client.send(command);
293
- * /* response ==
293
+ * /* response is
294
294
  * {
295
- * "Bucket": "acexamplebucket",
296
- * "ETag": "\"4d9031c7644d8081c2829f4ea23c55f7-2\"",
297
- * "Key": "bigobject",
298
- * "Location": "https://examplebucket.s3.<Region>.amazonaws.com/bigobject"
295
+ * Bucket: "acexamplebucket",
296
+ * ETag: `"4d9031c7644d8081c2829f4ea23c55f7-2"`,
297
+ * Key: "bigobject",
298
+ * Location: "https://examplebucket.s3.<Region>.amazonaws.com/bigobject"
299
299
  * }
300
300
  * *\/
301
- * // example id: to-complete-multipart-upload-1481851590483
302
301
  * ```
303
302
  *
303
+ * @public
304
304
  */
305
305
  export declare class CompleteMultipartUploadCommand extends CompleteMultipartUploadCommand_base {
306
306
  /** @internal type navigation helper, not in runtime. */
@@ -322,28 +322,28 @@ declare const CopyObjectCommand_base: {
322
322
  * @throws {@link S3ServiceException}
323
323
  * <p>Base exception class for all service exceptions from S3 service.</p>
324
324
  *
325
- * @public
325
+ *
326
326
  * @example To copy an object
327
327
  * ```javascript
328
328
  * // The following example copies an object from one bucket to another.
329
329
  * const input = {
330
- * "Bucket": "destinationbucket",
331
- * "CopySource": "/sourcebucket/HappyFacejpg",
332
- * "Key": "HappyFaceCopyjpg"
330
+ * Bucket: "destinationbucket",
331
+ * CopySource: "/sourcebucket/HappyFacejpg",
332
+ * Key: "HappyFaceCopyjpg"
333
333
  * };
334
334
  * const command = new CopyObjectCommand(input);
335
335
  * const response = await client.send(command);
336
- * /* response ==
336
+ * /* response is
337
337
  * {
338
- * "CopyObjectResult": {
339
- * "ETag": "\"6805f2cfc46c0f04559748bb039d69ae\"",
340
- * "LastModified": "2016-12-15T17:38:53.000Z"
338
+ * CopyObjectResult: {
339
+ * ETag: `"6805f2cfc46c0f04559748bb039d69ae"`,
340
+ * LastModified: "2016-12-15T17:38:53.000Z"
341
341
  * }
342
342
  * }
343
343
  * *\/
344
- * // example id: to-copy-an-object-1481823186878
345
344
  * ```
346
345
  *
346
+ * @public
347
347
  */
348
348
  export declare class CopyObjectCommand extends CopyObjectCommand_base {
349
349
  /** @internal type navigation helper, not in runtime. */
@@ -231,42 +231,41 @@ declare const CreateBucketCommand_base: {
231
231
  * @throws {@link S3ServiceException}
232
232
  * <p>Base exception class for all service exceptions from S3 service.</p>
233
233
  *
234
- * @public
235
- * @example To create a bucket
234
+ *
235
+ * @example To create a bucket in a specific region
236
236
  * ```javascript
237
- * // The following example creates a bucket.
237
+ * // The following example creates a bucket. The request specifies an AWS region where to create the bucket.
238
238
  * const input = {
239
- * "Bucket": "examplebucket"
239
+ * Bucket: "examplebucket",
240
+ * CreateBucketConfiguration: {
241
+ * LocationConstraint: "eu-west-1"
242
+ * }
240
243
  * };
241
244
  * const command = new CreateBucketCommand(input);
242
245
  * const response = await client.send(command);
243
- * /* response ==
246
+ * /* response is
244
247
  * {
245
- * "Location": "/examplebucket"
248
+ * Location: "http://examplebucket.<Region>.s3.amazonaws.com/"
246
249
  * }
247
250
  * *\/
248
- * // example id: to-create-a-bucket--1472851826060
249
251
  * ```
250
252
  *
251
- * @example To create a bucket in a specific region
253
+ * @example To create a bucket
252
254
  * ```javascript
253
- * // The following example creates a bucket. The request specifies an AWS region where to create the bucket.
255
+ * // The following example creates a bucket.
254
256
  * const input = {
255
- * "Bucket": "examplebucket",
256
- * "CreateBucketConfiguration": {
257
- * "LocationConstraint": "eu-west-1"
258
- * }
257
+ * Bucket: "examplebucket"
259
258
  * };
260
259
  * const command = new CreateBucketCommand(input);
261
260
  * const response = await client.send(command);
262
- * /* response ==
261
+ * /* response is
263
262
  * {
264
- * "Location": "http://examplebucket.<Region>.s3.amazonaws.com/"
263
+ * Location: "/examplebucket"
265
264
  * }
266
265
  * *\/
267
- * // example id: to-create-a-bucket-in-a-specific-region-1483399072992
268
266
  * ```
269
267
  *
268
+ * @public
270
269
  */
271
270
  export declare class CreateBucketCommand extends CreateBucketCommand_base {
272
271
  /** @internal type navigation helper, not in runtime. */
@@ -117,6 +117,7 @@ declare const CreateBucketMetadataTableConfigurationCommand_base: {
117
117
  * @throws {@link S3ServiceException}
118
118
  * <p>Base exception class for all service exceptions from S3 service.</p>
119
119
  *
120
+ *
120
121
  * @public
121
122
  */
122
123
  export declare class CreateBucketMetadataTableConfigurationCommand extends CreateBucketMetadataTableConfigurationCommand_base {
@@ -365,26 +365,26 @@ declare const CreateMultipartUploadCommand_base: {
365
365
  * @throws {@link S3ServiceException}
366
366
  * <p>Base exception class for all service exceptions from S3 service.</p>
367
367
  *
368
- * @public
368
+ *
369
369
  * @example To initiate a multipart upload
370
370
  * ```javascript
371
371
  * // The following example initiates a multipart upload.
372
372
  * const input = {
373
- * "Bucket": "examplebucket",
374
- * "Key": "largeobject"
373
+ * Bucket: "examplebucket",
374
+ * Key: "largeobject"
375
375
  * };
376
376
  * const command = new CreateMultipartUploadCommand(input);
377
377
  * const response = await client.send(command);
378
- * /* response ==
378
+ * /* response is
379
379
  * {
380
- * "Bucket": "examplebucket",
381
- * "Key": "largeobject",
382
- * "UploadId": "ibZBv_75gd9r8lH_gqXatLdxMVpAlj6ZQjEs.OwyF3953YdwbcQnMA2BLGn8Lx12fQNICtMw5KyteFeHw.Sjng--"
380
+ * Bucket: "examplebucket",
381
+ * Key: "largeobject",
382
+ * UploadId: "ibZBv_75gd9r8lH_gqXatLdxMVpAlj6ZQjEs.OwyF3953YdwbcQnMA2BLGn8Lx12fQNICtMw5KyteFeHw.Sjng--"
383
383
  * }
384
384
  * *\/
385
- * // example id: to-initiate-a-multipart-upload-1481836794513
386
385
  * ```
387
386
  *
387
+ * @public
388
388
  */
389
389
  export declare class CreateMultipartUploadCommand extends CreateMultipartUploadCommand_base {
390
390
  /** @internal type navigation helper, not in runtime. */
@@ -179,6 +179,7 @@ declare const CreateSessionCommand_base: {
179
179
  * @throws {@link S3ServiceException}
180
180
  * <p>Base exception class for all service exceptions from S3 service.</p>
181
181
  *
182
+ *
182
183
  * @public
183
184
  */
184
185
  export declare class CreateSessionCommand extends CreateSessionCommand_base {
@@ -84,6 +84,7 @@ declare const DeleteBucketAnalyticsConfigurationCommand_base: {
84
84
  * @throws {@link S3ServiceException}
85
85
  * <p>Base exception class for all service exceptions from S3 service.</p>
86
86
  *
87
+ *
87
88
  * @public
88
89
  */
89
90
  export declare class DeleteBucketAnalyticsConfigurationCommand extends DeleteBucketAnalyticsConfigurationCommand_base {
@@ -110,18 +110,21 @@ declare const DeleteBucketCommand_base: {
110
110
  * @throws {@link S3ServiceException}
111
111
  * <p>Base exception class for all service exceptions from S3 service.</p>
112
112
  *
113
- * @public
113
+ *
114
114
  * @example To delete a bucket
115
115
  * ```javascript
116
116
  * // The following example deletes the specified bucket.
117
117
  * const input = {
118
- * "Bucket": "forrandall2"
118
+ * Bucket: "forrandall2"
119
119
  * };
120
120
  * const command = new DeleteBucketCommand(input);
121
- * await client.send(command);
122
- * // example id: to-delete-a-bucket-1473108514262
121
+ * const response = await client.send(command);
122
+ * /* response is
123
+ * { /* metadata only *\/ }
124
+ * *\/
123
125
  * ```
124
126
  *
127
+ * @public
125
128
  */
126
129
  export declare class DeleteBucketCommand extends DeleteBucketCommand_base {
127
130
  /** @internal type navigation helper, not in runtime. */
@@ -76,18 +76,21 @@ declare const DeleteBucketCorsCommand_base: {
76
76
  * @throws {@link S3ServiceException}
77
77
  * <p>Base exception class for all service exceptions from S3 service.</p>
78
78
  *
79
- * @public
79
+ *
80
80
  * @example To delete cors configuration on a bucket.
81
81
  * ```javascript
82
82
  * // The following example deletes CORS configuration on a bucket.
83
83
  * const input = {
84
- * "Bucket": "examplebucket"
84
+ * Bucket: "examplebucket"
85
85
  * };
86
86
  * const command = new DeleteBucketCorsCommand(input);
87
- * await client.send(command);
88
- * // example id: to-delete-cors-configuration-on-a-bucket-1483042856112
87
+ * const response = await client.send(command);
88
+ * /* response is
89
+ * { /* metadata only *\/ }
90
+ * *\/
89
91
  * ```
90
92
  *
93
+ * @public
91
94
  */
92
95
  export declare class DeleteBucketCorsCommand extends DeleteBucketCorsCommand_base {
93
96
  /** @internal type navigation helper, not in runtime. */
@@ -113,6 +113,7 @@ declare const DeleteBucketEncryptionCommand_base: {
113
113
  * @throws {@link S3ServiceException}
114
114
  * <p>Base exception class for all service exceptions from S3 service.</p>
115
115
  *
116
+ *
116
117
  * @public
117
118
  */
118
119
  export declare class DeleteBucketEncryptionCommand extends DeleteBucketEncryptionCommand_base {
@@ -77,6 +77,7 @@ declare const DeleteBucketIntelligentTieringConfigurationCommand_base: {
77
77
  * @throws {@link S3ServiceException}
78
78
  * <p>Base exception class for all service exceptions from S3 service.</p>
79
79
  *
80
+ *
80
81
  * @public
81
82
  */
82
83
  export declare class DeleteBucketIntelligentTieringConfigurationCommand extends DeleteBucketIntelligentTieringConfigurationCommand_base {
@@ -82,6 +82,7 @@ declare const DeleteBucketInventoryConfigurationCommand_base: {
82
82
  * @throws {@link S3ServiceException}
83
83
  * <p>Base exception class for all service exceptions from S3 service.</p>
84
84
  *
85
+ *
85
86
  * @public
86
87
  */
87
88
  export declare class DeleteBucketInventoryConfigurationCommand extends DeleteBucketInventoryConfigurationCommand_base {
@@ -122,18 +122,21 @@ declare const DeleteBucketLifecycleCommand_base: {
122
122
  * @throws {@link S3ServiceException}
123
123
  * <p>Base exception class for all service exceptions from S3 service.</p>
124
124
  *
125
- * @public
125
+ *
126
126
  * @example To delete lifecycle configuration on a bucket.
127
127
  * ```javascript
128
128
  * // The following example deletes lifecycle configuration on a bucket.
129
129
  * const input = {
130
- * "Bucket": "examplebucket"
130
+ * Bucket: "examplebucket"
131
131
  * };
132
132
  * const command = new DeleteBucketLifecycleCommand(input);
133
- * await client.send(command);
134
- * // example id: to-delete-lifecycle-configuration-on-a-bucket-1483043310583
133
+ * const response = await client.send(command);
134
+ * /* response is
135
+ * { /* metadata only *\/ }
136
+ * *\/
135
137
  * ```
136
138
  *
139
+ * @public
137
140
  */
138
141
  export declare class DeleteBucketLifecycleCommand extends DeleteBucketLifecycleCommand_base {
139
142
  /** @internal type navigation helper, not in runtime. */
@@ -78,6 +78,7 @@ declare const DeleteBucketMetadataTableConfigurationCommand_base: {
78
78
  * @throws {@link S3ServiceException}
79
79
  * <p>Base exception class for all service exceptions from S3 service.</p>
80
80
  *
81
+ *
81
82
  * @public
82
83
  */
83
84
  export declare class DeleteBucketMetadataTableConfigurationCommand extends DeleteBucketMetadataTableConfigurationCommand_base {
@@ -90,6 +90,7 @@ declare const DeleteBucketMetricsConfigurationCommand_base: {
90
90
  * @throws {@link S3ServiceException}
91
91
  * <p>Base exception class for all service exceptions from S3 service.</p>
92
92
  *
93
+ *
93
94
  * @public
94
95
  */
95
96
  export declare class DeleteBucketMetricsConfigurationCommand extends DeleteBucketMetricsConfigurationCommand_base {
@@ -74,6 +74,7 @@ declare const DeleteBucketOwnershipControlsCommand_base: {
74
74
  * @throws {@link S3ServiceException}
75
75
  * <p>Base exception class for all service exceptions from S3 service.</p>
76
76
  *
77
+ *
77
78
  * @public
78
79
  */
79
80
  export declare class DeleteBucketOwnershipControlsCommand extends DeleteBucketOwnershipControlsCommand_base {
@@ -119,18 +119,21 @@ declare const DeleteBucketPolicyCommand_base: {
119
119
  * @throws {@link S3ServiceException}
120
120
  * <p>Base exception class for all service exceptions from S3 service.</p>
121
121
  *
122
- * @public
122
+ *
123
123
  * @example To delete bucket policy
124
124
  * ```javascript
125
125
  * // The following example deletes bucket policy on the specified bucket.
126
126
  * const input = {
127
- * "Bucket": "examplebucket"
127
+ * Bucket: "examplebucket"
128
128
  * };
129
129
  * const command = new DeleteBucketPolicyCommand(input);
130
- * await client.send(command);
131
- * // example id: to-delete-bucket-policy-1483043406577
130
+ * const response = await client.send(command);
131
+ * /* response is
132
+ * { /* metadata only *\/ }
133
+ * *\/
132
134
  * ```
133
135
  *
136
+ * @public
134
137
  */
135
138
  export declare class DeleteBucketPolicyCommand extends DeleteBucketPolicyCommand_base {
136
139
  /** @internal type navigation helper, not in runtime. */
@@ -80,18 +80,21 @@ declare const DeleteBucketReplicationCommand_base: {
80
80
  * @throws {@link S3ServiceException}
81
81
  * <p>Base exception class for all service exceptions from S3 service.</p>
82
82
  *
83
- * @public
83
+ *
84
84
  * @example To delete bucket replication configuration
85
85
  * ```javascript
86
86
  * // The following example deletes replication configuration set on bucket.
87
87
  * const input = {
88
- * "Bucket": "example"
88
+ * Bucket: "example"
89
89
  * };
90
90
  * const command = new DeleteBucketReplicationCommand(input);
91
- * await client.send(command);
92
- * // example id: to-delete-bucket-replication-configuration-1483043684668
91
+ * const response = await client.send(command);
92
+ * /* response is
93
+ * { /* metadata only *\/ }
94
+ * *\/
93
95
  * ```
94
96
  *
97
+ * @public
95
98
  */
96
99
  export declare class DeleteBucketReplicationCommand extends DeleteBucketReplicationCommand_base {
97
100
  /** @internal type navigation helper, not in runtime. */
@@ -72,18 +72,21 @@ declare const DeleteBucketTaggingCommand_base: {
72
72
  * @throws {@link S3ServiceException}
73
73
  * <p>Base exception class for all service exceptions from S3 service.</p>
74
74
  *
75
- * @public
75
+ *
76
76
  * @example To delete bucket tags
77
77
  * ```javascript
78
78
  * // The following example deletes bucket tags.
79
79
  * const input = {
80
- * "Bucket": "examplebucket"
80
+ * Bucket: "examplebucket"
81
81
  * };
82
82
  * const command = new DeleteBucketTaggingCommand(input);
83
- * await client.send(command);
84
- * // example id: to-delete-bucket-tags-1483043846509
83
+ * const response = await client.send(command);
84
+ * /* response is
85
+ * { /* metadata only *\/ }
86
+ * *\/
85
87
  * ```
86
88
  *
89
+ * @public
87
90
  */
88
91
  export declare class DeleteBucketTaggingCommand extends DeleteBucketTaggingCommand_base {
89
92
  /** @internal type navigation helper, not in runtime. */
@@ -79,18 +79,21 @@ declare const DeleteBucketWebsiteCommand_base: {
79
79
  * @throws {@link S3ServiceException}
80
80
  * <p>Base exception class for all service exceptions from S3 service.</p>
81
81
  *
82
- * @public
82
+ *
83
83
  * @example To delete bucket website configuration
84
84
  * ```javascript
85
85
  * // The following example deletes bucket website configuration.
86
86
  * const input = {
87
- * "Bucket": "examplebucket"
87
+ * Bucket: "examplebucket"
88
88
  * };
89
89
  * const command = new DeleteBucketWebsiteCommand(input);
90
- * await client.send(command);
91
- * // example id: to-delete-bucket-website-configuration-1483043937825
90
+ * const response = await client.send(command);
91
+ * /* response is
92
+ * { /* metadata only *\/ }
93
+ * *\/
92
94
  * ```
93
95
  *
96
+ * @public
94
97
  */
95
98
  export declare class DeleteBucketWebsiteCommand extends DeleteBucketWebsiteCommand_base {
96
99
  /** @internal type navigation helper, not in runtime. */