ListTables

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.

Descrição

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

Sintaxe

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

Name (Nome)	Descrição	Obrigatório
Limit	Um número de nomes de tabela máximos a serem retornados. Type: 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

Sintaxe

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

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

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

Exemplos

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

Exemplo de solicitação

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

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

• DescribeTables

• CreateTable

• DeleteTable