aws-sdk-s3 1.217.1 → 1.218.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 80d0d50561fa174f60eb3162b93fc65d636d4d995f865dd73fa5e540625bc9eb
-  data.tar.gz: eef0aa119ba790548fd9c3fc65a20b33ad36347c023de018d98248607746aaab
+  metadata.gz: 913843b58029ef60d1b24e4b7bce92c5d9651ad61219a1424310a6cd83213dd9
+  data.tar.gz: f68ab62fb802ec66d530867718319a90ba27481ad7fb2a58ed7dbfe8a63b5155
 SHA512:
-  metadata.gz: 7a4b1a0951f46b596fbe6c08f1d33acac3d17de4c13a04dc09172662491c7a24a3c3a263681bc432ea4ab75d40a7da6dcf126064f66757c93e685ccd405ab278
-  data.tar.gz: 2cb005b279c2e6d08f6fff9a961476f381afb2286495aa02d0a26172b2301511a7841d44c20aeac052ce6ed680f73e7b69cc779cc7f5468b089c76134dd2037c
+  metadata.gz: 288b272e52c817806a5799d7d2af4d986a46aac4b64163fbddad64454dc3bb312cfb98b3c81432cf511590b9e6fd82f9f0e916bc69c24950b4d6ea25eb68f478
+  data.tar.gz: 2e4bd25ebebf88dd3e55e91b860d05bab07b486a6c26e41723c7f8adb3d67f1f8431b767ca2a6a82dac230121b84ea4d986c196fa549a68a9c516b416d2f8694

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.218.0 (2026-03-31)
+------------------
+
+* Feature - Add Bucket Metrics configuration support to directory buckets
+
 1.217.1 (2026-03-30)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.217.1
+1.218.0

data/lib/aws-sdk-s3/client.rb

@@ -4784,6 +4784,12 @@ module Aws::S3
     # For information about the Amazon S3 inventory feature, see [Amazon S3
     # Inventory][3].
     #
+    # <note markdown="1"> After deleting a configuration, Amazon S3 might still deliver one
+    # additional inventory report during a brief transition period while the
+    # system processes the deletion.
+    #
+    #  </note>
+    #
     # Operations related to `DeleteBucketInventoryConfiguration` include:
     #
     # * [GetBucketInventoryConfiguration][4]
@@ -5105,34 +5111,66 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported for directory buckets.
-    #
-    #  </note>
-    #
     # Deletes a metrics configuration for the Amazon CloudWatch request
     # metrics (specified by the metrics configuration ID) from the bucket.
     # Note that this doesn't include the daily storage metrics.
     #
-    # To use this operation, you must have permissions to perform the
-    # `s3:PutMetricsConfiguration` action. The bucket owner has this
-    # permission by default. The bucket owner can grant this permission to
-    # others. For more information about permissions, see [Permissions
-    # Related to Bucket Subresource Operations][1] and [Managing Access
-    # Permissions to Your Amazon S3 Resources][2].
+    # <note markdown="1"> <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
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][1] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Concepts for directory buckets in Local Zones][2] in the
+    # *Amazon S3 User Guide*.
+    #
+    #  </note>
+    #
+    # Permissions
+    #
+    # : To use this operation, you must have permissions to perform the
+    #   `s3:PutMetricsConfiguration` action. The bucket owner has this
+    #   permission by default. The bucket owner can grant this permission to
+    #   others. For more information about permissions, see [Permissions
+    #   Related to Bucket Subresource Operations][3] and [Managing Access
+    #   Permissions to Your Amazon S3 Resources][4].
+    #
+    #   * **General purpose bucket permissions** - The
+    #     `s3:PutMetricsConfiguration` permission is required in a policy.
+    #     For more information about general purpose buckets permissions,
+    #     see [Using Bucket Policies and User Policies][5] in the *Amazon S3
+    #     User Guide*.
+    #
+    #   * **Directory bucket permissions** - To grant access to this API
+    #     operation, you must have the `s3express:PutMetricsConfiguration`
+    #     permission in 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. For more information
+    #     about directory bucket policies and permissions, see [Amazon Web
+    #     Services Identity and Access Management (IAM) for S3 Express One
+    #     Zone][6] in the *Amazon S3 User Guide*.
+    #
+    # HTTP Host header syntax
+    #
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # For information about CloudWatch request metrics for Amazon S3, see
-    # [Monitoring Metrics with Amazon CloudWatch][3].
+    # [Monitoring Metrics with Amazon CloudWatch][7].
     #
     # The following operations are related to
     # `DeleteBucketMetricsConfiguration`:
     #
-    # * [GetBucketMetricsConfiguration][4]
+    # * [GetBucketMetricsConfiguration][8]
     #
-    # * [PutBucketMetricsConfiguration][5]
+    # * [PutBucketMetricsConfiguration][9]
     #
-    # * [ListBucketMetricsConfigurations][6]
+    # * [ListBucketMetricsConfigurations][10]
     #
-    # * [Monitoring Metrics with Amazon CloudWatch][3]
+    # * [Monitoring Metrics with Amazon CloudWatch][7]
     #
     # You must URL encode any signed header values that contain spaces. For
     # example, if your header value is `my file.txt`, containing two spaces
@@ -5140,16 +5178,35 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket containing the metrics configuration to delete.
     #
+    #   <b>Directory buckets </b> - When you use this operation with a
+    #   directory bucket, you must use path-style requests in the format
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    #   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 `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
+    #
     # @option params [required, String] :id
     #   The ID used to identify the metrics configuration. The ID has a 64
     #   character limit and can only contain letters, numbers, periods,
@@ -5160,6 +5217,12 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> 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 `501 Not Implemented`.
+    #
+    #    </note>
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -7929,34 +7992,66 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported for directory buckets.
-    #
-    #  </note>
-    #
     # Gets a metrics configuration (specified by the metrics configuration
     # ID) from the bucket. Note that this doesn't include the daily storage
     # metrics.
     #
-    # To use this operation, you must have permissions to perform the
-    # `s3:GetMetricsConfiguration` action. The bucket owner has this
-    # permission by default. The bucket owner can grant this permission to
-    # others. For more information about permissions, see [Permissions
-    # Related to Bucket Subresource Operations][1] and [Managing Access
-    # Permissions to Your Amazon S3 Resources][2].
+    # <note markdown="1"> <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
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][1] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Concepts for directory buckets in Local Zones][2] in the
+    # *Amazon S3 User Guide*.
+    #
+    #  </note>
+    #
+    # Permissions
+    #
+    # : To use this operation, you must have permissions to perform the
+    #   `s3:GetMetricsConfiguration` action. The bucket owner has this
+    #   permission by default. The bucket owner can grant this permission to
+    #   others. For more information about permissions, see [Permissions
+    #   Related to Bucket Subresource Operations][3] and [Managing Access
+    #   Permissions to Your Amazon S3 Resources][4].
+    #
+    #   * **General purpose bucket permissions** - The
+    #     `s3:GetMetricsConfiguration` permission is required in a policy.
+    #     For more information about general purpose buckets permissions,
+    #     see [Using Bucket Policies and User Policies][5] in the *Amazon S3
+    #     User Guide*.
+    #
+    #   * **Directory bucket permissions** - To grant access to this API
+    #     operation, you must have the `s3express:GetMetricsConfiguration`
+    #     permission in 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. For more information
+    #     about directory bucket policies and permissions, see [Amazon Web
+    #     Services Identity and Access Management (IAM) for S3 Express One
+    #     Zone][6] in the *Amazon S3 User Guide*.
+    #
+    # HTTP Host header syntax
+    #
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # For information about CloudWatch request metrics for Amazon S3, see
-    # [Monitoring Metrics with Amazon CloudWatch][3].
+    # [Monitoring Metrics with Amazon CloudWatch][7].
     #
     # The following operations are related to
     # `GetBucketMetricsConfiguration`:
     #
-    # * [PutBucketMetricsConfiguration][4]
+    # * [PutBucketMetricsConfiguration][8]
     #
-    # * [DeleteBucketMetricsConfiguration][5]
+    # * [DeleteBucketMetricsConfiguration][9]
     #
-    # * [ListBucketMetricsConfigurations][6]
+    # * [ListBucketMetricsConfigurations][10]
     #
-    # * [Monitoring Metrics with Amazon CloudWatch][3]
+    # * [Monitoring Metrics with Amazon CloudWatch][7]
     #
     # You must URL encode any signed header values that contain spaces. For
     # example, if your header value is `my file.txt`, containing two spaces
@@ -7964,17 +8059,36 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket containing the metrics configuration to
     #   retrieve.
     #
+    #   <b>Directory buckets </b> - When you use this operation with a
+    #   directory bucket, you must use path-style requests in the format
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    #   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 `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
+    #
     # @option params [required, String] :id
     #   The ID used to identify the metrics configuration. The ID has a 64
     #   character limit and can only contain letters, numbers, periods,
@@ -7985,6 +8099,12 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> 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 `501 Not Implemented`.
+    #
+    #    </note>
+    #
     # @return [Types::GetBucketMetricsConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::GetBucketMetricsConfigurationOutput#metrics_configuration #metrics_configuration} => Types::MetricsConfiguration
@@ -11993,15 +12113,24 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported for directory buckets.
-    #
-    #  </note>
-    #
     # Lists the metrics configurations for the bucket. The metrics
     # configurations are only for the request metrics of the bucket and do
     # not provide information on daily storage metrics. You can have up to
     # 1,000 configurations per bucket.
     #
+    # <note markdown="1"> <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
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][1] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Concepts for directory buckets in Local Zones][2] in the
+    # *Amazon S3 User Guide*.
+    #
+    #  </note>
+    #
     # This action supports list pagination and does not return more than 100
     # configurations at a time. Always check the `IsTruncated` element in
     # the response. If there are no more configurations to list,
@@ -12011,24 +12140,47 @@ module Aws::S3
     # continue the pagination of the list by passing the value in
     # `continuation-token` in the request to `GET` the next page.
     #
-    # To use this operation, you must have permissions to perform the
-    # `s3:GetMetricsConfiguration` action. The bucket owner has this
-    # permission by default. The bucket owner can grant this permission to
-    # others. For more information about permissions, see [Permissions
-    # Related to Bucket Subresource Operations][1] and [Managing Access
-    # Permissions to Your Amazon S3 Resources][2].
+    # Permissions
+    #
+    # : To use this operation, you must have permissions to perform the
+    #   `s3:GetMetricsConfiguration` action. The bucket owner has this
+    #   permission by default. The bucket owner can grant this permission to
+    #   others. For more information about permissions, see [Permissions
+    #   Related to Bucket Subresource Operations][3] and [Managing Access
+    #   Permissions to Your Amazon S3 Resources][4].
+    #
+    #   * **General purpose bucket permissions** - The
+    #     `s3:GetMetricsConfiguration` permission is required in a policy.
+    #     For more information about general purpose buckets permissions,
+    #     see [Using Bucket Policies and User Policies][5] in the *Amazon S3
+    #     User Guide*.
+    #
+    #   * **Directory bucket permissions** - To grant access to this API
+    #     operation, you must have the `s3express:GetMetricsConfiguration`
+    #     permission in 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. For more information
+    #     about directory bucket policies and permissions, see [Amazon Web
+    #     Services Identity and Access Management (IAM) for S3 Express One
+    #     Zone][6] in the *Amazon S3 User Guide*.
+    #
+    # HTTP Host header syntax
+    #
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # For more information about metrics configurations and CloudWatch
-    # request metrics, see [Monitoring Metrics with Amazon CloudWatch][3].
+    # request metrics, see [Monitoring Metrics with Amazon CloudWatch][7].
     #
     # The following operations are related to
     # `ListBucketMetricsConfigurations`:
     #
-    # * [PutBucketMetricsConfiguration][4]
+    # * [PutBucketMetricsConfiguration][8]
     #
-    # * [GetBucketMetricsConfiguration][5]
+    # * [GetBucketMetricsConfiguration][9]
     #
-    # * [DeleteBucketMetricsConfiguration][6]
+    # * [DeleteBucketMetricsConfiguration][10]
     #
     # You must URL encode any signed header values that contain spaces. For
     # example, if your header value is `my file.txt`, containing two spaces
@@ -12036,17 +12188,36 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketMetricsConfiguration.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket containing the metrics configurations to
     #   retrieve.
     #
+    #   <b>Directory buckets </b> - When you use this operation with a
+    #   directory bucket, you must use path-style requests in the format
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    #   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 `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
+    #
     # @option params [String] :continuation_token
     #   The marker that is used to continue a metrics configuration listing
     #   that has been truncated. Use the `NextContinuationToken` from a
@@ -12058,6 +12229,12 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> 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 `501 Not Implemented`.
+    #
+    #    </note>
+    #
     # @return [Types::ListBucketMetricsConfigurationsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::ListBucketMetricsConfigurationsOutput#is_truncated #is_truncated} => Boolean
@@ -15977,10 +16154,6 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # <note markdown="1"> This operation is not supported for directory buckets.
-    #
-    #  </note>
-    #
     # Sets a metrics configuration (specified by the metrics configuration
     # ID) for the bucket. You can have up to 1,000 metrics configurations
     # per bucket. If you're updating an existing metrics configuration,
@@ -15988,24 +16161,60 @@ module Aws::S3
     # configuration. If you don't include the elements you want to keep,
     # they are erased.
     #
-    # To use this operation, you must have permissions to perform the
-    # `s3:PutMetricsConfiguration` action. The bucket owner has this
-    # permission by default. The bucket owner can grant this permission to
-    # others. For more information about permissions, see [Permissions
-    # Related to Bucket Subresource Operations][1] and [Managing Access
-    # Permissions to Your Amazon S3 Resources][2].
+    # <note markdown="1"> <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
+    # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    # Virtual-hosted-style requests aren't supported. For more information
+    # about endpoints in Availability Zones, see [Regional and Zonal
+    # endpoints for directory buckets in Availability Zones][1] in the
+    # *Amazon S3 User Guide*. For more information about endpoints in Local
+    # Zones, see [Concepts for directory buckets in Local Zones][2] in the
+    # *Amazon S3 User Guide*.
+    #
+    #  </note>
+    #
+    # Permissions
+    #
+    # : To use this operation, you must have permissions to perform the
+    #   `s3:PutMetricsConfiguration` action. The bucket owner has this
+    #   permission by default. The bucket owner can grant this permission to
+    #   others. For more information about permissions, see [Permissions
+    #   Related to Bucket Subresource Operations][3] and [Managing Access
+    #   Permissions to Your Amazon S3 Resources][4].
+    #
+    #   * **General purpose bucket permissions** - The
+    #     `s3:PutMetricsConfiguration` permission is required in a policy.
+    #     For more information about general purpose buckets permissions,
+    #     see [Using Bucket Policies and User Policies][5] in the *Amazon S3
+    #     User Guide*.
+    #
+    #   * **Directory bucket permissions** - To grant access to this API
+    #     operation, you must have the `s3express:PutMetricsConfiguration`
+    #     permission in 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. For more information
+    #     about directory bucket policies and permissions, see [Amazon Web
+    #     Services Identity and Access Management (IAM) for S3 Express One
+    #     Zone][6] in the *Amazon S3 User Guide*.
+    #
+    # HTTP Host header syntax
+    #
+    # : <b>Directory buckets </b> - The HTTP Host header syntax is
+    #   `s3express-control.region-code.amazonaws.com`.
     #
     # For information about CloudWatch request metrics for Amazon S3, see
-    # [Monitoring Metrics with Amazon CloudWatch][3].
+    # [Monitoring Metrics with Amazon CloudWatch][7].
     #
     # The following operations are related to
     # `PutBucketMetricsConfiguration`:
     #
-    # * [DeleteBucketMetricsConfiguration][4]
+    # * [DeleteBucketMetricsConfiguration][8]
     #
-    # * [GetBucketMetricsConfiguration][5]
+    # * [GetBucketMetricsConfiguration][9]
     #
-    # * [ListBucketMetricsConfigurations][6]
+    # * [ListBucketMetricsConfigurations][10]
     #
     # `PutBucketMetricsConfiguration` has the following special error:
     #
@@ -16022,16 +16231,35 @@ module Aws::S3
     #
     #
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
-    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
-    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
-    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
-    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
-    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
+    # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
+    # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources
+    # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
+    # [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-iam-policies.html
+    # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
+    # [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
+    # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
+    # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
+    # [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
     #
     # @option params [required, String] :bucket
     #   The name of the bucket for which the metrics configuration is set.
     #
+    #   <b>Directory buckets </b> - When you use this operation with a
+    #   directory bucket, you must use path-style requests in the format
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    #   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 `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
+    #
     # @option params [required, String] :id
     #   The ID used to identify the metrics configuration. The ID has a 64
     #   character limit and can only contain letters, numbers, periods,
@@ -16045,6 +16273,12 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the request
     #   fails with the HTTP status code `403 Forbidden` (access denied).
     #
+    #   <note markdown="1"> 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 `501 Not Implemented`.
+    #
+    #    </note>
+    #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
     # @example Request syntax with placeholder values
@@ -22600,7 +22834,7 @@ module Aws::S3
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.217.1'
+      context[:gem_version] = '1.218.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-s3/endpoints.rb

@@ -804,6 +804,7 @@ module Aws::S3
           bucket: context.params[:bucket],
           use_dual_stack: context[:use_dualstack_endpoint],
           accelerate: context[:use_accelerate_endpoint],
+          use_s3_express_control_endpoint: true,
         )
       end
     end

data/lib/aws-sdk-s3/types.rb

@@ -4404,6 +4404,21 @@ module Aws::S3
     # @!attribute [rw] bucket
     #   The name of the bucket containing the metrics configuration to
     #   delete.
+    #
+    #   <b>Directory buckets </b> - When you use this operation with a
+    #   directory bucket, you must use path-style requests in the format
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    #   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 `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
     #   @return [String]
     #
     # @!attribute [rw] id
@@ -4417,6 +4432,12 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the
     #   request fails with the HTTP status code `403 Forbidden` (access
     #   denied).
+    #
+    #   <note markdown="1"> 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 `501 Not Implemented`.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketMetricsConfigurationRequest AWS API Documentation
@@ -7177,6 +7198,21 @@ module Aws::S3
     # @!attribute [rw] bucket
     #   The name of the bucket containing the metrics configuration to
     #   retrieve.
+    #
+    #   <b>Directory buckets </b> - When you use this operation with a
+    #   directory bucket, you must use path-style requests in the format
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    #   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 `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
     #   @return [String]
     #
     # @!attribute [rw] id
@@ -7190,6 +7226,12 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the
     #   request fails with the HTTP status code `403 Forbidden` (access
     #   denied).
+    #
+    #   <note markdown="1"> 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 `501 Not Implemented`.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetricsConfigurationRequest AWS API Documentation
@@ -11267,6 +11309,21 @@ module Aws::S3
     # @!attribute [rw] bucket
     #   The name of the bucket containing the metrics configurations to
     #   retrieve.
+    #
+    #   <b>Directory buckets </b> - When you use this operation with a
+    #   directory bucket, you must use path-style requests in the format
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    #   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 `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
     #   @return [String]
     #
     # @!attribute [rw] continuation_token
@@ -11281,6 +11338,12 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the
     #   request fails with the HTTP status code `403 Forbidden` (access
     #   denied).
+    #
+    #   <note markdown="1"> 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 `501 Not Implemented`.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketMetricsConfigurationsRequest AWS API Documentation
@@ -13153,6 +13216,10 @@ module Aws::S3
     #
     # @!attribute [rw] tags
     #   The list of tags used when evaluating an AND predicate.
+    #
+    #   <note markdown="1"> `Tag` filters are not supported for directory buckets.
+    #
+    #    </note>
     #   @return [Array<Types::Tag>]
     #
     # @!attribute [rw] access_point_arn
@@ -13191,6 +13258,11 @@ module Aws::S3
     #   will only include objects that meet the filter's criteria. A filter
     #   must be a prefix, an object tag, an access point ARN, or a
     #   conjunction (MetricsAndOperator).
+    #
+    #   <note markdown="1"> Metrics configurations for directory buckets do not support tag
+    #   filters.
+    #
+    #    </note>
     #   @return [Types::MetricsFilter]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MetricsConfiguration AWS API Documentation
@@ -13218,6 +13290,10 @@ module Aws::S3
     #
     # @!attribute [rw] tag
     #   The tag used when evaluating a metrics filter.
+    #
+    #   <note markdown="1"> `Tag` filters are not supported for directory buckets.
+    #
+    #    </note>
     #   @return [Types::Tag]
     #
     # @!attribute [rw] access_point_arn
@@ -14969,6 +15045,21 @@ module Aws::S3
 
     # @!attribute [rw] bucket
     #   The name of the bucket for which the metrics configuration is set.
+    #
+    #   <b>Directory buckets </b> - When you use this operation with a
+    #   directory bucket, you must use path-style requests in the format
+    #   `https://s3express-control.region-code.amazonaws.com/bucket-name `.
+    #   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 `
+    #   bucket-base-name--zone-id--x-s3` (for example, `
+    #   DOC-EXAMPLE-BUCKET--usw2-az1--x-s3`). For information about bucket
+    #   naming restrictions, see [Directory bucket naming rules][1] in the
+    #   *Amazon S3 User Guide*
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-bucket-naming-rules.html
     #   @return [String]
     #
     # @!attribute [rw] id
@@ -14986,6 +15077,12 @@ module Aws::S3
     #   you provide does not match the actual owner of the bucket, the
     #   request fails with the HTTP status code `403 Forbidden` (access
     #   denied).
+    #
+    #   <note markdown="1"> 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 `501 Not Implemented`.
+    #
+    #    </note>
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketMetricsConfigurationRequest AWS API Documentation

data/lib/aws-sdk-s3.rb

@@ -75,7 +75,7 @@ module Aws::S3
   autoload :ObjectVersion, 'aws-sdk-s3/object_version'
   autoload :EventStreams, 'aws-sdk-s3/event_streams'
 
-  GEM_VERSION = '1.217.1'
+  GEM_VERSION = '1.218.0'
 
 end
 

metadata

@@ -1,7 +1,7 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-s3
 version: !ruby/object:Gem::Version
-  version: 1.217.1
+  version: 1.218.0
 platform: ruby
 authors:
 - Amazon Web Services