1. Packages
  2. AWS Cloud Control
  3. API Docs
  4. s3tables
  5. Table

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.54.0 published on Monday, Feb 16, 2026 by Pulumi
aws-native logo

We recommend new projects start with resources from the AWS provider.

AWS Cloud Control v1.54.0 published on Monday, Feb 16, 2026 by Pulumi

    Resource Type definition for AWS::S3Tables::Table

    Create Table Resource

    Resources are created with functions called constructors. To learn more about declaring and configuring resources, see Resources.

    Constructor syntax

    new Table(name: string, args: TableArgs, opts?: CustomResourceOptions);
    @overload
    def Table(resource_name: str,
              args: TableArgs,
              opts: Optional[ResourceOptions] = None)
    
    @overload
    def Table(resource_name: str,
              opts: Optional[ResourceOptions] = None,
              namespace: Optional[str] = None,
              open_table_format: Optional[TableOpenTableFormat] = None,
              table_bucket_arn: Optional[str] = None,
              compaction: Optional[TableCompactionArgs] = None,
              iceberg_metadata: Optional[TableIcebergMetadataArgs] = None,
              snapshot_management: Optional[TableSnapshotManagementArgs] = None,
              storage_class_configuration: Optional[TableStorageClassConfigurationArgs] = None,
              table_name: Optional[str] = None,
              tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
              without_metadata: Optional[TableWithoutMetadata] = None)
    func NewTable(ctx *Context, name string, args TableArgs, opts ...ResourceOption) (*Table, error)
    public Table(string name, TableArgs args, CustomResourceOptions? opts = null)
    public Table(String name, TableArgs args)
    public Table(String name, TableArgs args, CustomResourceOptions options)
    
    type: aws-native:s3tables:Table
    properties: # The arguments to resource properties.
    options: # Bag of options to control resource's behavior.
    
    

    Parameters

    name string
    The unique name of the resource.
    args TableArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    resource_name str
    The unique name of the resource.
    args TableArgs
    The arguments to resource properties.
    opts ResourceOptions
    Bag of options to control resource's behavior.
    ctx Context
    Context object for the current deployment.
    name string
    The unique name of the resource.
    args TableArgs
    The arguments to resource properties.
    opts ResourceOption
    Bag of options to control resource's behavior.
    name string
    The unique name of the resource.
    args TableArgs
    The arguments to resource properties.
    opts CustomResourceOptions
    Bag of options to control resource's behavior.
    name String
    The unique name of the resource.
    args TableArgs
    The arguments to resource properties.
    options CustomResourceOptions
    Bag of options to control resource's behavior.

    Table Resource Properties

    To learn more about resource properties and how to use them, see Inputs and Outputs in the Architecture and Concepts docs.

    Inputs

    In Python, inputs that are objects can be passed either as argument classes or as dictionary literals.

    The Table resource accepts the following input properties:

    Namespace string
    The name of the namespace.
    OpenTableFormat Pulumi.AwsNative.S3Tables.TableOpenTableFormat
    The format of the table.
    TableBucketArn string
    The Amazon Resource Name (ARN) of the table bucket to create the table in.
    Compaction Pulumi.AwsNative.S3Tables.Inputs.TableCompaction
    Contains details about the compaction settings for an Iceberg table.
    IcebergMetadata Pulumi.AwsNative.S3Tables.Inputs.TableIcebergMetadata
    Contains details about the metadata for an Iceberg table.
    SnapshotManagement Pulumi.AwsNative.S3Tables.Inputs.TableSnapshotManagement
    Contains details about the Iceberg snapshot management settings for the table.
    StorageClassConfiguration Pulumi.AwsNative.S3Tables.Inputs.TableStorageClassConfiguration
    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.
    TableName string
    The name for the table.
    Tags List<Pulumi.AwsNative.Inputs.Tag>
    User tags (key-value pairs) to associate with the table.
    WithoutMetadata Pulumi.AwsNative.S3Tables.TableWithoutMetadata
    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 .
    Namespace string
    The name of the namespace.
    OpenTableFormat TableOpenTableFormat
    The format of the table.
    TableBucketArn string
    The Amazon Resource Name (ARN) of the table bucket to create the table in.
    Compaction TableCompactionArgs
    Contains details about the compaction settings for an Iceberg table.
    IcebergMetadata TableIcebergMetadataArgs
    Contains details about the metadata for an Iceberg table.
    SnapshotManagement TableSnapshotManagementArgs
    Contains details about the Iceberg snapshot management settings for the table.
    StorageClassConfiguration TableStorageClassConfigurationArgs
    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.
    TableName string
    The name for the table.
    Tags TagArgs
    User tags (key-value pairs) to associate with the table.
    WithoutMetadata TableWithoutMetadata
    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 .
    namespace String
    The name of the namespace.
    openTableFormat TableOpenTableFormat
    The format of the table.
    tableBucketArn String
    The Amazon Resource Name (ARN) of the table bucket to create the table in.
    compaction TableCompaction
    Contains details about the compaction settings for an Iceberg table.
    icebergMetadata TableIcebergMetadata
    Contains details about the metadata for an Iceberg table.
    snapshotManagement TableSnapshotManagement
    Contains details about the Iceberg snapshot management settings for the table.
    storageClassConfiguration TableStorageClassConfiguration
    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.
    tableName String
    The name for the table.
    tags List<Tag>
    User tags (key-value pairs) to associate with the table.
    withoutMetadata TableWithoutMetadata
    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 .
    namespace string
    The name of the namespace.
    openTableFormat TableOpenTableFormat
    The format of the table.
    tableBucketArn string
    The Amazon Resource Name (ARN) of the table bucket to create the table in.
    compaction TableCompaction
    Contains details about the compaction settings for an Iceberg table.
    icebergMetadata TableIcebergMetadata
    Contains details about the metadata for an Iceberg table.
    snapshotManagement TableSnapshotManagement
    Contains details about the Iceberg snapshot management settings for the table.
    storageClassConfiguration TableStorageClassConfiguration
    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.
    tableName string
    The name for the table.
    tags Tag[]
    User tags (key-value pairs) to associate with the table.
    withoutMetadata TableWithoutMetadata
    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 .
    namespace str
    The name of the namespace.
    open_table_format TableOpenTableFormat
    The format of the table.
    table_bucket_arn str
    The Amazon Resource Name (ARN) of the table bucket to create the table in.
    compaction TableCompactionArgs
    Contains details about the compaction settings for an Iceberg table.
    iceberg_metadata TableIcebergMetadataArgs
    Contains details about the metadata for an Iceberg table.
    snapshot_management TableSnapshotManagementArgs
    Contains details about the Iceberg snapshot management settings for the table.
    storage_class_configuration TableStorageClassConfigurationArgs
    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.
    table_name str
    The name for the table.
    tags Sequence[TagArgs]
    User tags (key-value pairs) to associate with the table.
    without_metadata TableWithoutMetadata
    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 .
    namespace String
    The name of the namespace.
    openTableFormat "ICEBERG"
    The format of the table.
    tableBucketArn String
    The Amazon Resource Name (ARN) of the table bucket to create the table in.
    compaction Property Map
    Contains details about the compaction settings for an Iceberg table.
    icebergMetadata Property Map
    Contains details about the metadata for an Iceberg table.
    snapshotManagement Property Map
    Contains details about the Iceberg snapshot management settings for the table.
    storageClassConfiguration Property Map
    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.
    tableName String
    The name for the table.
    tags List<Property Map>
    User tags (key-value pairs) to associate with the table.
    withoutMetadata "Yes"
    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 .

    Outputs

    All input properties are implicitly available as output properties. Additionally, the Table resource produces the following output properties:

    Id string
    The provider-assigned unique ID for this managed resource.
    TableArn string
    The Amazon Resource Name (ARN) of the table.
    VersionToken string
    The version token of the table.
    WarehouseLocation string
    The warehouse location of the table.
    Id string
    The provider-assigned unique ID for this managed resource.
    TableArn string
    The Amazon Resource Name (ARN) of the table.
    VersionToken string
    The version token of the table.
    WarehouseLocation string
    The warehouse location of the table.
    id String
    The provider-assigned unique ID for this managed resource.
    tableArn String
    The Amazon Resource Name (ARN) of the table.
    versionToken String
    The version token of the table.
    warehouseLocation String
    The warehouse location of the table.
    id string
    The provider-assigned unique ID for this managed resource.
    tableArn string
    The Amazon Resource Name (ARN) of the table.
    versionToken string
    The version token of the table.
    warehouseLocation string
    The warehouse location of the table.
    id str
    The provider-assigned unique ID for this managed resource.
    table_arn str
    The Amazon Resource Name (ARN) of the table.
    version_token str
    The version token of the table.
    warehouse_location str
    The warehouse location of the table.
    id String
    The provider-assigned unique ID for this managed resource.
    tableArn String
    The Amazon Resource Name (ARN) of the table.
    versionToken String
    The version token of the table.
    warehouseLocation String
    The warehouse location of the table.

    Supporting Types

    TableCompaction, TableCompactionArgs

    Settings governing the Compaction maintenance action. Contains details about the compaction settings for an Iceberg table.
    Status Pulumi.AwsNative.S3Tables.TableCompactionStatus
    Indicates whether the Compaction maintenance action is enabled.
    TargetFileSizeMb int
    The target file size for the table in MB.
    Status TableCompactionStatus
    Indicates whether the Compaction maintenance action is enabled.
    TargetFileSizeMb int
    The target file size for the table in MB.
    status TableCompactionStatus
    Indicates whether the Compaction maintenance action is enabled.
    targetFileSizeMb Integer
    The target file size for the table in MB.
    status TableCompactionStatus
    Indicates whether the Compaction maintenance action is enabled.
    targetFileSizeMb number
    The target file size for the table in MB.
    status TableCompactionStatus
    Indicates whether the Compaction maintenance action is enabled.
    target_file_size_mb int
    The target file size for the table in MB.
    status "enabled" | "disabled"
    Indicates whether the Compaction maintenance action is enabled.
    targetFileSizeMb Number
    The target file size for the table in MB.

    TableCompactionStatus, TableCompactionStatusArgs

    Enabled
    enabled
    Disabled
    disabled
    TableCompactionStatusEnabled
    enabled
    TableCompactionStatusDisabled
    disabled
    Enabled
    enabled
    Disabled
    disabled
    Enabled
    enabled
    Disabled
    disabled
    ENABLED
    enabled
    DISABLED
    disabled
    "enabled"
    enabled
    "disabled"
    disabled

    TableIcebergMetadata, TableIcebergMetadataArgs

    Contains details about the metadata for an Iceberg table.

    TableIcebergPartitionField, TableIcebergPartitionFieldArgs

    A partition field specification for an Iceberg table
    Name string
    The name of the partition field
    SourceId int
    The source column ID to partition on
    Transform string
    The partition transform function (identity, bucket[N], truncate[N], year, month, day, hour)
    FieldId int
    The partition field ID (auto-assigned starting from 1000 if not specified)
    Name string
    The name of the partition field
    SourceId int
    The source column ID to partition on
    Transform string
    The partition transform function (identity, bucket[N], truncate[N], year, month, day, hour)
    FieldId int
    The partition field ID (auto-assigned starting from 1000 if not specified)
    name String
    The name of the partition field
    sourceId Integer
    The source column ID to partition on
    transform String
    The partition transform function (identity, bucket[N], truncate[N], year, month, day, hour)
    fieldId Integer
    The partition field ID (auto-assigned starting from 1000 if not specified)
    name string
    The name of the partition field
    sourceId number
    The source column ID to partition on
    transform string
    The partition transform function (identity, bucket[N], truncate[N], year, month, day, hour)
    fieldId number
    The partition field ID (auto-assigned starting from 1000 if not specified)
    name str
    The name of the partition field
    source_id int
    The source column ID to partition on
    transform str
    The partition transform function (identity, bucket[N], truncate[N], year, month, day, hour)
    field_id int
    The partition field ID (auto-assigned starting from 1000 if not specified)
    name String
    The name of the partition field
    sourceId Number
    The source column ID to partition on
    transform String
    The partition transform function (identity, bucket[N], truncate[N], year, month, day, hour)
    fieldId Number
    The partition field ID (auto-assigned starting from 1000 if not specified)

    TableIcebergPartitionSpec, TableIcebergPartitionSpecArgs

    Partition specification for an Iceberg table
    Fields List<Pulumi.AwsNative.S3Tables.Inputs.TableIcebergPartitionField>
    List of partition fields
    SpecId int
    The partition spec ID (defaults to 0 if not specified)
    Fields []TableIcebergPartitionField
    List of partition fields
    SpecId int
    The partition spec ID (defaults to 0 if not specified)
    fields List<TableIcebergPartitionField>
    List of partition fields
    specId Integer
    The partition spec ID (defaults to 0 if not specified)
    fields TableIcebergPartitionField[]
    List of partition fields
    specId number
    The partition spec ID (defaults to 0 if not specified)
    fields Sequence[TableIcebergPartitionField]
    List of partition fields
    spec_id int
    The partition spec ID (defaults to 0 if not specified)
    fields List<Property Map>
    List of partition fields
    specId Number
    The partition spec ID (defaults to 0 if not specified)

    TableIcebergSchema, TableIcebergSchemaArgs

    Contains details about the schema for an Iceberg table
    SchemaFieldList []TableSchemaField
    The schema fields for the table
    schemaFieldList List<TableSchemaField>
    The schema fields for the table
    schemaFieldList TableSchemaField[]
    The schema fields for the table
    schema_field_list Sequence[TableSchemaField]
    The schema fields for the table
    schemaFieldList List<Property Map>
    The schema fields for the table

    TableIcebergSortField, TableIcebergSortFieldArgs

    A sort field specification for an Iceberg table
    Direction Pulumi.AwsNative.S3Tables.TableIcebergSortFieldDirection
    Sort direction (asc or desc)
    NullOrder Pulumi.AwsNative.S3Tables.TableIcebergSortFieldNullOrder
    Null value ordering (nulls-first or nulls-last)
    SourceId int
    The source column ID to sort on
    Transform string
    The sort transform function
    Direction TableIcebergSortFieldDirection
    Sort direction (asc or desc)
    NullOrder TableIcebergSortFieldNullOrder
    Null value ordering (nulls-first or nulls-last)
    SourceId int
    The source column ID to sort on
    Transform string
    The sort transform function
    direction TableIcebergSortFieldDirection
    Sort direction (asc or desc)
    nullOrder TableIcebergSortFieldNullOrder
    Null value ordering (nulls-first or nulls-last)
    sourceId Integer
    The source column ID to sort on
    transform String
    The sort transform function
    direction TableIcebergSortFieldDirection
    Sort direction (asc or desc)
    nullOrder TableIcebergSortFieldNullOrder
    Null value ordering (nulls-first or nulls-last)
    sourceId number
    The source column ID to sort on
    transform string
    The sort transform function
    direction TableIcebergSortFieldDirection
    Sort direction (asc or desc)
    null_order TableIcebergSortFieldNullOrder
    Null value ordering (nulls-first or nulls-last)
    source_id int
    The source column ID to sort on
    transform str
    The sort transform function
    direction "asc" | "desc"
    Sort direction (asc or desc)
    nullOrder "nulls-first" | "nulls-last"
    Null value ordering (nulls-first or nulls-last)
    sourceId Number
    The source column ID to sort on
    transform String
    The sort transform function

    TableIcebergSortFieldDirection, TableIcebergSortFieldDirectionArgs

    Asc
    asc
    Desc
    desc
    TableIcebergSortFieldDirectionAsc
    asc
    TableIcebergSortFieldDirectionDesc
    desc
    Asc
    asc
    Desc
    desc
    Asc
    asc
    Desc
    desc
    ASC
    asc
    DESC
    desc
    "asc"
    asc
    "desc"
    desc

    TableIcebergSortFieldNullOrder, TableIcebergSortFieldNullOrderArgs

    NullsFirst
    nulls-first
    NullsLast
    nulls-last
    TableIcebergSortFieldNullOrderNullsFirst
    nulls-first
    TableIcebergSortFieldNullOrderNullsLast
    nulls-last
    NullsFirst
    nulls-first
    NullsLast
    nulls-last
    NullsFirst
    nulls-first
    NullsLast
    nulls-last
    NULLS_FIRST
    nulls-first
    NULLS_LAST
    nulls-last
    "nulls-first"
    nulls-first
    "nulls-last"
    nulls-last

    TableIcebergSortOrder, TableIcebergSortOrderArgs

    Sort order specification for an Iceberg table
    Fields List<Pulumi.AwsNative.S3Tables.Inputs.TableIcebergSortField>
    List of sort fields
    OrderId int
    The sort order ID (defaults to 1 if not specified, 0 is reserved for unsorted)
    Fields []TableIcebergSortField
    List of sort fields
    OrderId int
    The sort order ID (defaults to 1 if not specified, 0 is reserved for unsorted)
    fields List<TableIcebergSortField>
    List of sort fields
    orderId Integer
    The sort order ID (defaults to 1 if not specified, 0 is reserved for unsorted)
    fields TableIcebergSortField[]
    List of sort fields
    orderId number
    The sort order ID (defaults to 1 if not specified, 0 is reserved for unsorted)
    fields Sequence[TableIcebergSortField]
    List of sort fields
    order_id int
    The sort order ID (defaults to 1 if not specified, 0 is reserved for unsorted)
    fields List<Property Map>
    List of sort fields
    orderId Number
    The sort order ID (defaults to 1 if not specified, 0 is reserved for unsorted)

    TableOpenTableFormat, TableOpenTableFormatArgs

    Iceberg
    ICEBERG
    TableOpenTableFormatIceberg
    ICEBERG
    Iceberg
    ICEBERG
    Iceberg
    ICEBERG
    ICEBERG
    ICEBERG
    "ICEBERG"
    ICEBERG

    TableSchemaField, TableSchemaFieldArgs

    Contains details about the schema for an Iceberg table
    Name string
    The name of the field
    Type string
    The field type
    Id int
    The unique identifier for the field
    Required bool
    A Boolean value that specifies whether values are required for each row in this field
    Name string
    The name of the field
    Type string
    The field type
    Id int
    The unique identifier for the field
    Required bool
    A Boolean value that specifies whether values are required for each row in this field
    name String
    The name of the field
    type String
    The field type
    id Integer
    The unique identifier for the field
    required Boolean
    A Boolean value that specifies whether values are required for each row in this field
    name string
    The name of the field
    type string
    The field type
    id number
    The unique identifier for the field
    required boolean
    A Boolean value that specifies whether values are required for each row in this field
    name str
    The name of the field
    type str
    The field type
    id int
    The unique identifier for the field
    required bool
    A Boolean value that specifies whether values are required for each row in this field
    name String
    The name of the field
    type String
    The field type
    id Number
    The unique identifier for the field
    required Boolean
    A Boolean value that specifies whether values are required for each row in this field

    TableSnapshotManagement, TableSnapshotManagementArgs

    Contains details about the snapshot management settings for an Iceberg table. A snapshot is expired when it exceeds MinSnapshotsToKeep and MaxSnapshotAgeHours.
    MaxSnapshotAgeHours int
    The maximum age of a snapshot before it can be expired.
    MinSnapshotsToKeep int
    The minimum number of snapshots to keep.
    Status Pulumi.AwsNative.S3Tables.TableSnapshotManagementStatus
    Indicates whether the SnapshotManagement maintenance action is enabled.
    MaxSnapshotAgeHours int
    The maximum age of a snapshot before it can be expired.
    MinSnapshotsToKeep int
    The minimum number of snapshots to keep.
    Status TableSnapshotManagementStatus
    Indicates whether the SnapshotManagement maintenance action is enabled.
    maxSnapshotAgeHours Integer
    The maximum age of a snapshot before it can be expired.
    minSnapshotsToKeep Integer
    The minimum number of snapshots to keep.
    status TableSnapshotManagementStatus
    Indicates whether the SnapshotManagement maintenance action is enabled.
    maxSnapshotAgeHours number
    The maximum age of a snapshot before it can be expired.
    minSnapshotsToKeep number
    The minimum number of snapshots to keep.
    status TableSnapshotManagementStatus
    Indicates whether the SnapshotManagement maintenance action is enabled.
    max_snapshot_age_hours int
    The maximum age of a snapshot before it can be expired.
    min_snapshots_to_keep int
    The minimum number of snapshots to keep.
    status TableSnapshotManagementStatus
    Indicates whether the SnapshotManagement maintenance action is enabled.
    maxSnapshotAgeHours Number
    The maximum age of a snapshot before it can be expired.
    minSnapshotsToKeep Number
    The minimum number of snapshots to keep.
    status "enabled" | "disabled"
    Indicates whether the SnapshotManagement maintenance action is enabled.

    TableSnapshotManagementStatus, TableSnapshotManagementStatusArgs

    Enabled
    enabled
    Disabled
    disabled
    TableSnapshotManagementStatusEnabled
    enabled
    TableSnapshotManagementStatusDisabled
    disabled
    Enabled
    enabled
    Disabled
    disabled
    Enabled
    enabled
    Disabled
    disabled
    ENABLED
    enabled
    DISABLED
    disabled
    "enabled"
    enabled
    "disabled"
    disabled

    TableStorageClassConfiguration, TableStorageClassConfigurationArgs

    Specifies storage class settings for the table
    storageClass "STANDARD" | "INTELLIGENT_TIERING"
    The storage class for the table

    TableStorageClassConfigurationStorageClass, TableStorageClassConfigurationStorageClassArgs

    Standard
    STANDARD
    IntelligentTiering
    INTELLIGENT_TIERING
    TableStorageClassConfigurationStorageClassStandard
    STANDARD
    TableStorageClassConfigurationStorageClassIntelligentTiering
    INTELLIGENT_TIERING
    Standard
    STANDARD
    IntelligentTiering
    INTELLIGENT_TIERING
    Standard
    STANDARD
    IntelligentTiering
    INTELLIGENT_TIERING
    STANDARD
    STANDARD
    INTELLIGENT_TIERING
    INTELLIGENT_TIERING
    "STANDARD"
    STANDARD
    "INTELLIGENT_TIERING"
    INTELLIGENT_TIERING

    TableWithoutMetadata, TableWithoutMetadataArgs

    Yes
    Yes
    TableWithoutMetadataYes
    Yes
    Yes
    Yes
    Yes
    Yes
    YES
    Yes
    "Yes"
    Yes

    Tag, TagArgs

    A set of tags to apply to the resource.
    Key string
    The key name of the tag
    Value string
    The value of the tag
    Key string
    The key name of the tag
    Value string
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag
    key string
    The key name of the tag
    value string
    The value of the tag
    key str
    The key name of the tag
    value str
    The value of the tag
    key String
    The key name of the tag
    value String
    The value of the tag

    Package Details

    Repository
    AWS Native pulumi/pulumi-aws-native
    License
    Apache-2.0
    aws-native logo

    We recommend new projects start with resources from the AWS provider.

    AWS Cloud Control v1.54.0 published on Monday, Feb 16, 2026 by Pulumi
      Meet Neo: Your AI Platform Teammate