@aws-sdk/client-s3 3.670.0 → 3.673.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.
package/dist-cjs/index.js CHANGED
@@ -2129,7 +2129,9 @@ var se_ListBucketsCommand = /* @__PURE__ */ __name(async (input, context) => {
2129
2129
  const query = (0, import_smithy_client.map)({
2130
2130
  [_xi]: [, "ListBuckets"],
2131
2131
  [_mb]: [() => input.MaxBuckets !== void 0, () => input[_MB].toString()],
2132
- [_ct_]: [, input[_CTo]]
2132
+ [_ct_]: [, input[_CTo]],
2133
+ [_pr]: [, input[_P]],
2134
+ [_br]: [, input[_BR]]
2133
2135
  });
2134
2136
  let body;
2135
2137
  b.m("GET").h(headers).q(query).b(body);
@@ -4076,6 +4078,9 @@ var de_ListBucketsCommand = /* @__PURE__ */ __name(async (output, context) => {
4076
4078
  if (data[_O] != null) {
4077
4079
  contents[_O] = de_Owner(data[_O], context);
4078
4080
  }
4081
+ if (data[_P] != null) {
4082
+ contents[_P] = (0, import_smithy_client.expectString)(data[_P]);
4083
+ }
4079
4084
  return contents;
4080
4085
  }, "de_ListBucketsCommand");
4081
4086
  var de_ListDirectoryBucketsCommand = /* @__PURE__ */ __name(async (output, context) => {
@@ -6264,6 +6269,9 @@ var de_Bucket = /* @__PURE__ */ __name((output, context) => {
6264
6269
  if (output[_CDr] != null) {
6265
6270
  contents[_CDr] = (0, import_smithy_client.expectNonNull)((0, import_smithy_client.parseRfc3339DateTimeWithOffset)(output[_CDr]));
6266
6271
  }
6272
+ if (output[_BR] != null) {
6273
+ contents[_BR] = (0, import_smithy_client.expectString)(output[_BR]);
6274
+ }
6267
6275
  return contents;
6268
6276
  }, "de_Bucket");
6269
6277
  var de_Buckets = /* @__PURE__ */ __name((output, context) => {
@@ -8138,6 +8146,7 @@ var _ac = "accelerate";
8138
8146
  var _acl = "acl";
8139
8147
  var _ar = "accept-ranges";
8140
8148
  var _at = "attributes";
8149
+ var _br = "bucket-region";
8141
8150
  var _c = "cors";
8142
8151
  var _cc = "cache-control";
8143
8152
  var _cd = "content-disposition";
@@ -1027,6 +1027,8 @@ export const se_ListBucketsCommand = async (input, context) => {
1027
1027
  [_xi]: [, "ListBuckets"],
1028
1028
  [_mb]: [() => input.MaxBuckets !== void 0, () => input[_MB].toString()],
1029
1029
  [_ct_]: [, input[_CTo]],
1030
+ [_pr]: [, input[_P]],
1031
+ [_br]: [, input[_BR]],
1030
1032
  });
1031
1033
  let body;
1032
1034
  b.m("GET").h(headers).q(query).b(body);
@@ -2996,6 +2998,9 @@ export const de_ListBucketsCommand = async (output, context) => {
2996
2998
  if (data[_O] != null) {
2997
2999
  contents[_O] = de_Owner(data[_O], context);
2998
3000
  }
3001
+ if (data[_P] != null) {
3002
+ contents[_P] = __expectString(data[_P]);
3003
+ }
2999
3004
  return contents;
3000
3005
  };
3001
3006
  export const de_ListDirectoryBucketsCommand = async (output, context) => {
@@ -5245,6 +5250,9 @@ const de_Bucket = (output, context) => {
5245
5250
  if (output[_CDr] != null) {
5246
5251
  contents[_CDr] = __expectNonNull(__parseRfc3339DateTimeWithOffset(output[_CDr]));
5247
5252
  }
5253
+ if (output[_BR] != null) {
5254
+ contents[_BR] = __expectString(output[_BR]);
5255
+ }
5248
5256
  return contents;
5249
5257
  };
5250
5258
  const de_Buckets = (output, context) => {
@@ -7209,6 +7217,7 @@ const _ac = "accelerate";
7209
7217
  const _acl = "acl";
7210
7218
  const _ar = "accept-ranges";
7211
7219
  const _at = "attributes";
7220
+ const _br = "bucket-region";
7212
7221
  const _c = "cors";
7213
7222
  const _cc = "cache-control";
7214
7223
  const _cd = "content-disposition";
@@ -96,7 +96,7 @@ declare const CreateSessionCommand_base: {
96
96
  * To encrypt new objects in a directory bucket with SSE-KMS, you must specify SSE-KMS as the directory bucket's default encryption configuration with a KMS key (specifically, a <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a>). Then, when a session is created for Zonal endpoint API operations, new objects are automatically encrypted and decrypted with SSE-KMS and S3 Bucket Keys during the session.</p>
97
97
  * <note>
98
98
  * <p>
99
- * Only 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> is supported per directory bucket for the lifetime of the bucket. <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
99
+ * Only 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> is supported per directory bucket for the lifetime of the bucket. The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
100
100
  * After you specify SSE-KMS as your bucket's default encryption configuration with a customer managed key, you can't change the customer managed key for the bucket's SSE-KMS configuration.
101
101
  * </p>
102
102
  * </note>
@@ -27,87 +27,78 @@ declare const DeleteObjectCommand_base: {
27
27
  getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
28
28
  };
29
29
  /**
30
- * <p>Removes an object from a bucket. The behavior depends on the bucket's versioning state: </p>
31
- * <ul>
32
- * <li>
33
- * <p>If bucket versioning is not enabled, the operation permanently deletes the object.</p>
34
- * </li>
35
- * <li>
36
- * <p>If bucket versioning is enabled, the operation inserts a delete marker, which becomes the current version of the object. To permanently delete an object in a versioned bucket, you must include the object’s <code>versionId</code> in the request. For more information about versioning-enabled buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectVersions.html">Deleting object versions from a versioning-enabled bucket</a>.</p>
37
- * </li>
38
- * <li>
39
- * <p>If bucket versioning is suspended, the operation removes the object that has a null <code>versionId</code>, if there is one, and inserts a delete marker that becomes the current version of the object. If there isn't an object with a null <code>versionId</code>, and all versions of the object have a <code>versionId</code>, Amazon S3 does not remove the object and only inserts a delete marker. To permanently delete an object that has a <code>versionId</code>, you must include the object’s <code>versionId</code> in the request. For more information about versioning-suspended buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjectsfromVersioningSuspendedBuckets.html">Deleting objects from versioning-suspended buckets</a>.</p>
40
- * </li>
41
- * </ul>
30
+ * <p>Removes an object from a bucket. The behavior depends on the bucket's versioning state.
31
+ * For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/DeletingObjects.html#DeletingObjects-best-practices">Best
32
+ * practices to consider before deleting an object</a>.</p>
33
+ * <p>To remove a specific version, you must use the <code>versionId</code> query parameter.
34
+ * Using this query parameter permanently deletes the version. If the object deleted is a
35
+ * delete marker, Amazon S3 sets the response header <code>x-amz-delete-marker</code> to true. If
36
+ * the object you want to delete is in a bucket where the bucket versioning configuration is
37
+ * MFA delete enabled, you must include the <code>x-amz-mfa</code> request header in the
38
+ * DELETE <code>versionId</code> request. Requests that include <code>x-amz-mfa</code> must
39
+ * use HTTPS. For more information about MFA delete and to see example requests, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html">Using MFA
40
+ * delete</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete">Sample
41
+ * request</a> in the <i>Amazon S3 User Guide</i>.</p>
42
42
  * <note>
43
43
  * <ul>
44
44
  * <li>
45
- * <p>
46
- * <b>Directory buckets</b> - S3 Versioning isn't enabled and supported for directory buckets. For this API operation, only the <code>null</code> value of the version ID is supported by directory buckets. You can only specify <code>null</code>
47
- * to the <code>versionId</code> query parameter in the request.</p>
45
+ * <p>S3 Versioning isn't enabled and supported for directory buckets. For this API operation, only the <code>null</code> value of the version ID is supported by directory buckets. You can only specify <code>null</code> to the
46
+ * <code>versionId</code> query parameter in the request.</p>
48
47
  * </li>
49
48
  * <li>
50
- * <p>
51
- * <b>Directory buckets</b> - For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
49
+ * <p>For directory buckets, you must make requests for this API operation to the Zonal endpoint. These endpoints support virtual-hosted-style requests in the format <code>https://<i>bucket_name</i>.s3express-<i>az_id</i>.<i>region</i>.amazonaws.com/<i>key-name</i>
52
50
  * </code>. Path-style requests are not supported. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-Regions-and-Zones.html">Regional and Zonal endpoints</a> in the
53
51
  * <i>Amazon S3 User Guide</i>.</p>
54
52
  * </li>
53
+ * <li>
54
+ * <p>MFA delete is not supported by directory buckets.</p>
55
+ * </li>
55
56
  * </ul>
56
57
  * </note>
57
- * <p>To remove a specific version, you must use the <code>versionId</code> query parameter. Using this
58
- * query parameter permanently deletes the version. If the object deleted is a delete marker, Amazon S3
59
- * sets the response header <code>x-amz-delete-marker</code> to true. </p>
60
- * <p>If the object you want to delete is in a bucket where the bucket versioning
61
- * configuration is MFA Delete enabled, you must include the <code>x-amz-mfa</code> request
62
- * header in the DELETE <code>versionId</code> request. Requests that include
63
- * <code>x-amz-mfa</code> must use HTTPS. For more information about MFA Delete, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMFADelete.html">Using MFA Delete</a> in the <i>Amazon S3
64
- * User Guide</i>. To see sample
65
- * requests that use versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectDELETE.html#ExampleVersionObjectDelete">Sample
66
- * Request</a>. </p>
67
- * <note>
68
- * <p>
69
- * <b>Directory buckets</b> - MFA delete is not supported by directory buckets.</p>
70
- * </note>
71
- * <p>You can delete objects by explicitly calling DELETE Object or calling
72
- * (<a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>) to enable Amazon S3 to remove them for you. If you want to block
73
- * users or accounts from removing or deleting objects from your bucket, you must deny them
74
- * the <code>s3:DeleteObject</code>, <code>s3:DeleteObjectVersion</code>, and
75
- * <code>s3:PutLifeCycleConfiguration</code> actions. </p>
76
- * <note>
77
- * <p>
78
- * <b>Directory buckets</b> - S3 Lifecycle is not supported by directory buckets.</p>
79
- * </note>
80
58
  * <dl>
81
59
  * <dt>Permissions</dt>
82
60
  * <dd>
83
61
  * <ul>
84
62
  * <li>
85
63
  * <p>
86
- * <b>General purpose bucket permissions</b> - The following permissions are required in your policies when your
87
- * <code>DeleteObjects</code> request includes specific headers.</p>
64
+ * <b>General purpose bucket permissions</b> - The
65
+ * following permissions are required in your policies when your
66
+ * <code>DeleteObjects</code> request includes specific headers.</p>
88
67
  * <ul>
89
68
  * <li>
90
69
  * <p>
91
70
  * <b>
92
71
  * <code>s3:DeleteObject</code>
93
- * </b> - To delete an object from a bucket, you must always have the <code>s3:DeleteObject</code> permission.</p>
72
+ * </b>
73
+ * - To delete an object from a bucket, you must always have the
74
+ * <code>s3:DeleteObject</code> permission.</p>
75
+ * <note>
76
+ * <p>You can also use <a>PutBucketLifecycle</a> to delete
77
+ * objects in Amazon S3.</p>
78
+ * </note>
94
79
  * </li>
95
80
  * <li>
96
81
  * <p>
97
82
  * <b>
98
83
  * <code>s3:DeleteObjectVersion</code>
99
- * </b> - To delete a specific version of an object from a versioning-enabled bucket, you must have the <code>s3:DeleteObjectVersion</code> permission.</p>
84
+ * </b> - To delete a specific version of an object from a
85
+ * versioning-enabled bucket, you must have the
86
+ * <code>s3:DeleteObjectVersion</code> permission.</p>
87
+ * </li>
88
+ * <li>
89
+ * <p>If you want to block users or accounts from removing or deleting
90
+ * objects from your bucket, you must deny them the
91
+ * <code>s3:DeleteObject</code>, <code>s3:DeleteObjectVersion</code>,
92
+ * and <code>s3:PutLifeCycleConfiguration</code> permissions.</p>
100
93
  * </li>
101
94
  * </ul>
102
95
  * </li>
103
96
  * <li>
104
97
  * <p>
105
- * <b>Directory bucket permissions</b> - To grant access to this API operation on a directory bucket, we recommend that you use the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
106
- * <code>CreateSession</code>
107
- * </a> API operation for session-based authorization. Specifically, you grant the <code>s3express:CreateSession</code> permission to the directory bucket in a bucket policy or an IAM identity-based policy. Then, you make the <code>CreateSession</code> API call on the bucket to obtain a session token. With the session token in your request header, you can make API requests to this operation. After the session token expires, you make another <code>CreateSession</code> API call to generate a new session token for use.
108
- * Amazon Web Services CLI or SDKs create session and refresh the session token automatically to avoid service interruptions when a session expires. For more information about authorization, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateSession.html">
109
- * <code>CreateSession</code>
110
- * </a>.</p>
98
+ * <b>Directory buckets permissions</b> -
99
+ * To grant access to this API operation on a directory bucket, we recommend
100
+ * that you use the <a>CreateSession</a> API operation for
101
+ * session-based authorization.</p>
111
102
  * </li>
112
103
  * </ul>
113
104
  * </dd>
@@ -43,6 +43,8 @@ declare const ListBucketsCommand_base: {
43
43
  * const input = { // ListBucketsRequest
44
44
  * MaxBuckets: Number("int"),
45
45
  * ContinuationToken: "STRING_VALUE",
46
+ * Prefix: "STRING_VALUE",
47
+ * BucketRegion: "STRING_VALUE",
46
48
  * };
47
49
  * const command = new ListBucketsCommand(input);
48
50
  * const response = await client.send(command);
@@ -51,6 +53,7 @@ declare const ListBucketsCommand_base: {
51
53
  * // { // Bucket
52
54
  * // Name: "STRING_VALUE",
53
55
  * // CreationDate: new Date("TIMESTAMP"),
56
+ * // BucketRegion: "STRING_VALUE",
54
57
  * // },
55
58
  * // ],
56
59
  * // Owner: { // Owner
@@ -58,6 +61,7 @@ declare const ListBucketsCommand_base: {
58
61
  * // ID: "STRING_VALUE",
59
62
  * // },
60
63
  * // ContinuationToken: "STRING_VALUE",
64
+ * // Prefix: "STRING_VALUE",
61
65
  * // };
62
66
  *
63
67
  * ```
@@ -63,6 +63,7 @@ declare const ListDirectoryBucketsCommand_base: {
63
63
  * // { // Bucket
64
64
  * // Name: "STRING_VALUE",
65
65
  * // CreationDate: new Date("TIMESTAMP"),
66
+ * // BucketRegion: "STRING_VALUE",
66
67
  * // },
67
68
  * // ],
68
69
  * // ContinuationToken: "STRING_VALUE",
@@ -73,7 +73,7 @@ declare const PutBucketEncryptionCommand_base: {
73
73
  * </li>
74
74
  * <li>
75
75
  * <p>Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
76
- * <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
76
+ * The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
77
77
  * </p>
78
78
  * </li>
79
79
  * <li>
@@ -30,10 +30,6 @@ declare const RestoreObjectCommand_base: {
30
30
  * <note>
31
31
  * <p>This operation is not supported by directory buckets.</p>
32
32
  * </note>
33
- * <important>
34
- * <p>The <code>SELECT</code> job type for the RestoreObject operation is no longer available to new customers. Existing customers of Amazon S3 Select can continue to use the feature as usual. <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">Learn more</a>
35
- * </p>
36
- * </important>
37
33
  * <p>Restores an archived copy of an object back into Amazon S3</p>
38
34
  * <p>This functionality is not supported for Amazon S3 on Outposts.</p>
39
35
  * <p>This action performs the following types of requests: </p>
@@ -30,10 +30,6 @@ declare const SelectObjectContentCommand_base: {
30
30
  * <note>
31
31
  * <p>This operation is not supported by directory buckets.</p>
32
32
  * </note>
33
- * <important>
34
- * <p>The SelectObjectContent operation is no longer available to new customers. Existing customers of Amazon S3 Select can continue to use the operation as usual. <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">Learn more</a>
35
- * </p>
36
- * </important>
37
33
  * <p>This action filters the contents of an Amazon S3 object based on a simple structured query
38
34
  * language (SQL) statement. In the request, along with the SQL expression, you must also
39
35
  * specify a data serialization format (JSON, CSV, or Apache Parquet) of the object. Amazon S3 uses
@@ -1321,7 +1321,7 @@ export interface CopyObjectRequest {
1321
1321
  * </li>
1322
1322
  * <li>
1323
1323
  * <p>To encrypt new object copies to a directory bucket with SSE-KMS, we recommend you specify SSE-KMS as the directory bucket's default encryption configuration with a KMS key (specifically, a <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a>).
1324
- * <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported. Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket. After you specify a customer managed key for SSE-KMS, you can't override the customer managed key for the bucket's SSE-KMS configuration.
1324
+ * The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported. Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket. After you specify a customer managed key for SSE-KMS, you can't override the customer managed key for the bucket's SSE-KMS configuration.
1325
1325
  * Then, when you perform a <code>CopyObject</code> operation and want to specify server-side encryption settings for new object copies with SSE-KMS in the encryption-related request headers, you must ensure the encryption key is the same customer managed key that you specified for the directory bucket's default encryption configuration.
1326
1326
  * </p>
1327
1327
  * </li>
@@ -1427,10 +1427,13 @@ export interface CopyObjectRequest {
1427
1427
  * Signature Version in Request Authentication</a> in the
1428
1428
  * <i>Amazon S3 User Guide</i>.</p>
1429
1429
  * <p>
1430
- * <b>Directory buckets</b> - If you specify <code>x-amz-server-side-encryption</code> with <code>aws:kms</code>, you must specify the <code>
1431
- * x-amz-server-side-encryption-aws-kms-key-id</code> header with the ID (Key ID or Key ARN) of the KMS
1432
- * symmetric encryption customer managed key to use. Otherwise, you get an HTTP <code>400 Bad Request</code> error. Only use the key ID or key ARN. The key alias format of the KMS key isn't supported. Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
1433
- * <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
1430
+ * <b>Directory buckets</b> - If you specify <code>x-amz-server-side-encryption</code> with <code>aws:kms</code>, the <code>
1431
+ * x-amz-server-side-encryption-aws-kms-key-id</code> header is implicitly assigned the ID of the KMS
1432
+ * symmetric encryption customer managed key that's configured for your directory bucket's default encryption setting.
1433
+ * If you want to specify the <code>
1434
+ * x-amz-server-side-encryption-aws-kms-key-id</code> header explicitly, you can only specify it with the ID (Key ID or Key ARN) of the KMS
1435
+ * customer managed key that's configured for your directory bucket's default encryption setting. Otherwise, you get an HTTP <code>400 Bad Request</code> error. Only use the key ID or key ARN. The key alias format of the KMS key isn't supported. Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
1436
+ * The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
1434
1437
  * </p>
1435
1438
  * @public
1436
1439
  */
@@ -2526,10 +2529,13 @@ export interface CreateMultipartUploadRequest {
2526
2529
  * <code>x-amz-server-side-encryption:aws:kms:dsse</code>, but do not provide <code>x-amz-server-side-encryption-aws-kms-key-id</code>, Amazon S3 uses the Amazon Web Services managed key
2527
2530
  * (<code>aws/s3</code>) to protect the data.</p>
2528
2531
  * <p>
2529
- * <b>Directory buckets</b> - If you specify <code>x-amz-server-side-encryption</code> with <code>aws:kms</code>, you must specify the <code>
2530
- * x-amz-server-side-encryption-aws-kms-key-id</code> header with the ID (Key ID or Key ARN) of the KMS
2531
- * symmetric encryption customer managed key to use. Otherwise, you get an HTTP <code>400 Bad Request</code> error. Only use the key ID or key ARN. The key alias format of the KMS key isn't supported. Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
2532
- * <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
2532
+ * <b>Directory buckets</b> - If you specify <code>x-amz-server-side-encryption</code> with <code>aws:kms</code>, the <code>
2533
+ * x-amz-server-side-encryption-aws-kms-key-id</code> header is implicitly assigned the ID of the KMS
2534
+ * symmetric encryption customer managed key that's configured for your directory bucket's default encryption setting.
2535
+ * If you want to specify the <code>
2536
+ * x-amz-server-side-encryption-aws-kms-key-id</code> header explicitly, you can only specify it with the ID (Key ID or Key ARN) of the KMS
2537
+ * customer managed key that's configured for your directory bucket's default encryption setting. Otherwise, you get an HTTP <code>400 Bad Request</code> error. Only use the key ID or key ARN. The key alias format of the KMS key isn't supported. Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
2538
+ * The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
2533
2539
  * </p>
2534
2540
  * @public
2535
2541
  */
@@ -2732,7 +2738,7 @@ export interface CreateSessionRequest {
2732
2738
  * symmetric encryption customer managed key to use. Otherwise, you get an HTTP <code>400 Bad Request</code> error. Only use the key ID or key ARN. The key alias format of the KMS key isn't supported. Also, if the KMS key doesn't exist in the same
2733
2739
  * account that't issuing the command, you must use the full Key ARN not the Key ID. </p>
2734
2740
  * <p>Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
2735
- * <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
2741
+ * The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
2736
2742
  * </p>
2737
2743
  * @public
2738
2744
  */
@@ -5759,7 +5765,7 @@ export interface GetBucketCorsRequest {
5759
5765
  * <li>
5760
5766
  * <p>
5761
5767
  * <b>Directory buckets</b> - Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
5762
- * <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
5768
+ * The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
5763
5769
  * </p>
5764
5770
  * </li>
5765
5771
  * <li>
@@ -9736,7 +9742,7 @@ export interface PublicAccessBlockConfiguration {
9736
9742
  BlockPublicPolicy?: boolean;
9737
9743
  /**
9738
9744
  * <p>Specifies whether Amazon S3 should restrict public bucket policies for this bucket. Setting
9739
- * this element to <code>TRUE</code> restricts access to this bucket to only Amazon Web Servicesservice principals and authorized users within this account if the bucket has
9745
+ * this element to <code>TRUE</code> restricts access to this bucket to only Amazon Web Services service principals and authorized users within this account if the bucket has
9740
9746
  * a public policy.</p>
9741
9747
  * <p>Enabling this setting doesn't affect previously stored bucket policies, except that
9742
9748
  * public and cross-account access within any public bucket policy, including non-public
@@ -10654,6 +10660,12 @@ export interface Bucket {
10654
10660
  * @public
10655
10661
  */
10656
10662
  CreationDate?: Date;
10663
+ /**
10664
+ * <p>
10665
+ * <code>BucketRegion</code> indicates the Amazon Web Services region where the bucket is located. If the request contains at least one valid parameter, it is included in the response.</p>
10666
+ * @public
10667
+ */
10668
+ BucketRegion?: string;
10657
10669
  }
10658
10670
  /**
10659
10671
  * @public
@@ -10676,6 +10688,12 @@ export interface ListBucketsOutput {
10676
10688
  * @public
10677
10689
  */
10678
10690
  ContinuationToken?: string;
10691
+ /**
10692
+ * <p>If <code>Prefix</code> was sent with the request, it is included in the response.</p>
10693
+ * <p>All bucket names in the response begin with the specified bucket name prefix.</p>
10694
+ * @public
10695
+ */
10696
+ Prefix?: string;
10679
10697
  }
10680
10698
  /**
10681
10699
  * @public
@@ -10696,6 +10714,19 @@ export interface ListBucketsRequest {
10696
10714
  * @public
10697
10715
  */
10698
10716
  ContinuationToken?: string;
10717
+ /**
10718
+ * <p>Limits the response to bucket names that begin with the specified bucket name prefix.</p>
10719
+ * @public
10720
+ */
10721
+ Prefix?: string;
10722
+ /**
10723
+ * <p>Limits the response to buckets that are located in the specified Amazon Web Services Region. The Amazon Web Services Region must be expressed according to the Amazon Web Services Region code, such as <code>us-west-2</code> for the US West (Oregon) Region. For a list of the valid values for all of the Amazon Web Services Regions, see <a href="https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region">Regions and Endpoints</a>.</p>
10724
+ * <note>
10725
+ * <p>Requests made to a Regional endpoint that is different from the <code>bucket-region</code> parameter are not supported. For example, if you want to limit the response to your buckets in Region <code>us-west-2</code>, the request must be made to an endpoint in Region <code>us-west-2</code>.</p>
10726
+ * </note>
10727
+ * @public
10728
+ */
10729
+ BucketRegion?: string;
10699
10730
  }
10700
10731
  /**
10701
10732
  * @public
@@ -682,10 +682,10 @@ export interface PutObjectRequest {
682
682
  * Content-MD5 mechanism as an end-to-end integrity check. For more information about REST
683
683
  * request authentication, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html">REST Authentication</a>.</p>
684
684
  * <note>
685
- * <p>The <code>Content-MD5</code> header is required for any request to upload an
685
+ * <p>The <code>Content-MD5</code> or <code>x-amz-sdk-checksum-algorithm</code> header is required for any request to upload an
686
686
  * object with a retention period configured using Amazon S3 Object Lock. For more
687
- * information about Amazon S3 Object Lock, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html">Amazon S3 Object Lock
688
- * Overview</a> in the <i>Amazon S3 User Guide</i>. </p>
687
+ * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-managing.html#object-lock-put-object">Uploading objects to an Object Lock enabled bucket
688
+ * </a> in the <i>Amazon S3 User Guide</i>.</p>
689
689
  * </note>
690
690
  * <note>
691
691
  * <p>This functionality is not supported for directory buckets.</p>
@@ -738,8 +738,12 @@ export interface PutObjectRequest {
738
738
  * <code>ChecksumAlgorithm</code> parameter and uses the checksum algorithm that matches the provided value in <code>x-amz-checksum-<i>algorithm</i>
739
739
  * </code>.</p>
740
740
  * <note>
741
- * <p>For directory buckets, when you use Amazon Web Services SDKs, <code>CRC32</code> is the default checksum algorithm that's used for performance.</p>
741
+ * <p>The <code>Content-MD5</code> or <code>x-amz-sdk-checksum-algorithm</code> header is required for any request to upload an
742
+ * object with a retention period configured using Amazon S3 Object Lock. For more
743
+ * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-managing.html#object-lock-put-object">Uploading objects to an Object Lock enabled bucket
744
+ * </a> in the <i>Amazon S3 User Guide</i>.</p>
742
745
  * </note>
746
+ * <p>For directory buckets, when you use Amazon Web Services SDKs, <code>CRC32</code> is the default checksum algorithm that's used for performance.</p>
743
747
  * @public
744
748
  */
745
749
  ChecksumAlgorithm?: ChecksumAlgorithm;
@@ -983,10 +987,13 @@ export interface PutObjectRequest {
983
987
  * <code>x-amz-server-side-encryption:aws:kms:dsse</code>, but do not provide <code>x-amz-server-side-encryption-aws-kms-key-id</code>, Amazon S3 uses the Amazon Web Services managed key
984
988
  * (<code>aws/s3</code>) to protect the data.</p>
985
989
  * <p>
986
- * <b>Directory buckets</b> - If you specify <code>x-amz-server-side-encryption</code> with <code>aws:kms</code>, you must specify the <code>
987
- * x-amz-server-side-encryption-aws-kms-key-id</code> header with the ID (Key ID or Key ARN) of the KMS
988
- * symmetric encryption customer managed key to use. Otherwise, you get an HTTP <code>400 Bad Request</code> error. Only use the key ID or key ARN. The key alias format of the KMS key isn't supported. Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
989
- * <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
990
+ * <b>Directory buckets</b> - If you specify <code>x-amz-server-side-encryption</code> with <code>aws:kms</code>, the <code>
991
+ * x-amz-server-side-encryption-aws-kms-key-id</code> header is implicitly assigned the ID of the KMS
992
+ * symmetric encryption customer managed key that's configured for your directory bucket's default encryption setting.
993
+ * If you want to specify the <code>
994
+ * x-amz-server-side-encryption-aws-kms-key-id</code> header explicitly, you can only specify it with the ID (Key ID or Key ARN) of the KMS
995
+ * customer managed key that's configured for your directory bucket's default encryption setting. Otherwise, you get an HTTP <code>400 Bad Request</code> error. Only use the key ID or key ARN. The key alias format of the KMS key isn't supported. Your SSE-KMS configuration can only support 1 <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#customer-cmk">customer managed key</a> per directory bucket for the lifetime of the bucket.
996
+ * The <a href="https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk">Amazon Web Services managed key</a> (<code>aws/s3</code>) isn't supported.
990
997
  * </p>
991
998
  * @public
992
999
  */
@@ -1966,13 +1973,7 @@ export interface OutputSerialization {
1966
1973
  JSON?: JSONOutput;
1967
1974
  }
1968
1975
  /**
1969
- * <important>
1970
- * <p>Amazon S3 Select is no longer available to new customers. Existing customers of Amazon S3 Select can continue to use the feature as usual. <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">Learn more</a>
1971
- * </p>
1972
- * </important>
1973
- * <p>Describes the parameters for Select job types.</p>
1974
- * <p>Learn <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">How to optimize querying your data in Amazon S3</a> using
1975
- * <a href="https://docs.aws.amazon.com/athena/latest/ug/what-is.html">Amazon Athena</a>, <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html">S3 Object Lambda</a>, or client-side filtering.</p>
1976
+ * <p>Describes the parameters for Select job types.</p>
1976
1977
  * @public
1977
1978
  */
1978
1979
  export interface SelectParameters {
@@ -1987,11 +1988,7 @@ export interface SelectParameters {
1987
1988
  */
1988
1989
  ExpressionType: ExpressionType | undefined;
1989
1990
  /**
1990
- * <important>
1991
- * <p>Amazon S3 Select is no longer available to new customers. Existing customers of Amazon S3 Select can continue to use the feature as usual. <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">Learn more</a>
1992
- * </p>
1993
- * </important>
1994
- * <p>The expression that is used to query the object.</p>
1991
+ * <p>The expression that is used to query the object.</p>
1995
1992
  * @public
1996
1993
  */
1997
1994
  Expression: string | undefined;
@@ -2032,11 +2029,7 @@ export interface RestoreRequest {
2032
2029
  */
2033
2030
  GlacierJobParameters?: GlacierJobParameters;
2034
2031
  /**
2035
- * <important>
2036
- * <p>Amazon S3 Select is no longer available to new customers. Existing customers of Amazon S3 Select can continue to use the feature as usual. <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">Learn more</a>
2037
- * </p>
2038
- * </important>
2039
- * <p>Type of restore request.</p>
2032
+ * <p>Type of restore request.</p>
2040
2033
  * @public
2041
2034
  */
2042
2035
  Type?: RestoreRequestType;
@@ -2051,11 +2044,7 @@ export interface RestoreRequest {
2051
2044
  */
2052
2045
  Description?: string;
2053
2046
  /**
2054
- * <important>
2055
- * <p>Amazon S3 Select is no longer available to new customers. Existing customers of Amazon S3 Select can continue to use the feature as usual. <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">Learn more</a>
2056
- * </p>
2057
- * </important>
2058
- * <p>Describes the parameters for Select job types.</p>
2047
+ * <p>Describes the parameters for Select job types.</p>
2059
2048
  * @public
2060
2049
  */
2061
2050
  SelectParameters?: SelectParameters;
@@ -2362,11 +2351,7 @@ export interface ScanRange {
2362
2351
  End?: number;
2363
2352
  }
2364
2353
  /**
2365
- * <note>
2366
- * <p>Learn Amazon S3 Select is no longer available to new customers. Existing customers of Amazon S3 Select can continue to use the feature as usual. <a href="http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/">Learn more</a>
2367
- * </p>
2368
- * </note>
2369
- * <p>Request to filter the contents of an Amazon S3 object based on a simple Structured Query
2354
+ * <p>Request to filter the contents of an Amazon S3 object based on a simple Structured Query
2370
2355
  * Language (SQL) statement. In the request, along with the SQL expression, you must specify a
2371
2356
  * data serialization format (JSON or CSV) of the object. Amazon S3 uses this to parse object data
2372
2357
  * into records. It returns only records that match the specified SQL expression. You must
@@ -1655,15 +1655,19 @@ export interface ListBucketMetricsConfigurationsRequest {
1655
1655
  export interface Bucket {
1656
1656
  Name?: string;
1657
1657
  CreationDate?: Date;
1658
+ BucketRegion?: string;
1658
1659
  }
1659
1660
  export interface ListBucketsOutput {
1660
1661
  Buckets?: Bucket[];
1661
1662
  Owner?: Owner;
1662
1663
  ContinuationToken?: string;
1664
+ Prefix?: string;
1663
1665
  }
1664
1666
  export interface ListBucketsRequest {
1665
1667
  MaxBuckets?: number;
1666
1668
  ContinuationToken?: string;
1669
+ Prefix?: string;
1670
+ BucketRegion?: string;
1667
1671
  }
1668
1672
  export interface ListDirectoryBucketsOutput {
1669
1673
  Buckets?: Bucket[];
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.670.0",
4
+ "version": "3.673.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-s3",