本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
ListTables
提供資料表清單,以及每個資料表的名稱、狀態和保留屬性。有關詳細資訊,請參閱程式碼範例。
請求語法
{
"DatabaseName": "string
",
"MaxResults": number
,
"NextToken": "string
"
}
請求參數
如需所有動作的一般參數資訊,請參閱《Common Parameters》。
請求接受採用 JSON 格式的下列資料。
- DatabaseName
-
Timestream 資料庫的名稱。
類型:字串
長度限制:長度下限為 3。長度上限為 256。
必要:否
- MaxResults
-
在輸出中傳回的項目總數。如果可用的項目總數超過指定的值,輸出中會提供 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
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱以下內容: