UpdateTable - Amazon DynamoDB
DescripciónSolicitudesRespuestasErrores especialesEjemplosAcciones relacionadas

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.

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.

Los valores de desempeño provisionado se pueden aumentar o reducir según los máximos o mínimos indicados en Cuotas de tabla, servicio y cuenta en Amazon DynamoDB.

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.

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+1024). Para obtener más información sobre claves principales, consulte Clave principal.

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 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"}
}