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