本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
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"
}請求參數
如需所有動作的一般參數資訊，請參閱《Common Parameters》。
請求接受採用 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 格式的資料。
錯誤
如需所有動作常見錯誤的資訊，請參閱常見錯誤。
- AccessDeniedException
-
您無權執行此動作。
HTTP 狀態碼：400
- InternalServerException
-
由於內部伺服器錯誤，Timestream 無法完整處理此請求。
HTTP 狀態碼：500
- InvalidEndpointException
-
請求的端點無效。
HTTP 狀態碼：400
- ResourceNotFoundException
-
操作嘗試存取不存在的資源。資源可能未正確指定，或其狀態可能不是 ACTIVE。
HTTP 狀態碼：400
- ThrottlingException
-
使用者提出的請求過多，且超過服務配額。請求受到調節。
HTTP 狀態碼：400
- ValidationException
-
無效或格式不正確的請求。
HTTP 狀態碼：400
另請參閱
如需在其中一種語言特定 AWS SDKs中使用此 API 的詳細資訊，請參閱以下內容：
