UpdateTable - Amazon Timestream
请求语法请求参数响应语法响应元素错误另请参阅

有关与适用于 LiveAnalytics 的 Amazon Timestream 类似的功能，可以考虑使用适用于 InfluxDB 的 Amazon Timestream。适用于 InfluxDB 的 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

更新后的 Timestream 表。

类型：Table 对象

错误

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

AccessDeniedException

您无权执行此操作。

HTTP 状态代码：400

InternalServerException

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

HTTP 状态代码：500

InvalidEndpointException

请求的端点无效。

HTTP 状态代码：400

ResourceNotFoundException

该操作试图访问不存在的资源。该资源可能未正确指定，或其状态可能不是“活动”状态。

HTTP 状态代码：400

ThrottlingException

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

HTTP 状态代码：400

ValidationException

请求无效或格式错误。

HTTP 状态代码：400

另请参阅

有关在特定语言的 AWS SDK 中使用此 API 的更多信息，请参阅以下内容：