# CreateTable
**importante**
***Esta sección se refiere a la versión 2011-12-05 del API, que está obsoleta y no debe utilizarse para nuevas aplicaciones.***
**Para consultar la documentación sobre la API de bajo nivel actual, consulte la [Referencia de la API de Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**
## Descripción
La operación `CreateTable` agrega una nueva tabla a la cuenta.
El nombre de la tabla debe ser único para la cuenta de AWS que emite la solicitud y la región de AWS que recibe la solicitud a las que están asociadas (por ejemplo, dynamodb.us-west-2.amazonaws.com). Cada punto de enlace de DynamoDB es totalmente independiente. Por ejemplo, si tiene dos tablas llamadas “MyTable”, una en dynamodb.us-west-2.amazonaws.com y otra en dynamodb.us-west-1.amazonaws.com, son completamente independientes y no comparten ningún dato.
La operación `CreateTable` desencadena un flujo de trabajo asincrónico para comenzar a crear la tabla. DynamoDB devuelve inmediatamente el estado de la tabla (`CREATING`) hasta que la tabla adquiere el estado `ACTIVE`. Una vez que la tabla tiene el estado `ACTIVE`, puede llevar a cabo operaciones del plano de datos.
Use la operación [DescribeTables](API_DescribeTables_v20111205.md) para comprobar el estado de la tabla.
## Solicitudes
### Sintaxis
```
// This header is abbreviated.
// For a sample of a complete header, see API de bajo nivel de DynamoDB.
POST / HTTP/1.1
x-amz-target: DynamoDB_20111205.CreateTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```
****
| Nombre | Descripción | Obligatorio |
| --- | --- | --- |
| TableName | Nombre de la tabla que se va a crear.Los caracteres permitidos son a-z, A-Z, 0-9, "\$1" (guion bajo), "-" (guion) y "." (punto). Los nombres pueden tener de 3 a 255 caracteres de longitud. Tipo: cadena | Sí |
| KeySchema | Estructura de la clave principal (simple o compuesta) de la tabla. Se requiere un par de nombre-valor de `HashKeyElement`, pero el par de nombre-valor de `RangeKeyElement` es opcional (solo es obligatorio para las claves principales compuestas). Para obtener más información sobre claves principales, consulte [Clave principal](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Los nombres de elemento de clave principal pueden tener entre 1 y 255 caracteres y no tienen restricciones de caracteres. Los valores posibles de AttributeType son "S" (cadena), "N" (numérico) o "B" (binario).Tipo: Map, mapa de `HashKeyElement`, o bien de `HashKeyElement` y de `RangeKeyElement` si se trata de una clave principal compuesta. | Sí |
| ProvisionedThroughput | Nuevo rendimiento de la tabla especificada, que se compone de los valores de ReadCapacityUnits y WriteCapacityUnits. Para obtener más información, consulte [Modo de capacidad aprovisionada de DynamoDB](provisioned-capacity-mode.md). Para obtener los valores mínimo y máximo actuales, consulte [Cuotas en Amazon DynamoDB](ServiceQuotas.md). Tipo: matriz | Sí |
| ProvisionedThroughput: ReadCapacityUnits | Establece el número mínimo de `ReadCapacityUnits` consistentes consumidas por segundo para la tabla especificada antes de que DynamoDB equilibre la carga con otras operaciones. Las operaciones de lectura consistente final requieren menos esfuerzo que una operación de lectura consistente; por lo tanto, un ajuste de 50 unidades `ReadCapacityUnits` consistentes por segundo proporciona 100 unidades de capacidad `ReadCapacityUnits` consistentes finales por segundo. Tipo: Number | Sí |
| ProvisionedThroughput: WriteCapacityUnits | Establece el número mínimo de WriteCapacityUnits consumidas por segundo para la tabla especificada antes de que DynamoDB equilibre la carga con otras operaciones. Tipo: Number | Sí |
## Respuestas
### Sintaxis
```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.310506263362E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeName1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeName2","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
"TableName":"Table1",
"TableStatus":"CREATING"
}
}
```
****
| Nombre | Descripción |
| --- | --- |
| TableDescription | Contenedor de propiedades de la tabla. |
| CreationDateTime | Fecha en que se creó la tabla en [formato de tiempo UNIX](http://www.epochconverter.com/).Tipo: Number |
| KeySchema | Estructura de la clave principal (simple o compuesta) de la tabla. Se requiere un par de nombre-valor de `HashKeyElement`, pero el par de nombre-valor de `RangeKeyElement` es opcional (solo es obligatorio para las claves principales compuestas). Para obtener más información sobre claves principales, consulte [Clave principal](HowItWorks.CoreComponents.md#HowItWorks.CoreComponents.PrimaryKey).Tipo: Map, mapa de `HashKeyElement`, o bien de `HashKeyElement` y de `RangeKeyElement` si se trata de una clave principal compuesta. |
| ProvisionedThroughput | Rendimiento de la tabla especificada, que se compone de los valores de `ReadCapacityUnits` y `WriteCapacityUnits`. Consulte [Modo de capacidad aprovisionada de DynamoDB](provisioned-capacity-mode.md). Tipo: matriz |
| ProvisionedThroughput :ReadCapacityUnits | El número mínimo de `ReadCapacityUnits` consumidas por segundo antes de que DynamoDB equilibre la carga con otras operaciones.Tipo: Number |
| ProvisionedThroughput :WriteCapacityUnits | El número mínimo de `ReadCapacityUnits` consumidas por segundo antes de que `WriteCapacityUnits` equilibre la carga con otras operaciones.Tipo: Number |
| TableName | Nombre de la tabla creada. Tipo: cadena |
| TableStatus | Estado actual de la tabla (`CREATING`). Una vez que la tabla adquiere el estado `ACTIVE`, puede colocar datos en ella.Use el API [DescribeTables](API_DescribeTables_v20111205.md) para comprobar el estado de la tabla.Tipo: cadena |
## Errores especiales
****
| Error | Descripción |
| --- | --- |
| ResourceInUseException | Se intentó volver a crear una tabla que ya existía. |
| LimitExceededException | El número de solicitudes simultáneas para la tabla (número acumulado de tablas que se encuentren en los estados `CREATING`, `DELETING` o `UPDATING`) supera el máximo permitido. Para obtener los valores mínimo y máximo actuales, consulte [Cuotas en Amazon DynamoDB](ServiceQuotas.md). . |
## Ejemplos
En el siguiente ejemplo se crea una tabla con una clave principal compuesta que contiene una cadena y un número. Para obtener ejemplos sobre cómo usar el SDK de AWS, consulte [Uso de tablas y datos en DynamoDB](WorkingWithTables.md).
### Solicitud de ejemplo
```
// This header is abbreviated.
// For a sample of a complete header, see API de bajo nivel de DynamoDB.
POST / HTTP/1.1
x-amz-target: DynamoDB_20111205.CreateTable
content-type: application/x-amz-json-1.0
{"TableName":"comp-table",
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10}
}
```
### Respuesta de ejemplo
```
HTTP/1.1 200 OK
x-amzn-RequestId: CSOC7TJPLR0OOKIRLGOHVAICUFVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.310506263362E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":10},
"TableName":"comp-table",
"TableStatus":"CREATING"
}
}
```
## Acciones relacionadas
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)