@aws-sdk/client-s3tables 3.738.0 → 3.739.0

package/dist-cjs/models/models_0.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.JobStatus = exports.TableMaintenanceJobType = exports.TableMaintenanceSettings = exports.TableMaintenanceType = exports.MaintenanceStatus = exports.TableBucketMaintenanceSettings = exports.TableBucketMaintenanceType = exports.TableType = exports.OpenTableFormat = exports.TooManyRequestsException = exports.NotFoundException = exports.InternalServerErrorException = exports.ForbiddenException = exports.ConflictException = exports.BadRequestException = exports.AccessDeniedException = void 0;
+exports.JobStatus = exports.TableMaintenanceJobType = exports.TableMaintenanceSettings = exports.TableMaintenanceType = exports.MaintenanceStatus = exports.TableBucketMaintenanceSettings = exports.TableBucketMaintenanceType = exports.TableType = exports.TableMetadata = exports.OpenTableFormat = exports.TooManyRequestsException = exports.NotFoundException = exports.InternalServerErrorException = exports.ForbiddenException = exports.ConflictException = exports.BadRequestException = exports.AccessDeniedException = void 0;
 const S3TablesServiceException_1 = require("./S3TablesServiceException");
 class AccessDeniedException extends S3TablesServiceException_1.S3TablesServiceException {
     name = "AccessDeniedException";
@@ -96,6 +96,14 @@ exports.TooManyRequestsException = TooManyRequestsException;
 exports.OpenTableFormat = {
     ICEBERG: "ICEBERG",
 };
+var TableMetadata;
+(function (TableMetadata) {
+    TableMetadata.visit = (value, visitor) => {
+        if (value.iceberg !== undefined)
+            return visitor.iceberg(value.iceberg);
+        return visitor._(value.$unknown[0], value.$unknown[1]);
+    };
+})(TableMetadata || (exports.TableMetadata = TableMetadata = {}));
 exports.TableType = {
     AWS: "aws",
     CUSTOMER: "customer",

package/dist-cjs/protocols/Aws_restJson1.js

@@ -33,6 +33,7 @@ const se_CreateTableCommand = async (input, context) => {
     let body;
     body = JSON.stringify((0, smithy_client_1.take)(input, {
         format: [],
+        metadata: (_) => (0, smithy_client_1._json)(_),
         name: [],
     }));
     b.m("PUT").h(headers).b(body);

package/dist-es/models/models_0.js

@@ -86,6 +86,14 @@ export class TooManyRequestsException extends __BaseException {
 export const OpenTableFormat = {
     ICEBERG: "ICEBERG",
 };
+export var TableMetadata;
+(function (TableMetadata) {
+    TableMetadata.visit = (value, visitor) => {
+        if (value.iceberg !== undefined)
+            return visitor.iceberg(value.iceberg);
+        return visitor._(value.$unknown[0], value.$unknown[1]);
+    };
+})(TableMetadata || (TableMetadata = {}));
 export const TableType = {
     AWS: "aws",
     CUSTOMER: "customer",

package/dist-es/protocols/Aws_restJson1.js

@@ -28,6 +28,7 @@ export const se_CreateTableCommand = async (input, context) => {
     let body;
     body = JSON.stringify(take(input, {
         format: [],
+        metadata: (_) => _json(_),
         name: [],
     }));
     b.m("PUT").h(headers).b(body);

package/dist-types/commands/CreateNamespaceCommand.d.ts

@@ -27,7 +27,13 @@ declare const CreateNamespaceCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>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 <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html">Table namespaces</a>. </p>
+ * <p>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 <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-create.html">Create a namespace</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:CreateNamespace</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/CreateTableBucketCommand.d.ts

@@ -27,7 +27,13 @@ declare const CreateTableBucketCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Creates a table bucket.</p>
+ * <p>Creates a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-create.html">Creating a table bucket</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:CreateTableBucket</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/CreateTableCommand.d.ts

@@ -27,7 +27,16 @@ declare const CreateTableCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Creates a new table associated with the given namespace in a table bucket.</p>
+ * <p>Creates a new table associated with the given namespace in a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-create.html">Creating an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:CreateTable</code> permission to use this operation. </p>
+ *                <note>
+ *                   <p>Additionally, you must have the <code>s3tables:PutTableData</code> permission to use this operation with the optional <code>metadata</code> request parameter. </p>
+ *                </note>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
@@ -39,6 +48,19 @@ declare const CreateTableCommand_base: {
  *   namespace: "STRING_VALUE", // required
  *   name: "STRING_VALUE", // required
  *   format: "ICEBERG", // required
+ *   metadata: { // TableMetadata Union: only one key present
+ *     iceberg: { // IcebergMetadata
+ *       schema: { // IcebergSchema
+ *         fields: [ // SchemaFieldList // required
+ *           { // SchemaField
+ *             name: "STRING_VALUE", // required
+ *             type: "STRING_VALUE", // required
+ *             required: true || false,
+ *           },
+ *         ],
+ *       },
+ *     },
+ *   },
  * };
  * const command = new CreateTableCommand(input);
  * const response = await client.send(command);

package/dist-types/commands/DeleteNamespaceCommand.d.ts

@@ -27,7 +27,13 @@ declare const DeleteNamespaceCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Deletes a namespace.</p>
+ * <p>Deletes a namespace. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-delete.html">Delete a namespace</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:DeleteNamespace</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DeleteTableBucketCommand.d.ts

@@ -27,7 +27,13 @@ declare const DeleteTableBucketCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Deletes a table bucket.</p>
+ * <p>Deletes a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-delete.html">Deleting a table bucket</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:DeleteTableBucket</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DeleteTableBucketPolicyCommand.d.ts

@@ -27,7 +27,13 @@ declare const DeleteTableBucketPolicyCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Deletes a table bucket policy.</p>
+ * <p>Deletes a table bucket policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-delete">Deleting a table bucket policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:DeleteTableBucketPolicy</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DeleteTableCommand.d.ts

@@ -27,7 +27,13 @@ declare const DeleteTableCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Deletes a table.</p>
+ * <p>Deletes a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-delete.html">Deleting an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:DeleteTable</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/DeleteTablePolicyCommand.d.ts

@@ -27,7 +27,13 @@ declare const DeleteTablePolicyCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Deletes a table policy.</p>
+ * <p>Deletes a table policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-table-policy.html#table-policy-delete">Deleting a table policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:DeleteTablePolicy</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetNamespaceCommand.d.ts

@@ -27,7 +27,13 @@ declare const GetNamespaceCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Gets details about a namespace.</p>
+ * <p>Gets details about a namespace. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html">Table namespaces</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetNamespace</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTableBucketCommand.d.ts

@@ -27,7 +27,13 @@ declare const GetTableBucketCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Gets details on a table bucket.</p>
+ * <p>Gets details on a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-details.html">Viewing details about an Amazon S3 table bucket</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetTableBucket</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTableBucketMaintenanceConfigurationCommand.d.ts

@@ -27,7 +27,13 @@ declare const GetTableBucketMaintenanceConfigurationCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Gets details about a maintenance configuration for a given table bucket.</p>
+ * <p>Gets details about a maintenance configuration for a given table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-table-buckets-maintenance.html">Amazon S3 table bucket maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetTableBucketMaintenanceConfiguration</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTableBucketPolicyCommand.d.ts

@@ -27,7 +27,13 @@ declare const GetTableBucketPolicyCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Gets details about a table bucket policy.</p>
+ * <p>Gets details about a table bucket policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-get">Viewing a table bucket policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetTableBucketPolicy</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTableCommand.d.ts

@@ -27,7 +27,13 @@ declare const GetTableCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Gets details about a table.</p>
+ * <p>Gets details about a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-tables.html">S3 Tables</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetTable</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTableMaintenanceConfigurationCommand.d.ts

@@ -27,7 +27,13 @@ declare const GetTableMaintenanceConfigurationCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Gets details about the maintenance configuration of a table.</p>
+ * <p>Gets details about the maintenance configuration of a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html">S3 Tables maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetTableMaintenanceConfiguration</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTableMaintenanceJobStatusCommand.d.ts

@@ -27,7 +27,13 @@ declare const GetTableMaintenanceJobStatusCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Gets the status of a maintenance job for a table.</p>
+ * <p>Gets the status of a maintenance job for a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html">S3 Tables maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetTableMaintenanceJobStatus</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTableMetadataLocationCommand.d.ts

@@ -28,6 +28,12 @@ declare const GetTableMetadataLocationCommand_base: {
 };
 /**
  * <p>Gets the location of the table metadata.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetTableMetadataLocation</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/GetTablePolicyCommand.d.ts

@@ -27,7 +27,13 @@ declare const GetTablePolicyCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Gets details about a table policy.</p>
+ * <p>Gets details about a table policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-table-policy.html#table-policy-get">Viewing a table policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:GetTablePolicy</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListNamespacesCommand.d.ts

@@ -27,7 +27,13 @@ declare const ListNamespacesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Lists the namespaces within a table bucket.</p>
+ * <p>Lists the namespaces within a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html">Table namespaces</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:ListNamespaces</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListTableBucketsCommand.d.ts

@@ -27,7 +27,13 @@ declare const ListTableBucketsCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Lists table buckets for your account.</p>
+ * <p>Lists table buckets for your account. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets.html">S3 Table buckets</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:ListTableBuckets</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/ListTablesCommand.d.ts

@@ -27,7 +27,13 @@ declare const ListTablesCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>List tables in the given table bucket.</p>
+ * <p>List tables in the given table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-tables.html">S3 Tables</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:ListTables</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/PutTableBucketMaintenanceConfigurationCommand.d.ts

@@ -28,7 +28,13 @@ declare const PutTableBucketMaintenanceConfigurationCommand_base: {
 };
 /**
  * <p>Creates a new maintenance configuration or replaces an existing maintenance configuration
- *       for a table bucket.</p>
+ *       for a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-table-buckets-maintenance.html">Amazon S3 table bucket maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:PutTableBucketMaintenanceConfiguration</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/PutTableBucketPolicyCommand.d.ts

@@ -28,7 +28,13 @@ declare const PutTableBucketPolicyCommand_base: {
 };
 /**
  * <p>Creates a new maintenance configuration or replaces an existing table bucket policy for a
- *       table bucket. </p>
+ *       table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-add">Adding a table bucket policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:PutTableBucketPolicy</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/PutTableMaintenanceConfigurationCommand.d.ts

@@ -28,7 +28,13 @@ declare const PutTableMaintenanceConfigurationCommand_base: {
 };
 /**
  * <p>Creates a new maintenance configuration or replaces an existing maintenance configuration
- *       for a table.</p>
+ *       for a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-maintenance.html">S3 Tables maintenance</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:PutTableMaintenanceConfiguration</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/PutTablePolicyCommand.d.ts

@@ -27,8 +27,14 @@ declare const PutTablePolicyCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Creates a new maintenance configuration or replaces an existing table policy for a table.
+ * <p>Creates a new maintenance configuration or replaces an existing table policy for a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-table-policy.html#table-policy-add">Adding a table policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.
  *     </p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:PutTablePolicy</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/RenameTableCommand.d.ts

@@ -27,7 +27,13 @@ declare const RenameTableCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Renames a table or a namespace.</p>
+ * <p>Renames a table or a namespace. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-tables.html">S3 Tables</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:RenameTable</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/commands/UpdateTableMetadataLocationCommand.d.ts

@@ -27,7 +27,13 @@ declare const UpdateTableMetadataLocationCommand_base: {
     getEndpointParameterInstructions(): import("@smithy/middleware-endpoint").EndpointParameterInstructions;
 };
 /**
- * <p>Updates the metadata location for a table.</p>
+ * <p>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 <code>.metadata.json</code>, or if the metadata file is Gzip-compressed, <code>.metadata.json.gz</code>.</p>
+ *          <dl>
+ *             <dt>Permissions</dt>
+ *             <dd>
+ *                <p>You must have the <code>s3tables:UpdateTableMetadataLocation</code> permission to use this operation. </p>
+ *             </dd>
+ *          </dl>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript

package/dist-types/models/models_0.d.ts

@@ -126,6 +126,79 @@ export declare const OpenTableFormat: {
  * @public
  */
 export type OpenTableFormat = (typeof OpenTableFormat)[keyof typeof OpenTableFormat];
+/**
+ * <p>Contains details about a schema field.</p>
+ * @public
+ */
+export interface SchemaField {
+    /**
+     * <p>The name of the field.</p>
+     * @public
+     */
+    name: string | undefined;
+    /**
+     * <p>The field type. S3 Tables supports all Apache Iceberg primitive types. For more information, see the <a href="https://iceberg.apache.org/spec/#primitive-types">Apache Iceberg documentation</a>.</p>
+     * @public
+     */
+    type: string | undefined;
+    /**
+     * <p>A Boolean value that specifies whether values are required for each row in this field. By default, this is <code>false</code> and null values are allowed in the field. If this is <code>true</code> the field does not allow null values.</p>
+     * @public
+     */
+    required?: boolean | undefined;
+}
+/**
+ * <p>Contains details about the schema for an Iceberg table.</p>
+ * @public
+ */
+export interface IcebergSchema {
+    /**
+     * <p>The schema fields for the table</p>
+     * @public
+     */
+    fields: SchemaField[] | undefined;
+}
+/**
+ * <p>Contains details about the metadata for an Iceberg table.</p>
+ * @public
+ */
+export interface IcebergMetadata {
+    /**
+     * <p>The schema for an Iceberg table.</p>
+     * @public
+     */
+    schema: IcebergSchema | undefined;
+}
+/**
+ * <p>Contains details about the table metadata.</p>
+ * @public
+ */
+export type TableMetadata = TableMetadata.IcebergMember | TableMetadata.$UnknownMember;
+/**
+ * @public
+ */
+export declare namespace TableMetadata {
+    /**
+     * <p>Contains details about the metadata of an Iceberg table.</p>
+     * @public
+     */
+    interface IcebergMember {
+        iceberg: IcebergMetadata;
+        $unknown?: never;
+    }
+    /**
+     * @public
+     */
+    interface $UnknownMember {
+        iceberg?: never;
+        $unknown: [string, any];
+    }
+    interface Visitor<T> {
+        iceberg: (value: IcebergMetadata) => T;
+        _: (name: string, value: any) => T;
+    }
+    const visit: <T>(value: TableMetadata, visitor: Visitor<T>) => T;
+}
 /**
  * @public
  */
@@ -150,6 +223,11 @@ export interface CreateTableRequest {
      * @public
      */
     format: OpenTableFormat | undefined;
+    /**
+     * <p>The metadata for the table.</p>
+     * @public
+     */
+    metadata?: TableMetadata | undefined;
 }
 /**
  * @public
@@ -241,7 +319,7 @@ export interface DeleteTableBucketRequest {
  */
 export interface DeleteTableBucketPolicyRequest {
     /**
-     * <p>The Amazon Resource Number (ARN) of the table bucket.</p>
+     * <p>The Amazon Resource Name (ARN) of the table bucket.</p>
      * @public
      */
     tableBucketARN: string | undefined;
@@ -251,7 +329,7 @@ export interface DeleteTableBucketPolicyRequest {
  */
 export interface DeleteTablePolicyRequest {
     /**
-     * <p>The Amazon Resource Number (ARN) of the table bucket that contains the table.</p>
+     * <p>The Amazon Resource Name (ARN) of the table bucket that contains the table.</p>
      * @public
      */
     tableBucketARN: string | undefined;
@@ -570,7 +648,7 @@ export interface GetTableBucketMaintenanceConfigurationResponse {
  */
 export interface GetTableBucketPolicyRequest {
     /**
-     * <p>The Amazon Resource Number (ARN) of the table bucket.</p>
+     * <p>The Amazon Resource Name (ARN) of the table bucket.</p>
      * @public
      */
     tableBucketARN: string | undefined;
@@ -580,7 +658,7 @@ export interface GetTableBucketPolicyRequest {
  */
 export interface GetTableBucketPolicyResponse {
     /**
-     * <p>The name of the resource policy.</p>
+     * <p>The <code>JSON</code> that defines the policy.</p>
      * @public
      */
     resourcePolicy: string | undefined;
@@ -849,7 +927,7 @@ export interface GetTableMetadataLocationResponse {
  */
 export interface GetTablePolicyRequest {
     /**
-     * <p>The Amazon Resource Number (ARN) of the table bucket that contains the table.</p>
+     * <p>The Amazon Resource Name (ARN) of the table bucket that contains the table.</p>
      * @public
      */
     tableBucketARN: string | undefined;
@@ -869,7 +947,7 @@ export interface GetTablePolicyRequest {
  */
 export interface GetTablePolicyResponse {
     /**
-     * <p>The name of the resource policy.</p>
+     * <p>The <code>JSON</code> that defines the policy.</p>
      * @public
      */
     resourcePolicy: string | undefined;
@@ -972,7 +1050,7 @@ export interface ListTableBucketsRequest {
  */
 export interface TableBucketSummary {
     /**
-     * <p>The Amazon Resource Number (ARN) of the table bucket.</p>
+     * <p>The Amazon Resource Name (ARN) of the table bucket.</p>
      * @public
      */
     arn: string | undefined;
@@ -1012,7 +1090,7 @@ export interface ListTableBucketsResponse {
  */
 export interface ListTablesRequest {
     /**
-     * <p>The Amazon resource Number (ARN) of the table bucket.</p>
+     * <p>The Amazon resource Name (ARN) of the table bucket.</p>
      * @public
      */
     tableBucketARN: string | undefined;
@@ -1061,7 +1139,7 @@ export interface TableSummary {
      */
     type: TableType | undefined;
     /**
-     * <p>The Amazon Resource Number (ARN) of the table.</p>
+     * <p>The Amazon Resource Name (ARN) of the table.</p>
      * @public
      */
     tableARN: string | undefined;
@@ -1117,12 +1195,12 @@ export interface PutTableBucketMaintenanceConfigurationRequest {
  */
 export interface PutTableBucketPolicyRequest {
     /**
-     * <p>The Amazon Resource Number (ARN) of the table bucket.</p>
+     * <p>The Amazon Resource Name (ARN) of the table bucket.</p>
      * @public
      */
     tableBucketARN: string | undefined;
     /**
-     * <p>The name of the resource policy.</p>
+     * <p>The <code>JSON</code> that defines the policy.</p>
      * @public
      */
     resourcePolicy: string | undefined;
@@ -1163,7 +1241,7 @@ export interface PutTableMaintenanceConfigurationRequest {
  */
 export interface PutTablePolicyRequest {
     /**
-     * <p>The Amazon Resource Number (ARN) of the table bucket that contains the table.</p>
+     * <p>The Amazon Resource Name (ARN) of the table bucket that contains the table.</p>
      * @public
      */
     tableBucketARN: string | undefined;
@@ -1178,7 +1256,7 @@ export interface PutTablePolicyRequest {
      */
     name: string | undefined;
     /**
-     * <p>The name of the resource policy.</p>
+     * <p>The <code>JSON</code> that defines the policy.</p>
      * @public
      */
     resourcePolicy: string | undefined;
@@ -1258,7 +1336,7 @@ export interface UpdateTableMetadataLocationResponse {
      */
     name: string | undefined;
     /**
-     * <p>The Amazon Resource Number (ARN) of the table.</p>
+     * <p>The Amazon Resource Name (ARN) of the table.</p>
      * @public
      */
     tableARN: string | undefined;

package/dist-types/ts3.4/models/models_0.d.ts

@@ -56,11 +56,41 @@ export declare const OpenTableFormat: {
 };
 export type OpenTableFormat =
   (typeof OpenTableFormat)[keyof typeof OpenTableFormat];
+export interface SchemaField {
+  name: string | undefined;
+  type: string | undefined;
+  required?: boolean | undefined;
+}
+export interface IcebergSchema {
+  fields: SchemaField[] | undefined;
+}
+export interface IcebergMetadata {
+  schema: IcebergSchema | undefined;
+}
+export type TableMetadata =
+  | TableMetadata.IcebergMember
+  | TableMetadata.$UnknownMember;
+export declare namespace TableMetadata {
+  interface IcebergMember {
+    iceberg: IcebergMetadata;
+    $unknown?: never;
+  }
+  interface $UnknownMember {
+    iceberg?: never;
+    $unknown: [string, any];
+  }
+  interface Visitor<T> {
+    iceberg: (value: IcebergMetadata) => T;
+    _: (name: string, value: any) => T;
+  }
+  const visit: <T>(value: TableMetadata, visitor: Visitor<T>) => T;
+}
 export interface CreateTableRequest {
   tableBucketARN: string | undefined;
   namespace: string | undefined;
   name: string | undefined;
   format: OpenTableFormat | undefined;
+  metadata?: TableMetadata | undefined;
 }
 export interface CreateTableResponse {
   tableARN: string | undefined;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-sdk/client-s3tables",
   "description": "AWS SDK for JavaScript S3tables Client for Node.js, Browser and React Native",
-  "version": "3.738.0",
+  "version": "3.739.0",
   "scripts": {
     "build": "concurrently 'yarn:build:cjs' 'yarn:build:es' 'yarn:build:types'",
     "build:cjs": "tsc -p tsconfig.cjs.json",