UpdateTable - Amazon Timestream

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

UpdateTable

修改 Timestream 表的内存存储和磁性存储的保留时间。请注意,保留期限的更改会立即生效。例如,如果内存存储的保留期最初设置为 2 小时,然后更改为 24 小时,则内存存储将能够保存 24 小时的数据,但在进行此更改后 22 小时将填充 24 小时的数据。Timestream 不会从磁性存储中检索数据来填充内存存储。

请参阅代码示例,了解详细信息。

请求语法

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

请求参数

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

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

DatabaseName

Timestream 数据库的名称。

类型:字符串

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

必需:是

MagneticStoreWriteProperties

包含启用磁存储写入时要在表上设置的属性。

类型:MagneticStoreWriteProperties 对象

必需:否

RetentionProperties

存储器和磁性存储器的保留时间。

类型:RetentionProperties 对象

必需:否

Schema

表的架构。

类型:Schema 对象

必需:否

TableName

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

更新后的时间流表。

类型:Table 对象

错误

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

AccessDeniedException

您无权执行此操作。

HTTP状态码:400

InternalServerException

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

HTTP状态码:500

InvalidEndpointException

请求的端点无效。

HTTP状态码:400

ResourceNotFoundException

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

HTTP状态码:400

ThrottlingException

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

HTTP状态码:400

ValidationException

无效或格式错误的请求。

HTTP状态码:400

另请参阅

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