本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
UpdateDatabase
修改现有数据库的 AWS KMS 密钥。更新数据库时,必须指定数据库名称和要使用的新 AWS KMS 密钥的标识符 (KmsKeyId
)。如果有任何并发UpdateDatabase
请求,则第一个写入者获胜。
请参阅代码示例,了解详细信息。
请求语法
{
"DatabaseName": "string
",
"KmsKeyId": "string
"
}
请求参数
有关所有操作的通用参数的信息,请参阅通用参数。
该请求接受以下JSON格式的数据。
- DatabaseName
-
数据库的名称。
类型:字符串
长度约束:最小长度为 3。最大长度为 256。
必需:是
- KmsKeyId
-
用于加密存储在数据库中的数据的新 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
类型:字符串
长度限制:最小长度为 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
-
该操作试图访问一个不存在的资源。可能未正确指定资源,或者其状态可能不正确ACTIVE。
HTTP状态码:400
- ServiceQuotaExceededException
-
已超过该账户的资源实例配额。
HTTP状态码:400
- ThrottlingException
-
用户发出的请求太多,超过了服务配额。请求已被阻止。
HTTP状态码:400
- ValidationException
-
无效或格式错误的请求。
HTTP状态码:400
另请参阅
有关API在一种特定语言中使用此功能的更多信息 AWS SDKs,请参阅以下内容: