ListTables - Amazon Timestream

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

ListTables

提供表列表以及每个表的名称、状态和保留属性。请参阅代码示例,了解详细信息。

请求语法

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

请求参数

有关所有操作的通用参数的信息,请参阅通用参数

该请求接受以下JSON格式的数据。

DatabaseName

Timestream 数据库的名称。

类型:字符串

长度约束:最小长度为 3。最大长度为 256。

必需:否

MaxResults

要在输出中返回的项目总数。如果可用项目总数大于指定值,则输出中会提供 a NextToken 。要恢复分页,请提供该 NextToken 值作为后续API调用的参数。

类型:整数

有效范围:最小值为 1。最大值为 20。

必需:否

NextToken

分页标记。要恢复分页,请提供该 NextToken 值作为后续API调用的参数。

类型:字符串

必需:否

响应语法

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

响应元素

如果操作成功,服务将发回 HTTP 200 响应。

以下数据由服务以JSON格式返回。

NextToken

指定从何处开始分页的令牌。这是之前截 NextToken 断的响应。

类型:字符串

Tables

表格列表。

类型:Table 对象数组

错误

有关所有操作的常见错误的信息,请参阅常见错误

AccessDeniedException

您无权执行此操作。

HTTP状态码:400

InternalServerException

由于内部服务器错误,Timestream 无法完全处理此请求。

HTTP状态码:500

InvalidEndpointException

请求的端点无效。

HTTP状态码:400

ResourceNotFoundException

该操作试图访问一个不存在的资源。可能未正确指定资源,或者其状态可能不正确ACTIVE。

HTTP状态码:400

ThrottlingException

用户发出的请求太多,超过了服务配额。请求已被阻止。

HTTP状态码:400

ValidationException

无效或格式错误的请求。

HTTP状态码:400

另请参阅

有关API在一种特定语言中使用此功能的更多信息 AWS SDKs,请参阅以下内容: