ListTables

Important

Cette section fait référence à l'API version 2011-12-05 qui est obsolète et ne doit pas être utilisée pour de nouvelles applications.

Pour une documentation sur l'API de bas niveau actuelle, consultez la Référence d'API Amazon DynamoDB.

Description

Renvoie un tableau de toutes les tables associées au compte et au point de terminaison actuels

Chaque point de terminaison DynamoDB est entièrement indépendant. Par exemple, si vous avez deux tables nommées « MyTable », l'une dans la région dynamodb.us-west-2.amazonaws.com et l'autre dans la région dynamodb.us-east-1.amazonaws.com, ces tables sont complètement indépendantes et ne partagent aucune donnée. L'opération ListTables renvoie tous les noms de table associés au compte faisant la demande pour le point de terminaison recevant la demande.

Requêtes

Syntaxe

// This header is abbreviated. 
// For a sample of a complete header, see API de bas niveau de DynamoDB.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.ListTables
content-type: application/x-amz-json-1.0

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

Par défaut, l'opération ListTables demande tous les noms de table associés au compte faisant la demande pour le point de terminaison recevant la demande.

Nom	Description	Obligatoire
Limit	Nombre maximum de noms de table à renvoyer. Type : entier	Non
ExclusiveStartTableName	Nom de la table qui démarre la liste. Si vous avez déjà exécuté une opération ListTables et reçu une valeur LastEvaluatedTableName dans la réponse, utilisez cette valeur ici pour continuer la liste. Type : chaîne	Non

Réponses

Syntaxe

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 (Nom)	Description
TableNames	Noms des tables associées au compte actuel au point de terminaison actuel. Type : Array
LastEvaluatedTableName	Nom de la dernière table dans la liste active, uniquement si certaines tables pour le compte et le point de terminaison n'ont pas été renvoyées. Cette valeur n'existe pas dans une réponse si tous les noms de table sont déjà renvoyés. Utilisez cette valeur en tant que ExclusiveStartTableName dans une nouvelle demande pour continuer la liste jusqu'à ce que tous les noms de table soient renvoyés. Type : chaîne

Erreurs spéciales

Il n'existe pas d'erreur spécifique de cette opération.

Exemples

Les exemples suivants illustrent une requête HTTP POST et une réponse utilisant l'opération ListTables.

Exemple de demande

// This header is abbreviated. 
// For a sample of a complete header, see API de bas niveau de DynamoDB.
POST / HTTP/1.1 
x-amz-target: DynamoDB_20111205.ListTables
content-type: application/x-amz-json-1.0

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

Exemple de réponse

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

Actions connexes

• DescribeTables

• CreateTable

• DeleteTable