feat(s3tables): add metrics configuration support for TableBucket (#37275)

### Reason for this change

This PR adds request metrics configuration support to the S3 Tables TableBucket L2 construct, enabling users to enable or disable CloudWatch request metrics for their table buckets.
                                                                                
Request metrics provide insight into Amazon S3 Tables requests, helping users monitor and optimize their table bucket usage.

### Description of changes
Enhanced TableBucket construct with request metrics configuration:

  - Added RequestMetricsStatus enum with ENABLED and DISABLED values
  - Added requestMetricsStatus property to TableBucketProps (flat structure per CDK guidelines)
  - Pass metrics configuration through to CfnTableBucket L1 construct

  Documentation:

  - Updated README with "Enabling CloudWatch Request Metrics" section
  - Added RequestMetricsStatus to rosetta fixture

### Description of how you validated changes

- Unit tests: added 3 new test cases for request metrics (enabled, disabled, and not specified). All 193 tests passing.                                  

- Integration test: created integ.table-bucket-metrics.ts to validate metrics configuration deployment        

- Rosetta: verified with yarn rosetta:extract - passes successfully           

### Checklist
- [x] My code adheres to the [CONTRIBUTING GUIDE](https://github.com/aws/aws-cdk/blob/main/CONTRIBUTING.md) and [DESIGN GUIDELINES](https://github.com/aws/aws-cdk/blob/main/docs/DESIGN_GUIDELINES.md)

----

*By submitting this pull request, I confirm that my contribution is made under the terms of the Apache-2.0 license*

Author: olenarostotskyy

packages/@aws-cdk/aws-s3tables-alpha/README.md

@@ -235,6 +235,20 @@ const encryptedBucketAuto = new TableBucket(scope, 'EncryptedTableBucketAuto', {
 });
 ```
 
+### Enabling CloudWatch Request Metrics
+
+You can enable CloudWatch request metrics for your table bucket. Request metrics provide insight into Amazon S3 Tables requests, helping you monitor and optimize your table bucket usage.
+
+For more information about S3 Tables CloudWatch metrics, see the [S3 Tables CloudWatch Metrics documentation](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-cloudwatch-metrics.html).
+
+```ts
+// Enable CloudWatch request metrics for the table bucket
+const tableBucketWithMetrics = new TableBucket(scope, 'TableBucketWithMetrics', {
+    tableBucketName: 'metrics-enabled-bucket',
+    requestMetricsStatus: RequestMetricsStatus.ENABLED,
+});
+```
+
 ### Controlling Table Permissions
 
 ```ts

packages/@aws-cdk/aws-s3tables-alpha/lib/table-bucket.ts

@@ -147,6 +147,21 @@ export enum UnreferencedFileRemovalStatus {
   DISABLED = 'Disabled',
 }
 
+/**
+ * Controls whether CloudWatch request metrics are enabled or disabled for the table bucket.
+ */
+export enum RequestMetricsStatus {
+  /**
+   * Enable CloudWatch request metrics for the table bucket.
+   */
+  ENABLED = 'Enabled',
+
+  /**
+   * Disable CloudWatch request metrics for the table bucket.
+   */
+  DISABLED = 'Disabled',
+}
+
 /**
  * Controls Server Side Encryption (SSE) for this TableBucket.
  */
@@ -349,6 +364,16 @@ export interface TableBucketProps {
    * @default RETAIN
    */
   readonly removalPolicy?: RemovalPolicy;
+
+  /**
+   * CloudWatch request metrics configuration for the table bucket.
+   *
+   * When enabled, S3 Tables publishes CloudWatch request metrics for the table bucket.
+   * Request metrics provide insight into Amazon S3 Tables requests.
+   *
+   * @default - Request metrics are disabled
+   */
+  readonly requestMetricsStatus?: RequestMetricsStatus;
 }
 
 /**
@@ -601,6 +626,7 @@ export class TableBucket extends TableBucketBase {
         unreferencedDays: props.unreferencedFileRemoval?.unreferencedDays,
       },
       encryptionConfiguration: bucketEncryption,
+      metricsConfiguration: props.requestMetricsStatus ? { status: props.requestMetricsStatus } : undefined,
     });
 
     this.resource.applyRemovalPolicy(props.removalPolicy);

packages/@aws-cdk/aws-s3tables-alpha/rosetta/default.ts-fixture

@@ -1,6 +1,6 @@
 import { Construct } from 'constructs';
 import { Stack } from 'aws-cdk-lib';
-import { TableBucket, UnreferencedFileRemovalStatus, TableBucketEncryption, Namespace, Table, Status, OpenTableFormat, IcebergTransform, SortDirection, NullOrder } from '@aws-cdk/aws-s3tables-alpha';
+import { TableBucket, UnreferencedFileRemovalStatus, TableBucketEncryption, RequestMetricsStatus, Namespace, Table, Status, OpenTableFormat, IcebergTransform, SortDirection, NullOrder } from '@aws-cdk/aws-s3tables-alpha';
 import * as iam from 'aws-cdk-lib/aws-iam';
 import * as kms from 'aws-cdk-lib/aws-kms';
 

packages/@aws-cdk/aws-s3tables-alpha/test/integration/integ.table-bucket-metrics.js.snapshot/MetricsEnabledTestStack.assets.json

@@ -0,0 +1,50 @@
+{
+ "Resources": {
+  "MetricsEnabledBucket01C9F646": {
+   "Type": "AWS::S3Tables::TableBucket",
+   "Properties": {
+    "MetricsConfiguration": {
+     "Status": "Enabled"
+    },
+    "TableBucketName": "metrics-enabled-test-bucket",
+    "UnreferencedFileRemoval": {}
+   },
+   "UpdateReplacePolicy": "Delete",
+   "DeletionPolicy": "Delete"
+  }
+ },
+ "Parameters": {
+  "BootstrapVersion": {
+   "Type": "AWS::SSM::Parameter::Value<String>",
+   "Default": "/cdk-bootstrap/hnb659fds/version",
+   "Description": "Version of the CDK Bootstrap resources in this environment, automatically retrieved from SSM Parameter Store. [cdk:skip]"
+  }
+ },
+ "Rules": {
+  "CheckBootstrapVersion": {
+   "Assertions": [
+    {
+     "Assert": {
+      "Fn::Not": [
+       {
+        "Fn::Contains": [
+         [
+          "1",
+          "2",
+          "3",
+          "4",
+          "5"
+         ],
+         {
+          "Ref": "BootstrapVersion"
+         }
+        ]
+       }
+      ]
+     },
+     "AssertDescription": "CDK bootstrap stack version 6 required. Please run 'cdk bootstrap' with a recent version of the CDK CLI."
+    }
+   ]
+  }
+ }
+}