ListTables - Amazon Timestream

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

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 格式的資料。

NextToken

用以指定分頁開始位置的字符。這是來自先前已截斷回應的 NextToken。

類型:字串

Tables

資料表清單。

類型:Table 物件陣列

錯誤

如需所有動作常見錯誤的資訊,請參閱常見錯誤

AccessDeniedException

您無權執行此動作。

HTTP 狀態碼:400

InternalServerException

由於內部伺服器錯誤,Timestream 無法完整處理此請求。

HTTP 狀態碼:500

InvalidEndpointException

請求的端點無效。

HTTP 狀態碼:400

ResourceNotFoundException

操作嘗試存取不存在的資源。資源可能未正確指定,或其狀態可能不是 ACTIVE。

HTTP 狀態碼:400

ThrottlingException

使用者提出的請求太多,而且超過服務配額。請求受到調節。

HTTP 狀態碼:400

ValidationException

無效或格式不正確的請求。

HTTP 狀態碼:400

另請參閱

如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊,請參閱以下內容: