aws-sdk-s3tables 1.1.0 → 1.2.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: cdab8392d7dc910169cdc84c7ac25f71e724c4af20ec601bb8ba2ae62fde081e
-  data.tar.gz: 2a3e9835da9d7732757b29e87bd34c07657bdea5f54ca32f0fa1ad699fde1217
+  metadata.gz: 04046c4d2d57e9c03d732037469170302f8b6109978519856d898cb556d92218
+  data.tar.gz: 6e29cf438fe819b6884fd66e8507cc2b61f3d2d18f146657e200ab3b4d12efdb
 SHA512:
-  metadata.gz: 2bd9437955b07fcb3f60df54258e19ebd70e34c6bf93c8709bba988e0227053305f82c30c360fe9ffc95f06ca2742edd520b0607c109b3a89e6b39ccb73d3889
-  data.tar.gz: 6784adb92ca26e6a838214dfac632981f149d71896ecadec6f6d67df2827d3929725db99c07f57f33f700e491e1d07f246a88f24e80a87ecfbf8e4e0920bb891
+  metadata.gz: 6320ffb16adc5a6e4e0d4927238ded460d20dd49c507ef1c0a899f88834c1ee3710246e588a828170c161bbe9f8151aa2ef962e4b596de448f7a62dba2a73181
+  data.tar.gz: 7a4563120ad212da02b536da01397024100a877cb3294b8ef2c4deea0645ae8ff0f9ee1a3a9e28d98009d9f3b59a8a1c6af2772c10e3964ed89a353cbf49392a

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.2.0 (2025-01-30)
+------------------
+
+* Feature - You can now use the CreateTable API operation to create tables with schemas by adding an optional metadata argument.
+
 1.1.0 (2025-01-15)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.1.0
+1.2.0

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

@@ -472,11 +472,17 @@ module Aws::S3Tables
 
     # Creates a namespace. A namespace is a logical grouping of tables
     # within your table bucket, which you can use to organize tables. For
-    # more information, see [Table namespaces][1].
+    # more information, see [Create a namespace][1] in the *Amazon Simple
+    # Storage Service User Guide*.
     #
+    # Permissions
     #
+    # : You must have the `s3tables:CreateNamespace` permission to use this
+    #   operation.
     #
-    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-create.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket to create the
@@ -513,7 +519,23 @@ module Aws::S3Tables
     end
 
     # Creates a new table associated with the given namespace in a table
-    # bucket.
+    # bucket. For more information, see [Creating an Amazon S3 table][1] in
+    # the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:CreateTable` permission to use this
+    #   operation.
+    #
+    #   <note markdown="1"> Additionally, you must have the `s3tables:PutTableData` permission
+    #   to use this operation with the optional `metadata` request
+    #   parameter.
+    #
+    #    </note>
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-create.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket to create the table
@@ -528,6 +550,9 @@ module Aws::S3Tables
     # @option params [required, String] :format
     #   The format for the table.
     #
+    # @option params [Types::TableMetadata] :metadata
+    #   The metadata for the table.
+    #
     # @return [Types::CreateTableResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateTableResponse#table_arn #table_arn} => String
@@ -540,6 +565,19 @@ module Aws::S3Tables
     #     namespace: "NamespaceName", # required
     #     name: "TableName", # required
     #     format: "ICEBERG", # required, accepts ICEBERG
+    #     metadata: {
+    #       iceberg: {
+    #         schema: { # required
+    #           fields: [ # required
+    #             {
+    #               name: "String", # required
+    #               type: "String", # required
+    #               required: false,
+    #             },
+    #           ],
+    #         },
+    #       },
+    #     },
     #   })
     #
     # @example Response structure
@@ -556,7 +594,17 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Creates a table bucket.
+    # Creates a table bucket. For more information, see [Creating a table
+    # bucket][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:CreateTableBucket` permission to use
+    #   this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-create.html
     #
     # @option params [required, String] :name
     #   The name for the table bucket.
@@ -584,7 +632,17 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Deletes a namespace.
+    # Deletes a namespace. For more information, see [Delete a namespace][1]
+    # in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:DeleteNamespace` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-delete.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket associated with the
@@ -611,7 +669,17 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Deletes a table.
+    # Deletes a table. For more information, see [Deleting an Amazon S3
+    # table][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:DeleteTable` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-delete.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket that contains the
@@ -646,7 +714,17 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Deletes a table bucket.
+    # Deletes a table bucket. For more information, see [Deleting a table
+    # bucket][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:DeleteTableBucket` permission to use
+    #   this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-delete.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
@@ -668,10 +746,21 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Deletes a table bucket policy.
+    # Deletes a table bucket policy. For more information, see [Deleting a
+    # table bucket policy][1] in the *Amazon Simple Storage Service User
+    # Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:DeleteTableBucketPolicy` permission to
+    #   use this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-delete
     #
     # @option params [required, String] :table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket.
+    #   The Amazon Resource Name (ARN) of the table bucket.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -690,10 +779,20 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Deletes a table policy.
+    # Deletes a table policy. For more information, see [Deleting a table
+    # policy][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:DeleteTablePolicy` permission to use
+    #   this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-table-policy.html#table-policy-delete
     #
     # @option params [required, String] :table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket that contains the
+    #   The Amazon Resource Name (ARN) of the table bucket that contains the
     #   table.
     #
     # @option params [required, String] :namespace
@@ -721,7 +820,17 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Gets details about a namespace.
+    # Gets details about a namespace. For more information, see [Table
+    # namespaces][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetNamespace` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
@@ -760,7 +869,17 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Gets details about a table.
+    # Gets details about a table. For more information, see [S3 Tables][1]
+    # in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetTable` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-tables.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket associated with the
@@ -824,7 +943,18 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Gets details on a table bucket.
+    # Gets details on a table bucket. For more information, see [Viewing
+    # details about an Amazon S3 table bucket][1] in the *Amazon Simple
+    # Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetTableBucket` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-details.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
@@ -859,7 +989,17 @@ module Aws::S3Tables
     end
 
     # Gets details about a maintenance configuration for a given table
-    # bucket.
+    # bucket. For more information, see [Amazon S3 table bucket
+    # maintenance][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetTableBucketMaintenanceConfiguration`
+    #   permission to use this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-table-buckets-maintenance.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket associated with the
@@ -893,10 +1033,21 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Gets details about a table bucket policy.
+    # Gets details about a table bucket policy. For more information, see
+    # [Viewing a table bucket policy][1] in the *Amazon Simple Storage
+    # Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetTableBucketPolicy` permission to use
+    #   this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-get
     #
     # @option params [required, String] :table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket.
+    #   The Amazon Resource Name (ARN) of the table bucket.
     #
     # @return [Types::GetTableBucketPolicyResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -921,7 +1072,18 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Gets details about the maintenance configuration of a table.
+    # Gets details about the maintenance configuration of a table. For more
+    # information, see [S3 Tables maintenance][1] in the *Amazon Simple
+    # Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetTableMaintenanceConfiguration`
+    #   permission to use this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
@@ -963,7 +1125,18 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Gets the status of a maintenance job for a table.
+    # Gets the status of a maintenance job for a table. For more
+    # information, see [S3 Tables maintenance][1] in the *Amazon Simple
+    # Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetTableMaintenanceJobStatus` permission
+    #   to use this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
@@ -1006,6 +1179,11 @@ module Aws::S3Tables
 
     # Gets the location of the table metadata.
     #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetTableMetadataLocation` permission to
+    #   use this operation.
+    #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
     #
@@ -1044,10 +1222,20 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Gets details about a table policy.
+    # Gets details about a table policy. For more information, see [Viewing
+    # a table policy][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:GetTablePolicy` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-table-policy.html#table-policy-get
     #
     # @option params [required, String] :table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket that contains the
+    #   The Amazon Resource Name (ARN) of the table bucket that contains the
     #   table.
     #
     # @option params [required, String] :namespace
@@ -1081,7 +1269,18 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Lists the namespaces within a table bucket.
+    # Lists the namespaces within a table bucket. For more information, see
+    # [Table namespaces][1] in the *Amazon Simple Storage Service User
+    # Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:ListNamespaces` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
@@ -1133,7 +1332,17 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Lists table buckets for your account.
+    # Lists table buckets for your account. For more information, see [S3
+    # Table buckets][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:ListTableBuckets` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets.html
     #
     # @option params [String] :prefix
     #   The prefix of the table buckets.
@@ -1180,10 +1389,20 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # List tables in the given table bucket.
+    # List tables in the given table bucket. For more information, see [S3
+    # Tables][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:ListTables` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-tables.html
     #
     # @option params [required, String] :table_bucket_arn
-    #   The Amazon resource Number (ARN) of the table bucket.
+    #   The Amazon resource Name (ARN) of the table bucket.
     #
     # @option params [String] :namespace
     #   The namespace of the tables.
@@ -1239,7 +1458,18 @@ module Aws::S3Tables
     end
 
     # Creates a new maintenance configuration or replaces an existing
-    # maintenance configuration for a table bucket.
+    # maintenance configuration for a table bucket. For more information,
+    # see [Amazon S3 table bucket maintenance][1] in the *Amazon Simple
+    # Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:PutTableBucketMaintenanceConfiguration`
+    #   permission to use this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-table-buckets-maintenance.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket associated with the
@@ -1280,13 +1510,24 @@ module Aws::S3Tables
     end
 
     # Creates a new maintenance configuration or replaces an existing table
-    # bucket policy for a table bucket.
+    # bucket policy for a table bucket. For more information, see [Adding a
+    # table bucket policy][1] in the *Amazon Simple Storage Service User
+    # Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:PutTableBucketPolicy` permission to use
+    #   this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-add
     #
     # @option params [required, String] :table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket.
+    #   The Amazon Resource Name (ARN) of the table bucket.
     #
     # @option params [required, String] :resource_policy
-    #   The name of the resource policy.
+    #   The `JSON` that defines the policy.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1307,7 +1548,18 @@ module Aws::S3Tables
     end
 
     # Creates a new maintenance configuration or replaces an existing
-    # maintenance configuration for a table.
+    # maintenance configuration for a table. For more information, see [S3
+    # Tables maintenance][1] in the *Amazon Simple Storage Service User
+    # Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:PutTableMaintenanceConfiguration`
+    #   permission to use this operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table associated with the
@@ -1358,10 +1610,20 @@ module Aws::S3Tables
     end
 
     # Creates a new maintenance configuration or replaces an existing table
-    # policy for a table.
+    # policy for a table. For more information, see [Adding a table
+    # policy][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:PutTablePolicy` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-table-policy.html#table-policy-add
     #
     # @option params [required, String] :table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket that contains the
+    #   The Amazon Resource Name (ARN) of the table bucket that contains the
     #   table.
     #
     # @option params [required, String] :namespace
@@ -1371,7 +1633,7 @@ module Aws::S3Tables
     #   The name of the table.
     #
     # @option params [required, String] :resource_policy
-    #   The name of the resource policy.
+    #   The `JSON` that defines the policy.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1393,7 +1655,17 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Renames a table or a namespace.
+    # Renames a table or a namespace. For more information, see [S3
+    # Tables][1] in the *Amazon Simple Storage Service User Guide*.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:RenameTable` permission to use this
+    #   operation.
+    #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-tables.html
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
@@ -1435,7 +1707,16 @@ module Aws::S3Tables
       req.send_request(options)
     end
 
-    # Updates the metadata location for a table.
+    # Updates the metadata location for a table. The metadata location of a
+    # table must be an S3 URI that begins with the table's warehouse
+    # location. The metadata location for an Apache Iceberg table must end
+    # with `.metadata.json`, or if the metadata file is Gzip-compressed,
+    # `.metadata.json.gz`.
+    #
+    # Permissions
+    #
+    # : You must have the `s3tables:UpdateTableMetadataLocation` permission
+    #   to use this operation.
     #
     # @option params [required, String] :table_bucket_arn
     #   The Amazon Resource Name (ARN) of the table bucket.
@@ -1506,7 +1787,7 @@ module Aws::S3Tables
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-s3tables'
-      context[:gem_version] = '1.1.0'
+      context[:gem_version] = '1.2.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-s3tables/client_api.rb

@@ -17,6 +17,7 @@ module Aws::S3Tables
     AccessDeniedException = Shapes::StructureShape.new(name: 'AccessDeniedException')
     AccountId = Shapes::StringShape.new(name: 'AccountId')
     BadRequestException = Shapes::StructureShape.new(name: 'BadRequestException')
+    Boolean = Shapes::BooleanShape.new(name: 'Boolean')
     ConflictException = Shapes::StructureShape.new(name: 'ConflictException')
     CreateNamespaceRequest = Shapes::StructureShape.new(name: 'CreateNamespaceRequest')
     CreateNamespaceRequestNamespaceList = Shapes::ListShape.new(name: 'CreateNamespaceRequestNamespaceList')
@@ -51,6 +52,8 @@ module Aws::S3Tables
     GetTableRequest = Shapes::StructureShape.new(name: 'GetTableRequest')
     GetTableResponse = Shapes::StructureShape.new(name: 'GetTableResponse')
     IcebergCompactionSettings = Shapes::StructureShape.new(name: 'IcebergCompactionSettings')
+    IcebergMetadata = Shapes::StructureShape.new(name: 'IcebergMetadata')
+    IcebergSchema = Shapes::StructureShape.new(name: 'IcebergSchema')
     IcebergSnapshotManagementSettings = Shapes::StructureShape.new(name: 'IcebergSnapshotManagementSettings')
     IcebergUnreferencedFileRemovalSettings = Shapes::StructureShape.new(name: 'IcebergUnreferencedFileRemovalSettings')
     InternalServerErrorException = Shapes::StructureShape.new(name: 'InternalServerErrorException')
@@ -83,6 +86,8 @@ module Aws::S3Tables
     PutTablePolicyRequest = Shapes::StructureShape.new(name: 'PutTablePolicyRequest')
     RenameTableRequest = Shapes::StructureShape.new(name: 'RenameTableRequest')
     ResourcePolicy = Shapes::StringShape.new(name: 'ResourcePolicy')
+    SchemaField = Shapes::StructureShape.new(name: 'SchemaField')
+    SchemaFieldList = Shapes::ListShape.new(name: 'SchemaFieldList')
     String = Shapes::StringShape.new(name: 'String')
     SyntheticTimestamp_date_time = Shapes::TimestampShape.new(name: 'SyntheticTimestamp_date_time', timestampFormat: "iso8601")
     TableARN = Shapes::StringShape.new(name: 'TableARN')
@@ -101,6 +106,7 @@ module Aws::S3Tables
     TableMaintenanceJobType = Shapes::StringShape.new(name: 'TableMaintenanceJobType')
     TableMaintenanceSettings = Shapes::UnionShape.new(name: 'TableMaintenanceSettings')
     TableMaintenanceType = Shapes::StringShape.new(name: 'TableMaintenanceType')
+    TableMetadata = Shapes::UnionShape.new(name: 'TableMetadata')
     TableName = Shapes::StringShape.new(name: 'TableName')
     TableSummary = Shapes::StructureShape.new(name: 'TableSummary')
     TableSummaryList = Shapes::ListShape.new(name: 'TableSummaryList')
@@ -140,6 +146,7 @@ module Aws::S3Tables
     CreateTableRequest.add_member(:namespace, Shapes::ShapeRef.new(shape: NamespaceName, required: true, location: "uri", location_name: "namespace"))
     CreateTableRequest.add_member(:name, Shapes::ShapeRef.new(shape: TableName, required: true, location_name: "name"))
     CreateTableRequest.add_member(:format, Shapes::ShapeRef.new(shape: OpenTableFormat, required: true, location_name: "format"))
+    CreateTableRequest.add_member(:metadata, Shapes::ShapeRef.new(shape: TableMetadata, location_name: "metadata"))
     CreateTableRequest.struct_class = Types::CreateTableRequest
 
     CreateTableResponse.add_member(:table_arn, Shapes::ShapeRef.new(shape: TableARN, required: true, location_name: "tableARN"))
@@ -262,6 +269,12 @@ module Aws::S3Tables
     IcebergCompactionSettings.add_member(:target_file_size_mb, Shapes::ShapeRef.new(shape: PositiveInteger, location_name: "targetFileSizeMB"))
     IcebergCompactionSettings.struct_class = Types::IcebergCompactionSettings
 
+    IcebergMetadata.add_member(:schema, Shapes::ShapeRef.new(shape: IcebergSchema, required: true, location_name: "schema"))
+    IcebergMetadata.struct_class = Types::IcebergMetadata
+
+    IcebergSchema.add_member(:fields, Shapes::ShapeRef.new(shape: SchemaFieldList, required: true, location_name: "fields"))
+    IcebergSchema.struct_class = Types::IcebergSchema
+
     IcebergSnapshotManagementSettings.add_member(:min_snapshots_to_keep, Shapes::ShapeRef.new(shape: PositiveInteger, location_name: "minSnapshotsToKeep"))
     IcebergSnapshotManagementSettings.add_member(:max_snapshot_age_hours, Shapes::ShapeRef.new(shape: PositiveInteger, location_name: "maxSnapshotAgeHours"))
     IcebergSnapshotManagementSettings.struct_class = Types::IcebergSnapshotManagementSettings
@@ -346,6 +359,13 @@ module Aws::S3Tables
     RenameTableRequest.add_member(:version_token, Shapes::ShapeRef.new(shape: VersionToken, location_name: "versionToken"))
     RenameTableRequest.struct_class = Types::RenameTableRequest
 
+    SchemaField.add_member(:name, Shapes::ShapeRef.new(shape: String, required: true, location_name: "name"))
+    SchemaField.add_member(:type, Shapes::ShapeRef.new(shape: String, required: true, location_name: "type"))
+    SchemaField.add_member(:required, Shapes::ShapeRef.new(shape: Boolean, location_name: "required"))
+    SchemaField.struct_class = Types::SchemaField
+
+    SchemaFieldList.member = Shapes::ShapeRef.new(shape: SchemaField)
+
     TableBucketMaintenanceConfiguration.key = Shapes::ShapeRef.new(shape: TableBucketMaintenanceType)
     TableBucketMaintenanceConfiguration.value = Shapes::ShapeRef.new(shape: TableBucketMaintenanceConfigurationValue)
 
@@ -390,6 +410,12 @@ module Aws::S3Tables
     TableMaintenanceSettings.add_member_subclass(:unknown, Types::TableMaintenanceSettings::Unknown)
     TableMaintenanceSettings.struct_class = Types::TableMaintenanceSettings
 
+    TableMetadata.add_member(:iceberg, Shapes::ShapeRef.new(shape: IcebergMetadata, location_name: "iceberg"))
+    TableMetadata.add_member(:unknown, Shapes::ShapeRef.new(shape: nil, location_name: 'unknown'))
+    TableMetadata.add_member_subclass(:iceberg, Types::TableMetadata::Iceberg)
+    TableMetadata.add_member_subclass(:unknown, Types::TableMetadata::Unknown)
+    TableMetadata.struct_class = Types::TableMetadata
+
     TableSummary.add_member(:namespace, Shapes::ShapeRef.new(shape: NamespaceList, required: true, location_name: "namespace"))
     TableSummary.add_member(:name, Shapes::ShapeRef.new(shape: TableName, required: true, location_name: "name"))
     TableSummary.add_member(:type, Shapes::ShapeRef.new(shape: TableType, required: true, location_name: "type"))

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

@@ -128,13 +128,18 @@ module Aws::S3Tables
     #   The format for the table.
     #   @return [String]
     #
+    # @!attribute [rw] metadata
+    #   The metadata for the table.
+    #   @return [Types::TableMetadata]
+    #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/CreateTableRequest AWS API Documentation
     #
     class CreateTableRequest < Struct.new(
       :table_bucket_arn,
       :namespace,
       :name,
-      :format)
+      :format,
+      :metadata)
       SENSITIVE = []
       include Aws::Structure
     end
@@ -175,7 +180,7 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket.
+    #   The Amazon Resource Name (ARN) of the table bucket.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/DeleteTableBucketPolicyRequest AWS API Documentation
@@ -199,8 +204,8 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket that contains
-    #   the table.
+    #   The Amazon Resource Name (ARN) of the table bucket that contains the
+    #   table.
     #   @return [String]
     #
     # @!attribute [rw] namespace
@@ -338,7 +343,7 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket.
+    #   The Amazon Resource Name (ARN) of the table bucket.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/GetTableBucketPolicyRequest AWS API Documentation
@@ -350,7 +355,7 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] resource_policy
-    #   The name of the resource policy.
+    #   The `JSON` that defines the policy.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/GetTableBucketPolicyResponse AWS API Documentation
@@ -523,8 +528,8 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket that contains
-    #   the table.
+    #   The Amazon Resource Name (ARN) of the table bucket that contains the
+    #   table.
     #   @return [String]
     #
     # @!attribute [rw] namespace
@@ -546,7 +551,7 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] resource_policy
-    #   The name of the resource policy.
+    #   The `JSON` that defines the policy.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/GetTablePolicyResponse AWS API Documentation
@@ -671,6 +676,34 @@ module Aws::S3Tables
       include Aws::Structure
     end
 
+    # Contains details about the metadata for an Iceberg table.
+    #
+    # @!attribute [rw] schema
+    #   The schema for an Iceberg table.
+    #   @return [Types::IcebergSchema]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/IcebergMetadata AWS API Documentation
+    #
+    class IcebergMetadata < Struct.new(
+      :schema)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
+    # Contains details about the schema for an Iceberg table.
+    #
+    # @!attribute [rw] fields
+    #   The schema fields for the table
+    #   @return [Array<Types::SchemaField>]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/IcebergSchema AWS API Documentation
+    #
+    class IcebergSchema < Struct.new(
+      :fields)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Contains details about the snapshot management settings for an Iceberg
     # table. The oldest snapshot expires when its age exceeds the
     # `maxSnapshotAgeHours` and the total number of snapshots exceeds the
@@ -820,7 +853,7 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] table_bucket_arn
-    #   The Amazon resource Number (ARN) of the table bucket.
+    #   The Amazon resource Name (ARN) of the table bucket.
     #   @return [String]
     #
     # @!attribute [rw] namespace
@@ -940,11 +973,11 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket.
+    #   The Amazon Resource Name (ARN) of the table bucket.
     #   @return [String]
     #
     # @!attribute [rw] resource_policy
-    #   The name of the resource policy.
+    #   The `JSON` that defines the policy.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/PutTableBucketPolicyRequest AWS API Documentation
@@ -990,8 +1023,8 @@ module Aws::S3Tables
     end
 
     # @!attribute [rw] table_bucket_arn
-    #   The Amazon Resource Number (ARN) of the table bucket that contains
-    #   the table.
+    #   The Amazon Resource Name (ARN) of the table bucket that contains the
+    #   table.
     #   @return [String]
     #
     # @!attribute [rw] namespace
@@ -1003,7 +1036,7 @@ module Aws::S3Tables
     #   @return [String]
     #
     # @!attribute [rw] resource_policy
-    #   The name of the resource policy.
+    #   The `JSON` that defines the policy.
     #   @return [String]
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/PutTablePolicyRequest AWS API Documentation
@@ -1054,6 +1087,39 @@ module Aws::S3Tables
       include Aws::Structure
     end
 
+    # Contains details about a schema field.
+    #
+    # @!attribute [rw] name
+    #   The name of the field.
+    #   @return [String]
+    #
+    # @!attribute [rw] type
+    #   The field type. S3 Tables supports all Apache Iceberg primitive
+    #   types. For more information, see the [Apache Iceberg
+    #   documentation][1].
+    #
+    #
+    #
+    #   [1]: https://iceberg.apache.org/spec/#primitive-types
+    #   @return [String]
+    #
+    # @!attribute [rw] required
+    #   A Boolean value that specifies whether values are required for each
+    #   row in this field. By default, this is `false` and null values are
+    #   allowed in the field. If this is `true` the field does not allow
+    #   null values.
+    #   @return [Boolean]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/SchemaField AWS API Documentation
+    #
+    class SchemaField < Struct.new(
+      :name,
+      :type,
+      :required)
+      SENSITIVE = []
+      include Aws::Structure
+    end
+
     # Details about the values that define the maintenance configuration for
     # a table bucket.
     #
@@ -1101,7 +1167,7 @@ module Aws::S3Tables
     # Contains details about a table bucket.
     #
     # @!attribute [rw] arn
-    #   The Amazon Resource Number (ARN) of the table bucket.
+    #   The Amazon Resource Name (ARN) of the table bucket.
     #   @return [String]
     #
     # @!attribute [rw] name
@@ -1203,6 +1269,27 @@ module Aws::S3Tables
       class Unknown < TableMaintenanceSettings; end
     end
 
+    # Contains details about the table metadata.
+    #
+    # @note TableMetadata is a union - when making an API calls you must set exactly one of the members.
+    #
+    # @!attribute [rw] iceberg
+    #   Contains details about the metadata of an Iceberg table.
+    #   @return [Types::IcebergMetadata]
+    #
+    # @see http://docs.aws.amazon.com/goto/WebAPI/s3tables-2018-05-10/TableMetadata AWS API Documentation
+    #
+    class TableMetadata < Struct.new(
+      :iceberg,
+      :unknown)
+      SENSITIVE = []
+      include Aws::Structure
+      include Aws::Structure::Union
+
+      class Iceberg < TableMetadata; end
+      class Unknown < TableMetadata; end
+    end
+
     # Contains details about a table.
     #
     # @!attribute [rw] namespace
@@ -1218,7 +1305,7 @@ module Aws::S3Tables
     #   @return [String]
     #
     # @!attribute [rw] table_arn
-    #   The Amazon Resource Number (ARN) of the table.
+    #   The Amazon Resource Name (ARN) of the table.
     #   @return [String]
     #
     # @!attribute [rw] created_at
@@ -1292,7 +1379,7 @@ module Aws::S3Tables
     #   @return [String]
     #
     # @!attribute [rw] table_arn
-    #   The Amazon Resource Number (ARN) of the table.
+    #   The Amazon Resource Name (ARN) of the table.
     #   @return [String]
     #
     # @!attribute [rw] namespace

data/lib/aws-sdk-s3tables.rb

@@ -55,7 +55,7 @@ module Aws::S3Tables
   autoload :EndpointProvider, 'aws-sdk-s3tables/endpoint_provider'
   autoload :Endpoints, 'aws-sdk-s3tables/endpoints'
 
-  GEM_VERSION = '1.1.0'
+  GEM_VERSION = '1.2.0'
 
 end
 

data/sig/client.rbs

@@ -99,7 +99,20 @@ module Aws
                           table_bucket_arn: ::String,
                           namespace: ::String,
                           name: ::String,
-                          format: ("ICEBERG")
+                          format: ("ICEBERG"),
+                          ?metadata: {
+                            iceberg: {
+                              schema: {
+                                fields: Array[
+                                  {
+                                    name: ::String,
+                                    type: ::String,
+                                    required: bool?
+                                  },
+                                ]
+                              }
+                            }?
+                          }
                         ) -> _CreateTableResponseSuccess
                       | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateTableResponseSuccess
 

data/sig/types.rbs

@@ -50,6 +50,7 @@ module Aws::S3Tables
       attr_accessor namespace: ::String
       attr_accessor name: ::String
       attr_accessor format: ("ICEBERG")
+      attr_accessor metadata: Types::TableMetadata
       SENSITIVE: []
     end
 
@@ -225,6 +226,16 @@ module Aws::S3Tables
       SENSITIVE: []
     end
 
+    class IcebergMetadata
+      attr_accessor schema: Types::IcebergSchema
+      SENSITIVE: []
+    end
+
+    class IcebergSchema
+      attr_accessor fields: ::Array[Types::SchemaField]
+      SENSITIVE: []
+    end
+
     class IcebergSnapshotManagementSettings
       attr_accessor min_snapshots_to_keep: ::Integer
       attr_accessor max_snapshot_age_hours: ::Integer
@@ -337,6 +348,13 @@ module Aws::S3Tables
       SENSITIVE: []
     end
 
+    class SchemaField
+      attr_accessor name: ::String
+      attr_accessor type: ::String
+      attr_accessor required: bool
+      SENSITIVE: []
+    end
+
     class TableBucketMaintenanceConfigurationValue
       attr_accessor status: ("enabled" | "disabled")
       attr_accessor settings: Types::TableBucketMaintenanceSettings
@@ -389,6 +407,17 @@ module Aws::S3Tables
       end
     end
 
+    class TableMetadata
+      attr_accessor iceberg: Types::IcebergMetadata
+      attr_accessor unknown: untyped
+      SENSITIVE: []
+
+      class Iceberg < TableMetadata
+      end
+      class Unknown < TableMetadata
+      end
+    end
+
     class TableSummary
       attr_accessor namespace: ::Array[::String]
       attr_accessor name: ::String

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-s3tables
 version: !ruby/object:Gem::Version
-  version: 1.1.0
+  version: 1.2.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2025-01-15 00:00:00.000000000 Z
+date: 2025-01-30 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core