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 thes3tables:PutTableData
permission. -
If you use this operation with the optional
encryptionConfiguration
request parameter you must have thes3tables: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
} }
YAML
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.