ListTables - Amazon DynamoDB

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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 DynamoDB de bas niveau API. 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 DynamoDB de bas niveau API. 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"]}