UpdateDatabase - Amazon Timestream

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

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格式返回。

Database

表格的顶级容器。数据库和表是 Amazon Timestream 中的基本管理概念。数据库中的所有表都使用相同的 AWS KMS 密钥进行加密。

类型:Database 对象

错误

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

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,请参阅以下内容: