Docs Home Pulumi IaC Pulumi ESC Pulumi Cloud Packages Tutorials
  1. Packages
  2. AWS
  3. API Docs
  4. s3tables
  5. Table
AWS v6.74.0 published on Wednesday, Mar 26, 2025 by Pulumi
pulumi/pulumi-aws

aws.s3tables.Table

Explore with Pulumi AI

aws logo
AWS v6.74.0 published on Wednesday, Mar 26, 2025 by Pulumi
pulumi/pulumi-aws

    Resource for managing an Amazon S3 Tables Table.

    Example Usage

    Basic Usage

    import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const exampleTableBucket = new aws.s3tables.TableBucket("example", {name: "example-bucket"});
const exampleNamespace = new aws.s3tables.Namespace("example", {
    namespace: "example-namespace",
    tableBucketArn: exampleTableBucket.arn,
});
const example = new aws.s3tables.Table("example", {
    name: "example-table",
    namespace: exampleNamespace.namespace,
    tableBucketArn: exampleNamespace.tableBucketArn,
    format: "ICEBERG",
});

    import pulumi
import pulumi_aws as aws

example_table_bucket = aws.s3tables.TableBucket("example", name="example-bucket")
example_namespace = aws.s3tables.Namespace("example",
    namespace="example-namespace",
    table_bucket_arn=example_table_bucket.arn)
example = aws.s3tables.Table("example",
    name="example-table",
    namespace=example_namespace.namespace,
    table_bucket_arn=example_namespace.table_bucket_arn,
    format="ICEBERG")

    package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v6/go/aws/s3tables"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		exampleTableBucket, err := s3tables.NewTableBucket(ctx, "example", &s3tables.TableBucketArgs{
			Name: pulumi.String("example-bucket"),
		})
		if err != nil {
			return err
		}
		exampleNamespace, err := s3tables.NewNamespace(ctx, "example", &s3tables.NamespaceArgs{
			Namespace:      pulumi.String("example-namespace"),
			TableBucketArn: exampleTableBucket.Arn,
		})
		if err != nil {
			return err
		}
		_, err = s3tables.NewTable(ctx, "example", &s3tables.TableArgs{
			Name:           pulumi.String("example-table"),
			Namespace:      exampleNamespace.Namespace,
			TableBucketArn: exampleNamespace.TableBucketArn,
			Format:         pulumi.String("ICEBERG"),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

    using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() => 
{
    var exampleTableBucket = new Aws.S3Tables.TableBucket("example", new()
    {
        Name = "example-bucket",
    });

    var exampleNamespace = new Aws.S3Tables.Namespace("example", new()
    {
        NameSpace = "example-namespace",
        TableBucketArn = exampleTableBucket.Arn,
    });

    var example = new Aws.S3Tables.Table("example", new()
    {
        Name = "example-table",
        Namespace = exampleNamespace.NameSpace,
        TableBucketArn = exampleNamespace.TableBucketArn,
        Format = "ICEBERG",
    });

});

    package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.s3tables.TableBucket;
import com.pulumi.aws.s3tables.TableBucketArgs;
import com.pulumi.aws.s3tables.Namespace;
import com.pulumi.aws.s3tables.NamespaceArgs;
import com.pulumi.aws.s3tables.Table;
import com.pulumi.aws.s3tables.TableArgs;
import java.util.List;
import java.util.ArrayList;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var exampleTableBucket = new TableBucket("exampleTableBucket", TableBucketArgs.builder()
            .name("example-bucket")
            .build());

        var exampleNamespace = new Namespace("exampleNamespace", NamespaceArgs.builder()
            .namespace("example-namespace")
            .tableBucketArn(exampleTableBucket.arn())
            .build());

        var example = new Table("example", TableArgs.builder()
            .name("example-table")
            .namespace(exampleNamespace.namespace())
            .tableBucketArn(exampleNamespace.tableBucketArn())
            .format("ICEBERG")
            .build());

    }
}

    resources:
  example:
    type: aws:s3tables:Table
    properties:
      name: example-table
      namespace: ${exampleNamespace.namespace}
      tableBucketArn: ${exampleNamespace.tableBucketArn}
      format: ICEBERG
  exampleNamespace:
    type: aws:s3tables:Namespace
    name: example
    properties:
      namespace: example-namespace
      tableBucketArn: ${exampleTableBucket.arn}
  exampleTableBucket:
    type: aws:s3tables:TableBucket
    name: example
    properties:
      name: example-bucket

    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,
          format: Optional[str] = None,
          namespace: Optional[str] = None,
          table_bucket_arn: Optional[str] = None,
          maintenance_configuration: Optional[TableMaintenanceConfigurationArgs] = None,
          name: Optional[str] = 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: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.

    Constructor example

    The following reference example uses placeholder values for all input properties.

    var exampletableResourceResourceFromS3tablestable = new Aws.S3Tables.Table("exampletableResourceResourceFromS3tablestable", new()
{
    Format = "string",
    Namespace = "string",
    TableBucketArn = "string",
    MaintenanceConfiguration = new Aws.S3Tables.Inputs.TableMaintenanceConfigurationArgs
    {
        IcebergCompaction = new Aws.S3Tables.Inputs.TableMaintenanceConfigurationIcebergCompactionArgs
        {
            Settings = new Aws.S3Tables.Inputs.TableMaintenanceConfigurationIcebergCompactionSettingsArgs
            {
                TargetFileSizeMb = 0,
            },
            Status = "string",
        },
        IcebergSnapshotManagement = new Aws.S3Tables.Inputs.TableMaintenanceConfigurationIcebergSnapshotManagementArgs
        {
            Settings = new Aws.S3Tables.Inputs.TableMaintenanceConfigurationIcebergSnapshotManagementSettingsArgs
            {
                MaxSnapshotAgeHours = 0,
                MinSnapshotsToKeep = 0,
            },
            Status = "string",
        },
    },
    Name = "string",
});

    example, err := s3tables.NewTable(ctx, "exampletableResourceResourceFromS3tablestable", &s3tables.TableArgs{
	Format:         pulumi.String("string"),
	Namespace:      pulumi.String("string"),
	TableBucketArn: pulumi.String("string"),
	MaintenanceConfiguration: &s3tables.TableMaintenanceConfigurationArgs{
		IcebergCompaction: &s3tables.TableMaintenanceConfigurationIcebergCompactionArgs{
			Settings: &s3tables.TableMaintenanceConfigurationIcebergCompactionSettingsArgs{
				TargetFileSizeMb: pulumi.Int(0),
			},
			Status: pulumi.String("string"),
		},
		IcebergSnapshotManagement: &s3tables.TableMaintenanceConfigurationIcebergSnapshotManagementArgs{
			Settings: &s3tables.TableMaintenanceConfigurationIcebergSnapshotManagementSettingsArgs{
				MaxSnapshotAgeHours: pulumi.Int(0),
				MinSnapshotsToKeep:  pulumi.Int(0),
			},
			Status: pulumi.String("string"),
		},
	},
	Name: pulumi.String("string"),
})

    var exampletableResourceResourceFromS3tablestable = new Table("exampletableResourceResourceFromS3tablestable", TableArgs.builder()
    .format("string")
    .namespace("string")
    .tableBucketArn("string")
    .maintenanceConfiguration(TableMaintenanceConfigurationArgs.builder()
        .icebergCompaction(TableMaintenanceConfigurationIcebergCompactionArgs.builder()
            .settings(TableMaintenanceConfigurationIcebergCompactionSettingsArgs.builder()
                .targetFileSizeMb(0)
                .build())
            .status("string")
            .build())
        .icebergSnapshotManagement(TableMaintenanceConfigurationIcebergSnapshotManagementArgs.builder()
            .settings(TableMaintenanceConfigurationIcebergSnapshotManagementSettingsArgs.builder()
                .maxSnapshotAgeHours(0)
                .minSnapshotsToKeep(0)
                .build())
            .status("string")
            .build())
        .build())
    .name("string")
    .build());

    exampletable_resource_resource_from_s3tablestable = aws.s3tables.Table("exampletableResourceResourceFromS3tablestable",
    format="string",
    namespace="string",
    table_bucket_arn="string",
    maintenance_configuration={
        "iceberg_compaction": {
            "settings": {
                "target_file_size_mb": 0,
            },
            "status": "string",
        },
        "iceberg_snapshot_management": {
            "settings": {
                "max_snapshot_age_hours": 0,
                "min_snapshots_to_keep": 0,
            },
            "status": "string",
        },
    },
    name="string")

    const exampletableResourceResourceFromS3tablestable = new aws.s3tables.Table("exampletableResourceResourceFromS3tablestable", {
    format: "string",
    namespace: "string",
    tableBucketArn: "string",
    maintenanceConfiguration: {
        icebergCompaction: {
            settings: {
                targetFileSizeMb: 0,
            },
            status: "string",
        },
        icebergSnapshotManagement: {
            settings: {
                maxSnapshotAgeHours: 0,
                minSnapshotsToKeep: 0,
            },
            status: "string",
        },
    },
    name: "string",
});

    type: aws:s3tables:Table
properties:
    format: string
    maintenanceConfiguration:
        icebergCompaction:
            settings:
                targetFileSizeMb: 0
            status: string
        icebergSnapshotManagement:
            settings:
                maxSnapshotAgeHours: 0
                minSnapshotsToKeep: 0
            status: string
    name: string
    namespace: string
    tableBucketArn: string

    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:

    Format string
    Format of the table. Must be ICEBERG.
    Namespace string
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    TableBucketArn string

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    MaintenanceConfiguration TableMaintenanceConfiguration
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    Name string
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    Format string
    Format of the table. Must be ICEBERG.
    Namespace string
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    TableBucketArn string

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    MaintenanceConfiguration TableMaintenanceConfigurationArgs
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    Name string
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    format String
    Format of the table. Must be ICEBERG.
    namespace String
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    tableBucketArn String

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    maintenanceConfiguration TableMaintenanceConfiguration
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    name String
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    format string
    Format of the table. Must be ICEBERG.
    namespace string
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    tableBucketArn string

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    maintenanceConfiguration TableMaintenanceConfiguration
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    name string
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    format str
    Format of the table. Must be ICEBERG.
    namespace str
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    table_bucket_arn str

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    maintenance_configuration TableMaintenanceConfigurationArgs
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    name str
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    format String
    Format of the table. Must be ICEBERG.
    namespace String
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    tableBucketArn String

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    maintenanceConfiguration Property Map
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    name String
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.

    Outputs

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

    Arn string
    ARN of the table.
    CreatedAt string
    Date and time when the namespace was created.
    CreatedBy string
    Account ID of the account that created the namespace.
    Id string
    The provider-assigned unique ID for this managed resource.
    MetadataLocation string
    Location of table metadata.
    ModifiedAt string
    Date and time when the namespace was last modified.
    ModifiedBy string
    Account ID of the account that last modified the namespace.
    OwnerAccountId string
    Account ID of the account that owns the namespace.
    Type string
    Type of the table. One of customer or aws.
    VersionToken string
    Identifier for the current version of table data.
    WarehouseLocation string
    S3 URI pointing to the S3 Bucket that contains the table data.
    Arn string
    ARN of the table.
    CreatedAt string
    Date and time when the namespace was created.
    CreatedBy string
    Account ID of the account that created the namespace.
    Id string
    The provider-assigned unique ID for this managed resource.
    MetadataLocation string
    Location of table metadata.
    ModifiedAt string
    Date and time when the namespace was last modified.
    ModifiedBy string
    Account ID of the account that last modified the namespace.
    OwnerAccountId string
    Account ID of the account that owns the namespace.
    Type string
    Type of the table. One of customer or aws.
    VersionToken string
    Identifier for the current version of table data.
    WarehouseLocation string
    S3 URI pointing to the S3 Bucket that contains the table data.
    arn String
    ARN of the table.
    createdAt String
    Date and time when the namespace was created.
    createdBy String
    Account ID of the account that created the namespace.
    id String
    The provider-assigned unique ID for this managed resource.
    metadataLocation String
    Location of table metadata.
    modifiedAt String
    Date and time when the namespace was last modified.
    modifiedBy String
    Account ID of the account that last modified the namespace.
    ownerAccountId String
    Account ID of the account that owns the namespace.
    type String
    Type of the table. One of customer or aws.
    versionToken String
    Identifier for the current version of table data.
    warehouseLocation String
    S3 URI pointing to the S3 Bucket that contains the table data.
    arn string
    ARN of the table.
    createdAt string
    Date and time when the namespace was created.
    createdBy string
    Account ID of the account that created the namespace.
    id string
    The provider-assigned unique ID for this managed resource.
    metadataLocation string
    Location of table metadata.
    modifiedAt string
    Date and time when the namespace was last modified.
    modifiedBy string
    Account ID of the account that last modified the namespace.
    ownerAccountId string
    Account ID of the account that owns the namespace.
    type string
    Type of the table. One of customer or aws.
    versionToken string
    Identifier for the current version of table data.
    warehouseLocation string
    S3 URI pointing to the S3 Bucket that contains the table data.
    arn str
    ARN of the table.
    created_at str
    Date and time when the namespace was created.
    created_by str
    Account ID of the account that created the namespace.
    id str
    The provider-assigned unique ID for this managed resource.
    metadata_location str
    Location of table metadata.
    modified_at str
    Date and time when the namespace was last modified.
    modified_by str
    Account ID of the account that last modified the namespace.
    owner_account_id str
    Account ID of the account that owns the namespace.
    type str
    Type of the table. One of customer or aws.
    version_token str
    Identifier for the current version of table data.
    warehouse_location str
    S3 URI pointing to the S3 Bucket that contains the table data.
    arn String
    ARN of the table.
    createdAt String
    Date and time when the namespace was created.
    createdBy String
    Account ID of the account that created the namespace.
    id String
    The provider-assigned unique ID for this managed resource.
    metadataLocation String
    Location of table metadata.
    modifiedAt String
    Date and time when the namespace was last modified.
    modifiedBy String
    Account ID of the account that last modified the namespace.
    ownerAccountId String
    Account ID of the account that owns the namespace.
    type String
    Type of the table. One of customer or aws.
    versionToken String
    Identifier for the current version of table data.
    warehouseLocation String
    S3 URI pointing to the S3 Bucket that contains the table data.

    Look up Existing Table Resource

    Get an existing Table resource’s state with the given name, ID, and optional extra properties used to qualify the lookup.

    public static get(name: string, id: Input<ID>, state?: TableState, opts?: CustomResourceOptions): Table
    @staticmethod
def get(resource_name: str,
        id: str,
        opts: Optional[ResourceOptions] = None,
        arn: Optional[str] = None,
        created_at: Optional[str] = None,
        created_by: Optional[str] = None,
        format: Optional[str] = None,
        maintenance_configuration: Optional[TableMaintenanceConfigurationArgs] = None,
        metadata_location: Optional[str] = None,
        modified_at: Optional[str] = None,
        modified_by: Optional[str] = None,
        name: Optional[str] = None,
        namespace: Optional[str] = None,
        owner_account_id: Optional[str] = None,
        table_bucket_arn: Optional[str] = None,
        type: Optional[str] = None,
        version_token: Optional[str] = None,
        warehouse_location: Optional[str] = None) -> Table
    func GetTable(ctx *Context, name string, id IDInput, state *TableState, opts ...ResourceOption) (*Table, error)
    public static Table Get(string name, Input<string> id, TableState? state, CustomResourceOptions? opts = null)
    public static Table get(String name, Output<String> id, TableState state, CustomResourceOptions options)
    resources:  _:    type: aws:s3tables:Table    get:      id: ${id}
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    resource_name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    name
    The unique name of the resulting resource.
    id
    The unique provider ID of the resource to lookup.
    state
    Any extra arguments used during the lookup.
    opts
    A bag of options that control this resource's behavior.
    The following state arguments are supported:
    Arn string
    ARN of the table.
    CreatedAt string
    Date and time when the namespace was created.
    CreatedBy string
    Account ID of the account that created the namespace.
    Format string
    Format of the table. Must be ICEBERG.
    MaintenanceConfiguration TableMaintenanceConfiguration
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    MetadataLocation string
    Location of table metadata.
    ModifiedAt string
    Date and time when the namespace was last modified.
    ModifiedBy string
    Account ID of the account that last modified the namespace.
    Name string
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    Namespace string
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    OwnerAccountId string
    Account ID of the account that owns the namespace.
    TableBucketArn string

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    Type string
    Type of the table. One of customer or aws.
    VersionToken string
    Identifier for the current version of table data.
    WarehouseLocation string
    S3 URI pointing to the S3 Bucket that contains the table data.
    Arn string
    ARN of the table.
    CreatedAt string
    Date and time when the namespace was created.
    CreatedBy string
    Account ID of the account that created the namespace.
    Format string
    Format of the table. Must be ICEBERG.
    MaintenanceConfiguration TableMaintenanceConfigurationArgs
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    MetadataLocation string
    Location of table metadata.
    ModifiedAt string
    Date and time when the namespace was last modified.
    ModifiedBy string
    Account ID of the account that last modified the namespace.
    Name string
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    Namespace string
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    OwnerAccountId string
    Account ID of the account that owns the namespace.
    TableBucketArn string

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    Type string
    Type of the table. One of customer or aws.
    VersionToken string
    Identifier for the current version of table data.
    WarehouseLocation string
    S3 URI pointing to the S3 Bucket that contains the table data.
    arn String
    ARN of the table.
    createdAt String
    Date and time when the namespace was created.
    createdBy String
    Account ID of the account that created the namespace.
    format String
    Format of the table. Must be ICEBERG.
    maintenanceConfiguration TableMaintenanceConfiguration
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    metadataLocation String
    Location of table metadata.
    modifiedAt String
    Date and time when the namespace was last modified.
    modifiedBy String
    Account ID of the account that last modified the namespace.
    name String
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    namespace String
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    ownerAccountId String
    Account ID of the account that owns the namespace.
    tableBucketArn String

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    type String
    Type of the table. One of customer or aws.
    versionToken String
    Identifier for the current version of table data.
    warehouseLocation String
    S3 URI pointing to the S3 Bucket that contains the table data.
    arn string
    ARN of the table.
    createdAt string
    Date and time when the namespace was created.
    createdBy string
    Account ID of the account that created the namespace.
    format string
    Format of the table. Must be ICEBERG.
    maintenanceConfiguration TableMaintenanceConfiguration
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    metadataLocation string
    Location of table metadata.
    modifiedAt string
    Date and time when the namespace was last modified.
    modifiedBy string
    Account ID of the account that last modified the namespace.
    name string
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    namespace string
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    ownerAccountId string
    Account ID of the account that owns the namespace.
    tableBucketArn string

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    type string
    Type of the table. One of customer or aws.
    versionToken string
    Identifier for the current version of table data.
    warehouseLocation string
    S3 URI pointing to the S3 Bucket that contains the table data.
    arn str
    ARN of the table.
    created_at str
    Date and time when the namespace was created.
    created_by str
    Account ID of the account that created the namespace.
    format str
    Format of the table. Must be ICEBERG.
    maintenance_configuration TableMaintenanceConfigurationArgs
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    metadata_location str
    Location of table metadata.
    modified_at str
    Date and time when the namespace was last modified.
    modified_by str
    Account ID of the account that last modified the namespace.
    name str
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    namespace str
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    owner_account_id str
    Account ID of the account that owns the namespace.
    table_bucket_arn str

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    type str
    Type of the table. One of customer or aws.
    version_token str
    Identifier for the current version of table data.
    warehouse_location str
    S3 URI pointing to the S3 Bucket that contains the table data.
    arn String
    ARN of the table.
    createdAt String
    Date and time when the namespace was created.
    createdBy String
    Account ID of the account that created the namespace.
    format String
    Format of the table. Must be ICEBERG.
    maintenanceConfiguration Property Map
    A single table bucket maintenance configuration block. See maintenance_configuration below.
    metadataLocation String
    Location of table metadata.
    modifiedAt String
    Date and time when the namespace was last modified.
    modifiedBy String
    Account ID of the account that last modified the namespace.
    name String
    Name of the table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number. A full list of table naming rules can be found in the S3 Tables documentation.
    namespace String
    Name of the namespace for this table. Must be between 1 and 255 characters in length. Can consist of lowercase letters, numbers, and underscores, and must begin and end with a lowercase letter or number.
    ownerAccountId String
    Account ID of the account that owns the namespace.
    tableBucketArn String

    ARN referencing the Table Bucket that contains this Namespace.

    The following argument is optional:

    type String
    Type of the table. One of customer or aws.
    versionToken String
    Identifier for the current version of table data.
    warehouseLocation String
    S3 URI pointing to the S3 Bucket that contains the table data.

    Supporting Types

    TableMaintenanceConfiguration, TableMaintenanceConfigurationArgs

    IcebergCompaction TableMaintenanceConfigurationIcebergCompaction
    A single Iceberg compaction settings block. See iceberg_compaction below.
    IcebergSnapshotManagement TableMaintenanceConfigurationIcebergSnapshotManagement
    A single Iceberg snapshot management settings block. See iceberg_snapshot_management below.
    IcebergCompaction TableMaintenanceConfigurationIcebergCompaction
    A single Iceberg compaction settings block. See iceberg_compaction below.
    IcebergSnapshotManagement TableMaintenanceConfigurationIcebergSnapshotManagement
    A single Iceberg snapshot management settings block. See iceberg_snapshot_management below.
    icebergCompaction TableMaintenanceConfigurationIcebergCompaction
    A single Iceberg compaction settings block. See iceberg_compaction below.
    icebergSnapshotManagement TableMaintenanceConfigurationIcebergSnapshotManagement
    A single Iceberg snapshot management settings block. See iceberg_snapshot_management below.
    icebergCompaction TableMaintenanceConfigurationIcebergCompaction
    A single Iceberg compaction settings block. See iceberg_compaction below.
    icebergSnapshotManagement TableMaintenanceConfigurationIcebergSnapshotManagement
    A single Iceberg snapshot management settings block. See iceberg_snapshot_management below.
    iceberg_compaction TableMaintenanceConfigurationIcebergCompaction
    A single Iceberg compaction settings block. See iceberg_compaction below.
    iceberg_snapshot_management TableMaintenanceConfigurationIcebergSnapshotManagement
    A single Iceberg snapshot management settings block. See iceberg_snapshot_management below.
    icebergCompaction Property Map
    A single Iceberg compaction settings block. See iceberg_compaction below.
    icebergSnapshotManagement Property Map
    A single Iceberg snapshot management settings block. See iceberg_snapshot_management below.

    TableMaintenanceConfigurationIcebergCompaction, TableMaintenanceConfigurationIcebergCompactionArgs

    Settings TableMaintenanceConfigurationIcebergCompactionSettings
    Settings for compaction. See iceberg_compaction.settings below.
    Status string
    Whether the configuration is enabled. Valid values are enabled and disabled.
    Settings TableMaintenanceConfigurationIcebergCompactionSettings
    Settings for compaction. See iceberg_compaction.settings below.
    Status string
    Whether the configuration is enabled. Valid values are enabled and disabled.
    settings TableMaintenanceConfigurationIcebergCompactionSettings
    Settings for compaction. See iceberg_compaction.settings below.
    status String
    Whether the configuration is enabled. Valid values are enabled and disabled.
    settings TableMaintenanceConfigurationIcebergCompactionSettings
    Settings for compaction. See iceberg_compaction.settings below.
    status string
    Whether the configuration is enabled. Valid values are enabled and disabled.
    settings TableMaintenanceConfigurationIcebergCompactionSettings
    Settings for compaction. See iceberg_compaction.settings below.
    status str
    Whether the configuration is enabled. Valid values are enabled and disabled.
    settings Property Map
    Settings for compaction. See iceberg_compaction.settings below.
    status String
    Whether the configuration is enabled. Valid values are enabled and disabled.

    TableMaintenanceConfigurationIcebergCompactionSettings, TableMaintenanceConfigurationIcebergCompactionSettingsArgs

    TargetFileSizeMb int
    Data objects smaller than this size may be combined with others to improve query performance. Must be between 64 and 512.
    TargetFileSizeMb int
    Data objects smaller than this size may be combined with others to improve query performance. Must be between 64 and 512.
    targetFileSizeMb Integer
    Data objects smaller than this size may be combined with others to improve query performance. Must be between 64 and 512.
    targetFileSizeMb number
    Data objects smaller than this size may be combined with others to improve query performance. Must be between 64 and 512.
    target_file_size_mb int
    Data objects smaller than this size may be combined with others to improve query performance. Must be between 64 and 512.
    targetFileSizeMb Number
    Data objects smaller than this size may be combined with others to improve query performance. Must be between 64 and 512.

    TableMaintenanceConfigurationIcebergSnapshotManagement, TableMaintenanceConfigurationIcebergSnapshotManagementArgs

    Settings TableMaintenanceConfigurationIcebergSnapshotManagementSettings
    Settings for snapshot management. See iceberg_snapshot_management.settings below.
    Status string
    Whether the configuration is enabled. Valid values are enabled and disabled.
    Settings TableMaintenanceConfigurationIcebergSnapshotManagementSettings
    Settings for snapshot management. See iceberg_snapshot_management.settings below.
    Status string
    Whether the configuration is enabled. Valid values are enabled and disabled.
    settings TableMaintenanceConfigurationIcebergSnapshotManagementSettings
    Settings for snapshot management. See iceberg_snapshot_management.settings below.
    status String
    Whether the configuration is enabled. Valid values are enabled and disabled.
    settings TableMaintenanceConfigurationIcebergSnapshotManagementSettings
    Settings for snapshot management. See iceberg_snapshot_management.settings below.
    status string
    Whether the configuration is enabled. Valid values are enabled and disabled.
    settings TableMaintenanceConfigurationIcebergSnapshotManagementSettings
    Settings for snapshot management. See iceberg_snapshot_management.settings below.
    status str
    Whether the configuration is enabled. Valid values are enabled and disabled.
    settings Property Map
    Settings for snapshot management. See iceberg_snapshot_management.settings below.
    status String
    Whether the configuration is enabled. Valid values are enabled and disabled.

    TableMaintenanceConfigurationIcebergSnapshotManagementSettings, TableMaintenanceConfigurationIcebergSnapshotManagementSettingsArgs

    MaxSnapshotAgeHours int
    Snapshots older than this will be marked for deletiion. Must be at least 1.
    MinSnapshotsToKeep int
    Minimum number of snapshots to keep. Must be at least 1.
    MaxSnapshotAgeHours int
    Snapshots older than this will be marked for deletiion. Must be at least 1.
    MinSnapshotsToKeep int
    Minimum number of snapshots to keep. Must be at least 1.
    maxSnapshotAgeHours Integer
    Snapshots older than this will be marked for deletiion. Must be at least 1.
    minSnapshotsToKeep Integer
    Minimum number of snapshots to keep. Must be at least 1.
    maxSnapshotAgeHours number
    Snapshots older than this will be marked for deletiion. Must be at least 1.
    minSnapshotsToKeep number
    Minimum number of snapshots to keep. Must be at least 1.
    max_snapshot_age_hours int
    Snapshots older than this will be marked for deletiion. Must be at least 1.
    min_snapshots_to_keep int
    Minimum number of snapshots to keep. Must be at least 1.
    maxSnapshotAgeHours Number
    Snapshots older than this will be marked for deletiion. Must be at least 1.
    minSnapshotsToKeep Number
    Minimum number of snapshots to keep. Must be at least 1.

    Import

    Using pulumi import, import S3 Tables Table using the table_bucket_arn, the value of namespace, and the value of name, separated by a semicolon (;). For example:

    $ pulumi import aws:s3tables/table:Table example 'arn:aws:s3tables:us-west-2:123456789012:bucket/example-bucket;example-namespace;example-table'

    To learn more about importing existing cloud resources, see Importing resources.

    Package Details

    Repository
    AWS Classic pulumi/pulumi-aws
    License
    Apache-2.0
    Notes
    This Pulumi package is based on the aws Terraform Provider.
    aws logo
    AWS v6.74.0 published on Wednesday, Mar 26, 2025 by Pulumi
    pulumi/pulumi-aws