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