ListTables - Amazon Timestream

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

Fournit une liste de tables, ainsi que le nom, le statut et les propriétés de rétention de chaque table. Voir l'exemple de code pour plus de détails.

Syntaxe de la requête

{ "DatabaseName": "string", "MaxResults": number, "NextToken": "string" }

Paramètres de demande

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.

La demande accepte les données suivantes au JSON format suivant.

DatabaseName

Nom de la base de données Timestream.

Type : String

Contraintes de longueur : Longueur minimum de 3. Longueur maximale de 256.

Obligatoire : non

MaxResults

Le nombre total d'éléments à renvoyer dans la sortie. Si le nombre total d'éléments disponibles est supérieur à la valeur spécifiée, un NextToken est fourni dans la sortie. Pour reprendre la pagination, indiquez la NextToken valeur comme argument d'un appel ultérieurAPI.

Type : entier

Plage valide : valeur minimum de 1. Valeur maximale de 20.

Obligatoire : non

NextToken

Le jeton de pagination. Pour reprendre la pagination, indiquez la NextToken valeur comme argument d'un appel ultérieurAPI.

Type : chaîne

Obligatoire : non

Syntaxe de la réponse

{ "NextToken": "string", "Tables": [ { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } ] }

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées sous JSON forme formatée par le service.

NextToken

Jeton permettant de spécifier où commencer la pagination. C'est le résultat NextToken d'une réponse tronquée précédemment.

Type : String

Tables

Une liste de tables.

Type : tableau d’objets Table

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

AccessDeniedException

Vous n'êtes pas autorisé à effectuer cette action.

HTTPCode de statut : 400

InternalServerException

Timestream n'a pas pu traiter complètement cette demande en raison d'une erreur interne du serveur.

HTTPCode de statut : 500

InvalidEndpointException

Le point de terminaison demandé n'était pas valide.

HTTPCode de statut : 400

ResourceNotFoundException

L'opération a tenté d'accéder à une ressource inexistante. La ressource n'est peut-être pas spécifiée correctement ou son statut ne l'est peut-être pasACTIVE.

HTTPCode de statut : 400

ThrottlingException

Trop de demandes ont été effectuées par un utilisateur et elles ont dépassé les quotas de service. La demande a été limitée.

HTTPCode de statut : 400

ValidationException

Une demande non valide ou mal formée.

HTTPCode de statut : 400

consultez aussi

Pour plus d'informations sur son utilisation API dans l'une des langues spécifiques AWS SDKs, consultez ce qui suit :