AWS::S3Tables::Table - Amazon CloudFormation
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

This is the new Amazon CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the Amazon CloudFormation User Guide.

AWS::S3Tables::Table

Creates a new table associated with the given namespace in a table bucket. For more information, see Creating an Amazon S3 table 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.

Note

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.

Syntax

To declare this entity in your Amazon CloudFormation template, use the following syntax:

JSON

{ "Type" : "AWS::S3Tables::Table", "Properties" : { "Compaction" : Compaction, "IcebergMetadata" : IcebergMetadata, "Namespace" : String, "OpenTableFormat" : String, "SnapshotManagement" : SnapshotManagement, "TableBucketARN" : String, "TableName" : String, "WithoutMetadata" : String } }

Properties

Compaction

Property description not available.

Required: No

Type: Compaction

Update requires: No interruption

IcebergMetadata

Contains details about the metadata for an Iceberg table.

Required: No

Type: IcebergMetadata

Update requires: Replacement

Namespace

The name of the namespace.

Required: Yes

Type: String

Update requires: No interruption

OpenTableFormat

Property description not available.

Required: Yes

Type: String

Allowed values: ICEBERG

Update requires: Replacement

SnapshotManagement

Property description not available.

Required: No

Type: SnapshotManagement

Update requires: No interruption

TableBucketARN

Property description not available.

Required: Yes

Type: String

Update requires: Replacement

TableName

Property description not available.

Required: Yes

Type: String

Update requires: No interruption

WithoutMetadata

Property description not available.

Required: No

Type: String

Allowed values: Yes

Update requires: Replacement

Return values

Ref

Fn::GetAtt

TableARN

The Amazon Resource Name (ARN) of the table.

VersionToken

Property description not available.

WarehouseLocation

Property description not available.