UpdateDatabase - Amazon Timestream
リクエストの構文リクエストパラメータレスポンスの構文レスポンス要素エラー以下の資料も参照してください。

Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

UpdateDatabase

既存のデータベースの AWS KMS キーを変更します。データベースを更新するときは、データベース名と、使用する新しい AWS KMS キーの識別子 (KmsKeyId) を指定する必要があります。同時 UpdateDatabase リクエストがある場合、first writer wins セマンティクスが適用されます。

詳細については、 コードサンプルを参照してください。

リクエストの構文

{
   "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
   }
}

レスポンス要素

アクションが成功すると、サービスは 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

以下の資料も参照してください。

言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。