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

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

CreateTable

アカウントの既存のデータベースに新しいテーブルを追加します。では AWS アカウント、テーブル名が同じデータベースにある場合、各リージョン内で少なくとも一意である必要があります。テーブルが別のデータベースにある場合、同じリージョンに同じテーブル名がある場合があります。テーブルの作成時に、テーブル名、データベース名、保持プロパティを指定する必要があります。サービスクォータが適用されます。詳細については、 コードサンプルを参照してください。

リクエストの構文

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

リクエストパラメータ

すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。

リクエストは、次のJSON形式のデータを受け入れます。

DatabaseName

Timestream データベースの名前。

型: 文字列

長さの制限: 最小長は 3 です。最大長は 256 です。

Pattern: [a-zA-Z0-9_.-]+

必須：はい

MagneticStoreWriteProperties

磁気ストアの書き込みを有効にするときに表に設定するプロパティが含まれます。

型: MagneticStoreWriteProperties オブジェクト

必須：いいえ

RetentionProperties

時系列データをメモリストアとマグネティックストアに保存する必要がある期間。

型: RetentionProperties オブジェクト

必須：いいえ

Schema

テーブルのスキーマ。

型: Schema オブジェクト

必須：いいえ

TableName

Timestream テーブルの名前。

型: 文字列

長さの制限: 最小長は 3 です。最大長は 256 です。

Pattern: [a-zA-Z0-9_.-]+

必須：はい

Tags

テーブルにラベルを付けるキーと値のペアのリスト。

型: Tag オブジェクトの配列

配列メンバー: 最小数は 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"
   }
}

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを送り返します。

次のデータは、 サービスによって JSON 形式で返されます。

Table

新しく作成された Timestream テーブル。

型: Table オブジェクト

エラー

すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。

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

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

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