Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。 翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # CreateTable アカウントの既存のデータベースに新しいテーブルを追加します。では AWS アカウント、テーブル名は、同じデータベースにある場合、各リージョン内で少なくとも一意である必要があります。テーブルが別々のデータベースにある場合、同じリージョン内に同じテーブル名があっても構いません。テーブルの作成時に、テーブル名、データベース名、保持プロパティを指定する必要があります。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-table.html)を参照してください。 ## リクエストの構文 ``` { "DatabaseName": "string", "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## リクエストパラメーター すべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。 リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_CreateTable_RequestSyntax) ** Timestream データベースの名前。 タイプ: 文字列 長さの制約: 最小長は 3 です。最大長は 256 です。 パターン: `[a-zA-Z0-9_.-]+` 必須: はい ** [MagneticStoreWriteProperties](#API_CreateTable_RequestSyntax) ** 磁気ストアの書き込みを有効にするときに表に設定するプロパティが含まれます。 型: [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) オブジェクト 必須: いいえ ** [RetentionProperties](#API_CreateTable_RequestSyntax) ** 時系列データをマグネティックストアとメモリストアに保存する必要がある期間。 型: [RetentionProperties](API_RetentionProperties.md) オブジェクト 必須: いいえ ** [Schema](#API_CreateTable_RequestSyntax) ** テーブルのスキーマ。 型: [Schema](API_Schema.md) オブジェクト 必須: いいえ ** [TableName](#API_CreateTable_RequestSyntax) ** Timestream テーブルの名前。 タイプ: 文字列 長さの制約: 最小長は 3 です。最大長は 256 です。 パターン: `[a-zA-Z0-9_.-]+` 必須: はい ** [Tags](#API_CreateTable_RequestSyntax) ** テーブルにラベルを付けるためのキーと値のペアのリスト。 型: [Tag](API_Tag.md) オブジェクトの配列 配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。 必須: いいえ ## レスポンスの構文 ``` { "Table": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "MagneticStoreWriteProperties": { "EnableMagneticStoreWrites": boolean, "MagneticStoreRejectedDataLocation": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } } }, "RetentionProperties": { "MagneticStoreRetentionPeriodInDays": number, "MemoryStoreRetentionPeriodInHours": number }, "Schema": { "CompositePartitionKey": [ { "EnforcementInRecord": "string", "Name": "string", "Type": "string" } ] }, "TableName": "string", "TableStatus": "string" } } ``` ## レスポンス要素 アクションが成功すると、サービスは HTTP 200 レスポンスを返します。 サービスから以下のデータが JSON 形式で返されます。 ** [Table](#API_CreateTable_ResponseSyntax) ** 新しく作成された Timestream テーブル。 型: [Table](API_Table.md) オブジェクト ## エラー すべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** ConflictException ** Timestream は、既に存在するリソースが含まれているため、このリクエストを処理できませんでした。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 HTTP ステータスコード: 400 ** ServiceQuotaExceededException ** このアカウントにおけるリソースのインスタンスクォータを超過しました。 HTTP ステータスコード: 400 ** ThrottlingException ** ユーザーによるリクエストが多すぎたため、サービスクォータを超過しました。リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。 言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateTable) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateTable) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateTable) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateTable) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateTable) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateTable) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateTable) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateTable) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateTable) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateTable)