AWS Native v0.102.0, Apr 16 24

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.102.0 published on Tuesday, Apr 16, 2024 by Pulumi

pulumi/pulumi-aws-native

aws-native.dynamodb.Table

Explore with Pulumi AI

AWS Native is in preview. AWS Classic is fully supported.

AWS Native v0.102.0 published on Tuesday, Apr 16, 2024 by Pulumi

pulumi/pulumi-aws-native

CFNlong typically creates DDB tables in parallel. However, if your template includes multiple DDB tables with indexes, you must declare dependencies so that the tables are created sequentially. DDBlong limits the number of tables with secondary indexes that are in the creating state. If you create multiple tables with indexes at the same time, DDB returns an error and the stack operation fails. For an example, see DynamoDB Table with a DependsOn Attribute.

Our guidance is to use the latest schema documented here for your CFNlong templates. This schema supports the provisioning of all table settings below. When using this schema in your CFNlong templates, please ensure that your Identity and Access Management (IAM) policies are updated with appropriate permissions to allow for the authorization of these setting changes.

Example Usage

Example

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

return await Deployment.RunAsync(() => 
{
    var myDynamoDBTable = new AwsNative.DynamoDb.Table("myDynamoDBTable", new()
    {
        AttributeDefinitions = new[]
        {
            new AwsNative.DynamoDb.Inputs.TableAttributeDefinitionArgs
            {
                AttributeName = "Album",
                AttributeType = "S",
            },
            new AwsNative.DynamoDb.Inputs.TableAttributeDefinitionArgs
            {
                AttributeName = "Artist",
                AttributeType = "S",
            },
            new AwsNative.DynamoDb.Inputs.TableAttributeDefinitionArgs
            {
                AttributeName = "Sales",
                AttributeType = "N",
            },
            new AwsNative.DynamoDb.Inputs.TableAttributeDefinitionArgs
            {
                AttributeName = "NumberOfSongs",
                AttributeType = "N",
            },
        },
        KeySchema = new[]
        {
            new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
            {
                AttributeName = "Album",
                KeyType = "HASH",
            },
            new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
            {
                AttributeName = "Artist",
                KeyType = "RANGE",
            },
        },
        ProvisionedThroughput = new AwsNative.DynamoDb.Inputs.TableProvisionedThroughputArgs
        {
            ReadCapacityUnits = 5,
            WriteCapacityUnits = 5,
        },
        TableName = "myTableName",
        GlobalSecondaryIndexes = new[]
        {
            new AwsNative.DynamoDb.Inputs.TableGlobalSecondaryIndexArgs
            {
                IndexName = "myGSI",
                KeySchema = new[]
                {
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Sales",
                        KeyType = "HASH",
                    },
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Artist",
                        KeyType = "RANGE",
                    },
                },
                Projection = new AwsNative.DynamoDb.Inputs.TableProjectionArgs
                {
                    NonKeyAttributes = new[]
                    {
                        "Album",
                        "NumberOfSongs",
                    },
                    ProjectionType = "INCLUDE",
                },
                ProvisionedThroughput = new AwsNative.DynamoDb.Inputs.TableProvisionedThroughputArgs
                {
                    ReadCapacityUnits = 5,
                    WriteCapacityUnits = 5,
                },
            },
            new AwsNative.DynamoDb.Inputs.TableGlobalSecondaryIndexArgs
            {
                IndexName = "myGSI2",
                KeySchema = new[]
                {
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "NumberOfSongs",
                        KeyType = "HASH",
                    },
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Sales",
                        KeyType = "RANGE",
                    },
                },
                Projection = new AwsNative.DynamoDb.Inputs.TableProjectionArgs
                {
                    NonKeyAttributes = new[]
                    {
                        "Album",
                        "Artist",
                    },
                    ProjectionType = "INCLUDE",
                },
                ProvisionedThroughput = new AwsNative.DynamoDb.Inputs.TableProvisionedThroughputArgs
                {
                    ReadCapacityUnits = 5,
                    WriteCapacityUnits = 5,
                },
            },
        },
        LocalSecondaryIndexes = new[]
        {
            new AwsNative.DynamoDb.Inputs.TableLocalSecondaryIndexArgs
            {
                IndexName = "myLSI",
                KeySchema = new[]
                {
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Album",
                        KeyType = "HASH",
                    },
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Sales",
                        KeyType = "RANGE",
                    },
                },
                Projection = new AwsNative.DynamoDb.Inputs.TableProjectionArgs
                {
                    NonKeyAttributes = new[]
                    {
                        "Artist",
                        "NumberOfSongs",
                    },
                    ProjectionType = "INCLUDE",
                },
            },
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/dynamodb"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := dynamodb.NewTable(ctx, "myDynamoDBTable", &dynamodb.TableArgs{
			AttributeDefinitions: dynamodb.TableAttributeDefinitionArray{
				&dynamodb.TableAttributeDefinitionArgs{
					AttributeName: pulumi.String("Album"),
					AttributeType: pulumi.String("S"),
				},
				&dynamodb.TableAttributeDefinitionArgs{
					AttributeName: pulumi.String("Artist"),
					AttributeType: pulumi.String("S"),
				},
				&dynamodb.TableAttributeDefinitionArgs{
					AttributeName: pulumi.String("Sales"),
					AttributeType: pulumi.String("N"),
				},
				&dynamodb.TableAttributeDefinitionArgs{
					AttributeName: pulumi.String("NumberOfSongs"),
					AttributeType: pulumi.String("N"),
				},
			},
			KeySchema: pulumi.Any{
				&dynamodb.TableKeySchemaArgs{
					AttributeName: pulumi.String("Album"),
					KeyType:       pulumi.String("HASH"),
				},
				&dynamodb.TableKeySchemaArgs{
					AttributeName: pulumi.String("Artist"),
					KeyType:       pulumi.String("RANGE"),
				},
			},
			ProvisionedThroughput: &dynamodb.TableProvisionedThroughputArgs{
				ReadCapacityUnits:  pulumi.Int(5),
				WriteCapacityUnits: pulumi.Int(5),
			},
			TableName: pulumi.String("myTableName"),
			GlobalSecondaryIndexes: dynamodb.TableGlobalSecondaryIndexArray{
				&dynamodb.TableGlobalSecondaryIndexArgs{
					IndexName: pulumi.String("myGSI"),
					KeySchema: []dynamodb.TableKeySchemaArgs{
						{
							AttributeName: pulumi.String("Sales"),
							KeyType:       pulumi.String("HASH"),
						},
						{
							AttributeName: pulumi.String("Artist"),
							KeyType:       pulumi.String("RANGE"),
						},
					},
					Projection: &dynamodb.TableProjectionArgs{
						NonKeyAttributes: pulumi.StringArray{
							pulumi.String("Album"),
							pulumi.String("NumberOfSongs"),
						},
						ProjectionType: pulumi.String("INCLUDE"),
					},
					ProvisionedThroughput: &dynamodb.TableProvisionedThroughputArgs{
						ReadCapacityUnits:  pulumi.Int(5),
						WriteCapacityUnits: pulumi.Int(5),
					},
				},
				&dynamodb.TableGlobalSecondaryIndexArgs{
					IndexName: pulumi.String("myGSI2"),
					KeySchema: []dynamodb.TableKeySchemaArgs{
						{
							AttributeName: pulumi.String("NumberOfSongs"),
							KeyType:       pulumi.String("HASH"),
						},
						{
							AttributeName: pulumi.String("Sales"),
							KeyType:       pulumi.String("RANGE"),
						},
					},
					Projection: &dynamodb.TableProjectionArgs{
						NonKeyAttributes: pulumi.StringArray{
							pulumi.String("Album"),
							pulumi.String("Artist"),
						},
						ProjectionType: pulumi.String("INCLUDE"),
					},
					ProvisionedThroughput: &dynamodb.TableProvisionedThroughputArgs{
						ReadCapacityUnits:  pulumi.Int(5),
						WriteCapacityUnits: pulumi.Int(5),
					},
				},
			},
			LocalSecondaryIndexes: dynamodb.TableLocalSecondaryIndexArray{
				&dynamodb.TableLocalSecondaryIndexArgs{
					IndexName: pulumi.String("myLSI"),
					KeySchema: []dynamodb.TableKeySchemaArgs{
						{
							AttributeName: pulumi.String("Album"),
							KeyType:       pulumi.String("HASH"),
						},
						{
							AttributeName: pulumi.String("Sales"),
							KeyType:       pulumi.String("RANGE"),
						},
					},
					Projection: &dynamodb.TableProjectionArgs{
						NonKeyAttributes: pulumi.StringArray{
							pulumi.String("Artist"),
							pulumi.String("NumberOfSongs"),
						},
						ProjectionType: pulumi.String("INCLUDE"),
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

Coming soon!

import pulumi
import pulumi_aws_native as aws_native

my_dynamo_db_table = aws_native.dynamodb.Table("myDynamoDBTable",
    attribute_definitions=[
        aws_native.dynamodb.TableAttributeDefinitionArgs(
            attribute_name="Album",
            attribute_type="S",
        ),
        aws_native.dynamodb.TableAttributeDefinitionArgs(
            attribute_name="Artist",
            attribute_type="S",
        ),
        aws_native.dynamodb.TableAttributeDefinitionArgs(
            attribute_name="Sales",
            attribute_type="N",
        ),
        aws_native.dynamodb.TableAttributeDefinitionArgs(
            attribute_name="NumberOfSongs",
            attribute_type="N",
        ),
    ],
    key_schema=[
        aws_native.dynamodb.TableKeySchemaArgs(
            attribute_name="Album",
            key_type="HASH",
        ),
        aws_native.dynamodb.TableKeySchemaArgs(
            attribute_name="Artist",
            key_type="RANGE",
        ),
    ],
    provisioned_throughput=aws_native.dynamodb.TableProvisionedThroughputArgs(
        read_capacity_units=5,
        write_capacity_units=5,
    ),
    table_name="myTableName",
    global_secondary_indexes=[
        aws_native.dynamodb.TableGlobalSecondaryIndexArgs(
            index_name="myGSI",
            key_schema=[
                aws_native.dynamodb.TableKeySchemaArgs(
                    attribute_name="Sales",
                    key_type="HASH",
                ),
                aws_native.dynamodb.TableKeySchemaArgs(
                    attribute_name="Artist",
                    key_type="RANGE",
                ),
            ],
            projection=aws_native.dynamodb.TableProjectionArgs(
                non_key_attributes=[
                    "Album",
                    "NumberOfSongs",
                ],
                projection_type="INCLUDE",
            ),
            provisioned_throughput=aws_native.dynamodb.TableProvisionedThroughputArgs(
                read_capacity_units=5,
                write_capacity_units=5,
            ),
        ),
        aws_native.dynamodb.TableGlobalSecondaryIndexArgs(
            index_name="myGSI2",
            key_schema=[
                aws_native.dynamodb.TableKeySchemaArgs(
                    attribute_name="NumberOfSongs",
                    key_type="HASH",
                ),
                aws_native.dynamodb.TableKeySchemaArgs(
                    attribute_name="Sales",
                    key_type="RANGE",
                ),
            ],
            projection=aws_native.dynamodb.TableProjectionArgs(
                non_key_attributes=[
                    "Album",
                    "Artist",
                ],
                projection_type="INCLUDE",
            ),
            provisioned_throughput=aws_native.dynamodb.TableProvisionedThroughputArgs(
                read_capacity_units=5,
                write_capacity_units=5,
            ),
        ),
    ],
    local_secondary_indexes=[aws_native.dynamodb.TableLocalSecondaryIndexArgs(
        index_name="myLSI",
        key_schema=[
            aws_native.dynamodb.TableKeySchemaArgs(
                attribute_name="Album",
                key_type="HASH",
            ),
            aws_native.dynamodb.TableKeySchemaArgs(
                attribute_name="Sales",
                key_type="RANGE",
            ),
        ],
        projection=aws_native.dynamodb.TableProjectionArgs(
            non_key_attributes=[
                "Artist",
                "NumberOfSongs",
            ],
            projection_type="INCLUDE",
        ),
    )])

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const myDynamoDBTable = new aws_native.dynamodb.Table("myDynamoDBTable", {
    attributeDefinitions: [
        {
            attributeName: "Album",
            attributeType: "S",
        },
        {
            attributeName: "Artist",
            attributeType: "S",
        },
        {
            attributeName: "Sales",
            attributeType: "N",
        },
        {
            attributeName: "NumberOfSongs",
            attributeType: "N",
        },
    ],
    keySchema: [
        {
            attributeName: "Album",
            keyType: "HASH",
        },
        {
            attributeName: "Artist",
            keyType: "RANGE",
        },
    ],
    provisionedThroughput: {
        readCapacityUnits: 5,
        writeCapacityUnits: 5,
    },
    tableName: "myTableName",
    globalSecondaryIndexes: [
        {
            indexName: "myGSI",
            keySchema: [
                {
                    attributeName: "Sales",
                    keyType: "HASH",
                },
                {
                    attributeName: "Artist",
                    keyType: "RANGE",
                },
            ],
            projection: {
                nonKeyAttributes: [
                    "Album",
                    "NumberOfSongs",
                ],
                projectionType: "INCLUDE",
            },
            provisionedThroughput: {
                readCapacityUnits: 5,
                writeCapacityUnits: 5,
            },
        },
        {
            indexName: "myGSI2",
            keySchema: [
                {
                    attributeName: "NumberOfSongs",
                    keyType: "HASH",
                },
                {
                    attributeName: "Sales",
                    keyType: "RANGE",
                },
            ],
            projection: {
                nonKeyAttributes: [
                    "Album",
                    "Artist",
                ],
                projectionType: "INCLUDE",
            },
            provisionedThroughput: {
                readCapacityUnits: 5,
                writeCapacityUnits: 5,
            },
        },
    ],
    localSecondaryIndexes: [{
        indexName: "myLSI",
        keySchema: [
            {
                attributeName: "Album",
                keyType: "HASH",
            },
            {
                attributeName: "Sales",
                keyType: "RANGE",
            },
        ],
        projection: {
            nonKeyAttributes: [
                "Artist",
                "NumberOfSongs",
            ],
            projectionType: "INCLUDE",
        },
    }],
});

Coming soon!

Example

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

return await Deployment.RunAsync(() => 
{
    var myDynamoDBTable = new AwsNative.DynamoDb.Table("myDynamoDBTable", new()
    {
        AttributeDefinitions = new[]
        {
            new AwsNative.DynamoDb.Inputs.TableAttributeDefinitionArgs
            {
                AttributeName = "Album",
                AttributeType = "S",
            },
            new AwsNative.DynamoDb.Inputs.TableAttributeDefinitionArgs
            {
                AttributeName = "Artist",
                AttributeType = "S",
            },
            new AwsNative.DynamoDb.Inputs.TableAttributeDefinitionArgs
            {
                AttributeName = "Sales",
                AttributeType = "N",
            },
            new AwsNative.DynamoDb.Inputs.TableAttributeDefinitionArgs
            {
                AttributeName = "NumberOfSongs",
                AttributeType = "N",
            },
        },
        KeySchema = new[]
        {
            new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
            {
                AttributeName = "Album",
                KeyType = "HASH",
            },
            new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
            {
                AttributeName = "Artist",
                KeyType = "RANGE",
            },
        },
        ProvisionedThroughput = new AwsNative.DynamoDb.Inputs.TableProvisionedThroughputArgs
        {
            ReadCapacityUnits = 5,
            WriteCapacityUnits = 5,
        },
        TableName = "myTableName",
        GlobalSecondaryIndexes = new[]
        {
            new AwsNative.DynamoDb.Inputs.TableGlobalSecondaryIndexArgs
            {
                IndexName = "myGSI",
                KeySchema = new[]
                {
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Sales",
                        KeyType = "HASH",
                    },
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Artist",
                        KeyType = "RANGE",
                    },
                },
                Projection = new AwsNative.DynamoDb.Inputs.TableProjectionArgs
                {
                    NonKeyAttributes = new[]
                    {
                        "Album",
                        "NumberOfSongs",
                    },
                    ProjectionType = "INCLUDE",
                },
                ProvisionedThroughput = new AwsNative.DynamoDb.Inputs.TableProvisionedThroughputArgs
                {
                    ReadCapacityUnits = 5,
                    WriteCapacityUnits = 5,
                },
            },
            new AwsNative.DynamoDb.Inputs.TableGlobalSecondaryIndexArgs
            {
                IndexName = "myGSI2",
                KeySchema = new[]
                {
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "NumberOfSongs",
                        KeyType = "HASH",
                    },
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Sales",
                        KeyType = "RANGE",
                    },
                },
                Projection = new AwsNative.DynamoDb.Inputs.TableProjectionArgs
                {
                    NonKeyAttributes = new[]
                    {
                        "Album",
                        "Artist",
                    },
                    ProjectionType = "INCLUDE",
                },
                ProvisionedThroughput = new AwsNative.DynamoDb.Inputs.TableProvisionedThroughputArgs
                {
                    ReadCapacityUnits = 5,
                    WriteCapacityUnits = 5,
                },
            },
        },
        LocalSecondaryIndexes = new[]
        {
            new AwsNative.DynamoDb.Inputs.TableLocalSecondaryIndexArgs
            {
                IndexName = "myLSI",
                KeySchema = new[]
                {
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Album",
                        KeyType = "HASH",
                    },
                    new AwsNative.DynamoDb.Inputs.TableKeySchemaArgs
                    {
                        AttributeName = "Sales",
                        KeyType = "RANGE",
                    },
                },
                Projection = new AwsNative.DynamoDb.Inputs.TableProjectionArgs
                {
                    NonKeyAttributes = new[]
                    {
                        "Artist",
                        "NumberOfSongs",
                    },
                    ProjectionType = "INCLUDE",
                },
            },
        },
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws-native/sdk/go/aws/dynamodb"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := dynamodb.NewTable(ctx, "myDynamoDBTable", &dynamodb.TableArgs{
			AttributeDefinitions: dynamodb.TableAttributeDefinitionArray{
				&dynamodb.TableAttributeDefinitionArgs{
					AttributeName: pulumi.String("Album"),
					AttributeType: pulumi.String("S"),
				},
				&dynamodb.TableAttributeDefinitionArgs{
					AttributeName: pulumi.String("Artist"),
					AttributeType: pulumi.String("S"),
				},
				&dynamodb.TableAttributeDefinitionArgs{
					AttributeName: pulumi.String("Sales"),
					AttributeType: pulumi.String("N"),
				},
				&dynamodb.TableAttributeDefinitionArgs{
					AttributeName: pulumi.String("NumberOfSongs"),
					AttributeType: pulumi.String("N"),
				},
			},
			KeySchema: pulumi.Any{
				&dynamodb.TableKeySchemaArgs{
					AttributeName: pulumi.String("Album"),
					KeyType:       pulumi.String("HASH"),
				},
				&dynamodb.TableKeySchemaArgs{
					AttributeName: pulumi.String("Artist"),
					KeyType:       pulumi.String("RANGE"),
				},
			},
			ProvisionedThroughput: &dynamodb.TableProvisionedThroughputArgs{
				ReadCapacityUnits:  pulumi.Int(5),
				WriteCapacityUnits: pulumi.Int(5),
			},
			TableName: pulumi.String("myTableName"),
			GlobalSecondaryIndexes: dynamodb.TableGlobalSecondaryIndexArray{
				&dynamodb.TableGlobalSecondaryIndexArgs{
					IndexName: pulumi.String("myGSI"),
					KeySchema: []dynamodb.TableKeySchemaArgs{
						{
							AttributeName: pulumi.String("Sales"),
							KeyType:       pulumi.String("HASH"),
						},
						{
							AttributeName: pulumi.String("Artist"),
							KeyType:       pulumi.String("RANGE"),
						},
					},
					Projection: &dynamodb.TableProjectionArgs{
						NonKeyAttributes: pulumi.StringArray{
							pulumi.String("Album"),
							pulumi.String("NumberOfSongs"),
						},
						ProjectionType: pulumi.String("INCLUDE"),
					},
					ProvisionedThroughput: &dynamodb.TableProvisionedThroughputArgs{
						ReadCapacityUnits:  pulumi.Int(5),
						WriteCapacityUnits: pulumi.Int(5),
					},
				},
				&dynamodb.TableGlobalSecondaryIndexArgs{
					IndexName: pulumi.String("myGSI2"),
					KeySchema: []dynamodb.TableKeySchemaArgs{
						{
							AttributeName: pulumi.String("NumberOfSongs"),
							KeyType:       pulumi.String("HASH"),
						},
						{
							AttributeName: pulumi.String("Sales"),
							KeyType:       pulumi.String("RANGE"),
						},
					},
					Projection: &dynamodb.TableProjectionArgs{
						NonKeyAttributes: pulumi.StringArray{
							pulumi.String("Album"),
							pulumi.String("Artist"),
						},
						ProjectionType: pulumi.String("INCLUDE"),
					},
					ProvisionedThroughput: &dynamodb.TableProvisionedThroughputArgs{
						ReadCapacityUnits:  pulumi.Int(5),
						WriteCapacityUnits: pulumi.Int(5),
					},
				},
			},
			LocalSecondaryIndexes: dynamodb.TableLocalSecondaryIndexArray{
				&dynamodb.TableLocalSecondaryIndexArgs{
					IndexName: pulumi.String("myLSI"),
					KeySchema: []dynamodb.TableKeySchemaArgs{
						{
							AttributeName: pulumi.String("Album"),
							KeyType:       pulumi.String("HASH"),
						},
						{
							AttributeName: pulumi.String("Sales"),
							KeyType:       pulumi.String("RANGE"),
						},
					},
					Projection: &dynamodb.TableProjectionArgs{
						NonKeyAttributes: pulumi.StringArray{
							pulumi.String("Artist"),
							pulumi.String("NumberOfSongs"),
						},
						ProjectionType: pulumi.String("INCLUDE"),
					},
				},
			},
		})
		if err != nil {
			return err
		}
		return nil
	})
}

Coming soon!

import pulumi
import pulumi_aws_native as aws_native

my_dynamo_db_table = aws_native.dynamodb.Table("myDynamoDBTable",
    attribute_definitions=[
        aws_native.dynamodb.TableAttributeDefinitionArgs(
            attribute_name="Album",
            attribute_type="S",
        ),
        aws_native.dynamodb.TableAttributeDefinitionArgs(
            attribute_name="Artist",
            attribute_type="S",
        ),
        aws_native.dynamodb.TableAttributeDefinitionArgs(
            attribute_name="Sales",
            attribute_type="N",
        ),
        aws_native.dynamodb.TableAttributeDefinitionArgs(
            attribute_name="NumberOfSongs",
            attribute_type="N",
        ),
    ],
    key_schema=[
        aws_native.dynamodb.TableKeySchemaArgs(
            attribute_name="Album",
            key_type="HASH",
        ),
        aws_native.dynamodb.TableKeySchemaArgs(
            attribute_name="Artist",
            key_type="RANGE",
        ),
    ],
    provisioned_throughput=aws_native.dynamodb.TableProvisionedThroughputArgs(
        read_capacity_units=5,
        write_capacity_units=5,
    ),
    table_name="myTableName",
    global_secondary_indexes=[
        aws_native.dynamodb.TableGlobalSecondaryIndexArgs(
            index_name="myGSI",
            key_schema=[
                aws_native.dynamodb.TableKeySchemaArgs(
                    attribute_name="Sales",
                    key_type="HASH",
                ),
                aws_native.dynamodb.TableKeySchemaArgs(
                    attribute_name="Artist",
                    key_type="RANGE",
                ),
            ],
            projection=aws_native.dynamodb.TableProjectionArgs(
                non_key_attributes=[
                    "Album",
                    "NumberOfSongs",
                ],
                projection_type="INCLUDE",
            ),
            provisioned_throughput=aws_native.dynamodb.TableProvisionedThroughputArgs(
                read_capacity_units=5,
                write_capacity_units=5,
            ),
        ),
        aws_native.dynamodb.TableGlobalSecondaryIndexArgs(
            index_name="myGSI2",
            key_schema=[
                aws_native.dynamodb.TableKeySchemaArgs(
                    attribute_name="NumberOfSongs",
                    key_type="HASH",
                ),
                aws_native.dynamodb.TableKeySchemaArgs(
                    attribute_name="Sales",
                    key_type="RANGE",
                ),
            ],
            projection=aws_native.dynamodb.TableProjectionArgs(
                non_key_attributes=[
                    "Album",
                    "Artist",
                ],
                projection_type="INCLUDE",
            ),
            provisioned_throughput=aws_native.dynamodb.TableProvisionedThroughputArgs(
                read_capacity_units=5,
                write_capacity_units=5,
            ),
        ),
    ],
    local_secondary_indexes=[aws_native.dynamodb.TableLocalSecondaryIndexArgs(
        index_name="myLSI",
        key_schema=[
            aws_native.dynamodb.TableKeySchemaArgs(
                attribute_name="Album",
                key_type="HASH",
            ),
            aws_native.dynamodb.TableKeySchemaArgs(
                attribute_name="Sales",
                key_type="RANGE",
            ),
        ],
        projection=aws_native.dynamodb.TableProjectionArgs(
            non_key_attributes=[
                "Artist",
                "NumberOfSongs",
            ],
            projection_type="INCLUDE",
        ),
    )])

import * as pulumi from "@pulumi/pulumi";
import * as aws_native from "@pulumi/aws-native";

const myDynamoDBTable = new aws_native.dynamodb.Table("myDynamoDBTable", {
    attributeDefinitions: [
        {
            attributeName: "Album",
            attributeType: "S",
        },
        {
            attributeName: "Artist",
            attributeType: "S",
        },
        {
            attributeName: "Sales",
            attributeType: "N",
        },
        {
            attributeName: "NumberOfSongs",
            attributeType: "N",
        },
    ],
    keySchema: [
        {
            attributeName: "Album",
            keyType: "HASH",
        },
        {
            attributeName: "Artist",
            keyType: "RANGE",
        },
    ],
    provisionedThroughput: {
        readCapacityUnits: 5,
        writeCapacityUnits: 5,
    },
    tableName: "myTableName",
    globalSecondaryIndexes: [
        {
            indexName: "myGSI",
            keySchema: [
                {
                    attributeName: "Sales",
                    keyType: "HASH",
                },
                {
                    attributeName: "Artist",
                    keyType: "RANGE",
                },
            ],
            projection: {
                nonKeyAttributes: [
                    "Album",
                    "NumberOfSongs",
                ],
                projectionType: "INCLUDE",
            },
            provisionedThroughput: {
                readCapacityUnits: 5,
                writeCapacityUnits: 5,
            },
        },
        {
            indexName: "myGSI2",
            keySchema: [
                {
                    attributeName: "NumberOfSongs",
                    keyType: "HASH",
                },
                {
                    attributeName: "Sales",
                    keyType: "RANGE",
                },
            ],
            projection: {
                nonKeyAttributes: [
                    "Album",
                    "Artist",
                ],
                projectionType: "INCLUDE",
            },
            provisionedThroughput: {
                readCapacityUnits: 5,
                writeCapacityUnits: 5,
            },
        },
    ],
    localSecondaryIndexes: [{
        indexName: "myLSI",
        keySchema: [
            {
                attributeName: "Album",
                keyType: "HASH",
            },
            {
                attributeName: "Sales",
                keyType: "RANGE",
            },
        ],
        projection: {
            nonKeyAttributes: [
                "Artist",
                "NumberOfSongs",
            ],
            projectionType: "INCLUDE",
        },
    }],
});

Coming soon!

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,
          key_schema: Optional[Union[Sequence[TableKeySchemaArgs], Any]] = None,
          local_secondary_indexes: Optional[Sequence[TableLocalSecondaryIndexArgs]] = None,
          import_source_specification: Optional[TableImportSourceSpecificationArgs] = None,
          point_in_time_recovery_specification: Optional[TablePointInTimeRecoverySpecificationArgs] = None,
          global_secondary_indexes: Optional[Sequence[TableGlobalSecondaryIndexArgs]] = None,
          provisioned_throughput: Optional[TableProvisionedThroughputArgs] = None,
          billing_mode: Optional[str] = None,
          kinesis_stream_specification: Optional[TableKinesisStreamSpecificationArgs] = None,
          resource_policy: Optional[TableResourcePolicyArgs] = None,
          deletion_protection_enabled: Optional[bool] = None,
          contributor_insights_specification: Optional[TableContributorInsightsSpecificationArgs] = None,
          attribute_definitions: Optional[Sequence[TableAttributeDefinitionArgs]] = None,
          sse_specification: Optional[TableSseSpecificationArgs] = None,
          stream_specification: Optional[TableStreamSpecificationArgs] = None,
          table_class: Optional[str] = None,
          table_name: Optional[str] = None,
          tags: Optional[Sequence[_root_inputs.TagArgs]] = None,
          time_to_live_specification: Optional[TableTimeToLiveSpecificationArgs] = 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:dynamodb: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.

Example

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

Coming soon!

Coming soon!

Coming soon!

Coming soon!

const aws_nativeTableResource = new aws_native.dynamodb.Table("aws-nativeTableResource", {
    keySchema: undefined,
    localSecondaryIndexes: [{
        indexName: "string",
        keySchema: [{
            attributeName: "string",
            keyType: "string",
        }],
        projection: {
            nonKeyAttributes: ["string"],
            projectionType: "string",
        },
    }],
    importSourceSpecification: {
        inputFormat: "string",
        s3BucketSource: {
            s3Bucket: "string",
            s3BucketOwner: "string",
            s3KeyPrefix: "string",
        },
        inputCompressionType: "string",
        inputFormatOptions: {
            csv: {
                delimiter: "string",
                headerList: ["string"],
            },
        },
    },
    pointInTimeRecoverySpecification: {
        pointInTimeRecoveryEnabled: false,
    },
    globalSecondaryIndexes: [{
        indexName: "string",
        keySchema: [{
            attributeName: "string",
            keyType: "string",
        }],
        projection: {
            nonKeyAttributes: ["string"],
            projectionType: "string",
        },
        contributorInsightsSpecification: {
            enabled: false,
        },
        provisionedThroughput: {
            readCapacityUnits: 0,
            writeCapacityUnits: 0,
        },
    }],
    provisionedThroughput: {
        readCapacityUnits: 0,
        writeCapacityUnits: 0,
    },
    billingMode: "string",
    kinesisStreamSpecification: {
        streamArn: "string",
        approximateCreationDateTimePrecision: aws_native.dynamodb.TableKinesisStreamSpecificationApproximateCreationDateTimePrecision.Microsecond,
    },
    resourcePolicy: {
        policyDocument: "any",
    },
    deletionProtectionEnabled: false,
    contributorInsightsSpecification: {
        enabled: false,
    },
    attributeDefinitions: [{
        attributeName: "string",
        attributeType: "string",
    }],
    sseSpecification: {
        sseEnabled: false,
        kmsMasterKeyId: "string",
        sseType: "string",
    },
    streamSpecification: {
        streamViewType: "string",
        resourcePolicy: {
            policyDocument: "any",
        },
    },
    tableClass: "string",
    tableName: "string",
    tags: [{
        key: "string",
        value: "string",
    }],
    timeToLiveSpecification: {
        enabled: false,
        attributeName: "string",
    },
});

Coming soon!

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

The Table resource accepts the following input properties:

KeySchema List<Pulumi.AwsNative.DynamoDb.Inputs.TableKeySchema> | object

Specifies the attributes that make up the primary key for the table. The attributes in the KeySchema property must also be defined in the AttributeDefinitions property.

AttributeDefinitions List<Pulumi.AwsNative.DynamoDb.Inputs.TableAttributeDefinition>

A list of attributes that describe the key schema for the table and indexes. This property is required to create a DDB table. Update requires: Some interruptions. Replacement if you edit an existing AttributeDefinition.

BillingMode string

Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:

PROVISIONED - We recommend using PROVISIONED for predictable workloads. PROVISIONED sets the billing mode to Provisioned Mode.
PAY_PER_REQUEST - We recommend using PAY_PER_REQUEST for unpredictable workloads. PAY_PER_REQUEST sets the billing mode to On-Demand Mode.

If not specified, the default is PROVISIONED.

ContributorInsightsSpecification Pulumi.AwsNative.DynamoDb.Inputs.TableContributorInsightsSpecification

The settings used to enable or disable CloudWatch Contributor Insights for the specified table.

DeletionProtectionEnabled bool

Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see Using deletion protection in the Developer Guide.

GlobalSecondaryIndexes List<Pulumi.AwsNative.DynamoDb.Inputs.TableGlobalSecondaryIndex>

Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes. If you update a table to include a new global secondary index, CFNlong initiates the index creation and then proceeds with the stack update. CFNlong doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is ACTIVE. You can track its status by using the DynamoDB DescribeTable command. If you add or delete an index during an update, we recommend that you don't update any other resources. If your stack fails to update and is rolled back while adding a new index, you must manually delete the index. Updates are not supported. The following are exceptions:

If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.

ImportSourceSpecification Pulumi.AwsNative.DynamoDb.Inputs.TableImportSourceSpecification

Specifies the properties of data being imported from the S3 bucket source to the table. If you specify the ImportSourceSpecification property, and also specify either the StreamSpecification, the TableClass property, or the DeletionProtectionEnabled property, the IAM entity creating/updating stack must have UpdateTable permission.

KinesisStreamSpecification Pulumi.AwsNative.DynamoDb.Inputs.TableKinesisStreamSpecification

The Kinesis Data Streams configuration for the specified table.

LocalSecondaryIndexes List<Pulumi.AwsNative.DynamoDb.Inputs.TableLocalSecondaryIndex>

Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.

PointInTimeRecoverySpecification Pulumi.AwsNative.DynamoDb.Inputs.TablePointInTimeRecoverySpecification

The settings used to enable point in time recovery.

ProvisionedThroughput Pulumi.AwsNative.DynamoDb.Inputs.TableProvisionedThroughput

Throughput for the specified table, which consists of values for ReadCapacityUnits and WriteCapacityUnits. For more information about the contents of a provisioned throughput structure, see Amazon DynamoDB Table ProvisionedThroughput. If you set BillingMode as PROVISIONED, you must specify this property. If you set BillingMode as PAY_PER_REQUEST, you cannot specify this property.

ResourcePolicy Pulumi.AwsNative.DynamoDb.Inputs.TableResourcePolicy

A resource-based policy document that contains permissions to add to the specified table. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples. When you attach a resource-based policy while creating a table, the policy creation is strongly consistent. For information about the considerations that you should keep in mind while attaching a resource-based policy, see Resource-based policy considerations.

SseSpecification Pulumi.AwsNative.DynamoDb.Inputs.TableSseSpecification

Specifies the settings to enable server-side encryption.

StreamSpecification Pulumi.AwsNative.DynamoDb.Inputs.TableStreamSpecification

The settings for the DDB table stream, which capture changes to items stored in the table.

TableClass string

The table class of the new table. Valid values are STANDARD and STANDARD_INFREQUENT_ACCESS.

TableName string

A name for the table. If you don't specify a name, CFNlong generates a unique physical ID and uses that ID for the table name. For more information, see Name Type. If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.

Tags List<Pulumi.AwsNative.Inputs.Tag>

An array of key-value pairs to apply to this resource. For more information, see Tag.

TimeToLiveSpecification Pulumi.AwsNative.DynamoDb.Inputs.TableTimeToLiveSpecification

Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.

KeySchema []TableKeySchemaArgs | interface{}

Specifies the attributes that make up the primary key for the table. The attributes in the KeySchema property must also be defined in the AttributeDefinitions property.

AttributeDefinitions []TableAttributeDefinitionArgs

BillingMode string

Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:

PROVISIONED - We recommend using PROVISIONED for predictable workloads. PROVISIONED sets the billing mode to Provisioned Mode.
PAY_PER_REQUEST - We recommend using PAY_PER_REQUEST for unpredictable workloads. PAY_PER_REQUEST sets the billing mode to On-Demand Mode.

If not specified, the default is PROVISIONED.

ContributorInsightsSpecification TableContributorInsightsSpecificationArgs

The settings used to enable or disable CloudWatch Contributor Insights for the specified table.

DeletionProtectionEnabled bool

GlobalSecondaryIndexes []TableGlobalSecondaryIndexArgs

If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.

ImportSourceSpecification TableImportSourceSpecificationArgs

KinesisStreamSpecification TableKinesisStreamSpecificationArgs

The Kinesis Data Streams configuration for the specified table.

LocalSecondaryIndexes []TableLocalSecondaryIndexArgs

PointInTimeRecoverySpecification TablePointInTimeRecoverySpecificationArgs

The settings used to enable point in time recovery.

ProvisionedThroughput TableProvisionedThroughputArgs

ResourcePolicy TableResourcePolicyArgs

SseSpecification TableSseSpecificationArgs

Specifies the settings to enable server-side encryption.

StreamSpecification TableStreamSpecificationArgs

The settings for the DDB table stream, which capture changes to items stored in the table.

TableClass string

The table class of the new table. Valid values are STANDARD and STANDARD_INFREQUENT_ACCESS.

TableName string

Tags TagArgs

An array of key-value pairs to apply to this resource. For more information, see Tag.

TimeToLiveSpecification TableTimeToLiveSpecificationArgs

Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.

keySchema List<TableKeySchema> | Object

Specifies the attributes that make up the primary key for the table. The attributes in the KeySchema property must also be defined in the AttributeDefinitions property.

attributeDefinitions List<TableAttributeDefinition>

billingMode String

Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:

PROVISIONED - We recommend using PROVISIONED for predictable workloads. PROVISIONED sets the billing mode to Provisioned Mode.
PAY_PER_REQUEST - We recommend using PAY_PER_REQUEST for unpredictable workloads. PAY_PER_REQUEST sets the billing mode to On-Demand Mode.

If not specified, the default is PROVISIONED.

contributorInsightsSpecification TableContributorInsightsSpecification

The settings used to enable or disable CloudWatch Contributor Insights for the specified table.

deletionProtectionEnabled Boolean

globalSecondaryIndexes List<TableGlobalSecondaryIndex>

If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.

importSourceSpecification TableImportSourceSpecification

kinesisStreamSpecification TableKinesisStreamSpecification

The Kinesis Data Streams configuration for the specified table.

localSecondaryIndexes List<TableLocalSecondaryIndex>

pointInTimeRecoverySpecification TablePointInTimeRecoverySpecification

The settings used to enable point in time recovery.

provisionedThroughput TableProvisionedThroughput

resourcePolicy TableResourcePolicy

sseSpecification TableSseSpecification

Specifies the settings to enable server-side encryption.

streamSpecification TableStreamSpecification

The settings for the DDB table stream, which capture changes to items stored in the table.

tableClass String

The table class of the new table. Valid values are STANDARD and STANDARD_INFREQUENT_ACCESS.

tableName String

tags List<Tag>

An array of key-value pairs to apply to this resource. For more information, see Tag.

timeToLiveSpecification TableTimeToLiveSpecification

Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.

keySchema TableKeySchema[] | any

Specifies the attributes that make up the primary key for the table. The attributes in the KeySchema property must also be defined in the AttributeDefinitions property.

attributeDefinitions TableAttributeDefinition[]

billingMode string

Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:

PROVISIONED - We recommend using PROVISIONED for predictable workloads. PROVISIONED sets the billing mode to Provisioned Mode.
PAY_PER_REQUEST - We recommend using PAY_PER_REQUEST for unpredictable workloads. PAY_PER_REQUEST sets the billing mode to On-Demand Mode.

If not specified, the default is PROVISIONED.

contributorInsightsSpecification TableContributorInsightsSpecification

The settings used to enable or disable CloudWatch Contributor Insights for the specified table.

deletionProtectionEnabled boolean

globalSecondaryIndexes TableGlobalSecondaryIndex[]

If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.

importSourceSpecification TableImportSourceSpecification

kinesisStreamSpecification TableKinesisStreamSpecification

The Kinesis Data Streams configuration for the specified table.

localSecondaryIndexes TableLocalSecondaryIndex[]

pointInTimeRecoverySpecification TablePointInTimeRecoverySpecification

The settings used to enable point in time recovery.

provisionedThroughput TableProvisionedThroughput

resourcePolicy TableResourcePolicy

sseSpecification TableSseSpecification

Specifies the settings to enable server-side encryption.

streamSpecification TableStreamSpecification

The settings for the DDB table stream, which capture changes to items stored in the table.

tableClass string

The table class of the new table. Valid values are STANDARD and STANDARD_INFREQUENT_ACCESS.

tableName string

tags Tag[]

An array of key-value pairs to apply to this resource. For more information, see Tag.

timeToLiveSpecification TableTimeToLiveSpecification

Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.

key_schema Sequence[TableKeySchemaArgs] | Any

Specifies the attributes that make up the primary key for the table. The attributes in the KeySchema property must also be defined in the AttributeDefinitions property.

attribute_definitions Sequence[TableAttributeDefinitionArgs]

billing_mode str

Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:

PROVISIONED - We recommend using PROVISIONED for predictable workloads. PROVISIONED sets the billing mode to Provisioned Mode.
PAY_PER_REQUEST - We recommend using PAY_PER_REQUEST for unpredictable workloads. PAY_PER_REQUEST sets the billing mode to On-Demand Mode.

If not specified, the default is PROVISIONED.

contributor_insights_specification TableContributorInsightsSpecificationArgs

The settings used to enable or disable CloudWatch Contributor Insights for the specified table.

deletion_protection_enabled bool

global_secondary_indexes Sequence[TableGlobalSecondaryIndexArgs]

If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.

import_source_specification TableImportSourceSpecificationArgs

kinesis_stream_specification TableKinesisStreamSpecificationArgs

The Kinesis Data Streams configuration for the specified table.

local_secondary_indexes Sequence[TableLocalSecondaryIndexArgs]

point_in_time_recovery_specification TablePointInTimeRecoverySpecificationArgs

The settings used to enable point in time recovery.

provisioned_throughput TableProvisionedThroughputArgs

resource_policy TableResourcePolicyArgs

sse_specification TableSseSpecificationArgs

Specifies the settings to enable server-side encryption.

stream_specification TableStreamSpecificationArgs

The settings for the DDB table stream, which capture changes to items stored in the table.

table_class str

The table class of the new table. Valid values are STANDARD and STANDARD_INFREQUENT_ACCESS.

table_name str

tags Sequence[TagArgs]

An array of key-value pairs to apply to this resource. For more information, see Tag.

time_to_live_specification TableTimeToLiveSpecificationArgs

Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.

keySchema List<Property Map> | Any

Specifies the attributes that make up the primary key for the table. The attributes in the KeySchema property must also be defined in the AttributeDefinitions property.

attributeDefinitions List<Property Map>

billingMode String

Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:

PROVISIONED - We recommend using PROVISIONED for predictable workloads. PROVISIONED sets the billing mode to Provisioned Mode.
PAY_PER_REQUEST - We recommend using PAY_PER_REQUEST for unpredictable workloads. PAY_PER_REQUEST sets the billing mode to On-Demand Mode.

If not specified, the default is PROVISIONED.

contributorInsightsSpecification Property Map

The settings used to enable or disable CloudWatch Contributor Insights for the specified table.

deletionProtectionEnabled Boolean

globalSecondaryIndexes List<Property Map>

If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.

importSourceSpecification Property Map

kinesisStreamSpecification Property Map

The Kinesis Data Streams configuration for the specified table.

localSecondaryIndexes List<Property Map>

pointInTimeRecoverySpecification Property Map

The settings used to enable point in time recovery.

provisionedThroughput Property Map

resourcePolicy Property Map

sseSpecification Property Map

Specifies the settings to enable server-side encryption.

streamSpecification Property Map

The settings for the DDB table stream, which capture changes to items stored in the table.

tableClass String

The table class of the new table. Valid values are STANDARD and STANDARD_INFREQUENT_ACCESS.

tableName String

tags List<Property Map>

An array of key-value pairs to apply to this resource. For more information, see Tag.

timeToLiveSpecification Property Map

Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.

Outputs

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

Arn string
Id string: The provider-assigned unique ID for this managed resource.
StreamArn string

Arn string
Id string: The provider-assigned unique ID for this managed resource.
StreamArn string

arn String
id String: The provider-assigned unique ID for this managed resource.
streamArn String

arn string
id string: The provider-assigned unique ID for this managed resource.
streamArn string

arn str
id str: The provider-assigned unique ID for this managed resource.
stream_arn str

arn String
id String: The provider-assigned unique ID for this managed resource.
streamArn String

Supporting Types

TableAttributeDefinition, TableAttributeDefinitionArgs

AttributeName string

A name for the attribute.

AttributeType string

The data type for the attribute, where:

S - the attribute is of type String
N - the attribute is of type Number
B - the attribute is of type Binary

AttributeName string

A name for the attribute.

AttributeType string

The data type for the attribute, where:

S - the attribute is of type String
N - the attribute is of type Number
B - the attribute is of type Binary

attributeName String

A name for the attribute.

attributeType String

The data type for the attribute, where:

S - the attribute is of type String
N - the attribute is of type Number
B - the attribute is of type Binary

attributeName string

A name for the attribute.

attributeType string

The data type for the attribute, where:

S - the attribute is of type String
N - the attribute is of type Number
B - the attribute is of type Binary

attribute_name str

A name for the attribute.

attribute_type str

The data type for the attribute, where:

S - the attribute is of type String
N - the attribute is of type Number
B - the attribute is of type Binary

attributeName String

A name for the attribute.

attributeType String

The data type for the attribute, where:

S - the attribute is of type String
N - the attribute is of type Number
B - the attribute is of type Binary

TableContributorInsightsSpecification, TableContributorInsightsSpecificationArgs

Enabled bool: Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).

Enabled bool: Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).

enabled Boolean: Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).

enabled boolean: Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).

enabled bool: Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).

enabled Boolean: Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).

TableCsv, TableCsvArgs

Delimiter string: The delimiter used for separating items in the CSV file being imported.
HeaderList List<string>: List of the headers used to specify a common header for all source CSV files being imported. If this field is specified then the first line of each CSV file is treated as data instead of the header. If this field is not specified the the first line of each CSV file is treated as the header.

Delimiter string: The delimiter used for separating items in the CSV file being imported.
HeaderList []string: List of the headers used to specify a common header for all source CSV files being imported. If this field is specified then the first line of each CSV file is treated as data instead of the header. If this field is not specified the the first line of each CSV file is treated as the header.

delimiter String: The delimiter used for separating items in the CSV file being imported.
headerList List<String>: List of the headers used to specify a common header for all source CSV files being imported. If this field is specified then the first line of each CSV file is treated as data instead of the header. If this field is not specified the the first line of each CSV file is treated as the header.

delimiter string: The delimiter used for separating items in the CSV file being imported.
headerList string[]: List of the headers used to specify a common header for all source CSV files being imported. If this field is specified then the first line of each CSV file is treated as data instead of the header. If this field is not specified the the first line of each CSV file is treated as the header.

delimiter str: The delimiter used for separating items in the CSV file being imported.
header_list Sequence[str]: List of the headers used to specify a common header for all source CSV files being imported. If this field is specified then the first line of each CSV file is treated as data instead of the header. If this field is not specified the the first line of each CSV file is treated as the header.

delimiter String: The delimiter used for separating items in the CSV file being imported.
headerList List<String>: List of the headers used to specify a common header for all source CSV files being imported. If this field is specified then the first line of each CSV file is treated as data instead of the header. If this field is not specified the the first line of each CSV file is treated as the header.

TableGlobalSecondaryIndex, TableGlobalSecondaryIndexArgs

IndexName string

The name of the global secondary index. The name must be unique among all other indexes on this table.

KeySchema List<Pulumi.AwsNative.DynamoDb.Inputs.TableKeySchema>

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.

Projection Pulumi.AwsNative.DynamoDb.Inputs.TableProjection

Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

ContributorInsightsSpecification Pulumi.AwsNative.DynamoDb.Inputs.TableContributorInsightsSpecification

The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.

ProvisionedThroughput Pulumi.AwsNative.DynamoDb.Inputs.TableProvisionedThroughput

Represents the provisioned throughput settings for the specified global secondary index. For current minimum and maximum provisioned throughput values, see Service, Account, and Table Quotas in the Amazon DynamoDB Developer Guide.

IndexName string

The name of the global secondary index. The name must be unique among all other indexes on this table.

KeySchema []TableKeySchema

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

Projection TableProjection

ContributorInsightsSpecification TableContributorInsightsSpecification

The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.

ProvisionedThroughput TableProvisionedThroughput

indexName String

The name of the global secondary index. The name must be unique among all other indexes on this table.

keySchema List<TableKeySchema>

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

projection TableProjection

contributorInsightsSpecification TableContributorInsightsSpecification

The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.

provisionedThroughput TableProvisionedThroughput

indexName string

The name of the global secondary index. The name must be unique among all other indexes on this table.

keySchema TableKeySchema[]

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

projection TableProjection

contributorInsightsSpecification TableContributorInsightsSpecification

The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.

provisionedThroughput TableProvisionedThroughput

index_name str

The name of the global secondary index. The name must be unique among all other indexes on this table.

key_schema Sequence[TableKeySchema]

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

projection TableProjection

contributor_insights_specification TableContributorInsightsSpecification

The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.

provisioned_throughput TableProvisionedThroughput

indexName String

The name of the global secondary index. The name must be unique among all other indexes on this table.

keySchema List<Property Map>

The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

projection Property Map

contributorInsightsSpecification Property Map

The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.

provisionedThroughput Property Map

TableImportSourceSpecification, TableImportSourceSpecificationArgs

InputFormat string: The format of the source data. Valid values for ImportFormat are CSV, DYNAMODB_JSON or ION.
S3BucketSource Pulumi.AwsNative.DynamoDb.Inputs.TableS3BucketSource: The S3 bucket that provides the source for the import.
InputCompressionType string: Type of compression to be used on the input coming from the imported table.
InputFormatOptions Pulumi.AwsNative.DynamoDb.Inputs.TableInputFormatOptions: Additional properties that specify how the input is formatted,

InputFormat string: The format of the source data. Valid values for ImportFormat are CSV, DYNAMODB_JSON or ION.
S3BucketSource TableS3BucketSource: The S3 bucket that provides the source for the import.
InputCompressionType string: Type of compression to be used on the input coming from the imported table.
InputFormatOptions TableInputFormatOptions: Additional properties that specify how the input is formatted,

inputFormat String: The format of the source data. Valid values for ImportFormat are CSV, DYNAMODB_JSON or ION.
s3BucketSource TableS3BucketSource: The S3 bucket that provides the source for the import.
inputCompressionType String: Type of compression to be used on the input coming from the imported table.
inputFormatOptions TableInputFormatOptions: Additional properties that specify how the input is formatted,

inputFormat string: The format of the source data. Valid values for ImportFormat are CSV, DYNAMODB_JSON or ION.
s3BucketSource TableS3BucketSource: The S3 bucket that provides the source for the import.
inputCompressionType string: Type of compression to be used on the input coming from the imported table.
inputFormatOptions TableInputFormatOptions: Additional properties that specify how the input is formatted,

input_format str: The format of the source data. Valid values for ImportFormat are CSV, DYNAMODB_JSON or ION.
s3_bucket_source TableS3BucketSource: The S3 bucket that provides the source for the import.
input_compression_type str: Type of compression to be used on the input coming from the imported table.
input_format_options TableInputFormatOptions: Additional properties that specify how the input is formatted,

inputFormat String: The format of the source data. Valid values for ImportFormat are CSV, DYNAMODB_JSON or ION.
s3BucketSource Property Map: The S3 bucket that provides the source for the import.
inputCompressionType String: Type of compression to be used on the input coming from the imported table.
inputFormatOptions Property Map: Additional properties that specify how the input is formatted,

TableInputFormatOptions, TableInputFormatOptionsArgs

Csv Pulumi.AwsNative.DynamoDb.Inputs.TableCsv: The options for imported source files in CSV format. The values are Delimiter and HeaderList.

Csv TableCsv: The options for imported source files in CSV format. The values are Delimiter and HeaderList.

csv TableCsv: The options for imported source files in CSV format. The values are Delimiter and HeaderList.

csv TableCsv: The options for imported source files in CSV format. The values are Delimiter and HeaderList.

csv TableCsv: The options for imported source files in CSV format. The values are Delimiter and HeaderList.

csv Property Map: The options for imported source files in CSV format. The values are Delimiter and HeaderList.

TableKeySchema, TableKeySchemaArgs

AttributeName string

The name of a key attribute.

KeyType string

The role that this key attribute will assume:

HASH - partition key
RANGE - sort key

AttributeName string

The name of a key attribute.

KeyType string

The role that this key attribute will assume:

HASH - partition key
RANGE - sort key

attributeName String

The name of a key attribute.

keyType String

The role that this key attribute will assume:

HASH - partition key
RANGE - sort key

attributeName string

The name of a key attribute.

keyType string

The role that this key attribute will assume:

HASH - partition key
RANGE - sort key

attribute_name str

The name of a key attribute.

key_type str

The role that this key attribute will assume:

HASH - partition key
RANGE - sort key

attributeName String

The name of a key attribute.

keyType String

The role that this key attribute will assume:

HASH - partition key
RANGE - sort key

TableKinesisStreamSpecification, TableKinesisStreamSpecificationArgs

StreamArn string: The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
ApproximateCreationDateTimePrecision Pulumi.AwsNative.DynamoDb.TableKinesisStreamSpecificationApproximateCreationDateTimePrecision: The precision for the time and date that the stream was created.

StreamArn string: The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
ApproximateCreationDateTimePrecision TableKinesisStreamSpecificationApproximateCreationDateTimePrecision: The precision for the time and date that the stream was created.

streamArn String: The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
approximateCreationDateTimePrecision TableKinesisStreamSpecificationApproximateCreationDateTimePrecision: The precision for the time and date that the stream was created.

streamArn string: The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
approximateCreationDateTimePrecision TableKinesisStreamSpecificationApproximateCreationDateTimePrecision: The precision for the time and date that the stream was created.

stream_arn str: The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
approximate_creation_date_time_precision TableKinesisStreamSpecificationApproximateCreationDateTimePrecision: The precision for the time and date that the stream was created.

streamArn String: The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
approximateCreationDateTimePrecision "MICROSECOND" | "MILLISECOND": The precision for the time and date that the stream was created.

TableKinesisStreamSpecificationApproximateCreationDateTimePrecision, TableKinesisStreamSpecificationApproximateCreationDateTimePrecisionArgs

Microsecond: MICROSECOND
Millisecond: MILLISECOND

TableKinesisStreamSpecificationApproximateCreationDateTimePrecisionMicrosecond: MICROSECOND
TableKinesisStreamSpecificationApproximateCreationDateTimePrecisionMillisecond: MILLISECOND

Microsecond: MICROSECOND
Millisecond: MILLISECOND

Microsecond: MICROSECOND
Millisecond: MILLISECOND

MICROSECOND: MICROSECOND
MILLISECOND: MILLISECOND

"MICROSECOND": MICROSECOND
"MILLISECOND": MILLISECOND

TableLocalSecondaryIndex, TableLocalSecondaryIndexArgs

IndexName string

The name of the local secondary index. The name must be unique among all other indexes on this table.

KeySchema List<Pulumi.AwsNative.DynamoDb.Inputs.TableKeySchema>

The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

Projection Pulumi.AwsNative.DynamoDb.Inputs.TableProjection

Represents attributes that are copied (projected) from the table into the local secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.

IndexName string

The name of the local secondary index. The name must be unique among all other indexes on this table.

KeySchema []TableKeySchema

The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

Projection TableProjection

indexName String

The name of the local secondary index. The name must be unique among all other indexes on this table.

keySchema List<TableKeySchema>

The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

projection TableProjection

indexName string

The name of the local secondary index. The name must be unique among all other indexes on this table.

keySchema TableKeySchema[]

The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

projection TableProjection

index_name str

The name of the local secondary index. The name must be unique among all other indexes on this table.

key_schema Sequence[TableKeySchema]

The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

projection TableProjection

indexName String

The name of the local secondary index. The name must be unique among all other indexes on this table.

keySchema List<Property Map>

The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:

HASH - partition key
RANGE - sort key

projection Property Map

TablePointInTimeRecoverySpecification, TablePointInTimeRecoverySpecificationArgs

PointInTimeRecoveryEnabled bool: Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.

PointInTimeRecoveryEnabled bool: Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.

pointInTimeRecoveryEnabled Boolean: Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.

pointInTimeRecoveryEnabled boolean: Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.

point_in_time_recovery_enabled bool: Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.

pointInTimeRecoveryEnabled Boolean: Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.

TableProjection, TableProjectionArgs

NonKeyAttributes List<string>

Represents the non-key attribute names which will be projected into the index. For local secondary indexes, the total count of NonKeyAttributes summed across all of the local secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total.

ProjectionType string

The set of attributes that are projected into the index:

KEYS_ONLY - Only the index and primary keys are projected into the index.
INCLUDE - In addition to the attributes described in KEYS_ONLY, the secondary index will include other non-key attributes that you specify.
ALL - All of the table attributes are projected into the index.