Returns an array of table names associated with the current account and endpoint. The
output from ListTables is paginated, with each page returning a maximum of
100 table names.
Request Syntax
{
"ExclusiveStartTableName": "string",
"Limit": number
}Request Parameters
The request accepts the following data in JSON format.
Note
In the following list, the required parameters are described first.
- ExclusiveStartTableName
-
The first table name that this operation will evaluate. Use the value that was returned for
LastEvaluatedTableNamein a previous operation, so that you can obtain the next page of results.Type: String
Length Constraints: Minimum length of 3. Maximum length of 255.
Pattern:
[a-zA-Z0-9_.-]+Required: No
- Limit
-
A maximum number of table names to return. If this parameter is not specified, the limit is 100.
Type: Integer
Valid Range: Minimum value of 1. Maximum value of 100.
Required: No
Response Syntax
{
"LastEvaluatedTableName": "string",
"TableNames": [ "string" ]
}Response Elements
If the action is successful, the service sends back an HTTP 200 response.
The following data is returned in JSON format by the service.
- LastEvaluatedTableName
-
The name of the last table in the current page of results. Use this value as the
ExclusiveStartTableNamein a new request to obtain the next page of results, until all the table names are returned.If you do not receive a
LastEvaluatedTableNamevalue in the response, this means that there are no more table names to be retrieved.Type: String
Length Constraints: Minimum length of 3. Maximum length of 255.
Pattern:
[a-zA-Z0-9_.-]+ - TableNames
-
The names of the tables associated with the current account at the current endpoint. The maximum size of this array is 100.
If
LastEvaluatedTableNamealso appears in the output, you can use this value as theExclusiveStartTableNameparameter in a subsequentListTablesrequest and obtain the next page of results.Type: Array of strings
Length Constraints: Minimum length of 3. Maximum length of 255.
Pattern:
[a-zA-Z0-9_.-]+
Errors
For information about the errors that are common to all actions, see Common Errors.
- InternalServerError
-
An error occurred on the server side.
HTTP Status Code: 500
Examples
List Tables
This example requests a list of tables, starting with a table named
Forum and ending after three table names have been
returned.
Sample Request
POST / HTTP/1.1
Host: dynamodb.<region>.<domain>;
Accept-Encoding: identity
Content-Length: <PayloadSizeBytes>
User-Agent: <UserAgentString>
Content-Type: application/x-amz-json-1.0
Authorization: AWS4-HMAC-SHA256 Credential=<Credential>, SignedHeaders=<Headers>, Signature=<Signature>
X-Amz-Date: <Date>
X-Amz-Target: DynamoDB_20120810.ListTables
{
"ExclusiveStartTableName": "Forum",
"Limit": 3
}Sample Response
HTTP/1.1 200 OK
x-amzn-RequestId: <RequestId>
x-amz-crc32: <Checksum>
Content-Type: application/x-amz-json-1.0
Content-Length: <PayloadSizeBytes>
Date: <Date>
{
"LastEvaluatedTableName": "Thread",
"TableNames": ["Forum","Reply","Thread"]
}See Also
For more information about using this API in one of the language-specific AWS SDKs, see the following:
