@aws-sdk/client-s3 3.917.0 → 3.919.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (112) hide show
  1. package/dist-cjs/endpoint/ruleset.js +1 -1
  2. package/dist-cjs/index.js +2 -0
  3. package/dist-es/endpoint/ruleset.js +1 -1
  4. package/dist-es/protocols/Aws_restXml.js +2 -0
  5. package/dist-types/commands/AbortMultipartUploadCommand.d.ts +3 -0
  6. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +3 -0
  7. package/dist-types/commands/CopyObjectCommand.d.ts +10 -8
  8. package/dist-types/commands/CreateBucketCommand.d.ts +6 -13
  9. package/dist-types/commands/CreateBucketMetadataConfigurationCommand.d.ts +3 -0
  10. package/dist-types/commands/CreateBucketMetadataTableConfigurationCommand.d.ts +3 -0
  11. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +6 -6
  12. package/dist-types/commands/CreateSessionCommand.d.ts +3 -0
  13. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +3 -0
  14. package/dist-types/commands/DeleteBucketCommand.d.ts +3 -0
  15. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +3 -0
  16. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +3 -0
  17. package/dist-types/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +3 -0
  18. package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +3 -0
  19. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +3 -0
  20. package/dist-types/commands/DeleteBucketMetadataConfigurationCommand.d.ts +3 -0
  21. package/dist-types/commands/DeleteBucketMetadataTableConfigurationCommand.d.ts +3 -0
  22. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +3 -0
  23. package/dist-types/commands/DeleteBucketOwnershipControlsCommand.d.ts +3 -0
  24. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +3 -0
  25. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +3 -0
  26. package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +3 -0
  27. package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +3 -0
  28. package/dist-types/commands/DeleteObjectCommand.d.ts +6 -0
  29. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +3 -0
  30. package/dist-types/commands/DeleteObjectsCommand.d.ts +3 -0
  31. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +3 -0
  32. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +3 -0
  33. package/dist-types/commands/GetBucketAclCommand.d.ts +4 -1
  34. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +3 -0
  35. package/dist-types/commands/GetBucketCorsCommand.d.ts +3 -0
  36. package/dist-types/commands/GetBucketEncryptionCommand.d.ts +3 -0
  37. package/dist-types/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +3 -0
  38. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +3 -0
  39. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +3 -0
  40. package/dist-types/commands/GetBucketLocationCommand.d.ts +19 -5
  41. package/dist-types/commands/GetBucketLoggingCommand.d.ts +4 -1
  42. package/dist-types/commands/GetBucketMetadataConfigurationCommand.d.ts +3 -0
  43. package/dist-types/commands/GetBucketMetadataTableConfigurationCommand.d.ts +3 -0
  44. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +3 -0
  45. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +3 -0
  46. package/dist-types/commands/GetBucketOwnershipControlsCommand.d.ts +3 -0
  47. package/dist-types/commands/GetBucketPolicyCommand.d.ts +3 -0
  48. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +3 -0
  49. package/dist-types/commands/GetBucketReplicationCommand.d.ts +3 -0
  50. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +3 -0
  51. package/dist-types/commands/GetBucketTaggingCommand.d.ts +3 -0
  52. package/dist-types/commands/GetBucketVersioningCommand.d.ts +3 -0
  53. package/dist-types/commands/GetBucketWebsiteCommand.d.ts +3 -0
  54. package/dist-types/commands/GetObjectAclCommand.d.ts +11 -1
  55. package/dist-types/commands/GetObjectAttributesCommand.d.ts +3 -0
  56. package/dist-types/commands/GetObjectCommand.d.ts +3 -0
  57. package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +3 -0
  58. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +3 -0
  59. package/dist-types/commands/GetObjectRetentionCommand.d.ts +3 -0
  60. package/dist-types/commands/GetObjectTaggingCommand.d.ts +3 -0
  61. package/dist-types/commands/GetObjectTorrentCommand.d.ts +3 -0
  62. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +3 -0
  63. package/dist-types/commands/HeadBucketCommand.d.ts +12 -6
  64. package/dist-types/commands/HeadObjectCommand.d.ts +3 -0
  65. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +3 -0
  66. package/dist-types/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +3 -0
  67. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +4 -1
  68. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +3 -0
  69. package/dist-types/commands/ListBucketsCommand.d.ts +4 -1
  70. package/dist-types/commands/ListDirectoryBucketsCommand.d.ts +3 -0
  71. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +4 -1
  72. package/dist-types/commands/ListObjectVersionsCommand.d.ts +4 -1
  73. package/dist-types/commands/ListObjectsCommand.d.ts +4 -1
  74. package/dist-types/commands/ListObjectsV2Command.d.ts +11 -1
  75. package/dist-types/commands/ListPartsCommand.d.ts +4 -1
  76. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +3 -0
  77. package/dist-types/commands/PutBucketAclCommand.d.ts +6 -6
  78. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +3 -0
  79. package/dist-types/commands/PutBucketCorsCommand.d.ts +3 -0
  80. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +3 -0
  81. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +3 -0
  82. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +3 -0
  83. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +3 -0
  84. package/dist-types/commands/PutBucketLoggingCommand.d.ts +6 -6
  85. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +3 -0
  86. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +3 -0
  87. package/dist-types/commands/PutBucketOwnershipControlsCommand.d.ts +3 -0
  88. package/dist-types/commands/PutBucketPolicyCommand.d.ts +3 -0
  89. package/dist-types/commands/PutBucketReplicationCommand.d.ts +3 -0
  90. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +3 -0
  91. package/dist-types/commands/PutBucketTaggingCommand.d.ts +3 -0
  92. package/dist-types/commands/PutBucketVersioningCommand.d.ts +3 -0
  93. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +3 -0
  94. package/dist-types/commands/PutObjectAclCommand.d.ts +9 -1
  95. package/dist-types/commands/PutObjectCommand.d.ts +6 -6
  96. package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +3 -0
  97. package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +3 -0
  98. package/dist-types/commands/PutObjectRetentionCommand.d.ts +3 -0
  99. package/dist-types/commands/PutObjectTaggingCommand.d.ts +3 -0
  100. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +3 -0
  101. package/dist-types/commands/RenameObjectCommand.d.ts +3 -0
  102. package/dist-types/commands/RestoreObjectCommand.d.ts +3 -0
  103. package/dist-types/commands/SelectObjectContentCommand.d.ts +3 -0
  104. package/dist-types/commands/UpdateBucketMetadataInventoryTableConfigurationCommand.d.ts +3 -0
  105. package/dist-types/commands/UpdateBucketMetadataJournalTableConfigurationCommand.d.ts +3 -0
  106. package/dist-types/commands/UploadPartCommand.d.ts +3 -0
  107. package/dist-types/commands/UploadPartCopyCommand.d.ts +3 -0
  108. package/dist-types/commands/WriteGetObjectResponseCommand.d.ts +3 -0
  109. package/dist-types/models/models_0.d.ts +57 -27
  110. package/dist-types/models/models_1.d.ts +10 -17
  111. package/dist-types/ts3.4/models/models_0.d.ts +2 -0
  112. package/package.json +4 -4
@@ -141,6 +141,12 @@ declare const DeleteObjectCommand_base: {
141
141
  * </p>
142
142
  * </li>
143
143
  * </ul>
144
+ * <important>
145
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
146
+ * </important>
147
+ * <note>
148
+ * <p>The <code>If-Match</code> header is supported for both general purpose and directory buckets. <code>IfMatchLastModifiedTime</code> and <code>IfMatchSize</code> is only supported for directory buckets. </p>
149
+ * </note>
144
150
  * @example
145
151
  * Use a bare-bones client and the command you need to make an API call.
146
152
  * ```javascript
@@ -50,6 +50,9 @@ declare const DeleteObjectTaggingCommand_base: {
50
50
  * </p>
51
51
  * </li>
52
52
  * </ul>
53
+ * <important>
54
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
55
+ * </important>
53
56
  * @example
54
57
  * Use a bare-bones client and the command you need to make an API call.
55
58
  * ```javascript
@@ -157,6 +157,9 @@ declare const DeleteObjectsCommand_base: {
157
157
  * </p>
158
158
  * </li>
159
159
  * </ul>
160
+ * <important>
161
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
162
+ * </important>
160
163
  * @example
161
164
  * Use a bare-bones client and the command you need to make an API call.
162
165
  * ```javascript
@@ -58,6 +58,9 @@ declare const DeletePublicAccessBlockCommand_base: {
58
58
  * </p>
59
59
  * </li>
60
60
  * </ul>
61
+ * <important>
62
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
63
+ * </important>
61
64
  * @example
62
65
  * Use a bare-bones client and the command you need to make an API call.
63
66
  * ```javascript
@@ -53,6 +53,9 @@ declare const GetBucketAccelerateConfigurationCommand_base: {
53
53
  * </p>
54
54
  * </li>
55
55
  * </ul>
56
+ * <important>
57
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
58
+ * </important>
56
59
  * @example
57
60
  * Use a bare-bones client and the command you need to make an API call.
58
61
  * ```javascript
@@ -28,7 +28,7 @@ declare const GetBucketAclCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <important>
31
- * <p>End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
31
+ * <p>End of support notice: Beginning November 21, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
32
32
  * Amazon Web Services accounts), Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of <code>DisplayName</code>.
33
33
  * </p>
34
34
  * <p>This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N. California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
@@ -53,6 +53,9 @@ declare const GetBucketAclCommand_base: {
53
53
  * being the account that created the bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html"> Controlling object ownership and
54
54
  * disabling ACLs</a> in the <i>Amazon S3 User Guide</i>.</p>
55
55
  * </note>
56
+ * <important>
57
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
58
+ * </important>
56
59
  * <p>The following operations are related to <code>GetBucketAcl</code>:</p>
57
60
  * <ul>
58
61
  * <li>
@@ -56,6 +56,9 @@ declare const GetBucketAnalyticsConfigurationCommand_base: {
56
56
  * </p>
57
57
  * </li>
58
58
  * </ul>
59
+ * <important>
60
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
61
+ * </important>
59
62
  * @example
60
63
  * Use a bare-bones client and the command you need to make an API call.
61
64
  * ```javascript
@@ -53,6 +53,9 @@ declare const GetBucketCorsCommand_base: {
53
53
  * </p>
54
54
  * </li>
55
55
  * </ul>
56
+ * <important>
57
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
58
+ * </important>
56
59
  * @example
57
60
  * Use a bare-bones client and the command you need to make an API call.
58
61
  * ```javascript
@@ -86,6 +86,9 @@ declare const GetBucketEncryptionCommand_base: {
86
86
  * </p>
87
87
  * </li>
88
88
  * </ul>
89
+ * <important>
90
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
91
+ * </important>
89
92
  * @example
90
93
  * Use a bare-bones client and the command you need to make an API call.
91
94
  * ```javascript
@@ -52,6 +52,9 @@ declare const GetBucketIntelligentTieringConfigurationCommand_base: {
52
52
  * </p>
53
53
  * </li>
54
54
  * </ul>
55
+ * <important>
56
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
57
+ * </important>
55
58
  * @example
56
59
  * Use a bare-bones client and the command you need to make an API call.
57
60
  * ```javascript
@@ -55,6 +55,9 @@ declare const GetBucketInventoryConfigurationCommand_base: {
55
55
  * </p>
56
56
  * </li>
57
57
  * </ul>
58
+ * <important>
59
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
60
+ * </important>
58
61
  * @example
59
62
  * Use a bare-bones client and the command you need to make an API call.
60
63
  * ```javascript
@@ -120,6 +120,9 @@ declare const GetBucketLifecycleConfigurationCommand_base: {
120
120
  * </p>
121
121
  * </li>
122
122
  * </ul>
123
+ * <important>
124
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
125
+ * </important>
123
126
  * @example
124
127
  * Use a bare-bones client and the command you need to make an API call.
125
128
  * ```javascript
@@ -27,20 +27,31 @@ declare const GetBucketLocationCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note>
31
- * <p>This operation is not supported for directory buckets.</p>
32
- * </note>
30
+ * <important>
31
+ * <p>Using the <code>GetBucketLocation</code> operation is no longer a best practice. To return the
32
+ * Region that a bucket resides in, we recommend that you use the
33
+ * <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html">HeadBucket</a>
34
+ * operation instead. For backward compatibility, Amazon S3 continues to support the
35
+ * <code>GetBucketLocation</code> operation.</p>
36
+ * </important>
33
37
  * <p>Returns the Region the bucket resides in. You set the bucket's Region using the
34
38
  * <code>LocationConstraint</code> request parameter in a <code>CreateBucket</code> request. For more
35
39
  * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>.</p>
40
+ * <note>
41
+ * <p>In a bucket's home Region, calls to the <code>GetBucketLocation</code> operation are governed
42
+ * by the bucket's policy. In other Regions, the bucket policy doesn't apply, which means that
43
+ * cross-account access won't be authorized. However, calls to the <code>HeadBucket</code> operation
44
+ * always return the bucket’s location through an HTTP response header, whether access to the bucket
45
+ * is authorized or not. Therefore, we recommend using the <code>HeadBucket</code> operation for
46
+ * bucket Region discovery and to avoid using the <code>GetBucketLocation</code> operation.</p>
47
+ * </note>
36
48
  * <p>When you use this API operation with an access point, provide the alias of the access point in place of the bucket name.</p>
37
49
  * <p>When you use this API operation with an Object Lambda access point, provide the alias of the Object Lambda access point in place of the bucket name.
38
50
  * If the Object Lambda access point alias in a request is not valid, the error code <code>InvalidAccessPointAliasError</code> is returned.
39
51
  * For more information about <code>InvalidAccessPointAliasError</code>, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ErrorCodeList">List of
40
52
  * Error Codes</a>.</p>
41
53
  * <note>
42
- * <p>We recommend that you use <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_HeadBucket.html">HeadBucket</a> to return the Region that a bucket
43
- * resides in. For backward compatibility, Amazon S3 continues to support GetBucketLocation.</p>
54
+ * <p>This operation is not supported for directory buckets.</p>
44
55
  * </note>
45
56
  * <p>The following operations are related to <code>GetBucketLocation</code>:</p>
46
57
  * <ul>
@@ -55,6 +66,9 @@ declare const GetBucketLocationCommand_base: {
55
66
  * </p>
56
67
  * </li>
57
68
  * </ul>
69
+ * <important>
70
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
71
+ * </important>
58
72
  * @example
59
73
  * Use a bare-bones client and the command you need to make an API call.
60
74
  * ```javascript
@@ -28,7 +28,7 @@ declare const GetBucketLoggingCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <important>
31
- * <p>End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
31
+ * <p>End of support notice: Beginning November 21, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
32
32
  * Amazon Web Services accounts), Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of <code>DisplayName</code>.
33
33
  * </p>
34
34
  * <p>This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N. California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
@@ -52,6 +52,9 @@ declare const GetBucketLoggingCommand_base: {
52
52
  * </p>
53
53
  * </li>
54
54
  * </ul>
55
+ * <important>
56
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
57
+ * </important>
55
58
  * @example
56
59
  * Use a bare-bones client and the command you need to make an API call.
57
60
  * ```javascript
@@ -70,6 +70,9 @@ declare const GetBucketMetadataConfigurationCommand_base: {
70
70
  * </p>
71
71
  * </li>
72
72
  * </ul>
73
+ * <important>
74
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
75
+ * </important>
73
76
  * @example
74
77
  * Use a bare-bones client and the command you need to make an API call.
75
78
  * ```javascript
@@ -70,6 +70,9 @@ declare const GetBucketMetadataTableConfigurationCommand_base: {
70
70
  * </p>
71
71
  * </li>
72
72
  * </ul>
73
+ * <important>
74
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
75
+ * </important>
73
76
  * @example
74
77
  * Use a bare-bones client and the command you need to make an API call.
75
78
  * ```javascript
@@ -62,6 +62,9 @@ declare const GetBucketMetricsConfigurationCommand_base: {
62
62
  * </p>
63
63
  * </li>
64
64
  * </ul>
65
+ * <important>
66
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
67
+ * </important>
65
68
  * @example
66
69
  * Use a bare-bones client and the command you need to make an API call.
67
70
  * ```javascript
@@ -52,6 +52,9 @@ declare const GetBucketNotificationConfigurationCommand_base: {
52
52
  * </p>
53
53
  * </li>
54
54
  * </ul>
55
+ * <important>
56
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
57
+ * </important>
55
58
  * @example
56
59
  * Use a bare-bones client and the command you need to make an API call.
57
60
  * ```javascript
@@ -62,6 +62,9 @@ declare const GetBucketOwnershipControlsCommand_base: {
62
62
  * </p>
63
63
  * </li>
64
64
  * </ul>
65
+ * <important>
66
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
67
+ * </important>
65
68
  * @example
66
69
  * Use a bare-bones client and the command you need to make an API call.
67
70
  * ```javascript
@@ -94,6 +94,9 @@ declare const GetBucketPolicyCommand_base: {
94
94
  * </p>
95
95
  * </li>
96
96
  * </ul>
97
+ * <important>
98
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
99
+ * </important>
97
100
  * @example
98
101
  * Use a bare-bones client and the command you need to make an API call.
99
102
  * ```javascript
@@ -58,6 +58,9 @@ declare const GetBucketPolicyStatusCommand_base: {
58
58
  * </p>
59
59
  * </li>
60
60
  * </ul>
61
+ * <important>
62
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
63
+ * </important>
61
64
  * @example
62
65
  * Use a bare-bones client and the command you need to make an API call.
63
66
  * ```javascript
@@ -59,6 +59,9 @@ declare const GetBucketReplicationCommand_base: {
59
59
  * </p>
60
60
  * </li>
61
61
  * </ul>
62
+ * <important>
63
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
64
+ * </important>
62
65
  * @example
63
66
  * Use a bare-bones client and the command you need to make an API call.
64
67
  * ```javascript
@@ -40,6 +40,9 @@ declare const GetBucketRequestPaymentCommand_base: {
40
40
  * </p>
41
41
  * </li>
42
42
  * </ul>
43
+ * <important>
44
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
45
+ * </important>
43
46
  * @example
44
47
  * Use a bare-bones client and the command you need to make an API call.
45
48
  * ```javascript
@@ -59,6 +59,9 @@ declare const GetBucketTaggingCommand_base: {
59
59
  * </p>
60
60
  * </li>
61
61
  * </ul>
62
+ * <important>
63
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
64
+ * </important>
62
65
  * @example
63
66
  * Use a bare-bones client and the command you need to make an API call.
64
67
  * ```javascript
@@ -53,6 +53,9 @@ declare const GetBucketVersioningCommand_base: {
53
53
  * </p>
54
54
  * </li>
55
55
  * </ul>
56
+ * <important>
57
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
58
+ * </important>
56
59
  * @example
57
60
  * Use a bare-bones client and the command you need to make an API call.
58
61
  * ```javascript
@@ -49,6 +49,9 @@ declare const GetBucketWebsiteCommand_base: {
49
49
  * </p>
50
50
  * </li>
51
51
  * </ul>
52
+ * <important>
53
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
54
+ * </important>
52
55
  * @example
53
56
  * Use a bare-bones client and the command you need to make an API call.
54
57
  * ```javascript
@@ -27,7 +27,14 @@ declare const GetObjectAclCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <note>
30
+ * <important>
31
+ * <p>End of support notice: Beginning November 21, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
32
+ * Amazon Web Services accounts), Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of <code>DisplayName</code>.
33
+ * </p>
34
+ * <p>This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N. California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
35
+ * Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South America (São Paulo) Region.</p>
36
+ * </important>
37
+ * <note>
31
38
  * <p>This operation is not supported for directory buckets.</p>
32
39
  * </note>
33
40
  * <p>Returns the access control list (ACL) of an object. To use this operation, you must have
@@ -67,6 +74,9 @@ declare const GetObjectAclCommand_base: {
67
74
  * </p>
68
75
  * </li>
69
76
  * </ul>
77
+ * <important>
78
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
79
+ * </important>
70
80
  * @example
71
81
  * Use a bare-bones client and the command you need to make an API call.
72
82
  * ```javascript
@@ -232,6 +232,9 @@ declare const GetObjectAttributesCommand_base: {
232
232
  * </p>
233
233
  * </li>
234
234
  * </ul>
235
+ * <important>
236
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
237
+ * </important>
235
238
  * @example
236
239
  * Use a bare-bones client and the command you need to make an API call.
237
240
  * ```javascript
@@ -190,6 +190,9 @@ declare const GetObjectCommand_base: {
190
190
  * </p>
191
191
  * </li>
192
192
  * </ul>
193
+ * <important>
194
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
195
+ * </important>
193
196
  * @example
194
197
  * Use a bare-bones client and the command you need to make an API call.
195
198
  * ```javascript
@@ -40,6 +40,9 @@ declare const GetObjectLegalHoldCommand_base: {
40
40
  * </p>
41
41
  * </li>
42
42
  * </ul>
43
+ * <important>
44
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
45
+ * </important>
43
46
  * @example
44
47
  * Use a bare-bones client and the command you need to make an API call.
45
48
  * ```javascript
@@ -41,6 +41,9 @@ declare const GetObjectLockConfigurationCommand_base: {
41
41
  * </p>
42
42
  * </li>
43
43
  * </ul>
44
+ * <important>
45
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
46
+ * </important>
44
47
  * @example
45
48
  * Use a bare-bones client and the command you need to make an API call.
46
49
  * ```javascript
@@ -40,6 +40,9 @@ declare const GetObjectRetentionCommand_base: {
40
40
  * </p>
41
41
  * </li>
42
42
  * </ul>
43
+ * <important>
44
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
45
+ * </important>
43
46
  * @example
44
47
  * Use a bare-bones client and the command you need to make an API call.
45
48
  * ```javascript
@@ -57,6 +57,9 @@ declare const GetObjectTaggingCommand_base: {
57
57
  * </p>
58
58
  * </li>
59
59
  * </ul>
60
+ * <important>
61
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
62
+ * </important>
60
63
  * @example
61
64
  * Use a bare-bones client and the command you need to make an API call.
62
65
  * ```javascript
@@ -47,6 +47,9 @@ declare const GetObjectTorrentCommand_base: {
47
47
  * </p>
48
48
  * </li>
49
49
  * </ul>
50
+ * <important>
51
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
52
+ * </important>
50
53
  * @example
51
54
  * Use a bare-bones client and the command you need to make an API call.
52
55
  * ```javascript
@@ -65,6 +65,9 @@ declare const GetPublicAccessBlockCommand_base: {
65
65
  * </p>
66
66
  * </li>
67
67
  * </ul>
68
+ * <important>
69
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
70
+ * </important>
68
71
  * @example
69
72
  * Use a bare-bones client and the command you need to make an API call.
70
73
  * ```javascript
@@ -28,13 +28,16 @@ declare const HeadBucketCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <p>You can use this operation to determine if a bucket exists and if you have permission to access it.
31
- * The action returns a <code>200 OK</code> if the bucket exists and you have permission to access
32
- * it.</p>
31
+ * The action returns a <code>200 OK</code> HTTP status code if the bucket exists and you have
32
+ * permission to access it. You can make a <code>HeadBucket</code> call on any bucket name to any
33
+ * Region in the partition, and regardless of the permissions on the bucket, you will receive a
34
+ * response header with the correct bucket location so that you can then make a proper, signed request
35
+ * to the appropriate Regional endpoint.</p>
33
36
  * <note>
34
- * <p>If the bucket does not exist or you do not have permission to access it, the <code>HEAD</code>
35
- * request returns a generic <code>400 Bad Request</code>, <code>403 Forbidden</code> or <code>404 Not
36
- * Found</code> code. A message body is not included, so you cannot determine the exception beyond
37
- * these HTTP response codes.</p>
37
+ * <p>If the bucket doesn't exist or you don't have permission to access it, the <code>HEAD</code>
38
+ * request returns a generic <code>400 Bad Request</code>, <code>403 Forbidden</code>, or
39
+ * <code>404 Not Found</code> HTTP status code. A message body isn't included, so you can't determine
40
+ * the exception beyond these HTTP response codes.</p>
38
41
  * </note>
39
42
  * <dl>
40
43
  * <dt>Authentication and authorization</dt>
@@ -94,6 +97,9 @@ declare const HeadBucketCommand_base: {
94
97
  * </note>
95
98
  * </dd>
96
99
  * </dl>
100
+ * <important>
101
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
102
+ * </important>
97
103
  * @example
98
104
  * Use a bare-bones client and the command you need to make an API call.
99
105
  * ```javascript
@@ -178,6 +178,9 @@ declare const HeadObjectCommand_base: {
178
178
  * </p>
179
179
  * </li>
180
180
  * </ul>
181
+ * <important>
182
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
183
+ * </important>
181
184
  * @example
182
185
  * Use a bare-bones client and the command you need to make an API call.
183
186
  * ```javascript
@@ -63,6 +63,9 @@ declare const ListBucketAnalyticsConfigurationsCommand_base: {
63
63
  * </p>
64
64
  * </li>
65
65
  * </ul>
66
+ * <important>
67
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
68
+ * </important>
66
69
  * @example
67
70
  * Use a bare-bones client and the command you need to make an API call.
68
71
  * ```javascript
@@ -52,6 +52,9 @@ declare const ListBucketIntelligentTieringConfigurationsCommand_base: {
52
52
  * </p>
53
53
  * </li>
54
54
  * </ul>
55
+ * <important>
56
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
57
+ * </important>
55
58
  * @example
56
59
  * Use a bare-bones client and the command you need to make an API call.
57
60
  * ```javascript
@@ -30,7 +30,7 @@ declare const ListBucketInventoryConfigurationsCommand_base: {
30
30
  * <note>
31
31
  * <p>This operation is not supported for directory buckets.</p>
32
32
  * </note>
33
- * <p>Returns a list of S3 Inventory configurations for the bucket. You can have up to 1,000 analytics
33
+ * <p>Returns a list of S3 Inventory configurations for the bucket. You can have up to 1,000 inventory
34
34
  * configurations per bucket.</p>
35
35
  * <p>This action supports list pagination and does not return more than 100 configurations at a time.
36
36
  * Always check the <code>IsTruncated</code> element in the response. If there are no more configurations
@@ -62,6 +62,9 @@ declare const ListBucketInventoryConfigurationsCommand_base: {
62
62
  * </p>
63
63
  * </li>
64
64
  * </ul>
65
+ * <important>
66
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
67
+ * </important>
65
68
  * @example
66
69
  * Use a bare-bones client and the command you need to make an API call.
67
70
  * ```javascript
@@ -63,6 +63,9 @@ declare const ListBucketMetricsConfigurationsCommand_base: {
63
63
  * </p>
64
64
  * </li>
65
65
  * </ul>
66
+ * <important>
67
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
68
+ * </important>
66
69
  * @example
67
70
  * Use a bare-bones client and the command you need to make an API call.
68
71
  * ```javascript
@@ -28,7 +28,7 @@ declare const ListBucketsCommand_base: {
28
28
  };
29
29
  /**
30
30
  * <important>
31
- * <p>End of support notice: Beginning October 1, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
31
+ * <p>End of support notice: Beginning November 21, 2025, Amazon S3 will stop returning <code>DisplayName</code>. Update your applications to use canonical IDs (unique identifier for
32
32
  * Amazon Web Services accounts), Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full resource naming) as a direct replacement of <code>DisplayName</code>.
33
33
  * </p>
34
34
  * <p>This change affects the following Amazon Web Services Regions: US East (N. Virginia) Region, US West (N. California) Region, US West (Oregon) Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
@@ -49,6 +49,9 @@ declare const ListBucketsCommand_base: {
49
49
  * <code>ListBuckets</code> requests will be rejected for Amazon Web Services accounts with a general purpose bucket
50
50
  * quota greater than 10,000. </p>
51
51
  * </important>
52
+ * <important>
53
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
54
+ * </important>
52
55
  * @example
53
56
  * Use a bare-bones client and the command you need to make an API call.
54
57
  * ```javascript
@@ -56,6 +56,9 @@ declare const ListDirectoryBucketsCommand_base: {
56
56
  * <p> The <code>BucketRegion</code> response element is not part of the
57
57
  * <code>ListDirectoryBuckets</code> Response Syntax.</p>
58
58
  * </note>
59
+ * <important>
60
+ * <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
61
+ * </important>
59
62
  * @example
60
63
  * Use a bare-bones client and the command you need to make an API call.
61
64
  * ```javascript