Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。
CreateDatabase
新しい Timestream データベースを作成します。AWS KMS キーが指定されていない場合、データベースは、アカウントにある Timestream マネージドの AWS KMS キーで暗号化されます。詳細については、AWS マネージドキー を参照してください。サービスクォータが適用されます。詳細については、コードサンプルを参照してください。
リクエストの構文
{
"DatabaseName": "string",
"KmsKeyId": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
]
}
リクエストパラメータ
すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。
リクエストは以下のデータを JSON 形式で受け入れます。
- DatabaseName
-
Timestream データベースの名前。
タイプ: 文字列
長さの制約: 最小長は 3 です。最大長は 256 です。
パターン:
[a-zA-Z0-9_.-]+必須: はい
- KmsKeyId
-
データベースの AWS KMS キー。AWS KMS キーが指定されていない場合、データベースは、アカウントにある Timestream マネージドの AWS KMS キーで暗号化されます。詳細については、AWS マネージドキー を参照してください。
タイプ: 文字列
長さの制約: 最小長は 1 です。最大長は 2,048 です。
必須: いいえ
- Tags
-
テーブルにラベルを付けるためのキーと値のペアのリスト。
型: Tag オブジェクトの配列
配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。
必須: いいえ
レスポンスの構文
{
"Database": {
"Arn": "string",
"CreationTime": number,
"DatabaseName": "string",
"KmsKeyId": "string",
"LastUpdatedTime": number,
"TableCount": number
}
}
レスポンス要素
アクションが成功すると、サービスは HTTP 200 レスポンスを返します。
サービスから以下のデータが JSON 形式で返されます。
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
このアクションを実行する権限がありません。
HTTP ステータスコード: 400
- ConflictException
-
Timestream は、既に存在するリソースが含まれているため、このリクエストを処理できませんでした。
HTTP ステータスコード: 400
- InternalServerException
-
内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。
HTTP ステータスコード: 500
- InvalidEndpointException
-
リクエストされたエンドポイントが有効ではありませんでした。
HTTP ステータスコード: 400
- InvalidEndpointException
-
リクエストされたエンドポイントが有効ではありませんでした。
HTTP ステータスコード: 400
- ServiceQuotaExceededException
-
このアカウントにおけるリソースのインスタンスクォータを超過しました。
HTTP ステータスコード: 400
- ThrottlingException
-
ユーザーによるリクエストが多すぎたため、サービスクォータを超過しました。リクエストがスロットリングされました。
HTTP ステータスコード: 400
- ValidationException
-
リクエストが無効であるか、形式が正しくありません。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。