本文為英文版的機器翻譯版本,如內容有任何歧義或不一致之處,概以英文版為準。
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 格式傳回下列資料。
錯誤
如需所有動作常見錯誤的資訊,請參閱常見錯誤。
- 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 的詳細資訊,請參閱下列內容: