本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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格式返回。
错误
有关所有操作的常见错误的信息,请参阅常见错误。
- AccessDeniedException
-
您无权执行此操作。
HTTP状态码:400
- InternalServerException
-
由于内部服务器错误,Timestream 无法完全处理此请求。
HTTP状态码:500
- InvalidEndpointException
-
请求的端点无效。
HTTP状态码:400
- ResourceNotFoundException
-
该操作试图访问一个不存在的资源。可能未正确指定资源,或者其状态可能不正确ACTIVE。
HTTP状态码:400
- ThrottlingException
-
用户发出的请求太多,超过了服务配额。请求已被阻止。
HTTP状态码:400
- ValidationException
-
无效或格式错误的请求。
HTTP状态码:400
另请参阅
有关API在一种特定语言中使用此功能的更多信息 AWS SDKs,请参阅以下内容: