# UpdateTable
**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
Actualiza el desempeño aprovisionado de la tabla en cuestión. Configurar el rendimiento de una tabla para le ayuda a su administración; esto forma parte de la característica de rendimiento aprovisionado de DynamoDB. Para obtener más información, consulte [Modo de capacidad aprovisionada de DynamoDB](provisioned-capacity-mode.md).
Los valores de desempeño provisionado se pueden aumentar o reducir según los máximos o mínimos indicados en [Cuotas en Amazon DynamoDB](ServiceQuotas.md).
La tabla debe encontrarse en el estado `ACTIVE` para poder realizar correctamente esta operación. UpdateTable es una operación asíncrona; es decir, mientras se ejecuta la operación, la tabla se mantiene en el estado `UPDATING`. Mientras la tabla se encuentra en el estado `UPDATING`, sigue teniendo el rendimiento provisionado previo a la llamada. La nueva configuración de desempeño provisionado no entra en vigor hasta que la tabla vuelve al estado `ACTIVE` después de la operación UpdateTable.
## 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.UpdateTable
content-type: application/x-amz-json-1.0
{"TableName":"Table1",
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}
```
****
| Nombre | Descripción | Obligatorio |
| --- | --- | --- |
| TableName | Nombre de la tabla que se va a actualizar. Tipo: cadena | Sí |
| ProvisionedThroughput | Nuevo 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 | 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/json
Content-Length: 311
Date: Tue, 12 Jul 2011 21:31:03 GMT
{"TableDescription":
{"CreationDateTime":1.321657838135E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"AttributeValue1","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"AttributeValue2","AttributeType":"N"}},
"ProvisionedThroughput":
{"LastDecreaseDateTime":1.321661704489E9,
"LastIncreaseDateTime":1.321663607695E9,
"ReadCapacityUnits":5,
"WriteCapacityUnits":10},
"TableName":"Table1",
"TableStatus":"UPDATING"}}
```
****
| Nombre | Descripción |
| --- | --- |
| CreationDateTime | Fecha de creación de la tabla.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). El tamaño máximo de la clave hash es de 2048 bytes. El tamaño máximo de la clave de rango es de 1024 bytes. Ambos límites se aplican por separado (es decir, puede disponer de una clave combinada de rango y hash de 2048\$11024). 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 | Ajustes de desempeño actuales de la tabla especificada, incluidos los valores de `LastIncreaseDateTime` (si procede) y `LastDecreaseDateTime` (si procede). Tipo: matriz |
| TableName | Nombre de la tabla actualizada. Tipo: cadena |
| TableStatus | Estado actual de la tabla (CREATING, ACTIVE, DELETING o UPDATING), que debe ser UPDATING. Use la operación [DescribeTables](API_DescribeTables_v20111205.md) para comprobar el estado de la tabla. Tipo: cadena |
## Errores especiales
****
| Error | Descripción |
| --- | --- |
| ResourceNotFoundException | No se encontró la tabla especificada. |
| ResourceInUseException | La tabla no se encuentra en el estado ACTIVE. |
## Ejemplos
### 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.UpdateTable
content-type: application/x-amz-json-1.0
{"TableName":"comp1",
"ProvisionedThroughput":{"ReadCapacityUnits":5,"WriteCapacityUnits":15}
}
```
### Respuesta de ejemplo
```
HTTP/1.1 200 OK
content-type: application/x-amz-json-1.0
content-length: 390
Date: Sat, 19 Nov 2011 00:46:47 GMT
{"TableDescription":
{"CreationDateTime":1.321657838135E9,
"KeySchema":
{"HashKeyElement":{"AttributeName":"user","AttributeType":"S"},
"RangeKeyElement":{"AttributeName":"time","AttributeType":"N"}},
"ProvisionedThroughput":
{"LastDecreaseDateTime":1.321661704489E9,
"LastIncreaseDateTime":1.321663607695E9,
"ReadCapacityUnits":5,
"WriteCapacityUnits":10},
"TableName":"comp1",
"TableStatus":"UPDATING"}
}
```
## Acciones relacionadas
+ [CreateTable](API_CreateTable_v20111205.md)
+ [DescribeTables](API_DescribeTables_v20111205.md)
+ [DeleteTable](API_DeleteTable_v20111205.md)