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.36.0 published on Friday, Oct 3, 2025 by Pulumi

aws-native.s3tables.Table

Explore with Pulumi AI

aws-native logo

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

AWS Cloud Control v1.36.0 published on Friday, Oct 3, 2025 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,
              table_name: Optional[str] = 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.
    TableName string
    The name for 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.
    TableName string
    The name for 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.
    tableName String
    The name for 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.
    tableName string
    The name for 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.
    table_name str
    The name for 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.
    tableName String
    The name for 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

    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

    IcebergSchema TableIcebergSchema
    The schema for an Iceberg table.
    icebergSchema TableIcebergSchema
    The schema for an Iceberg table.
    icebergSchema TableIcebergSchema
    The schema for an Iceberg table.
    iceberg_schema TableIcebergSchema
    The schema for an Iceberg table.
    icebergSchema Property Map
    The schema for an Iceberg table.

    TableIcebergSchema, TableIcebergSchemaArgs

    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

    TableOpenTableFormat, TableOpenTableFormatArgs

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

    TableSchemaField, TableSchemaFieldArgs

    Name string
    The name of the field
    Type string
    The field type
    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
    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
    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
    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
    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
    required Boolean
    A Boolean value that specifies whether values are required for each row in this field

    TableSnapshotManagement, TableSnapshotManagementArgs

    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

    TableWithoutMetadata, TableWithoutMetadataArgs

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

    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.36.0 published on Friday, Oct 3, 2025 by Pulumi
      AI Agentic Workflows: Register now