AWS::S3Tables::Table - AWS CloudFormation

This is the new AWS CloudFormation Template Reference Guide. Please update your bookmarks and links. For help getting started with CloudFormation, see the AWS 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 AWS 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.