AWS Fundamentals Logo
AWS Fundamentals
L1 ConstructAWS::S3Tables::Table

CfnTable

Creates a new table associated with the given namespace in a table bucket. For more information, see [Creating an Amazon S3 table](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-create.html) in the *Amazon Simple Storage Service User Guide* . - **Permissions** - - You must have the `s3tables:CreateTable` permission to use this operation. - If you use this operation with the optional `metadata` request parameter you must have the `s3tables:PutTableData` permission. - If you use this operation with the optional `encryptionConfiguration` request parameter you must have the `s3tables:PutTableEncryption` permission. > Additionally, If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see [Permissions requirements for S3 Tables SSE-KMS encryption](https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-kms-permissions.html) . - **Cloud Development Kit** - To use S3 Tables AWS CDK constructs, add the `@aws-cdk/aws-s3tables-alpha` dependency with one of the following options: - NPM: `npm i

Import

import { CfnTable } from 'aws-cdk-lib/aws-s3tables';

Or use the module namespace:

import * as s3tables from 'aws-cdk-lib/aws-s3tables';
// s3tables.CfnTable

Properties

Configuration passed to the constructor as CfnTableProps.

namespaceRequired
string

The name of the namespace.

openTableFormatRequired
string

The format of the table.

tableBucketArnRequired
string

The Amazon Resource Name (ARN) of the table bucket to create the table in.

tableNameRequired
string

The name for the table.

compactionOptional
IResolvable | CompactionProperty

Contains details about the compaction settings for an Iceberg table.

icebergMetadataOptional
IResolvable | IcebergMetadataProperty

Contains details about the metadata for an Iceberg table.

snapshotManagementOptional
IResolvable | SnapshotManagementProperty

Contains details about the Iceberg snapshot management settings for the table.

storageClassConfigurationOptional
IResolvable | StorageClassConfigurationProperty

The configuration details for the storage class of tables or table buckets. This allows you to optimize storage costs by selecting the appropriate storage class based on your access patterns and performance requirements.

tagsOptional
CfnTag[]

User tags (key-value pairs) to associate with the table.

withoutMetadataOptional
string

Indicates that you don't want to specify a schema for the table. This property is mutually exclusive to `IcebergMetadata` , and its only possible value is `Yes` .

CloudFormation Resource

This L1 construct maps directly to the following CloudFormation resource type.

AWS::S3Tables::TableView in CloudFormation Explorer

Learn AWS the Practical Way

Our bi-weekly newsletter teaches hands-on AWS fundamentals. No certification fluff - just practical knowledge.

Subscribe to Newsletter

Quick Facts

LevelL1 (CloudFormation)
Moduleaws-s3tables
CFN TypeAWS::S3Tables::Table
Properties10

Related Constructs

Explore This Service

External Links