# ListTables
<a name="API_ListTables_v20111205"></a>

**Importante**  
***Esta seção refere-se à versão de API 2011-12-05, que está obsoleta e não deve ser usada para novos aplicativos.***  
 **Para obter a documentação da API de baixo nível atual, consulte a [Referência da API do Amazon DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/APIReference/).**

## Descrição
<a name="API_ListTables_Description"></a>

Retorna uma matriz de todas as tabelas associadas à conta e ao endpoint atuais.

Cada endpoint do DynamoDB é totalmente independente. Por exemplo, se você tiver duas tabelas chamadas “MyTable”, uma em dynamodb.us-west-2.amazonaws.com e outra em dynamodb.us-east-1.amazonaws.com, elas serão completamente independentes e não compartilharão nenhum dado. A operação ListTables retorna todos os nomes de tabelas associados à conta que está fazendo a solicitação, para o endpoint que recebe a solicitação.

## Solicitações
<a name="API_ListTables_RequestParameters"></a>

### Sintaxe
<a name="API_ListTables_RequestParameters.syntax"></a>

```
// This header is abbreviated. 
// For a sample of a complete header, see API de baixo nível do DynamoDB.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.ListTables
content-type: application/x-amz-json-1.0

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

Por padrão, a operação ListTables solicita todos os nomes de tabelas associados à conta que está fazendo a solicitação, para o endpoint que recebe a solicitação.


****  

|  Nome  |  Descrição  | Obrigatório | 
| --- | --- | --- | 
|  Limit  |  Um número de nomes de tabela máximos a serem retornados.  Tipo: número inteiro  | Não | 
| ExclusiveStartTableName  | O nome da tabela que inicia a lista. Se você já executou uma operação ListTables e recebeu um valor `LastEvaluatedTableName` na resposta, use esse valor aqui para continuar a lista. Tipo: string | Não | 

## Respostas
<a name="API_ListTables_ResponseElements"></a>

### Sintaxe
<a name="API_ListTables_ResponseElements.syntax"></a>

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


****  

|  Nome  |  Descrição  | 
| --- | --- | 
|  TableNames  |  Os nomes das tabelas associadas à conta atual no endpoint atual.  Tipo: matriz  | 
| LastEvaluatedTableName  | O nome da última tabela na lista atual, somente se algumas tabelas da conta e do endpoint não tiverem sido retornadas. Esse valor não existirá em uma resposta se todos os nomes de tabelas já tiverem sido retornados. Use esse valor como o `ExclusiveStartTableName` em uma nova solicitação para continuar a lista até que todos os nomes das tabelas sejam retornados.  Tipo: string  | 

## Erros especiais
<a name="API_ListTables_SpecialErrors"></a>

Nenhum erro é específico dessa operação.

## Exemplos
<a name="API_ListTables_Examples"></a>

Os exemplos a seguir mostram uma solicitação e uma resposta HTTP POST usando a operação ListTables.

### Exemplo de solicitação
<a name="API_ListTables_Examples_Request"></a>

```
// This header is abbreviated. 
// For a sample of a complete header, see API de baixo nível do DynamoDB.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.ListTables
content-type: application/x-amz-json-1.0

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

### Exemplo de resposta
<a name="API_ListTables_Examples_Response"></a>

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

## Ações relacionadas
<a name="API_ListTables_Related_Actions"></a>
+  [DescribeTables](API_DescribeTables_v20111205.md) 
+  [CreateTable](API_CreateTable_v20111205.md) 
+  [DeleteTable](API_DeleteTable_v20111205.md)