ListTables

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

Muestra una matriz de todas las tablas asociadas con la cuenta y el punto de enlace actuales.

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-east-1.amazonaws.com, son completamente independientes y no comparten ningún dato. La operación ListTables devuelve todos los nombres de las tablas asociadas con la cuenta que realiza la solicitud para el punto de enlace que recibe la solicitud.

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.ListTables
content-type: application/x-amz-json-1.0

{"ExclusiveStartTableName":"Table1","Limit":3}

De forma predeterminada, la operación ListTables solicita todos los nombres de las tablas asociadas con la cuenta que realiza la solicitud para el punto de enlace que recibe la solicitud.

Nombre	Descripción	Obligatorio
Limit	Número máximo de nombres de tabla que se devolverán. Tipo: entero	No
ExclusiveStartTableName	Nombre de la primera tabla de la lista. Si ya se ha ejecutado una operación ListTables y se ha recibido un valor LastEvaluatedTableName en la respuesta, use ese valor aquí para continuar la lista. Tipo: cadena	No

Respuestas

Sintaxis

HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT

{"TableNames":["Table1","Table2","Table3"], "LastEvaluatedTableName":"Table3"}

Nombre	Descripción
TableNames	Nombres de las tablas asociadas con la cuenta actual en el punto de enlace actual. Tipo: matriz
LastEvaluatedTableName	Nombre de la última tabla de la lista actual, pero solo si no se han devuelto algunas tablas de la cuenta y el punto de enlace. Este valor no existe en una respuesta si ya se han devuelto los nombres de todas las tablas. Use este valor en ExclusiveStartTableName en una nueva solicitud para continuar la lista hasta que se hayan devuelto los nombres de todas las tablas. Tipo: cadena

Errores especiales

No hay errores específicos de esta operación.

Ejemplos

En los ejemplos siguientes se muestra una solicitud HTTP POST y su respuesta utilizando la operación ListTables.

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.ListTables
content-type: application/x-amz-json-1.0

{"ExclusiveStartTableName":"comp2","Limit":3}

Respuesta de ejemplo

HTTP/1.1 200 OK
x-amzn-RequestId: S1LEK2DPQP8OJNHVHL8OU2M7KRVV4KQNSO5AEMVJF66Q9ASUAAJG
content-type: application/x-amz-json-1.0
content-length: 81
Date: Fri, 21 Oct 2011 20:35:38 GMT

{"LastEvaluatedTableName":"comp5","TableNames":["comp3","comp4","comp5"]}

Acciones relacionadas

• DescribeTables

• CreateTable

• DeleteTable