翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
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
型: 文字列
長さの制限：最小長は 1 です。最大長は 2,048 です。
必須：はい
-
レスポンスの構文
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}レスポンス要素
アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。
次のデータは、 サービスによって 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、以下を参照してください。
