如需與 Amazon Timestream for LiveAnalytics 類似的功能，請考慮使用 Amazon Timestream for InfluxDB。它提供簡化的資料擷取和單一位數毫秒查詢回應時間，以進行即時分析。[在這裡](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)進一步了解。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # Amazon Timestream 寫入 Amazon Timestream Write 支援下列動作： + [CreateBatchLoadTask](API_CreateBatchLoadTask.md) + [CreateDatabase](API_CreateDatabase.md) + [CreateTable](API_CreateTable.md) + [DeleteDatabase](API_DeleteDatabase.md) + [DeleteTable](API_DeleteTable.md) + [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) + [DescribeDatabase](API_DescribeDatabase.md) + [DescribeEndpoints](API_DescribeEndpoints.md) + [DescribeTable](API_DescribeTable.md) + [ListBatchLoadTasks](API_ListBatchLoadTasks.md) + [ListDatabases](API_ListDatabases.md) + [ListTables](API_ListTables.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateDatabase](API_UpdateDatabase.md) + [UpdateTable](API_UpdateTable.md) + [WriteRecords](API_WriteRecords.md) # CreateBatchLoadTask 建立新的 Timestream 批次載入任務。批次載入任務會處理 S3 位置中 CSV 來源的資料，並寫入 Timestream 資料表。在批次載入任務中定義從來源到目標的映射。錯誤和事件會寫入 S3 位置的報告。對於報告，如果未指定 AWS KMS 金鑰，則當 `SSE_S3`是 選項時，報告將使用 S3 受管金鑰加密。否則會擲回錯誤。如需詳細資訊，請參閱 [AWS 受管金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。如需詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html)。 ## 請求語法 ``` { "ClientToken": "string", "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "TargetDatabaseName": "string", "TargetTableName": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) ** 類型：字串 長度限制：長度下限為 1。長度上限為 64。 必要：否 ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 類型：[DataModelConfiguration](API_DataModelConfiguration.md) 物件 必要：否 ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 定義批次載入任務之資料來源的組態詳細資訊。 類型：[DataSourceConfiguration](API_DataSourceConfiguration.md) 物件 必要：是 ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) ** 類型：Long 必要：否 ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 批次載入任務的報告組態。這包含錯誤報告存放位置的詳細資訊。 類型：[ReportConfiguration](API_ReportConfiguration.md) 物件 必要：是 ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) ** 批次載入任務的目標 Timestream 資料庫。 類型：字串 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) ** 批次載入任務的目標 Timestream 資料表。 類型：字串 模式：`[a-zA-Z0-9_.-]+` 必要：是 ## 回應語法 ``` { "TaskId": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) ** 批次載入任務的 ID。 類型：字串 長度限制：長度下限為 3。長度上限為 32。 模式：`[A-Z0-9]+` ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** ConflictException ** Timestream 無法處理此請求，因為它包含已存在的資源。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask) # CreateDatabase 建立新的 Timestream 資料庫。如果未指定 AWS KMS 金鑰，則會使用您帳戶中的 Timestream 受管 AWS KMS 金鑰來加密資料庫。如需詳細資訊，請參閱 [AWS 受管金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。如需詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html)。 ## 請求語法 ``` { "DatabaseName": "string", "KmsKeyId": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_CreateDatabase_RequestSyntax) ** Timestream 資料庫的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [KmsKeyId](#API_CreateDatabase_RequestSyntax) ** 資料庫的 AWS KMS 金鑰。如果未指定 AWS KMS 金鑰，則會使用您帳戶中的 Timestream 受管 AWS KMS 金鑰來加密資料庫。如需詳細資訊，請參閱 [AWS 受管金鑰](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk)。 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 必要：否 ** [Tags](#API_CreateDatabase_RequestSyntax) ** 標記資料表的鍵值對清單。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 必要：否 ## 回應語法 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Database](#API_CreateDatabase_ResponseSyntax) ** 新建立的 Timestream 資料庫。 類型：[Database](API_Database.md) 物件 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** ConflictException ** Timestream 無法處理此請求，因為它包含已存在的資源。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateDatabase) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateDatabase) # CreateTable 將新資料表新增至您帳戶中的現有資料庫。在 中 AWS 帳戶，如果資料表名稱位於相同的資料庫中，則每個區域中的資料表名稱必須至少是唯一的。如果資料表位於不同的資料庫中，您可能在同一區域中有相同的資料表名稱。建立資料表時，您必須指定資料表名稱、資料庫名稱，以及保留屬性。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "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", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_CreateTable_RequestSyntax) ** Timestream 資料庫的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) ** 包含啟用磁性存放區寫入時要在表格上設定的屬性。 類型：[MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 物件 必要：否 ** [RetentionProperties](#API_CreateTable_RequestSyntax) ** 您的時間序列資料必須存放在記憶體存放區和磁性存放區的持續時間。 類型：[RetentionProperties](API_RetentionProperties.md) 物件 必要：否 ** [Schema](#API_CreateTable_RequestSyntax) ** 資料表的結構描述。 類型：[Schema](API_Schema.md) 物件 必要：否 ** [TableName](#API_CreateTable_RequestSyntax) ** Timestream 資料表的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 模式：`[a-zA-Z0-9_.-]+` 必要：是 ** [Tags](#API_CreateTable_RequestSyntax) ** 標記資料表的鍵值對清單。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 必要：否 ## 回應語法 ``` { "Table": { "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 格式的資料。 ** [Table](#API_CreateTable_ResponseSyntax) ** 新建立的 Timestream 資料表。 類型：[Table](API_Table.md) 物件 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** ConflictException ** Timestream 無法處理此請求，因為它包含已存在的資源。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateTable) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateTable) # DeleteDatabase 刪除指定的 Timestream 資料庫。*這是不可復原的操作。刪除資料庫後，無法復原資料表中的時間序列資料。* **注意** 必須先刪除資料庫中的所有資料表，否則會擲回 ValidationException 錯誤。 由於分散式重試的性質，操作可能會傳回成功或 ResourceNotFoundException。用戶端應該將其視為同等項目。 有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html)。 ## 請求語法 ``` { "DatabaseName": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_DeleteDatabase_RequestSyntax) ** 要刪除的 Timestream 資料庫名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteDatabase) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteDatabase) # DeleteTable 刪除指定的 Timestream 資料表。這是不可復原的操作。刪除 Timestream 資料庫資料表後，無法復原存放在資料表中的時間序列資料。 **注意** 由於分散式重試的性質，操作可能會傳回成功或 ResourceNotFoundException。用戶端應該將其視為同等項目。 有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "TableName": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_DeleteTable_RequestSyntax) ** 要刪除 Timestream 資料庫的資料庫名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ** [TableName](#API_DeleteTable_RequestSyntax) ** 要刪除的 Timestream 資料表名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteTable) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteTable) # DescribeBatchLoadTask 傳回批次載入任務的相關資訊，包括組態、映射、進度和其他詳細資訊。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-batch-load.html)。 ## 請求語法 ``` { "TaskId": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) ** 批次載入任務的 ID。 類型：字串 長度限制：長度下限為 3。長度上限為 32。 模式：`[A-Z0-9]+` 必要：是 ## 回應語法 ``` { "BatchLoadTaskDescription": { "CreationTime": number, "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "ErrorMessage": "string", "LastUpdatedTime": number, "ProgressReport": { "BytesMetered": number, "FileFailures": number, "ParseFailures": number, "RecordIngestionFailures": number, "RecordsIngested": number, "RecordsProcessed": number }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "ResumableUntil": number, "TargetDatabaseName": "string", "TargetTableName": "string", "TaskId": "string", "TaskStatus": "string" } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) ** 批次載入任務的描述。 類型：[BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) 物件 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeBatchLoadTask) # DescribeDatabase 傳回資料庫的相關資訊，包括資料庫名稱、建立資料庫的時間，以及在資料庫中找到的資料表總數。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html)。 ## 請求語法 ``` { "DatabaseName": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_DescribeDatabase_RequestSyntax) ** Timestream 資料庫的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ## 回應語法 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Database](#API_DescribeDatabase_ResponseSyntax) ** Timestream 資料表的名稱。 類型：[Database](API_Database.md) 物件 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeDatabase) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeDatabase) # DescribeEndpoints 傳回可用端點的清單，以進行 Timestream API 呼叫。此 API 操作可透過寫入和查詢 APIs使用。 由於 Timestream SDKs旨在透明地使用服務的架構，包括服務端點的管理和映射，*因此我們不建議您使用此 API 操作，除非*： + 您使用 [VPC 端點 (AWS PrivateLink) 搭配 Timestream](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) + 您的應用程式使用尚未支援 SDK 的程式設計語言 + 您需要更好地控制用戶端實作 如需如何使用和何時實作 DescribeEndpoints 的詳細資訊，請參閱[端點探索模式](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery)。 ## 回應語法 ``` { "Endpoints": [ { "Address": "string", "CachePeriodInMinutes": number } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) ** 發出`DescribeEndpoints`請求時，會傳回`Endpoints`物件。 類型：[Endpoint](API_Endpoint.md) 物件陣列 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeEndpoints) # DescribeTable 傳回資料表的相關資訊，包括資料表名稱、資料庫名稱、記憶體存放區和磁性存放區的保留期間。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "TableName": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_DescribeTable_RequestSyntax) ** Timestream 資料庫的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ** [TableName](#API_DescribeTable_RequestSyntax) ** Timestream 資料表的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ## 回應語法 ``` { "Table": { "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 格式的資料。 ** [Table](#API_DescribeTable_ResponseSyntax) ** Timestream 資料表。 類型：[Table](API_Table.md) 物件 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeTable) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeTable) # ListBatchLoadTasks 提供批次載入任務的清單，以及任務在 之前可繼續執行的名稱、狀態和其他詳細資訊。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html)。 ## 請求語法 ``` { "MaxResults": number, "NextToken": "string", "TaskStatus": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) ** 要在輸出中傳回的項目總數。如果可用的項目總數超過指定的值，則會在輸出中提供 NextToken。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。 類型：整數 有效範圍：最小值為 1。最大值為 100。 必要：否 ** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) ** 用以指定分頁開始位置的字符。這是來自先前已截斷回應的 NextToken。 類型：字串 必要：否 ** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) ** 批次載入任務的狀態。 類型：字串 有效值:`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必要：否 ## 回應語法 ``` { "BatchLoadTasks": [ { "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "ResumableUntil": number, "TableName": "string", "TaskId": "string", "TaskStatus": "string" } ], "NextToken": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) ** 批次載入任務詳細資訊的清單。 類型：[BatchLoadTask](API_BatchLoadTask.md) 物件陣列 ** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) ** 用以指定分頁開始位置的字符。提供下一個 ListBatchLoadTasksRequest。 類型：字串 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListBatchLoadTasks) # ListDatabases 傳回 Timestream 資料庫的清單。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html)。 ## 請求語法 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_ListDatabases_RequestSyntax) ** 要在輸出中傳回的項目總數。如果可用的項目總數超過指定的值，則會在輸出中提供 NextToken。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。 類型：整數 有效範圍：最小值為 1。最大值為 20。 必要：否 ** [NextToken](#API_ListDatabases_RequestSyntax) ** 分頁字符。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。 類型：字串 必要：否 ## 回應語法 ``` { "Databases": [ { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } ], "NextToken": "string" } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Databases](#API_ListDatabases_ResponseSyntax) ** 資料庫名稱清單。 類型：[Database](API_Database.md) 物件陣列 ** [NextToken](#API_ListDatabases_ResponseSyntax) ** 分頁字符。當回應被截斷時，會傳回此參數。 類型：字串 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListDatabases) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListDatabases) # ListTables 提供資料表清單，以及每個資料表的名稱、狀態和保留屬性。有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "MaxResults": number, "NextToken": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_ListTables_RequestSyntax) ** Timestream 資料庫的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：否 ** [MaxResults](#API_ListTables_RequestSyntax) ** 要在輸出中傳回的項目總數。如果可用的項目總數超過指定的值，則會在輸出中提供 NextToken。若要繼續分頁，請提供 NextToken 值做為後續 API 呼叫的引數。 類型：整數 有效範圍：最小值為 1。最大值為 20。 必要：否 ** [NextToken](#API_ListTables_RequestSyntax) ** 分頁字符。若要繼續分頁，請提供 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](#API_ListTables_ResponseSyntax) ** 用以指定分頁開始位置的字符。這是來自先前已截斷回應的 NextToken。 類型：字串 ** [Tables](#API_ListTables_ResponseSyntax) ** 資料表清單。 類型：[Table](API_Table.md) 物件陣列 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListTables) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTables) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTables) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTables) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTables) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTables) # ListTagsForResource 列出 Timestream 資源上的所有標籤。 ## 請求語法 ``` { "ResourceARN": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) ** 要列出標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度下限為 1。長度上限為 1011。 必要：是 ## 回應語法 ``` { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** 目前與 Timestream 資源相關聯的標籤。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTagsForResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTagsForResource) # ResumeBatchLoadTask ## 請求語法 ``` { "TaskId": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) ** 要繼續的批次載入任務 ID。 類型：字串 長度限制：長度下限為 3。長度上限為 32。 模式：`[A-Z0-9]+` 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ResumeBatchLoadTask) # TagResource 將一組標籤與 Timestream 資源建立關聯。然後，您可以啟用這些使用者定義的標籤，使其顯示在 Billing and Cost Management 主控台上，以進行成本分配追蹤。 ## 請求語法 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_TagResource_RequestSyntax) ** 識別應新增標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度下限為 1。長度上限為 1011。 必要：是 ** [Tags](#API_TagResource_RequestSyntax) ** 要指派給 Timestream 資源的標籤。 類型：[Tag](API_Tag.md) 物件陣列 陣列成員：項目數下限為 0。項目數上限為 200。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/TagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/TagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/TagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/TagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/TagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/TagResource) # UntagResource 從 Timestream 資源移除標籤的關聯。 ## 請求語法 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_UntagResource_RequestSyntax) ** 要從中移除標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。 類型：字串 長度限制：長度下限為 1。長度上限為 1011。 必要：是 ** [TagKeys](#API_UntagResource_RequestSyntax) ** 標籤索引鍵的清單。資源的現有標籤，其金鑰是此清單的成員，將會從 Timestream 資源中移除。 類型：字串陣列 陣列成員：項目數下限為 0。項目數上限為 200。 長度限制：長度下限為 1。長度上限為 128。 必要：是 ## 回應元素 如果動作成功，則服務會傳回具空 HTTP 內文的 HTTP 200 回應。 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UntagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UntagResource) # UpdateDatabase 修改現有資料庫的 AWS KMS 金鑰。更新資料庫時，您必須指定要使用的新 AWS KMS 金鑰的資料庫名稱和識別符 (`KmsKeyId`)。如果有任何並行`UpdateDatabase`請求，第一個寫入器會獲勝。 有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html)。 ## 請求語法 ``` { "DatabaseName": "string", "KmsKeyId": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_UpdateDatabase_RequestSyntax) ** 資料庫的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) ** 用來加密資料庫中存放資料之新 AWS KMS 金鑰 (`KmsKeyId`) 的識別符。如果`KmsKeyId`目前向資料庫註冊的 與請求`KmsKeyId`中的 相同，則不會有任何更新。 您可以使用下列`KmsKeyId`任一項來指定 ： + 金鑰 ID：`1234abcd-12ab-34cd-56ef-1234567890ab` + 金鑰 ARN：`arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab` + 別名名稱：`alias/ExampleAlias` + 別名 ARN：`arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias` 類型：字串 長度限制：長度下限為 1。長度上限為 2048。 必要：是 ## 回應語法 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [Database](#API_UpdateDatabase_ResponseSyntax) ** 資料表的最上層容器。資料庫和資料表是 Amazon Timestream 中的基本管理概念。資料庫中的所有資料表都會使用相同的 AWS KMS 金鑰加密。 類型：[Database](API_Database.md) 物件 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完全處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ServiceQuotaExceededException ** 此帳戶超過資源的執行個體配額。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase) # UpdateTable 修改 Timestream 資料表的記憶體存放區和磁性存放區的保留期間。請注意，保留期間的變更會立即生效。例如，如果記憶體存放區的保留期間最初設定為 2 小時，然後變更為 24 小時，則記憶體存放區將能夠保留 24 小時的資料，但在進行此變更的 22 小時後將填入 24 小時的資料。Timestream 不會從磁性存放區擷取資料來填入記憶體存放區。 有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-table.html)。 ## 請求語法 ``` { "DatabaseName": "string", "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" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [DatabaseName](#API_UpdateTable_RequestSyntax) ** Timestream 資料庫的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) ** 包含啟用磁性存放區寫入時要在表格上設定的屬性。 類型：[MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) 物件 必要：否 ** [RetentionProperties](#API_UpdateTable_RequestSyntax) ** 記憶體存放區和磁性存放區的保留期間。 類型：[RetentionProperties](API_RetentionProperties.md) 物件 必要：否 ** [Schema](#API_UpdateTable_RequestSyntax) ** 資料表的結構描述。 類型：[Schema](API_Schema.md) 物件 必要：否 ** [TableName](#API_UpdateTable_RequestSyntax) ** Timestream 資料表的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ## 回應語法 ``` { "Table": { "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 格式的資料。 ** [Table](#API_UpdateTable_ResponseSyntax) ** 更新的 Timestream 資料表。 類型：[Table](API_Table.md) 物件 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateTable) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateTable) # WriteRecords 可讓您將時間序列資料寫入 Timestream。您可以指定要插入系統的單一資料點或一批資料點。Timestream 為您提供彈性的結構描述，可根據您叫用寫入資料庫時指定的資料點維度名稱和資料類型，自動偵測 Timestream 資料表的資料欄名稱和資料類型。 Timestream 支援最終一致性讀取語意。這表示當您在將一批資料寫入 Timestream 後立即查詢資料時，查詢結果可能不會反映最近完成的寫入操作的結果。結果也可能包含一些過時的資料。如果您在短時間內重複查詢請求，結果應該會傳回最新的資料。[服務配額適用](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。 有關詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html)。 **Upserts** 您可以在`WriteRecords`請求中使用 `Version` 參數來更新資料點。Timestream 會追蹤每個記錄的版本編號。當未在請求中為記錄指定`1`時， `Version`預設為 。Timestream 會在收到寫入請求`Version`時，更新現有記錄的度量值及其 ，該記錄的寫入請求具有較高的`Version`數字。當它收到更新請求，其中度量值與現有記錄的值相同時，如果 Timestream 大於 的現有值`Version`，則仍然會更新 `Version`。只要 的值`Version`持續增加，您就可以視需要多次更新資料點。 例如，假設您在 請求`Version`中沒有指示 的情況下撰寫新記錄。Timestream 會儲存此記錄，並將 `Version`設定為 `1`。現在，假設您嘗試使用具有不同度量值的相同記錄`WriteRecords`請求來更新此記錄，但和之前一樣，不提供 `Version`。在此情況下，Timestream 會使用 拒絕此更新，`RejectedRecordsException`因為更新記錄的版本不大於 版本的現有值。 不過，如果您要重新傳送 `Version` 設定為 的更新請求`2`，則 Timestream 會成功更新記錄的值，而 `Version`會設定為 `2`。接著，假設您已傳送具有相同記錄和相同度量值的`WriteRecords`請求，但將 `Version` 設定為 `3`。在此情況下，Timestream 只會更新`Version`為 `3`。任何進一步的更新都需要傳送大於 的版本編號`3`，否則更新請求會收到 `RejectedRecordsException`。 ## 請求語法 ``` { "CommonAttributes": { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number }, "DatabaseName": "string", "Records": [ { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number } ], "TableName": "string" } ``` ## 請求參數 如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。 請求接受採用 JSON 格式的下列資料。 ** [CommonAttributes](#API_WriteRecords_RequestSyntax) ** 包含請求中所有記錄之間共用的常見度量、維度、時間和版本屬性的記錄。將資料寫入 Timestream 時，指定的量值和維度屬性將與記錄物件中的量值和維度屬性合併。維度可能不會重疊，或者`ValidationException`會擲回 。換句話說，記錄必須包含具有唯一名稱的維度。 類型：[Record](API_Record.md) 物件 必要：否 ** [DatabaseName](#API_WriteRecords_RequestSyntax) ** Timestream 資料庫的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ** [Records](#API_WriteRecords_RequestSyntax) ** 記錄陣列，其中包含每個時間序列資料點的唯一度量、維度、時間和版本屬性。 類型：[Record](API_Record.md) 物件陣列 陣列成員：項目數下限為 1。項目數上限為 100。 必要：是 ** [TableName](#API_WriteRecords_RequestSyntax) ** Timestream 資料表的名稱。 類型：字串 長度限制：長度下限為 3。長度上限為 256。 必要：是 ## 回應語法 ``` { "RecordsIngested": { "MagneticStore": number, "MemoryStore": number, "Total": number } } ``` ## 回應元素 如果動作成功，則服務傳回 HTTP 200 回應。 服務會傳回下列 JSON 格式的資料。 ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) ** 此請求所擷取之記錄的相關資訊。 類型：[RecordsIngested](API_RecordsIngested.md) 物件 ## 錯誤 如需所有動作常見錯誤的資訊，請參閱[常見錯誤](CommonErrors.md)。 ** AccessDeniedException ** 您無權執行此動作。 HTTP 狀態碼：400 ** InternalServerException ** 由於內部伺服器錯誤，Timestream 無法完整處理此請求。 HTTP 狀態碼：500 ** InvalidEndpointException ** 請求的端點無效。 HTTP 狀態碼：400 ** RejectedRecordsException ** WriteRecords 會在下列情況下擲回此例外狀況： + 具有重複資料的記錄，其中有多個記錄具有相同的維度、時間戳記和度量名稱，但： + 測量值不同 + 版本不存在於請求中，*或*新記錄中的版本值等於或低於現有值 在此情況下，如果 Timestream 拒絕資料，`RejectedRecords`回應中的 `ExistingVersion` 欄位會指出目前記錄的版本。若要強制更新，您可以將記錄集的版本 重新傳送請求至大於 的值`ExistingVersion`。 + 時間戳記超過記憶體存放區保留期間的記錄。 + 維度或量值超過 Timestream 定義限制的記錄。 如需詳細資訊，請參閱《Amazon Timestream 開發人員指南[》中的配額](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。 ** RejectedRecords ** HTTP 狀態碼：400 ** ResourceNotFoundException ** 操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。 HTTP 狀態碼：400 ** ThrottlingException ** 使用者提出的請求太多，而且超過服務配額。請求受到調節。 HTTP 狀態碼：400 ** ValidationException ** 無效或格式不正確的請求。 HTTP 狀態碼：400 ## 另請參閱 如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱下列內容： + [AWS 命令列界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords)