UpdateDatabase - Amazon Timestream

本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。

UpdateDatabase

修改現有資料庫的 AWS KMS 金鑰。更新資料庫時,您必須指定要使用的新 AWS KMS 金鑰的資料庫名稱和識別碼 (KmsKeyId)。如果有任何並行UpdateDatabase請求,第一個寫入器會獲勝。

有關詳細資訊,請參閱程式碼範例

請求語法

{ "DatabaseName": "string", "KmsKeyId": "string" }

請求參數

如需所有動作的一般參數資訊,請參閱《Common Parameters》。

請求接受 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

類型:字串

長度限制:長度下限為 1。長度上限為 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 的詳細資訊,請參閱下列內容: