@aws-sdk/client-s3 3.1020.0 → 3.1021.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 (9) hide show
  1. package/dist-cjs/index.js +1 -0
  2. package/dist-es/commands/ListBucketMetricsConfigurationsCommand.js +1 -0
  3. package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts +4 -0
  4. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +39 -8
  5. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +39 -8
  6. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +39 -8
  7. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +39 -8
  8. package/dist-types/models/models_0.d.ts +51 -0
  9. package/package.json +7 -7
package/dist-cjs/index.js CHANGED
@@ -1325,6 +1325,7 @@ class ListBucketMetricsConfigurationsCommand extends smithyClient.Command
1325
1325
  .classBuilder()
1326
1326
  .ep({
1327
1327
  ...commonParams,
1328
+ UseS3ExpressControlEndpoint: { type: "staticContextParams", value: true },
1328
1329
  Bucket: { type: "contextParams", name: "Bucket" },
1329
1330
  })
1330
1331
  .m(function (Command, cs, config, o) {
package/dist-es/commands/ListBucketMetricsConfigurationsCommand.js CHANGED
@@ -8,6 +8,7 @@ export class ListBucketMetricsConfigurationsCommand extends $Command
8
8
  .classBuilder()
9
9
  .ep({
10
10
  ...commonParams,
11
+ UseS3ExpressControlEndpoint: { type: "staticContextParams", value: true },
11
12
  Bucket: { type: "contextParams", name: "Bucket" },
12
13
  })
13
14
  .m(function (Command, cs, config, o) {
package/dist-types/commands/DeleteBucketInventoryConfigurationCommand.d.ts CHANGED
@@ -36,6 +36,10 @@ declare const DeleteBucketInventoryConfigurationCommand_base: {
36
36
  * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
37
37
  * Resources</a>.</p>
38
38
  * <p>For information about the Amazon S3 inventory feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-inventory.html">Amazon S3 Inventory</a>.</p>
39
+ * <note>
40
+ * <p>After deleting a configuration, Amazon S3 might still deliver one additional inventory
41
+ * report during a brief transition period while the system processes the deletion.</p>
42
+ * </note>
39
43
  * <p>Operations related to <code>DeleteBucketInventoryConfiguration</code> include: </p>
40
44
  * <ul>
41
45
  * <li>
package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts CHANGED
@@ -27,15 +27,46 @@ declare const DeleteBucketMetricsConfigurationCommand_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>
33
- * <p>Deletes a metrics configuration for the Amazon CloudWatch request metrics (specified by the metrics
30
+ * <p>Deletes a metrics configuration for the Amazon CloudWatch request metrics (specified by the metrics
34
31
  * configuration ID) from the bucket. Note that this doesn't include the daily storage metrics.</p>
35
- * <p> To use this operation, you must have permissions to perform the
36
- * <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by default. The
37
- * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
38
- * Resources</a>.</p>
32
+ * <note>
33
+ * <p>
34
+ * <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
35
+ * </code>. Virtual-hosted-style requests aren't supported.
36
+ * For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
37
+ * <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Concepts for directory buckets in Local Zones</a> in the
38
+ * <i>Amazon S3 User Guide</i>.</p>
39
+ * </note>
40
+ * <dl>
41
+ * <dt>Permissions</dt>
42
+ * <dd>
43
+ * <p> To use this operation, you must have permissions to perform the
44
+ * <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by default. The
45
+ * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
46
+ * Resources</a>.</p>
47
+ * <ul>
48
+ * <li>
49
+ * <p>
50
+ * <b>General purpose bucket permissions</b> - The
51
+ * <code>s3:PutMetricsConfiguration</code> permission is required in a policy. For more information
52
+ * about general purpose buckets permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
53
+ * Policies</a> in the <i>Amazon S3 User Guide</i>.</p>
54
+ * </li>
55
+ * <li>
56
+ * <p>
57
+ * <b>Directory bucket permissions</b> - To grant access to
58
+ * this API operation, you must have the <code>s3express:PutMetricsConfiguration</code> permission in
59
+ * an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
60
+ * For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
61
+ * </li>
62
+ * </ul>
63
+ * </dd>
64
+ * <dt>HTTP Host header syntax</dt>
65
+ * <dd>
66
+ * <p>
67
+ * <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region-code</i>.amazonaws.com</code>.</p>
68
+ * </dd>
69
+ * </dl>
39
70
  * <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon CloudWatch</a>. </p>
40
71
  * <p>The following operations are related to <code>DeleteBucketMetricsConfiguration</code>:</p>
41
72
  * <ul>
package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts CHANGED
@@ -27,15 +27,46 @@ declare const GetBucketMetricsConfigurationCommand_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>
33
- * <p>Gets a metrics configuration (specified by the metrics configuration ID) from the bucket. Note that
30
+ * <p>Gets a metrics configuration (specified by the metrics configuration ID) from the bucket. Note that
34
31
  * this doesn't include the daily storage metrics.</p>
35
- * <p> To use this operation, you must have permissions to perform the
36
- * <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by default. The
37
- * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
38
- * Resources</a>.</p>
32
+ * <note>
33
+ * <p>
34
+ * <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
35
+ * </code>. Virtual-hosted-style requests aren't supported.
36
+ * For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
37
+ * <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Concepts for directory buckets in Local Zones</a> in the
38
+ * <i>Amazon S3 User Guide</i>.</p>
39
+ * </note>
40
+ * <dl>
41
+ * <dt>Permissions</dt>
42
+ * <dd>
43
+ * <p> To use this operation, you must have permissions to perform the
44
+ * <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by default. The
45
+ * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
46
+ * Resources</a>.</p>
47
+ * <ul>
48
+ * <li>
49
+ * <p>
50
+ * <b>General purpose bucket permissions</b> - The
51
+ * <code>s3:GetMetricsConfiguration</code> permission is required in a policy. For more information
52
+ * about general purpose buckets permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
53
+ * Policies</a> in the <i>Amazon S3 User Guide</i>.</p>
54
+ * </li>
55
+ * <li>
56
+ * <p>
57
+ * <b>Directory bucket permissions</b> - To grant access to
58
+ * this API operation, you must have the <code>s3express:GetMetricsConfiguration</code> permission in
59
+ * an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
60
+ * For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
61
+ * </li>
62
+ * </ul>
63
+ * </dd>
64
+ * <dt>HTTP Host header syntax</dt>
65
+ * <dd>
66
+ * <p>
67
+ * <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region-code</i>.amazonaws.com</code>.</p>
68
+ * </dd>
69
+ * </dl>
39
70
  * <p> For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
40
71
  * CloudWatch</a>.</p>
41
72
  * <p>The following operations are related to <code>GetBucketMetricsConfiguration</code>:</p>
package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts CHANGED
@@ -27,22 +27,53 @@ declare const ListBucketMetricsConfigurationsCommand_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>
33
- * <p>Lists the metrics configurations for the bucket. The metrics configurations are only for the request
30
+ * <p>Lists the metrics configurations for the bucket. The metrics configurations are only for the request
34
31
  * metrics of the bucket and do not provide information on daily storage metrics. You can have up to 1,000
35
32
  * configurations per bucket.</p>
33
+ * <note>
34
+ * <p>
35
+ * <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
36
+ * </code>. Virtual-hosted-style requests aren't supported.
37
+ * For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
38
+ * <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Concepts for directory buckets in Local Zones</a> in the
39
+ * <i>Amazon S3 User Guide</i>.</p>
40
+ * </note>
36
41
  * <p>This action supports list pagination and does not return more than 100 configurations at a time.
37
42
  * Always check the <code>IsTruncated</code> element in the response. If there are no more configurations
38
43
  * to list, <code>IsTruncated</code> is set to false. If there are more configurations to list,
39
44
  * <code>IsTruncated</code> is set to true, and there is a value in <code>NextContinuationToken</code>.
40
45
  * You use the <code>NextContinuationToken</code> value to continue the pagination of the list by passing
41
46
  * the value in <code>continuation-token</code> in the request to <code>GET</code> the next page.</p>
42
- * <p>To use this operation, you must have permissions to perform the
43
- * <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by default. The
44
- * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
45
- * Resources</a>.</p>
47
+ * <dl>
48
+ * <dt>Permissions</dt>
49
+ * <dd>
50
+ * <p>To use this operation, you must have permissions to perform the
51
+ * <code>s3:GetMetricsConfiguration</code> action. The bucket owner has this permission by default. The
52
+ * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
53
+ * Resources</a>.</p>
54
+ * <ul>
55
+ * <li>
56
+ * <p>
57
+ * <b>General purpose bucket permissions</b> - The
58
+ * <code>s3:GetMetricsConfiguration</code> permission is required in a policy. For more information
59
+ * about general purpose buckets permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
60
+ * Policies</a> in the <i>Amazon S3 User Guide</i>.</p>
61
+ * </li>
62
+ * <li>
63
+ * <p>
64
+ * <b>Directory bucket permissions</b> - To grant access to
65
+ * this API operation, you must have the <code>s3express:GetMetricsConfiguration</code> permission in
66
+ * an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
67
+ * For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
68
+ * </li>
69
+ * </ul>
70
+ * </dd>
71
+ * <dt>HTTP Host header syntax</dt>
72
+ * <dd>
73
+ * <p>
74
+ * <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region-code</i>.amazonaws.com</code>.</p>
75
+ * </dd>
76
+ * </dl>
46
77
  * <p>For more information about metrics configurations and CloudWatch request metrics, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with
47
78
  * Amazon CloudWatch</a>.</p>
48
79
  * <p>The following operations are related to <code>ListBucketMetricsConfigurations</code>:</p>
package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts CHANGED
@@ -27,17 +27,48 @@ declare const PutBucketMetricsConfigurationCommand_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>
33
- * <p>Sets a metrics configuration (specified by the metrics configuration ID) for the bucket. You can
30
+ * <p>Sets a metrics configuration (specified by the metrics configuration ID) for the bucket. You can
34
31
  * have up to 1,000 metrics configurations per bucket. If you're updating an existing metrics
35
32
  * configuration, note that this is a full replacement of the existing metrics configuration. If you don't
36
33
  * include the elements you want to keep, they are erased.</p>
37
- * <p>To use this operation, you must have permissions to perform the
38
- * <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by default. The
39
- * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
40
- * Resources</a>.</p>
34
+ * <note>
35
+ * <p>
36
+ * <b>Directory buckets </b> - For directory buckets, you must make requests for this API operation to the Regional endpoint. These endpoints support path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
37
+ * </code>. Virtual-hosted-style requests aren't supported.
38
+ * For more information about endpoints in Availability Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html">Regional and Zonal endpoints for directory buckets in Availability Zones</a> in the
39
+ * <i>Amazon S3 User Guide</i>. For more information about endpoints in Local Zones, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html">Concepts for directory buckets in Local Zones</a> in the
40
+ * <i>Amazon S3 User Guide</i>.</p>
41
+ * </note>
42
+ * <dl>
43
+ * <dt>Permissions</dt>
44
+ * <dd>
45
+ * <p>To use this operation, you must have permissions to perform the
46
+ * <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by default. The
47
+ * bucket owner can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
48
+ * Resources</a>.</p>
49
+ * <ul>
50
+ * <li>
51
+ * <p>
52
+ * <b>General purpose bucket permissions</b> - The
53
+ * <code>s3:PutMetricsConfiguration</code> permission is required in a policy. For more information
54
+ * about general purpose buckets permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html">Using Bucket Policies and User
55
+ * Policies</a> in the <i>Amazon S3 User Guide</i>.</p>
56
+ * </li>
57
+ * <li>
58
+ * <p>
59
+ * <b>Directory bucket permissions</b> - To grant access to
60
+ * this API operation, you must have the <code>s3express:PutMetricsConfiguration</code> permission in
61
+ * an IAM identity-based policy instead of a bucket policy. Cross-account access to this API operation isn't supported. This operation can only be performed by the Amazon Web Services account that owns the resource.
62
+ * For more information about directory bucket policies and permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html">Amazon Web Services Identity and Access Management (IAM) for S3 Express One Zone</a> in the <i>Amazon S3 User Guide</i>.</p>
63
+ * </li>
64
+ * </ul>
65
+ * </dd>
66
+ * <dt>HTTP Host header syntax</dt>
67
+ * <dd>
68
+ * <p>
69
+ * <b>Directory buckets </b> - The HTTP Host header syntax is <code>s3express-control.<i>region-code</i>.amazonaws.com</code>.</p>
70
+ * </dd>
71
+ * </dl>
41
72
  * <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
42
73
  * CloudWatch</a>.</p>
43
74
  * <p>The following operations are related to <code>PutBucketMetricsConfiguration</code>:</p>
package/dist-types/models/models_0.d.ts CHANGED
@@ -3030,6 +3030,12 @@ export interface DeleteBucketMetadataTableConfigurationRequest {
3030
3030
  export interface DeleteBucketMetricsConfigurationRequest {
3031
3031
  /**
3032
3032
  * <p>The name of the bucket containing the metrics configuration to delete.</p>
3033
+ * <p>
3034
+ * <b>Directory buckets </b> - When you use this operation with a directory bucket, you must use path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
3035
+ * </code>. Virtual-hosted-style requests aren't supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must also follow the format <code>
3036
+ * <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code>
3037
+ * <i>DOC-EXAMPLE-BUCKET</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>
3038
+ * </p>
3033
3039
  * <p>Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "@aws-sdk/signature-v4-crt" package to your project dependencies.
3034
3040
  * For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues</p>
3035
3041
  * @public
@@ -3043,6 +3049,10 @@ export interface DeleteBucketMetricsConfigurationRequest {
3043
3049
  Id: string | undefined;
3044
3050
  /**
3045
3051
  * <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
3052
+ * <note>
3053
+ * <p>For directory buckets, this header is not supported in this API operation. If you specify this header, the request fails with the HTTP status code
3054
+ * <code>501 Not Implemented</code>.</p>
3055
+ * </note>
3046
3056
  * @public
3047
3057
  */
3048
3058
  ExpectedBucketOwner?: string | undefined;
@@ -7597,6 +7607,10 @@ export interface MetricsAndOperator {
7597
7607
  Prefix?: string | undefined;
7598
7608
  /**
7599
7609
  * <p>The list of tags used when evaluating an AND predicate.</p>
7610
+ * <note>
7611
+ * <p>
7612
+ * <code>Tag</code> filters are not supported for directory buckets.</p>
7613
+ * </note>
7600
7614
  * @public
7601
7615
  */
7602
7616
  Tags?: Tag[] | undefined;
@@ -7630,6 +7644,10 @@ export declare namespace MetricsFilter {
7630
7644
  }
7631
7645
  /**
7632
7646
  * <p>The tag used when evaluating a metrics filter.</p>
7647
+ * <note>
7648
+ * <p>
7649
+ * <code>Tag</code> filters are not supported for directory buckets.</p>
7650
+ * </note>
7633
7651
  * @public
7634
7652
  */
7635
7653
  interface TagMember {
@@ -7703,6 +7721,9 @@ export interface MetricsConfiguration {
7703
7721
  * <p>Specifies a metrics configuration filter. The metrics configuration will only include objects that
7704
7722
  * meet the filter's criteria. A filter must be a prefix, an object tag, an access point ARN, or a
7705
7723
  * conjunction (MetricsAndOperator).</p>
7724
+ * <note>
7725
+ * <p>Metrics configurations for directory buckets do not support tag filters.</p>
7726
+ * </note>
7706
7727
  * @public
7707
7728
  */
7708
7729
  Filter?: MetricsFilter | undefined;
@@ -7723,6 +7744,12 @@ export interface GetBucketMetricsConfigurationOutput {
7723
7744
  export interface GetBucketMetricsConfigurationRequest {
7724
7745
  /**
7725
7746
  * <p>The name of the bucket containing the metrics configuration to retrieve.</p>
7747
+ * <p>
7748
+ * <b>Directory buckets </b> - When you use this operation with a directory bucket, you must use path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
7749
+ * </code>. Virtual-hosted-style requests aren't supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must also follow the format <code>
7750
+ * <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code>
7751
+ * <i>DOC-EXAMPLE-BUCKET</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>
7752
+ * </p>
7726
7753
  * <p>Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "@aws-sdk/signature-v4-crt" package to your project dependencies.
7727
7754
  * For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues</p>
7728
7755
  * @public
@@ -7736,6 +7763,10 @@ export interface GetBucketMetricsConfigurationRequest {
7736
7763
  Id: string | undefined;
7737
7764
  /**
7738
7765
  * <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
7766
+ * <note>
7767
+ * <p>For directory buckets, this header is not supported in this API operation. If you specify this header, the request fails with the HTTP status code
7768
+ * <code>501 Not Implemented</code>.</p>
7769
+ * </note>
7739
7770
  * @public
7740
7771
  */
7741
7772
  ExpectedBucketOwner?: string | undefined;
@@ -11087,6 +11118,12 @@ export interface ListBucketMetricsConfigurationsOutput {
11087
11118
  export interface ListBucketMetricsConfigurationsRequest {
11088
11119
  /**
11089
11120
  * <p>The name of the bucket containing the metrics configurations to retrieve.</p>
11121
+ * <p>
11122
+ * <b>Directory buckets </b> - When you use this operation with a directory bucket, you must use path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
11123
+ * </code>. Virtual-hosted-style requests aren't supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must also follow the format <code>
11124
+ * <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code>
11125
+ * <i>DOC-EXAMPLE-BUCKET</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>
11126
+ * </p>
11090
11127
  * <p>Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "@aws-sdk/signature-v4-crt" package to your project dependencies.
11091
11128
  * For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues</p>
11092
11129
  * @public
@@ -11101,6 +11138,10 @@ export interface ListBucketMetricsConfigurationsRequest {
11101
11138
  ContinuationToken?: string | undefined;
11102
11139
  /**
11103
11140
  * <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
11141
+ * <note>
11142
+ * <p>For directory buckets, this header is not supported in this API operation. If you specify this header, the request fails with the HTTP status code
11143
+ * <code>501 Not Implemented</code>.</p>
11144
+ * </note>
11104
11145
  * @public
11105
11146
  */
11106
11147
  ExpectedBucketOwner?: string | undefined;
@@ -13250,6 +13291,12 @@ export interface PutBucketLoggingRequest {
13250
13291
  export interface PutBucketMetricsConfigurationRequest {
13251
13292
  /**
13252
13293
  * <p>The name of the bucket for which the metrics configuration is set.</p>
13294
+ * <p>
13295
+ * <b>Directory buckets </b> - When you use this operation with a directory bucket, you must use path-style requests in the format <code>https://s3express-control.<i>region-code</i>.amazonaws.com/<i>bucket-name</i>
13296
+ * </code>. Virtual-hosted-style requests aren't supported. Directory bucket names must be unique in the chosen Zone (Availability Zone or Local Zone). Bucket names must also follow the format <code>
13297
+ * <i>bucket-base-name</i>--<i>zone-id</i>--x-s3</code> (for example, <code>
13298
+ * <i>DOC-EXAMPLE-BUCKET</i>--<i>usw2-az1</i>--x-s3</code>). For information about bucket naming restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html">Directory bucket naming rules</a> in the <i>Amazon S3 User Guide</i>
13299
+ * </p>
13253
13300
  * <p>Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "@aws-sdk/signature-v4-crt" package to your project dependencies.
13254
13301
  * For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues</p>
13255
13302
  * @public
@@ -13268,6 +13315,10 @@ export interface PutBucketMetricsConfigurationRequest {
13268
13315
  MetricsConfiguration: MetricsConfiguration | undefined;
13269
13316
  /**
13270
13317
  * <p>The account ID of the expected bucket owner. If the account ID that you provide does not match the actual owner of the bucket, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
13318
+ * <note>
13319
+ * <p>For directory buckets, this header is not supported in this API operation. If you specify this header, the request fails with the HTTP status code
13320
+ * <code>501 Not Implemented</code>.</p>
13321
+ * </note>
13271
13322
  * @public
13272
13323
  */
13273
13324
  ExpectedBucketOwner?: string | undefined;
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.1020.0",
4
+ "version": "3.1021.0",
5
5
  "scripts": {
6
6
  "build": "concurrently 'yarn:build:types' 'yarn:build:es' && yarn build:cjs",
7
7
  "build:cjs": "node ../../scripts/compilation/inline client-s3",
@@ -31,7 +31,7 @@
31
31
  "@aws-crypto/sha256-browser": "5.2.0",
32
32
  "@aws-crypto/sha256-js": "5.2.0",
33
33
  "@aws-sdk/core": "^3.973.26",
34
- "@aws-sdk/credential-provider-node": "^3.972.28",
34
+ "@aws-sdk/credential-provider-node": "^3.972.29",
35
35
  "@aws-sdk/middleware-bucket-endpoint": "^3.972.8",
36
36
  "@aws-sdk/middleware-expect-continue": "^3.972.8",
37
37
  "@aws-sdk/middleware-flexible-checksums": "^3.974.6",
@@ -41,13 +41,13 @@
41
41
  "@aws-sdk/middleware-recursion-detection": "^3.972.9",
42
42
  "@aws-sdk/middleware-sdk-s3": "^3.972.27",
43
43
  "@aws-sdk/middleware-ssec": "^3.972.8",
44
- "@aws-sdk/middleware-user-agent": "^3.972.27",
44
+ "@aws-sdk/middleware-user-agent": "^3.972.28",
45
45
  "@aws-sdk/region-config-resolver": "^3.972.10",
46
46
  "@aws-sdk/signature-v4-multi-region": "^3.996.15",
47
47
  "@aws-sdk/types": "^3.973.6",
48
48
  "@aws-sdk/util-endpoints": "^3.996.5",
49
49
  "@aws-sdk/util-user-agent-browser": "^3.972.8",
50
- "@aws-sdk/util-user-agent-node": "^3.973.13",
50
+ "@aws-sdk/util-user-agent-node": "^3.973.14",
51
51
  "@smithy/config-resolver": "^4.4.13",
52
52
  "@smithy/core": "^3.23.13",
53
53
  "@smithy/eventstream-serde-browser": "^4.2.12",
@@ -61,7 +61,7 @@
61
61
  "@smithy/md5-js": "^4.2.12",
62
62
  "@smithy/middleware-content-length": "^4.2.12",
63
63
  "@smithy/middleware-endpoint": "^4.4.28",
64
- "@smithy/middleware-retry": "^4.4.45",
64
+ "@smithy/middleware-retry": "^4.4.46",
65
65
  "@smithy/middleware-serde": "^4.2.16",
66
66
  "@smithy/middleware-stack": "^4.2.12",
67
67
  "@smithy/node-config-provider": "^4.3.12",
@@ -77,14 +77,14 @@
77
77
  "@smithy/util-defaults-mode-node": "^4.2.48",
78
78
  "@smithy/util-endpoints": "^3.3.3",
79
79
  "@smithy/util-middleware": "^4.2.12",
80
- "@smithy/util-retry": "^4.2.12",
80
+ "@smithy/util-retry": "^4.2.13",
81
81
  "@smithy/util-stream": "^4.5.21",
82
82
  "@smithy/util-utf8": "^4.2.2",
83
83
  "@smithy/util-waiter": "^4.2.14",
84
84
  "tslib": "^2.6.2"
85
85
  },
86
86
  "devDependencies": {
87
- "@aws-sdk/signature-v4-crt": "3.1020.0",
87
+ "@aws-sdk/signature-v4-crt": "3.1021.0",
88
88
  "@smithy/snapshot-testing": "^2.0.4",
89
89
  "@tsconfig/node20": "20.1.8",
90
90
  "@types/node": "^20.14.8",