The CreateTable operation adds a new table to your account. In an Amazon Web Services account, table names must be unique within each Region. That is, you can
have two tables with same name if you create the tables in different Regions.
CreateTable is an asynchronous operation. Upon receiving a
CreateTable request, DynamoDB immediately returns a response with a
TableStatus of CREATING. After the table is created,
DynamoDB sets the TableStatus to ACTIVE. You can perform read
and write operations only on an ACTIVE table.
You can optionally define secondary indexes on the new table, as part of the
CreateTable operation. If you want to create multiple tables with
secondary indexes on them, you must create the tables sequentially. Only one table with
secondary indexes can be in the CREATING state at any given time.
You can use the DescribeTable action to check the table status.
example
Use a bare-bones client and the command you need to make an API call.
The
CreateTableoperation adds a new table to your account. In an Amazon Web Services account, table names must be unique within each Region. That is, you can have two tables with same name if you create the tables in different Regions.CreateTableis an asynchronous operation. Upon receiving aCreateTablerequest, DynamoDB immediately returns a response with aTableStatusofCREATING. After the table is created, DynamoDB sets theTableStatustoACTIVE. You can perform read and write operations only on anACTIVEtable.You can optionally define secondary indexes on the new table, as part of the
CreateTableoperation. If you want to create multiple tables with secondary indexes on them, you must create the tables sequentially. Only one table with secondary indexes can be in theCREATINGstate at any given time.You can use the
DescribeTableaction to check the table status.Use a bare-bones client and the command you need to make an API call.
import { DynamoDBClient, CreateTableCommand } from "@aws-sdk/client-dynamodb"; // ES Modules import // const { DynamoDBClient, CreateTableCommand } = require("@aws-sdk/client-dynamodb"); // CommonJS import const client = new DynamoDBClient(config); const command = new CreateTableCommand(input); const response = await client.send(command);CreateTableCommandInput for command's
inputshape.CreateTableCommandOutput for command's
responseshape.config for DynamoDBClient's
configshape.