从2025年6月20日起，亚马逊Timestream版 LiveAnalytics 将不再向新客户开放。如果您想使用亚马逊 Timestream LiveAnalytics，请在该日期之前注册。现有客户可以继续照常使用该服务。有关更多信息，请参阅 Amazon Timestream 以了解 LiveAnalytics 可用性变更。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
UpdateDatabase
修改现有数据库的 Amazon KMS 密钥。更新数据库时，必须指定数据库名称和要使用的新 Amazon KMS 密钥的标识符 (KmsKeyId)。如果有任何并发UpdateDatabase请求，则第一个写入者获胜。
请参阅代码示例，了解详细信息。
请求语法
{
"DatabaseName": "string",
"KmsKeyId": "string"
}请求参数
有关所有操作的通用参数的信息，请参阅常用参数。
请求接受采用 JSON 格式的以下数据。
- DatabaseName
-
数据库的名称。
类型：字符串
长度约束：最小长度为 3。最大长度为 256。
必需：是
- KmsKeyId
-
用于加密存储在数据库中的数据的新 Amazon 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
类型：字符串
长度限制：最小长度为 0。最大长度为 2048。
必需：是
-
响应语法
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}响应元素
如果此操作成功，则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回以下数据。
错误
有关所有操作的常见错误的信息，请参阅常见错误。
- AccessDeniedException
-
您无权执行此操作。
HTTP 状态代码：400
- InternalServerException
-
由于内部服务器错误，Timestream 无法完全处理此请求。
HTTP 状态代码：500
- InvalidEndpointException
-
请求的端点无效。
HTTP 状态代码：400
- ResourceNotFoundException
-
该操作试图访问一个不存在的资源。可能未正确指定资源，或者其状态可能不是 “活动”。
HTTP 状态代码：400
- ServiceQuotaExceededException
-
已超过该账户的资源实例配额。
HTTP 状态代码：400
- ThrottlingException
-
用户发出的请求太多，超过了服务配额。请求已被阻止。
HTTP 状态代码：400
- ValidationException
-
请求无效或格式错误。
HTTP 状态代码：400
另请参阅
有关以特定语言之一使用此 API 的更多信息 Amazon SDKs，请参阅以下内容：