Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。 # API リファレンスこのセクションには、Amazon Timestream の API リファレンスドキュメントが含まれています。 Timestream には、Query と Write の 2 つの API があります。 + **Write API** を使用すると、テーブルの作成、リソースのタグ付け、Timestream へのレコードの書き込みなどのオペレーションを実行できます。 + **Query API** を使用すると、クエリオペレーションを実行できます。 **注記** 両方の API に DescribeEndpoints アクションが含まれています。*Query と Write の両方で、DescribeEndpoints アクションは同じです。* 以下で各 API の詳細と、データ型、よくあるエラー、パラメータを確認できます。 **注記** すべての AWS サービスに共通するエラーコードについては、[AWS 「サポート」セクション](https://docs.aws.amazon.com/awssupport/latest/APIReference/CommonErrors.html)を参照してください。 **Topics** + [アクション](API_Operations.md) + [データ型](API_Types.md) + [共通エラー](CommonErrors.md) + [共通パラメータ](CommonParameters.md) # アクション Amazon Timestream Write では次のアクションがサポートされています。 + [CreateBatchLoadTask](API_CreateBatchLoadTask.md) + [CreateDatabase](API_CreateDatabase.md) + [CreateTable](API_CreateTable.md) + [DeleteDatabase](API_DeleteDatabase.md) + [DeleteTable](API_DeleteTable.md) + [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) + [DescribeDatabase](API_DescribeDatabase.md) + [DescribeEndpoints](API_DescribeEndpoints.md) + [DescribeTable](API_DescribeTable.md) + [ListBatchLoadTasks](API_ListBatchLoadTasks.md) + [ListDatabases](API_ListDatabases.md) + [ListTables](API_ListTables.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateDatabase](API_UpdateDatabase.md) + [UpdateTable](API_UpdateTable.md) + [WriteRecords](API_WriteRecords.md) Amazon Timestream Query では次のアクションがサポートされています。 + [CancelQuery](API_query_CancelQuery.md) + [CreateScheduledQuery](API_query_CreateScheduledQuery.md) + [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) + [DescribeAccountSettings](API_query_DescribeAccountSettings.md) + [DescribeEndpoints](API_query_DescribeEndpoints.md) + [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) + [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) + [ListScheduledQueries](API_query_ListScheduledQueries.md) + [ListTagsForResource](API_query_ListTagsForResource.md) + [PrepareQuery](API_query_PrepareQuery.md) + [Query](API_query_Query.md) + [TagResource](API_query_TagResource.md) + [UntagResource](API_query_UntagResource.md) + [UpdateAccountSettings](API_query_UpdateAccountSettings.md) + [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) # Amazon Timestream Write Amazon Timestream Write では次のアクションがサポートされています。 + [CreateBatchLoadTask](API_CreateBatchLoadTask.md) + [CreateDatabase](API_CreateDatabase.md) + [CreateTable](API_CreateTable.md) + [DeleteDatabase](API_DeleteDatabase.md) + [DeleteTable](API_DeleteTable.md) + [DescribeBatchLoadTask](API_DescribeBatchLoadTask.md) + [DescribeDatabase](API_DescribeDatabase.md) + [DescribeEndpoints](API_DescribeEndpoints.md) + [DescribeTable](API_DescribeTable.md) + [ListBatchLoadTasks](API_ListBatchLoadTasks.md) + [ListDatabases](API_ListDatabases.md) + [ListTables](API_ListTables.md) + [ListTagsForResource](API_ListTagsForResource.md) + [ResumeBatchLoadTask](API_ResumeBatchLoadTask.md) + [TagResource](API_TagResource.md) + [UntagResource](API_UntagResource.md) + [UpdateDatabase](API_UpdateDatabase.md) + [UpdateTable](API_UpdateTable.md) + [WriteRecords](API_WriteRecords.md) # CreateBatchLoadTask 新しい Timestream バッチロードタスクを作成します。バッチロードタスクは、S3 ロケーションの CSV ソースからのデータを処理し、Timestream テーブルに書き込みます。ソースからターゲットへのマッピングは、バッチロードタスクで定義されます。エラーとイベントは S3 ロケーションのレポートに書き込まれます。レポートでは、 AWS KMS キーが指定されていない場合、 `SSE_S3`がオプションの場合、レポートは S3 マネージドキーで暗号化されます。それ以外の場合は、エラーがスローされます。詳細については、[AWS マネージドキー](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) を参照してください。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-batch-load.html)を参照してください。 ## リクエストの構文 ``` { "ClientToken": "string", "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "TargetDatabaseName": "string", "TargetTableName": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ClientToken](#API_CreateBatchLoadTask_RequestSyntax) ** タイプ: 文字列長さの制約: 最小長は 1 です。最大長 64 必須: いいえ ** [DataModelConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** 型: [DataModelConfiguration](API_DataModelConfiguration.md) オブジェクト必須: いいえ ** [DataSourceConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** バッチロードタスクのデータソースに関する設定の詳細を定義します。型: [DataSourceConfiguration](API_DataSourceConfiguration.md) オブジェクト必須: はい ** [RecordVersion](#API_CreateBatchLoadTask_RequestSyntax) ** タイプ: Long 必須: いいえ ** [ReportConfiguration](#API_CreateBatchLoadTask_RequestSyntax) ** バッチロードタスクのレポート設定。これには、エラーレポートの保存先に関する詳細が含まれます。型: [ReportConfiguration](API_ReportConfiguration.md) オブジェクト必須: はい ** [TargetDatabaseName](#API_CreateBatchLoadTask_RequestSyntax) ** バッチロードタスクのターゲット Timestream データベース。タイプ: 文字列 Pattern: `[a-zA-Z0-9_.-]+` 必須: はい ** [TargetTableName](#API_CreateBatchLoadTask_RequestSyntax) ** バッチロードタスクのターゲット Timestream テーブル。タイプ: 文字列 Pattern: `[a-zA-Z0-9_.-]+` 必須: はい ## レスポンスの構文 ``` { "TaskId": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [TaskId](#API_CreateBatchLoadTask_ResponseSyntax) ** バッチロードタスクの ID。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 32 です。パターン: `[A-Z0-9]+` ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** ConflictException ** Timestream は、既に存在するリソースが含まれているため、このリクエストを処理できませんでした。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** 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/CreateBatchLoadTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateBatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateBatchLoadTask) # CreateDatabase 新しい Timestream データベースを作成します。 AWS KMS キーが指定されていない場合、データベースはアカウントにある Timestream マネージド AWS KMS キーで暗号化されます。詳細については、[AWS マネージドキー](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) を参照してください。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.create-db.html)を参照してください。 ## リクエストの構文 ``` { "DatabaseName": "string", "KmsKeyId": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_CreateDatabase_RequestSyntax) ** Timestream データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。パターン: `[a-zA-Z0-9_.-]+` 必須: はい ** [KmsKeyId](#API_CreateDatabase_RequestSyntax) ** データベースの AWS KMS キー。 AWS KMS キーが指定されていない場合、データベースはアカウントにある Timestream マネージド AWS KMS キーで暗号化されます。詳細については、[AWS マネージドキー](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-managed-cmk) を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** [Tags](#API_CreateDatabase_RequestSyntax) ** テーブルにラベルを付けるためのキーと値のペアのリスト。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ## レスポンスの構文 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Database](#API_CreateDatabase_ResponseSyntax) ** 新しく作成された Timestream データベース。型: [Database](API_Database.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** 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 SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/CreateDatabase) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CreateDatabase) # 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) # DeleteDatabase 特定の Timestream データベースを削除します。*このオペレーションは元に戻せません。データベースを削除した後、そのテーブルの時系列データは復元できません。* **注記** 最初に、データベース内のすべてのテーブルを削除する必要があります。そうしないと、ValidationException エラーがスローされます。分散再試行の性質上、オペレーションは成功または ResourceNotFoundException のいずれかを返す可能性があります。クライアントはそれらを同等とみなします。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-db.html)を参照してください。 ## リクエストの構文 ``` { "DatabaseName": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_DeleteDatabase_RequestSyntax) ** 削除される Timestream データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/DeleteDatabase) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteDatabase) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteDatabase) # DeleteTable 指定された Timestream テーブルを削除します。このオペレーションは元に戻せません。Timestream データベーステーブルを削除した後、そのテーブルに保存されている時系列データは復元できません。 **注記** 分散再試行の性質上、オペレーションは成功または ResourceNotFoundException のいずれかを返す可能性があります。クライアントはそれらを同等とみなします。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.delete-table.html)を参照してください。 ## リクエストの構文 ``` { "DatabaseName": "string", "TableName": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_DeleteTable_RequestSyntax) ** Timestream データベースが削除されるデータベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ** [TableName](#API_DeleteTable_RequestSyntax) ** 削除される Timestream テーブルの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/DeleteTable) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DeleteTable) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DeleteTable) # DescribeBatchLoadTask 設定、マッピング、進行状況、その他の詳細など、バッチロードタスクに関する情報を返します。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-batch-load.html)を参照してください。 ## リクエストの構文 ``` { "TaskId": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [TaskId](#API_DescribeBatchLoadTask_RequestSyntax) ** バッチロードタスクの ID。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 32 です。パターン: `[A-Z0-9]+` 必須: はい ## レスポンスの構文 ``` { "BatchLoadTaskDescription": { "CreationTime": number, "DataModelConfiguration": { "DataModel": { "DimensionMappings": [ { "DestinationColumn": "string", "SourceColumn": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TimeColumn": "string", "TimeUnit": "string" }, "DataModelS3Configuration": { "BucketName": "string", "ObjectKey": "string" } }, "DataSourceConfiguration": { "CsvConfiguration": { "ColumnSeparator": "string", "EscapeChar": "string", "NullValue": "string", "QuoteChar": "string", "TrimWhiteSpace": boolean }, "DataFormat": "string", "DataSourceS3Configuration": { "BucketName": "string", "ObjectKeyPrefix": "string" } }, "ErrorMessage": "string", "LastUpdatedTime": number, "ProgressReport": { "BytesMetered": number, "FileFailures": number, "ParseFailures": number, "RecordIngestionFailures": number, "RecordsIngested": number, "RecordsProcessed": number }, "RecordVersion": number, "ReportConfiguration": { "ReportS3Configuration": { "BucketName": "string", "EncryptionOption": "string", "KmsKeyId": "string", "ObjectKeyPrefix": "string" } }, "ResumableUntil": number, "TargetDatabaseName": "string", "TargetTableName": "string", "TaskId": "string", "TaskStatus": "string" } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [BatchLoadTaskDescription](#API_DescribeBatchLoadTask_ResponseSyntax) ** バッチロードタスクの説明。型: [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 HTTP ステータスコード: 400 ** ThrottlingException ** ユーザーによるリクエストが多すぎたため、サービスクォータを超過しました。リクエストがスロットリングされました。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeBatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeBatchLoadTask) # DescribeDatabase データベース名、データベースが作成された時刻、データベース内で見つかったテーブルの合計数など、データベースに関する情報を返します。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-db.html)を参照してください。 ## リクエストの構文 ``` { "DatabaseName": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_DescribeDatabase_RequestSyntax) ** Timestream データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ## レスポンスの構文 ``` { "Database": { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Database](#API_DescribeDatabase_ResponseSyntax) ** Timestream テーブルの名前。型: [Database](API_Database.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/DescribeDatabase) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeDatabase) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeDatabase) # DescribeEndpoints Timestream API コールを実行するために使用できるエンドポイントのリストを返します。この API オペレーションは、Write API と Query API の両方で使用できます。 Timestream SDK は、サービスエンドポイントの管理やマッピングなど、サービスのアーキテクチャと透過的に連携するように設計されているため、*以下の場合を除き、この API オペレーションを使用することは推奨されません*。 + [Timestream で VPC エンドポイント (AWS PrivateLink)](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) を使用している + アプリケーションで、SDK をまだサポートしていないプログラミング言語を使用している + クライアント側の実装をより適切に制御する必要がある DescribeEndpoints を使用および実装する方法とタイミングの詳細については、「[エンドポイント検出パターン](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery)」を参照してください。 ## レスポンスの構文 ``` { "Endpoints": [ { "Address": "string", "CachePeriodInMinutes": number } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Endpoints](#API_DescribeEndpoints_ResponseSyntax) ** `Endpoints` オブジェクトは、`DescribeEndpoints` リクエストが行われたときに返されます。型: [Endpoint](API_Endpoint.md) オブジェクトの配列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** ThrottlingException ** ユーザーによるリクエストが多すぎたため、サービスクォータを超過しました。リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeEndpoints) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeEndpoints) # DescribeTable テーブル名、データベース名、メモリストアの保持期間、マグネティックストアなど、テーブルに関する情報を返します。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.describe-table.html)を参照してください。 ## リクエストの構文 ``` { "DatabaseName": "string", "TableName": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_DescribeTable_RequestSyntax) ** Timestream データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ** [TableName](#API_DescribeTable_RequestSyntax) ** Timestream テーブルの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ## レスポンスの構文 ``` { "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_DescribeTable_ResponseSyntax) ** Timestream テーブル。型: [Table](API_Table.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/DescribeTable) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/DescribeTable) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DescribeTable) # ListBatchLoadTasks バッチロードタスクのリストと、名前、ステータス、いつまでタスクが再開可能か、およびその他の詳細を提供します。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-batch-load-tasks.html)を参照してください。 ## リクエストの構文 ``` { "MaxResults": number, "NextToken": "string", "TaskStatus": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [MaxResults](#API_ListBatchLoadTasks_RequestSyntax) ** 出力で返される項目の総数。使用可能な項目の総数が指定値を上回る場合、出力で NextToken が提供されます。ページ分割を再開するには、後続 API 呼び出しの引数として NextToken 値を指定します。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 100 です。必須: いいえ ** [NextToken](#API_ListBatchLoadTasks_RequestSyntax) ** ページ分割を始める場所を指定するトークン。これは、以前に切り詰められたレスポンスからの NextToken です。タイプ: 文字列必須: いいえ ** [TaskStatus](#API_ListBatchLoadTasks_RequestSyntax) ** バッチロードタスクのステータス。型: 文字列有効な値：`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必須：いいえ ## レスポンスの構文 ``` { "BatchLoadTasks": [ { "CreationTime": number, "DatabaseName": "string", "LastUpdatedTime": number, "ResumableUntil": number, "TableName": "string", "TaskId": "string", "TaskStatus": "string" } ], "NextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [BatchLoadTasks](#API_ListBatchLoadTasks_ResponseSyntax) ** バッチロードタスクの詳細のリスト。型: [BatchLoadTask](API_BatchLoadTask.md) オブジェクトの配列 ** [NextToken](#API_ListBatchLoadTasks_ResponseSyntax) ** ページ分割を始める場所を指定するトークン。次の ListBatchLoadTasksRequest を指定します。タイプ: 文字列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 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/ListBatchLoadTasks) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListBatchLoadTasks) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListBatchLoadTasks) # ListDatabases Timestream データベースのリストを返します。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-db.html)を参照してください。 ## リクエストの構文 ``` { "MaxResults": number, "NextToken": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [MaxResults](#API_ListDatabases_RequestSyntax) ** 出力で返される項目の総数。使用可能な項目の総数が指定値を上回る場合、出力で NextToken が提供されます。ページ分割を再開するには、後続 API 呼び出しの引数として NextToken 値を指定します。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 20 です。必須: いいえ ** [NextToken](#API_ListDatabases_RequestSyntax) ** ページ分割トークン。ページ分割を再開するには、後続 API 呼び出しの引数として NextToken 値を指定します。タイプ: 文字列必須: いいえ ## レスポンスの構文 ``` { "Databases": [ { "Arn": "string", "CreationTime": number, "DatabaseName": "string", "KmsKeyId": "string", "LastUpdatedTime": number, "TableCount": number } ], "NextToken": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Databases](#API_ListDatabases_ResponseSyntax) ** データベース名のリスト。型: [Database](API_Database.md) オブジェクトの配列 ** [NextToken](#API_ListDatabases_ResponseSyntax) ** ページ分割トークン。このパラメータは、レスポンスが切り捨てられたときに返されます。タイプ: 文字列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 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/ListDatabases) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListDatabases) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListDatabases) # ListTables テーブルのリストと、各テーブルの名前、ステータス、保持プロパティを提供します。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.list-table.html)を参照してください。 ## リクエストの構文 ``` { "DatabaseName": "string", "MaxResults": number, "NextToken": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_ListTables_RequestSyntax) ** Timestream データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: いいえ ** [MaxResults](#API_ListTables_RequestSyntax) ** 出力で返される項目の総数。使用可能な項目の総数が指定値を上回る場合、出力で NextToken が提供されます。ページ分割を再開するには、後続 API 呼び出しの引数として NextToken 値を指定します。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 20 です。必須: いいえ ** [NextToken](#API_ListTables_RequestSyntax) ** ページ分割トークン。ページ分割を再開するには、後続 API 呼び出しの引数として NextToken 値を指定します。タイプ: 文字列必須: いいえ ## レスポンスの構文 ``` { "NextToken": "string", "Tables": [ { "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 形式で返されます。 ** [NextToken](#API_ListTables_ResponseSyntax) ** ページ分割を始める場所を指定するトークン。これは、以前に切り詰められたレスポンスからの NextToken です。タイプ: 文字列 ** [Tables](#API_ListTables_ResponseSyntax) ** テーブルのリスト。型: [Table](API_Table.md) オブジェクトの配列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/ListTables) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTables) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTables) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTables) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTables) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTables) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTables) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTables) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTables) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTables) # ListTagsForResource Timestream リソースのすべてのタグを一覧表示します。 ## リクエストの構文 ``` { "ResourceARN": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ResourceARN](#API_ListTagsForResource_RequestSyntax) ** 一覧表示されるタグを持つ Timestream リソース。この値は Amazon リソースネーム (ARN) です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 1011 です。必須: はい ## レスポンスの構文 ``` { "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Tags](#API_ListTagsForResource_ResponseSyntax) ** Timestream リソースに現在関連付けられているタグ。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/ListTagsForResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ListTagsForResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ListTagsForResource) # ResumeBatchLoadTask ## リクエストの構文 ``` { "TaskId": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [TaskId](#API_ResumeBatchLoadTask_RequestSyntax) ** 再開するバッチロードタスクの ID。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 32 です。パターン: `[A-Z0-9]+` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/ResumeBatchLoadTask) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/ResumeBatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ResumeBatchLoadTask) # TagResource タグのセットを Timestream リソースに関連付けます。次に、これらのユーザー定義タグをアクティブ化し、コスト配分の追跡のため、Billing and Cost Management コンソールに表示できます。 ## リクエストの構文 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ResourceARN](#API_TagResource_RequestSyntax) ** タグを追加する Timestream リソースを識別します。この値は Amazon リソースネーム (ARN) です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 1011 です。必須: はい ** [Tags](#API_TagResource_RequestSyntax) ** Timestream リソースに割り当てられるタグ。型: [Tag](API_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** 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/TagResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/TagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/TagResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/TagResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/TagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/TagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/TagResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/TagResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/TagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/TagResource) # UntagResource Timestream リソースからタグの関連付けを削除します。 ## リクエストの構文 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ResourceARN](#API_UntagResource_RequestSyntax) ** タグを削除する Timestream リソース。この値は Amazon リソースネーム (ARN) です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 1011 です。必須: はい ** [TagKeys](#API_UntagResource_RequestSyntax) ** タグキーのリスト。このリストのメンバーであるキーを持つリソースの既存のタグは、Timestream リソースから削除されます。型: 文字列の配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。長さの制限：最小長 1、最大長は 128 です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** 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/UntagResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UntagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UntagResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UntagResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UntagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UntagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UntagResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UntagResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UntagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UntagResource) # UpdateDatabase 既存のデータベースの AWS KMS キーを変更します。データベースを更新するときは、使用する新しい AWS KMS キーのデータベース名と識別子 () を指定する必要があります`KmsKeyId`。同時 `UpdateDatabase` リクエストがある場合、first writer wins セマンティクスが適用されます。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-db.html)を参照してください。 ## リクエストの構文 ``` { "DatabaseName": "string", "KmsKeyId": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_UpdateDatabase_RequestSyntax) ** データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ** [KmsKeyId](#API_UpdateDatabase_RequestSyntax) ** データベースに保存されているデータの暗号化に使用される新しい 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](#API_UpdateDatabase_ResponseSyntax) ** テーブルの最上位コンテナ。データベースとテーブルは、Amazon Timestream の基本的な管理概念です。データベース内のすべてのテーブルは、同じ AWS KMS キーで暗号化されます。型: [Database](API_Database.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** 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/UpdateDatabase) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateDatabase) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateDatabase) # UpdateTable Timestream テーブルのメモリストアとマグネティックストアの保持期間を変更します。保持期間の変更は即時に有効になることに注意してください。例えば、メモリストアの保持期間が最初に 2 時間に設定され、その後 24 時間に変更された場合、メモリストアは 24 時間分のデータを保持できますが、この変更が行われた 22 時間後に 24 時間分のデータが入力されます。Timestream は、メモリストアに入力するためにマグネティックストアからデータを取得しません。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.update-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" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [DatabaseName](#API_UpdateTable_RequestSyntax) ** Timestream データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ** [MagneticStoreWriteProperties](#API_UpdateTable_RequestSyntax) ** 磁気ストアの書き込みを有効にするときに表に設定するプロパティが含まれます。型: [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) オブジェクト必須: いいえ ** [RetentionProperties](#API_UpdateTable_RequestSyntax) ** メモリストアとマグネティックストアの保持期間。型: [RetentionProperties](API_RetentionProperties.md) オブジェクト必須: いいえ ** [Schema](#API_UpdateTable_RequestSyntax) ** テーブルのスキーマ。型: [Schema](API_Schema.md) オブジェクト必須: いいえ ** [TableName](#API_UpdateTable_RequestSyntax) ** Timestream テーブルの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ## レスポンスの構文 ``` { "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_UpdateTable_ResponseSyntax) ** 更新された Timestream テーブル。型: [Table](API_Table.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/UpdateTable) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/UpdateTable) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/UpdateTable) # WriteRecords Timestream に時系列データを書き込むことができます。システムに挿入する単一のデータポイントまたはデータポイントのバッチを指定できます。Timestream には、データベースへの書き込みを呼び出すときに指定したデータポイントのディメンション名とデータ型に基づいて、Timestream テーブルの列名とデータ型を自動検出する柔軟なスキーマが用意されています。 Timestream は、結果整合性のある読み込みセマンティクスをサポートしています。つまり、データのバッチを Timestream に書き込んだ直後にデータをクエリする場合、クエリ結果には最近完了した書き込みオペレーションの結果が反映されていない可能性があります。また、結果に古いデータが含まれている可能性もあります。少し時間が経ってからクエリリクエストを繰り返すと、結果で最新のデータが返されます。[サービスクォータが適用されます](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.write.html)を参照してください。 **アップサート** `WriteRecords` リクエストで `Version` パラメータを使用して、データポイントを更新できます。Timestream は、各レコードのバージョン番号を追跡します。`Version` は、リクエストのレコードに対して指定されていない場合、デフォルトで `1` になります。Timestream が既存のレコードのメジャー値とその `Version` を更新するのは、そのレコードの `Version` 番号がより大きい書き込みリクエストを受信した場合です。メジャー値が既存のレコードの値と同じである更新リクエストを受信した場合、Timestream は `Version` の既存の値より大きければ `Version` を更新します。データポイントは、`Version` の値が増加し続ける限り、何度でも更新できます。例えば、リクエストで `Version` を指定せずに新しいレコードを書き込むとします。Timestream はこのレコードを保存し、`Version` を `1` に設定します。ここで、このレコードを別のメジャー値を持つ同じレコードの `WriteRecords` リクエストで更新しようとしますが、以前と同様に `Version` を指定しないとします。この場合、更新されたレコードのバージョンが Version の既存の値以下であるため、Timestream はこの更新を `RejectedRecordsException` で拒否します。ただし、`Version` を `2` に設定して更新リクエストを再送信すると、Timestream はレコードの値の更新に成功し、`Version` は `2` に設定されます。次に、同じレコードと同じメジャー値で、`Version` を `3` に設定して `WriteRecords` リクエストを送信したとします。この場合、Timestream は `Version` を `3` に更新するだけです。それ以降の更新では、`3` より大きいバージョン番号を送信する必要があります。そうしないと、更新リクエストで `RejectedRecordsException` がスローされます。 ## リクエストの構文 ``` { "CommonAttributes": { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number }, "DatabaseName": "string", "Records": [ { "Dimensions": [ { "DimensionValueType": "string", "Name": "string", "Value": "string" } ], "MeasureName": "string", "MeasureValue": "string", "MeasureValues": [ { "Name": "string", "Type": "string", "Value": "string" } ], "MeasureValueType": "string", "Time": "string", "TimeUnit": "string", "Version": number } ], "TableName": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [CommonAttributes](#API_WriteRecords_RequestSyntax) ** リクエスト内のすべてのレコードで共有される共通のメジャー、ディメンション、時間、バージョンの属性を含むレコード。指定されたメジャー属性とディメンション属性は、データが Timestream に書き込まれるときに、レコードオブジェクトのメジャー属性およびディメンション属性とマージされます。ディメンションが重複してはいけません。重複すると、`ValidationException` がスローされます。つまり、レコードには一意の名前のディメンションが含まれている必要があります。型: [Record](API_Record.md) オブジェクト必須: いいえ ** [DatabaseName](#API_WriteRecords_RequestSyntax) ** Timestream データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ** [Records](#API_WriteRecords_RequestSyntax) ** 各時系列データポイントにおける一意のメジャー、ディメンション、時間、バージョンの属性を含むレコードの配列。型: [Record](API_Record.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。最大数は 100 項目です。必須: はい ** [TableName](#API_WriteRecords_RequestSyntax) ** Timestream テーブルの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: はい ## レスポンスの構文 ``` { "RecordsIngested": { "MagneticStore": number, "MemoryStore": number, "Total": number } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [RecordsIngested](#API_WriteRecords_ResponseSyntax) ** このリクエストによって取り込まれたレコードに関する情報。型: [RecordsIngested](API_RecordsIngested.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** このアクションを実行する権限がありません。 HTTP ステータスコード: 400 ** InternalServerException ** 内部サーバーエラーのため、Timestream はこのリクエストを完全に処理できませんでした。 HTTP ステータスコード: 500 ** InvalidEndpointException ** リクエストされたエンドポイントが有効ではありませんでした。 HTTP ステータスコード: 400 ** RejectedRecordsException ** WriteRecords は、次のケースでこの例外をスローします。 + ディメンション、タイムスタンプ、メジャー名が同じであるレコードが複数あるが、以下に該当する重複データを含むレコード。 + メジャー値が異なる + バージョンがリクエストに存在しないか、*または*新しいレコードのバージョンの値が既存の値以下であるこの場合、Timestream がデータを拒否すると、`RejectedRecords` レスポンスの `ExistingVersion` フィールドには現在のレコードのバージョンが表示されます。強制的に更新するには、レコードのバージョンを `ExistingVersion` より大きい値に設定してリクエストを再送信します。 + タイムスタンプがメモリストアの保持期間外であるレコード。 + ディメンションまたはメジャーが Timestream で定義された制限を超えるレコード。詳細については、「Amazon Timestream デベロッパーガイド」の「[クォータ](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)」を参照してください。 ** RejectedRecords ** HTTP ステータスコード: 400 ** ResourceNotFoundException ** オペレーションは、存在しないリソースにアクセスしようとしました。リソースが正しく指定されていないか、ステータスが ACTIVE ではない可能性があります。 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/WriteRecords) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-write-2018-11-01/WriteRecords) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/WriteRecords) # Amazon Timestream Query Amazon Timestream Query では次のアクションがサポートされています。 + [CancelQuery](API_query_CancelQuery.md) + [CreateScheduledQuery](API_query_CreateScheduledQuery.md) + [DeleteScheduledQuery](API_query_DeleteScheduledQuery.md) + [DescribeAccountSettings](API_query_DescribeAccountSettings.md) + [DescribeEndpoints](API_query_DescribeEndpoints.md) + [DescribeScheduledQuery](API_query_DescribeScheduledQuery.md) + [ExecuteScheduledQuery](API_query_ExecuteScheduledQuery.md) + [ListScheduledQueries](API_query_ListScheduledQueries.md) + [ListTagsForResource](API_query_ListTagsForResource.md) + [PrepareQuery](API_query_PrepareQuery.md) + [Query](API_query_Query.md) + [TagResource](API_query_TagResource.md) + [UntagResource](API_query_UntagResource.md) + [UpdateAccountSettings](API_query_UpdateAccountSettings.md) + [UpdateScheduledQuery](API_query_UpdateScheduledQuery.md) # CancelQuery 発行されたクエリをキャンセルします。キャンセルは、キャンセルリクエストが発行される前にクエリの実行が完了していない場合にのみ提供されます。キャンセルはべき等のオペレーションであるため、後続のキャンセルリクエストはクエリが既にキャンセルされたことを示す `CancellationMessage` を返します。詳細については、[ コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.cancel-query.html)を参照してください。 ## リクエストの構文 ``` { "QueryId": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [QueryId](#API_query_CancelQuery_RequestSyntax) ** キャンセルする必要があるクエリの ID。`QueryID` はクエリ結果の一部として返されます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長 64 パターン: `[a-zA-Z0-9]+` 必須: はい ## レスポンスの構文 ``` { "CancellationMessage": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [CancellationMessage](#API_query_CancelQuery_ResponseSyntax) ** `CancellationMessage` は、`QueryId` で指定されたクエリの `CancelQuery` リクエストが既に発行されている場合に返されます。タイプ: 文字列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CancelQuery) # CreateScheduledQuery 設定されたスケジュールでユーザーに代わって実行されるスケジュールされたクエリを作成します。Timestream は、`ScheduledQueryExecutionRoleArn` パラメータの一部として提供される実行ロールを引き受けて、クエリを実行します。`NotificationConfiguration` パラメータを使用して、スケジュールされたクエリ操作の通知を設定できます。 ## リクエストの構文 ``` { "ClientToken": "string", "ErrorReportConfiguration": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "ObjectKeyPrefix": "string" } }, "KmsKeyId": "string", "Name": "string", "NotificationConfiguration": { "SnsConfiguration": { "TopicArn": "string" } }, "QueryString": "string", "ScheduleConfiguration": { "ScheduleExpression": "string" }, "ScheduledQueryExecutionRoleArn": "string", "Tags": [ { "Key": "string", "Value": "string" } ], "TargetConfiguration": { "TimestreamConfiguration": { "DatabaseName": "string", "DimensionMappings": [ { "DimensionValueType": "string", "Name": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TableName": "string", "TimeColumn": "string" } } } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) ** ClientToken を使用すると、createCheduledQuery の呼び出しがべき等になります。つまり、同じリクエストを繰り返し実行すると同じ結果が生成されます。同じ CreateScheduledQuery リクエストを複数回実行しても、1 回実行する場合と効果は同じです。 + CreateScheduledQuery が `ClientToken` がない状態で呼び出される場合、クエリ SDK はユーザーに代わって `ClientToken` を生成します。 + 8 時間後、同じ `ClientToken` を持つリクエストは新しいリクエストとして処理されます。タイプ: 文字列長さの制限: 最小長 32。最大長は 128 です。必須: いいえ ** [ErrorReportConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** エラーレポートの構成。エラーレポートは、クエリ結果を書き込むときに問題が発生した場合に生成されます。型: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) オブジェクト必須: はい ** [KmsKeyId](#API_query_CreateScheduledQuery_RequestSyntax) ** スケジュールされたクエリリソースを保管時に暗号化するために使用される Amazon KMS キー。Amazon KMS キーが指定されていない場合、スケジュールされたクエリリソースは、Timestream 所有の Amazon KMS キーで暗号化されます。KMS キーを指定するには、キー ID、キー ARN、エイリアス名、エイリアス ARN を使用します。エイリアス名を使用する場合は、名前にプレフィックスとして *alias/* を付けます。 ErrorReportConfiguration が暗号化タイプとして `SSE_KMS` を使用する場合、保管時にエラーレポートを暗号化するために同じ KmsKeyId が使用されます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** [Name](#API_query_CreateScheduledQuery_RequestSyntax) ** スケジュールされたクエリの名前。タイプ: 文字列長さの制約: 最小長は 1 です。最大長 64 パターン: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必須: はい ** [NotificationConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** スケジュールされたクエリの通知構成。Timestream は、クエリの実行が終了したとき、状態が更新されたとき、または削除されたときに通知を送信します。型: [NotificationConfiguration](API_query_NotificationConfiguration.md) オブジェクト必須: はい ** [QueryString](#API_query_CreateScheduledQuery_RequestSyntax) ** 実行するクエリ文字列。パラメータ名は、クエリ文字列 `@` 文字とその後に識別子を続けることで指定できます。名前付きパラメータ `@scheduled_runtime` は予約されており、クエリの実行がスケジュールされている時刻を取得するためにクエリ内で使用できます。 scheduleConfiguration パラメータに従って計算されたタイムスタンプは、各クエリ実行の `@scheduled_runtime` パラメータの値になります。例えば、2021-12-01 00:00:00 にスケジュールされたクエリのインスタンスを実行するとします。この場合、クエリを呼び出すと、`@scheduled_runtime` パラメータはタイムスタンプ 2021-12-01 00:00:00 に初期化されます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 262,144 です。必須: はい ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** クエリのスケジュール設定。型: [ScheduleConfiguration](API_query_ScheduleConfiguration.md) オブジェクト必須: はい ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) ** スケジュールされたクエリの実行時に Timestream が引き受ける IAM ロールの ARN。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ** [Tags](#API_query_CreateScheduledQuery_RequestSyntax) ** スケジュールされたクエリにラベルを付けるためのキーと値のペアのリスト。型: [Tag](API_query_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: いいえ ** [TargetConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** クエリの結果を書き込むために使用される設定。型: [TargetConfiguration](API_query_TargetConfiguration.md) オブジェクト必須: いいえ ## レスポンスの構文 ``` { "Arn": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Arn](#API_query_CreateScheduledQuery_ResponseSyntax) ** 作成されたスケジュールされたクエリの ARN。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** ConflictException ** キャンセルされたクエリの結果をポーリングできません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ServiceQuotaExceededException ** サービスクォータを超過しました。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery) # DeleteScheduledQuery 指定したスケジュールされたクエリを削除します。このオペレーションは元に戻せません。 ## リクエストの構文 ``` { "ScheduledQueryArn": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) ** スケジュールされたクエリの ARN。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** リクエストされたリソースが見つかりませんでした。 ** ScheduledQueryArn ** スケジュールされたクエリの ARN。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery) # DescribeAccountSettings クエリ料金モデルと、サービスがクエリワークロードに使用できる構成済みの最大 TCU 数を含むアカウントの設定を説明します。ワークロードにおけるコンピューティングユニットの使用期間に対してのみ課金されます。 ## レスポンスの構文 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "ActiveQueryTCU": number, "LastUpdate": { "Status": "string", "StatusMessage": "string", "TargetQueryTCU": number }, "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } } } }, "QueryPricingModel": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [MaxQueryTCU](#API_query_DescribeAccountSettings_ResponseSyntax) ** サービスがクエリを処理するために任意の時点で使用する [Timestream コンピューティングユニット](https://docs.aws.amazon.com/timestream/latest/developerguide/tcu.html) (TCU) の最大数。クエリを実行するには、最小数を 4 TCU に設定する必要があります。TCU の最大数は、4 の倍数 (4、8、16、32 など) に設定できます。この設定は、TCU のオンデマンド使用にのみ適用されます。タイプ: 整数 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) ** クエリワークロードに対するアカウントの TCU の使用設定を含むオブジェクト。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。型: [QueryComputeResponse](API_query_QueryComputeResponse.md) オブジェクト ** [QueryPricingModel](#API_query_DescribeAccountSettings_ResponseSyntax) ** アカウントにおけるクエリの料金モデル。 `QueryPricingModel` パラメータは複数の Timestream オペレーションで使用されますが、`UpdateAccountSettings` API オペレーションは `COMPUTE_UNITS` 以外の値を認識しません。型: 文字列有効な値：`BYTES_SCANNED | COMPUTE_UNITS` ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings) # DescribeEndpoints DescribeEndpoints は、Timestream API コールを行うために利用可能なエンドポイントのリストを返します。この API は、書き込みとクエリの両方で使用できます。 Timestream SDK は、サービスエンドポイントの管理やマッピングなど、サービスのアーキテクチャと透過的に連携するように設計されているため、*以下の場合を除き、この API を使用することは推奨されません*。 + [Timestream で VPC エンドポイント (AWS PrivateLink)](https://docs.aws.amazon.com/timestream/latest/developerguide/VPCEndpoints) を使用している + アプリケーションで、SDK をまだサポートしていないプログラミング言語を使用している + クライアント側の実装をより適切に制御する必要がある DescribeEndpoints を使用および実装する方法とタイミングの詳細については、「[エンドポイント検出パターン](https://docs.aws.amazon.com/timestream/latest/developerguide/Using.API.html#Using-API.endpoint-discovery)」を参照してください。 ## レスポンスの構文 ``` { "Endpoints": [ { "Address": "string", "CachePeriodInMinutes": number } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Endpoints](#API_query_DescribeEndpoints_ResponseSyntax) ** `Endpoints` オブジェクトは、`DescribeEndpoints` リクエストが行われたときに返されます。型: [Endpoint](API_query_Endpoint.md) オブジェクトの配列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints) # DescribeScheduledQuery スケジュールされたクエリに関する詳細情報を提供します。 ## リクエストの構文 ``` { "ScheduledQueryArn": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) ** スケジュールされたクエリの ARN。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ## レスポンスの構文 ``` { "ScheduledQuery": { "Arn": "string", "CreationTime": number, "ErrorReportConfiguration": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "ObjectKeyPrefix": "string" } }, "KmsKeyId": "string", "LastRunSummary": { "ErrorReportLocation": { "S3ReportLocation": { "BucketName": "string", "ObjectKey": "string" } }, "ExecutionStats": { "BytesMetered": number, "CumulativeBytesScanned": number, "DataWrites": number, "ExecutionTimeInMillis": number, "QueryResultRows": number, "RecordsIngested": number }, "FailureReason": "string", "InvocationTime": number, "QueryInsightsResponse": { "OutputBytes": number, "OutputRows": number, "QuerySpatialCoverage": { "Max": { "PartitionKey": [ "string" ], "TableArn": "string", "Value": number } }, "QueryTableCount": number, "QueryTemporalRange": { "Max": { "TableArn": "string", "Value": number } } }, "RunStatus": "string", "TriggerTime": number }, "Name": "string", "NextInvocationTime": number, "NotificationConfiguration": { "SnsConfiguration": { "TopicArn": "string" } }, "PreviousInvocationTime": number, "QueryString": "string", "RecentlyFailedRuns": [ { "ErrorReportLocation": { "S3ReportLocation": { "BucketName": "string", "ObjectKey": "string" } }, "ExecutionStats": { "BytesMetered": number, "CumulativeBytesScanned": number, "DataWrites": number, "ExecutionTimeInMillis": number, "QueryResultRows": number, "RecordsIngested": number }, "FailureReason": "string", "InvocationTime": number, "QueryInsightsResponse": { "OutputBytes": number, "OutputRows": number, "QuerySpatialCoverage": { "Max": { "PartitionKey": [ "string" ], "TableArn": "string", "Value": number } }, "QueryTableCount": number, "QueryTemporalRange": { "Max": { "TableArn": "string", "Value": number } } }, "RunStatus": "string", "TriggerTime": number } ], "ScheduleConfiguration": { "ScheduleExpression": "string" }, "ScheduledQueryExecutionRoleArn": "string", "State": "string", "TargetConfiguration": { "TimestreamConfiguration": { "DatabaseName": "string", "DimensionMappings": [ { "DimensionValueType": "string", "Name": "string" } ], "MeasureNameColumn": "string", "MixedMeasureMappings": [ { "MeasureName": "string", "MeasureValueType": "string", "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "SourceColumn": "string", "TargetMeasureName": "string" } ], "MultiMeasureMappings": { "MultiMeasureAttributeMappings": [ { "MeasureValueType": "string", "SourceColumn": "string", "TargetMultiMeasureAttributeName": "string" } ], "TargetMultiMeasureName": "string" }, "TableName": "string", "TimeColumn": "string" } } } } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [ScheduledQuery](#API_query_DescribeScheduledQuery_ResponseSyntax) ** スケジュールされたクエリ。型: [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) オブジェクト ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** リクエストされたリソースが見つかりませんでした。 ** ScheduledQueryArn ** スケジュールされたクエリの ARN。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeScheduledQuery) # ExecuteScheduledQuery この API を使用して、スケジュールされたクエリを手動で実行できます。 `QueryInsights` を有効にした場合、この API は Amazon SNS 通知の一部として、実行したクエリに関連するインサイトとメトリクスも返します。`QueryInsights` はクエリのパフォーマンスチューニングに役立ちます。`QueryInsights` の詳細については、「[クエリインサイトを使用して Amazon Timestream のクエリを最適化する](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html)」を参照してください。 ## リクエストの構文 ``` { "ClientToken": "string", "InvocationTime": number, "QueryInsights": { "Mode": "string" }, "ScheduledQueryArn": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 使用されていません。タイプ: 文字列長さの制限: 最小長 32。最大長は 128 です。必須: いいえ ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) ** UTC のタイムスタンプ。クエリは、このタイムスタンプで呼び出されたものとして実行されます。タイプ: タイムスタンプ必須: はい ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) ** `QueryInsights` を有効にするための設定をカプセル化します。 `QueryInsights` を有効にすると、実行したクエリの Amazon SNS 通知の一部としてインサイトとメトリクスが返されます。`QueryInsights` を使用して、クエリのパフォーマンスとコストをチューニングできます。型: [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) オブジェクト必須: いいえ ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) ** スケジュールされたクエリの ARN。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** リクエストされたリソースが見つかりませんでした。 ** ScheduledQueryArn ** スケジュールされたクエリの ARN。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 例 ### ENABLED\$1WITH\$1RATE\$1CONTROL モードのスケジュールされたクエリ通知メッセージ次の例は、`QueryInsights` パラメータの `ENABLED_WITH_RATE_CONTROL` モードのスケジュールされたクエリ通知メッセージの成功を示しています。 ``` "SuccessNotificationMessage": { "type": "MANUAL_TRIGGER_SUCCESS", "arn": "arn:aws:timestream:::scheduled-query/sq-test-49c6ed55-c2e7-4cc2-9956-4a0ecea13420-80e05b035236a4c3", "scheduledQueryRunSummary": { "invocationEpochSecond": 1723710546, "triggerTimeMillis": 1723710547490, "runStatus": "MANUAL_TRIGGER_SUCCESS", "executionStats": { "executionTimeInMillis": 17343, "dataWrites": 1024, "bytesMetered": 0, "cumulativeBytesScanned": 600, "recordsIngested": 1, "queryResultRows": 1 }, "queryInsightsResponse": { "querySpatialCoverage": { "max": { "value": 1.0, "tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable", "partitionKey": [ "measure_name" ] } }, "queryTemporalRange": { "max": { "value": 2399999999999, "tableArn": "arn:aws:timestream:::database/BaseDb/table/BaseTable" } }, "queryTableCount": 1, "outputRows": 1, "outputBytes": 59 } } } ``` ### DISABLED モードのスケジュールされたクエリ通知メッセージ次の例は、`QueryInsights` パラメータの `DISABLED` モードのスケジュールされたクエリ通知メッセージの成功を示しています。 ``` "SuccessNotificationMessage": { "type": "MANUAL_TRIGGER_SUCCESS", "arn": "arn:aws:timestream:::scheduled-query/sq-test-fa109d9e-6528-4a0d-ac40-482fa05e657f-140faaeecdc5b2a7", "scheduledQueryRunSummary": { "invocationEpochSecond": 1723711401, "triggerTimeMillis": 1723711402144, "runStatus": "MANUAL_TRIGGER_SUCCESS", "executionStats": { "executionTimeInMillis": 17992, "dataWrites": 1024, "bytesMetered": 0, "cumulativeBytesScanned": 600, "recordsIngested": 1, "queryResultRows": 1 } } } ``` ### ENABLED\$1WITH\$1RATE\$1CONTROL モードの失敗通知メッセージ次の例は、`QueryInsights` パラメータの `ENABLED_WITH_RATE_CONTROL` モードのスケジュールされたクエリ通知メッセージの失敗を示しています。 ``` "FailureNotificationMessage": { "type": "MANUAL_TRIGGER_FAILURE", "arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d", "scheduledQueryRunSummary": { "invocationEpochSecond": 1727915513, "triggerTimeMillis": 1727915513894, "runStatus": "MANUAL_TRIGGER_FAILURE", "executionStats": { "executionTimeInMillis": 10777, "dataWrites": 0, "bytesMetered": 0, "cumulativeBytesScanned": 0, "recordsIngested": 0, "queryResultRows": 4 }, "errorReportLocation": { "s3ReportLocation": { "bucketName": "amzn-s3-demo-bucket", "objectKey": "4my-organization-f7a3c5d065a1a95e/1727915513/MANUAL/1727915513894/5e14b3df-b147-49f4-9331-784f749b68ae" } }, "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details" } } ``` ### DISABLED モードの失敗通知メッセージ次の例は、`QueryInsights` パラメータの `DISABLED` モードのスケジュールされたクエリ通知メッセージの失敗を示しています。 ``` "FailureNotificationMessage": { "type": "MANUAL_TRIGGER_FAILURE", "arn": "arn:aws:timestream:::scheduled-query/sq-test-b261670d-790c-4116-9db5-0798071b18b1-b7e27a1d79be226d", "scheduledQueryRunSummary": { "invocationEpochSecond": 1727915194, "triggerTimeMillis": 1727915195119, "runStatus": "MANUAL_TRIGGER_FAILURE", "executionStats": { "executionTimeInMillis": 10777, "dataWrites": 0, "bytesMetered": 0, "cumulativeBytesScanned": 0, "recordsIngested": 0, "queryResultRows": 4 }, "errorReportLocation": { "s3ReportLocation": { "bucketName": "amzn-s3-demo-bucket", "objectKey": "4my-organization-b7e27a1d79be226d/1727915194/MANUAL/1727915195119/08dea9f5-9a0a-4e63-a5f7-ded23247bb98" } }, "failureReason": "Schedule encountered some errors and is incomplete. Please take a look at error report for further details" } } ``` ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery) # ListScheduledQueries 呼び出し元の Amazon アカウントとリージョンにおけるスケジュールされたクエリすべてのリストを取得します。`ListScheduledQueries` には結果整合性があります。 ## リクエストの構文 ``` { "MaxResults": number, "NextToken": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) ** 出力で返される項目の最大数。使用可能な項目の総数が指定値を上回る場合、出力で `NextToken` が提供されます。ページ分割を再開するには、`ListScheduledQueriesRequest` への後続呼び出しの引数として `NextToken` 値を指定します。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 1000 です。必須: いいえ ** [NextToken](#API_query_ListScheduledQueries_RequestSyntax) ** ページ分割を再開するためのページ分割トークン。タイプ: 文字列必須: いいえ ## レスポンスの構文 ``` { "NextToken": "string", "ScheduledQueries": [ { "Arn": "string", "CreationTime": number, "ErrorReportConfiguration": { "S3Configuration": { "BucketName": "string", "EncryptionOption": "string", "ObjectKeyPrefix": "string" } }, "LastRunStatus": "string", "Name": "string", "NextInvocationTime": number, "PreviousInvocationTime": number, "State": "string", "TargetDestination": { "TimestreamDestination": { "DatabaseName": "string", "TableName": "string" } } } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [NextToken](#API_query_ListScheduledQueries_ResponseSyntax) ** ページ分割を始める場所を指定するトークン。これは、以前に切り詰められたレスポンスからの NextToken です。タイプ: 文字列 ** [ScheduledQueries](#API_query_ListScheduledQueries_ResponseSyntax) ** スケジュールされたクエリのリスト。型: [ScheduledQuery](API_query_ScheduledQuery.md) オブジェクトの配列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries) # ListTagsForResource Timestream クエリリソースのすべてのタグを一覧表示します。 ## リクエストの構文 ``` { "MaxResults": number, "NextToken": "string", "ResourceARN": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) ** 返されるタグの最大数。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 200 です。必須: いいえ ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) ** ページ分割を再開するためのページ分割トークン。タイプ: 文字列必須: いいえ ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) ** 一覧表示されるタグを持つ Timestream リソース。この値は Amazon リソースネーム (ARN) です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ## レスポンスの構文 ``` { "NextToken": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [NextToken](#API_query_ListTagsForResource_ResponseSyntax) ** `ListTagsForResourceResponse` への後続呼び出しでページ分割を再開するためのページ分割トークン。タイプ: 文字列 ** [Tags](#API_query_ListTagsForResource_ResponseSyntax) ** Timestream リソースに現在関連付けられているタグ。型: [Tag](API_query_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** リクエストされたリソースが見つかりませんでした。 ** ScheduledQueryArn ** スケジュールされたクエリの ARN。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource) # PrepareQuery Timestream が後で実行するために保存するパラメータを含むクエリを送信できる同期オペレーション。Timestream は、`ValidateOnly` が `true` に設定されている場合にのみ、このオペレーションの使用をサポートします。 ## リクエストの構文 ``` { "QueryString": "string", "ValidateOnly": boolean } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) ** 準備済みステートメントとして使用する Timestream クエリ文字列。パラメータ名は、クエリ文字列 `@` 文字とその後に識別子を続けることで指定できます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 262,144 です。必須: はい ** [ValidateOnly](#API_query_PrepareQuery_RequestSyntax) ** この値を `true` に設定すると、Timestream はクエリ文字列が有効な Timestream クエリであることを検証するのみで、準備されたクエリを後で使用するために保存しません。タイプ: ブール値必須: いいえ ## レスポンスの構文 ``` { "Columns": [ { "Aliased": boolean, "DatabaseName": "string", "Name": "string", "TableName": "string", "Type": { "ArrayColumnInfo": { "Name": "string", "Type": "Type" }, "RowColumnInfo": [ { "Name": "string", "Type": "Type" } ], "ScalarType": "string", "TimeSeriesMeasureValueColumnInfo": { "Name": "string", "Type": "Type" } } } ], "Parameters": [ { "Name": "string", "Type": { "ArrayColumnInfo": { "Name": "string", "Type": "Type" }, "RowColumnInfo": [ { "Name": "string", "Type": "Type" } ], "ScalarType": "string", "TimeSeriesMeasureValueColumnInfo": { "Name": "string", "Type": "Type" } } } ], "QueryString": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [Columns](#API_query_PrepareQuery_ResponseSyntax) ** 送信されたクエリ文字列の SELECT 句列のリスト。型: [SelectColumn](API_query_SelectColumn.md) オブジェクトの配列 ** [Parameters](#API_query_PrepareQuery_ResponseSyntax) ** 送信されたクエリ文字列で使用されるパラメータのリスト。型: [ParameterMapping](API_query_ParameterMapping.md) オブジェクトの配列 ** [QueryString](#API_query_PrepareQuery_ResponseSyntax) ** 準備するクエリ文字列。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 262,144 です。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/PrepareQuery) # Query `Query` は、Amazon Timestream データに対してクエリを実行できる同期オペレーションです。 `QueryInsights` を有効にした場合、この API は実行したクエリに関連するインサイトとメトリクスも返します。`QueryInsights` はクエリのパフォーマンスチューニングに役立ちます。`QueryInsights` の詳細については、「[クエリインサイトを使用して Amazon Timestream のクエリを最適化する](https://docs.aws.amazon.com/timestream/latest/developerguide/using-query-insights.html)」を参照してください。 **注記** `QueryInsights` が有効な状態で実行できる `Query` API リクエストの最大数は、1 クエリ/秒 (QPS) です。このクエリレートを超えると、スロットリングが発生する可能性があります。 `Query` は 60 秒後にタイムアウトします。60 秒のタイムアウトをサポートするには、SDK のデフォルトタイムアウトを更新する必要があります。詳細については、[コードサンプル](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html)を参照してください。以下のケースでは、クエリリクエストが失敗します。 + 5 分間のべき等性期間外に同じクライアントトークンを使用して `Query` リクエストを送信する場合。 + 5 分間のべき等性期間内に同じクライアントトークンを使用し、その他のパラメータは変更して `Query` リクエストを送信する場合。 + 行のサイズ (クエリメタデータを含む) が 1 MB を超える場合、クエリは失敗し、次のエラーメッセージが表示されます。 `Query aborted as max page response size has been exceeded by the output result row` + クエリ発行元と結果読み取り先の IAM プリンシパルが同じでない場合や、クエリ発行元と結果読み取り先のクエリリクエストに同じクエリ文字列がない場合、クエリは `Invalid pagination token` エラーで失敗します。 ## リクエストの構文 ``` { "ClientToken": "string", "MaxRows": number, "NextToken": "string", "QueryInsights": { "Mode": "string" }, "QueryString": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ClientToken](#API_query_Query_RequestSyntax) ** `Query` リクエストの実行時に指定される、最大 64 ASCII 文字の、大文字と小文字を区別する一意の文字列。`ClientToken` を指定すると、`Query` への呼び出しが*べき等*になります。これは、同じクエリを繰り返し実行すると、同じ結果が生成されることを意味します。つまり、同じ `Query` リクエストを複数作成しても、効果は 1 つのリクエストを作成する場合と同じです。クエリで `ClientToken` を使用する場合は、次の点に注意してください。 + Query API が `ClientToken` なしでインスタンス化される場合、Query SDK がユーザーに代わって `ClientToken` を生成します。 + `Query` 呼び出しに `ClientToken` のみが含まれ、`NextToken` が含まれていない場合、`Query` の呼び出しは新しいクエリ実行とみなされます。 + 呼び出しに `NextToken` が含まれている場合、その呼び出しは Query API に対する以前の呼び出しの後続呼び出しとみなされ、結果セットが返されます。 + 4 時間後、同じを持つすべてのリクエスト`ClientToken`は新しいリクエストとして扱われます。タイプ: 文字列長さの制限: 最小長 32。最大長は 128 です。必須: いいえ ** [MaxRows](#API_query_Query_RequestSyntax) ** `Query` 出力で返される行の総数。`MaxRows` 値が指定された `Query` の最初の実行では、次の 2 つのケースでクエリの結果セットが返されます。 + 結果のサイズが `1MB` 未満である。 + 結果セットの行数が `maxRows` の値未満である。上記に該当しない場合、`Query` の最初の呼び出しは `NextToken` のみを返します。これは、結果セットを取得するために後続の呼び出しで使用できます。ページ分割を再開するには、後続コマンドで `NextToken` 値を指定します。行サイズが大きい場合 (例: 行に列が多数ある場合)、Timestream はレスポンスサイズが 1 MB の上限を超えないように、返す行数を減らすことがあります。`MaxRows` が指定されていない場合、Timestream は 1 MB の上限を満たす必要な行数を送信します。タイプ: 整数有効範囲: 最小値は 1 です。最大値は 1000 です。必須: いいえ ** [NextToken](#API_query_Query_RequestSyntax) ** 結果セットを返すために使用されるページ分割トークン。`Query` API が `NextToken` を使用して呼び出されると、その呼び出しは `Query` に対する以前の呼び出しの後続呼び出しとみなされ、結果セットが返されます。ただし、`Query` 呼び出しに `ClientToken` のみが含まれる場合、`Query` の呼び出しは新しいクエリ実行とみなされます。クエリで NextToken を使用する場合は、次の点に注意してください。 + ページ分割トークンは、最大 5 回の `Query` 呼び出しと、最大 1 時間のどちらか早い方に使用できます。 + 同じ `NextToken` を使用すると、同じレコードセットが返されます。結果セットをページ分割し続けるには、最新の `nextToken` を使用する必要があります。 + `Query` 呼び出しが `TokenA` と `TokenB` の 2 つの `NextToken` 値を返すとします。`TokenB` が後続の `Query` 呼び出しで使用される場合、`TokenA` は無効になり、再利用できません。 + ページ分割の開始後にクエリから以前の結果セットをリクエストするには、Query API を再度呼び出す必要があります。 + `null` が返されるまでは最新の `NextToken` を使用してページ分割し、これが返された時点で新しい `NextToken` を使用する必要があります。 + クエリ発行元と結果読み取り先の IAM プリンシパルが同じでない場合や、クエリ発行元と結果読み取り先のクエリリクエストに同じクエリ文字列がない場合、クエリは `Invalid pagination token` エラーで失敗します。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** [QueryInsights](#API_query_Query_RequestSyntax) ** `QueryInsights` を有効にするための設定をカプセル化します。 `QueryInsights` を有効にすると、実行したクエリのクエリ結果に加えて、インサイトとメトリクスが返されます。`QueryInsights` を使用して、クエリのパフォーマンスをチューニングできます。型: [QueryInsights](API_query_QueryInsights.md) オブジェクト必須: いいえ ** [QueryString](#API_query_Query_RequestSyntax) ** Timestream によって実行されるクエリ。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 262,144 です。必須: はい ## レスポンスの構文 ``` { "ColumnInfo": [ { "Name": "string", "Type": { "ArrayColumnInfo": "ColumnInfo", "RowColumnInfo": [ "ColumnInfo" ], "ScalarType": "string", "TimeSeriesMeasureValueColumnInfo": "ColumnInfo" } } ], "NextToken": "string", "QueryId": "string", "QueryInsightsResponse": { "OutputBytes": number, "OutputRows": number, "QuerySpatialCoverage": { "Max": { "PartitionKey": [ "string" ], "TableArn": "string", "Value": number } }, "QueryTableCount": number, "QueryTemporalRange": { "Max": { "TableArn": "string", "Value": number } }, "UnloadPartitionCount": number, "UnloadWrittenBytes": number, "UnloadWrittenRows": number }, "QueryStatus": { "CumulativeBytesMetered": number, "CumulativeBytesScanned": number, "ProgressPercentage": number }, "Rows": [ { "Data": [ { "ArrayValue": [ "Datum" ], "NullValue": boolean, "RowValue": "Row", "ScalarValue": "string", "TimeSeriesValue": [ { "Time": "string", "Value": "Datum" } ] } ] } ] } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [ColumnInfo](#API_query_Query_ResponseSyntax) ** 返された結果セットの列データ型。型: [ColumnInfo](API_query_ColumnInfo.md) オブジェクトの配列 ** [NextToken](#API_query_Query_ResponseSyntax) ** `Query` 呼び出しで再度使用して次の結果セットを取得できるページ分割トークン。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。 ** [QueryId](#API_query_Query_ResponseSyntax) ** 指定されたクエリの一意の ID。タイプ: 文字列長さの制約: 最小長は 1 です。最大長 64 パターン: `[a-zA-Z0-9]+` ** [QueryInsightsResponse](#API_query_Query_ResponseSyntax) ** 実行したクエリに関連するインサイトとメトリクスを含む `QueryInsights` をカプセル化します。型: [QueryInsightsResponse](API_query_QueryInsightsResponse.md) オブジェクト ** [QueryStatus](#API_query_Query_ResponseSyntax) ** 進行状況やスキャンされたバイト数など、クエリのステータスに関する情報。型: [QueryStatus](API_query_QueryStatus.md) オブジェクト ** [Rows](#API_query_Query_ResponseSyntax) ** クエリによって返される結果セット行。型: [Row](API_query_Row.md) オブジェクトの配列 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** ConflictException ** キャンセルされたクエリの結果をポーリングできません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** QueryExecutionException ** Timestream がクエリを正常に実行できませんでした。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/Query) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Query) # TagResource タグのセットを Timestream リソースに関連付けます。次に、これらのユーザー定義タグをアクティブ化し、コスト配分の追跡のため、Billing and Cost Management コンソールに表示できます。 ## リクエストの構文 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ResourceARN](#API_query_TagResource_RequestSyntax) ** タグを追加する Timestream リソースを識別します。この値は Amazon リソースネーム (ARN) です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ** [Tags](#API_query_TagResource_RequestSyntax) ** Timestream リソースに割り当てられるタグ。型: [Tag](API_query_Tag.md) オブジェクトの配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** リクエストされたリソースが見つかりませんでした。 ** ScheduledQueryArn ** スケジュールされたクエリの ARN。 HTTP ステータスコード: 400 ** ServiceQuotaExceededException ** サービスクォータを超過しました。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/TagResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource) # UntagResource Timestream クエリリソースからタグの関連付けを削除します。 ## リクエストの構文 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) ** タグを削除する Timestream リソース。この値は Amazon リソースネーム (ARN) です。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ** [TagKeys](#API_query_UntagResource_RequestSyntax) ** タグキーのリスト。このリストのメンバーであるキーを持つリソースの既存のタグは、Timestream リソースから削除されます。型: 文字列の配列配列メンバー: 最小数は 0 項目です。最大数は 200 項目です。長さの制限：最小長 1、最大長は 128 です。必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** リクエストされたリソースが見つかりませんでした。 ** ScheduledQueryArn ** スケジュールされたクエリの ARN。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UntagResource) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource) # UpdateAccountSettings クエリ料金に TCU を使用するようにアカウントを移行し、設定した最大クエリコンピューティングユニット数を変更します。`MaxQueryTCU` の値を希望の設定まで減らした場合、新しい値が有効になるまでに最大 24 時間かかります。 **注記** クエリ料金に TCU を使用するようにアカウントを移行した後は、クエリ料金にスキャン済みバイト数を使用するように移行できません。 ## リクエストの構文 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } }, "TargetQueryTCU": number } }, "QueryPricingModel": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) ** サービスがクエリを処理するために任意の時点で使用するコンピューティングユニットの最大数。クエリを実行するには、最小数を 4 TCU に設定する必要があります。TCU の最大数は、4 の倍数 (4、8、16、32 など) に設定できます。`MaxQueryTCU` に対してサポートされる最大値は 1000 です。このソフト制限の引き上げをリクエストするには、 AWS サポートにお問い合わせください。maxQueryTCU のデフォルトクォータの詳細については、「デフォルトのクォータ」を参照してください。この設定は、Timestream コンピューティングユニット (TCU) のオンデマンド使用にのみ適用されます。 `MaxQueryTCU` に対してサポートされる最大値は 1000 です。このソフト制限の引き上げをリクエストするには、 AWS サポートにお問い合わせください。`maxQueryTCU` のデフォルトクォータの詳細については、「[デフォルトのクォータ](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default)」を参照してください。タイプ: 整数必須: いいえ ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) ** アカウントのクエリコンピューティング設定を変更します。これには、アカウントのクエリ料金モデルやプロビジョンド Timestream コンピューティングユニット (TCU) 数が含まれます。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。この API はべき等です。つまり、同じリクエストを複数回行っても、1 回行う場合と効果は同じです。型: [QueryComputeRequest](API_query_QueryComputeRequest.md) オブジェクト必須: いいえ ** [QueryPricingModel](#API_query_UpdateAccountSettings_RequestSyntax) ** アカウントにおけるクエリの料金モデル。 `QueryPricingModel` パラメータは複数の Timestream オペレーションで使用されますが、`UpdateAccountSettings` API オペレーションは `COMPUTE_UNITS` 以外の値を認識しません。型: 文字列有効な値：`BYTES_SCANNED | COMPUTE_UNITS` 必須：いいえ ## レスポンスの構文 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "ActiveQueryTCU": number, "LastUpdate": { "Status": "string", "StatusMessage": "string", "TargetQueryTCU": number }, "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } } } }, "QueryPricingModel": "string" } ``` ## レスポンス要素アクションが成功すると、サービスは HTTP 200 レスポンスを返します。サービスから以下のデータが JSON 形式で返されます。 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_ResponseSyntax) ** サービスがクエリを処理するために任意の時点で使用するコンピューティングユニットの設定済みの最大数。タイプ: 整数 ** [QueryCompute](#API_query_UpdateAccountSettings_ResponseSyntax) ** アカウントのデータのクエリに関する更新されたアカウント設定を確認します。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。型: [QueryComputeResponse](API_query_QueryComputeResponse.md) オブジェクト ** [QueryPricingModel](#API_query_UpdateAccountSettings_ResponseSyntax) ** アカウントの料金モデル。型: 文字列有効な値：`BYTES_SCANNED | COMPUTE_UNITS` ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings) # UpdateScheduledQuery スケジュールされたクエリを更新します。 ## リクエストの構文 ``` { "ScheduledQueryArn": "string", "State": "string" } ``` ## リクエストパラメーターすべてのアクションに共通のパラメータの詳細については、「[共通パラメータ](CommonParameters.md)」を参照してください。リクエストは以下のデータを JSON 形式で受け入れます。 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) ** スケジュールされたクエリの ARN。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ** [State](#API_query_UpdateScheduledQuery_RequestSyntax) ** スケジュールされたクエリの状態。型: 文字列有効な値: `ENABLED | DISABLED` 必須: はい ## レスポンス要素アクションが成功した場合、サービスは空の HTTP 本文を持つ HTTP 200 レスポンスを返します。 ## エラーすべてのアクションに共通のエラーについては、「[共通エラー](CommonErrors.md)」を参照してください。 ** AccessDeniedException ** アカウント設定にアクセスするために必要なアクセス許可がありません。 HTTP ステータスコード: 400 ** InternalServerException ** リクエストの処理中に内部サーバーエラーが発生しました。 HTTP ステータスコード: 400 ** InvalidEndpointException ** リクエストされたエンドポイントが無効です。 HTTP ステータスコード: 400 ** ResourceNotFoundException ** リクエストされたリソースが見つかりませんでした。 ** ScheduledQueryArn ** スケジュールされたクエリの ARN。 HTTP ステータスコード: 400 ** ThrottlingException ** リクエストが多すぎるため、リクエストがスロットリングされました。 HTTP ステータスコード: 400 ** ValidationException ** リクエストが無効であるか、形式が正しくありません。 HTTP ステータスコード: 400 ## 以下の資料も参照してください。言語固有の AWS SDKs のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS コマンドラインインターフェイス V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for Python](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery) # データ型 Amazon Timestream Write では次のデータ型がサポートされています。 + [BatchLoadProgressReport](API_BatchLoadProgressReport.md) + [BatchLoadTask](API_BatchLoadTask.md) + [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) + [CsvConfiguration](API_CsvConfiguration.md) + [Database](API_Database.md) + [DataModel](API_DataModel.md) + [DataModelConfiguration](API_DataModelConfiguration.md) + [DataModelS3Configuration](API_DataModelS3Configuration.md) + [DataSourceConfiguration](API_DataSourceConfiguration.md) + [DataSourceS3Configuration](API_DataSourceS3Configuration.md) + [Dimension](API_Dimension.md) + [DimensionMapping](API_DimensionMapping.md) + [Endpoint](API_Endpoint.md) + [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) + [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) + [MeasureValue](API_MeasureValue.md) + [MixedMeasureMapping](API_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_MultiMeasureMappings.md) + [PartitionKey](API_PartitionKey.md) + [Record](API_Record.md) + [RecordsIngested](API_RecordsIngested.md) + [RejectedRecord](API_RejectedRecord.md) + [ReportConfiguration](API_ReportConfiguration.md) + [ReportS3Configuration](API_ReportS3Configuration.md) + [RetentionProperties](API_RetentionProperties.md) + [S3Configuration](API_S3Configuration.md) + [Schema](API_Schema.md) + [Table](API_Table.md) + [Tag](API_Tag.md) Amazon Timestream Query では次のデータ型がサポートされています。 + [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) + [ColumnInfo](API_query_ColumnInfo.md) + [Datum](API_query_Datum.md) + [DimensionMapping](API_query_DimensionMapping.md) + [Endpoint](API_query_Endpoint.md) + [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) + [ErrorReportLocation](API_query_ErrorReportLocation.md) + [ExecutionStats](API_query_ExecutionStats.md) + [LastUpdate](API_query_LastUpdate.md) + [MixedMeasureMapping](API_query_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_query_MultiMeasureMappings.md) + [NotificationConfiguration](API_query_NotificationConfiguration.md) + [ParameterMapping](API_query_ParameterMapping.md) + [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) + [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) + [QueryComputeRequest](API_query_QueryComputeRequest.md) + [QueryComputeResponse](API_query_QueryComputeResponse.md) + [QueryInsights](API_query_QueryInsights.md) + [QueryInsightsResponse](API_query_QueryInsightsResponse.md) + [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) + [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) + [QueryStatus](API_query_QueryStatus.md) + [QueryTemporalRange](API_query_QueryTemporalRange.md) + [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) + [Row](API_query_Row.md) + [S3Configuration](API_query_S3Configuration.md) + [S3ReportLocation](API_query_S3ReportLocation.md) + [ScheduleConfiguration](API_query_ScheduleConfiguration.md) + [ScheduledQuery](API_query_ScheduledQuery.md) + [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) + [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) + [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) + [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) + [SelectColumn](API_query_SelectColumn.md) + [SnsConfiguration](API_query_SnsConfiguration.md) + [Tag](API_query_Tag.md) + [TargetConfiguration](API_query_TargetConfiguration.md) + [TargetDestination](API_query_TargetDestination.md) + [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) + [TimestreamConfiguration](API_query_TimestreamConfiguration.md) + [TimestreamDestination](API_query_TimestreamDestination.md) + [Type](API_query_Type.md) # Amazon Timestream Write Amazon Timestream Write では次のデータ型がサポートされています。 + [BatchLoadProgressReport](API_BatchLoadProgressReport.md) + [BatchLoadTask](API_BatchLoadTask.md) + [BatchLoadTaskDescription](API_BatchLoadTaskDescription.md) + [CsvConfiguration](API_CsvConfiguration.md) + [Database](API_Database.md) + [DataModel](API_DataModel.md) + [DataModelConfiguration](API_DataModelConfiguration.md) + [DataModelS3Configuration](API_DataModelS3Configuration.md) + [DataSourceConfiguration](API_DataSourceConfiguration.md) + [DataSourceS3Configuration](API_DataSourceS3Configuration.md) + [Dimension](API_Dimension.md) + [DimensionMapping](API_DimensionMapping.md) + [Endpoint](API_Endpoint.md) + [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) + [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) + [MeasureValue](API_MeasureValue.md) + [MixedMeasureMapping](API_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_MultiMeasureMappings.md) + [PartitionKey](API_PartitionKey.md) + [Record](API_Record.md) + [RecordsIngested](API_RecordsIngested.md) + [RejectedRecord](API_RejectedRecord.md) + [ReportConfiguration](API_ReportConfiguration.md) + [ReportS3Configuration](API_ReportS3Configuration.md) + [RetentionProperties](API_RetentionProperties.md) + [S3Configuration](API_S3Configuration.md) + [Schema](API_Schema.md) + [Table](API_Table.md) + [Tag](API_Tag.md) # BatchLoadProgressReport バッチロードタスクの進行状況に関する詳細。 ## 内容 ** BytesMetered ** 型: Long 必須: いいえ ** FileFailures ** 型: Long 必須: いいえ ** ParseFailures ** 型: Long 必須: いいえ ** RecordIngestionFailures ** 型: Long 必須: いいえ ** RecordsIngested ** 型: Long 必須: いいえ ** RecordsProcessed ** 型: Long 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadProgressReport) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadProgressReport) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadProgressReport) # BatchLoadTask バッチロードタスクに関する詳細。 ## 内容 ** CreationTime ** Timestream バッチロードタスクが作成された時刻。型: タイムスタンプ必須: いいえ ** DatabaseName ** バッチロードタスクがデータをロードするデータベースのデータベース名。タイプ: 文字列必須: いいえ ** LastUpdatedTime ** Timestream バッチロードタスクが最後に更新された時刻。型: タイムスタンプ必須: いいえ ** ResumableUntil ** 型: タイムスタンプ必須: いいえ ** TableName ** バッチロードタスクがデータをロードするテーブルのテーブル名。タイプ: 文字列必須: いいえ ** TaskId ** バッチロードタスクの ID。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 32 です。パターン: `[A-Z0-9]+` 必須: いいえ ** TaskStatus ** バッチロードタスクのステータス。型: 文字列有効な値：`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTask) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTask) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTask) # BatchLoadTaskDescription バッチロードタスクに関する詳細。 ## 内容 ** CreationTime ** Timestream バッチロードタスクが作成された時刻。型: タイムスタンプ必須: いいえ ** DataModelConfiguration ** バッチロードタスクのデータモデル設定。これには、バッチロードタスクのデータモデルの保存先に関する詳細が含まれます。型: [DataModelConfiguration](API_DataModelConfiguration.md) オブジェクト必須: いいえ ** DataSourceConfiguration ** バッチロードタスクのデータソースに関する設定の詳細。型: [DataSourceConfiguration](API_DataSourceConfiguration.md) オブジェクト必須: いいえ ** ErrorMessage ** タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** LastUpdatedTime ** Timestream バッチロードタスクが最後に更新された時刻。型: タイムスタンプ必須: いいえ ** ProgressReport ** 型: [BatchLoadProgressReport](API_BatchLoadProgressReport.md) オブジェクト必須: いいえ ** RecordVersion ** 型: Long 必須: いいえ ** ReportConfiguration ** バッチロードタスクのレポート設定。これには、エラーレポートの保存先に関する詳細が含まれます。型: [ReportConfiguration](API_ReportConfiguration.md) オブジェクト必須: いいえ ** ResumableUntil ** 型: タイムスタンプ必須: いいえ ** TargetDatabaseName ** タイプ: 文字列必須: いいえ ** TargetTableName ** タイプ: 文字列必須: いいえ ** TaskId ** バッチロードタスクの ID。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 32 です。パターン: `[A-Z0-9]+` 必須: いいえ ** TaskStatus ** バッチロードタスクのステータス。型: 文字列有効な値：`CREATED | IN_PROGRESS | FAILED | SUCCEEDED | PROGRESS_STOPPED | PENDING_RESUME` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/BatchLoadTaskDescription) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/BatchLoadTaskDescription) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/BatchLoadTaskDescription) # CsvConfiguration 列区切り文字がカンマで、レコード区切り文字が改行文字である、区切りデータ形式。 ## 内容 ** ColumnSeparator ** 列区切り文字はカンマ (',')、パイプ ('\$1')、セミコロン (';')、タブ ('/t')、空白 (' ') のいずれかです。タイプ: 文字列長さの制限：1 の固定長。必須: いいえ ** EscapeChar ** エスケープ文字が次のいずれかになります。タイプ: 文字列長さの制限：1 の固定長。必須: いいえ ** NullValue ** 空白 (' ') にすることができます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** QuoteChar ** 一重引用符 (') または二重引用符 (") を使用できます。タイプ: 文字列長さの制限：1 の固定長。必須: いいえ ** TrimWhiteSpace ** 先頭と末尾の空白をトリミングするように指定します。型: ブール値必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/CsvConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/CsvConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/CsvConfiguration) # Database テーブルの最上位コンテナ。データベースとテーブルは、Amazon Timestream の基本的な管理概念です。データベース内のすべてのテーブルが、同じ AWS KMS キーで暗号化されます。 ## 内容 ** Arn ** このデータベースを一意に識別する Amazon リソースネーム。タイプ: 文字列必須: いいえ ** CreationTime ** Unix エポック時間から計算された、データベースの作成時刻。型: タイムスタンプ必須: いいえ ** DatabaseName ** Timestream データベースの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: いいえ ** KmsKeyId ** データベースに保存されているデータの暗号化に使用される AWS KMS キーの識別子。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** LastUpdatedTime ** このデータベースが最後に更新された時刻。型: タイムスタンプ必須: いいえ ** TableCount ** Timestream データベース内で見つかったテーブルの合計数。型: Long 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Database) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Database) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Database) # DataModel バッチロードタスクのデータモデル。 ## 内容 ** DimensionMappings ** ディメンションのソースからターゲットへのマッピング。型: [DimensionMapping](API_DimensionMapping.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。 Required: Yes ** MeasureNameColumn ** タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** MixedMeasureMappings ** メジャーのソースからターゲットへのマッピング。型: [MixedMeasureMapping](API_MixedMeasureMapping.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。必須: いいえ ** MultiMeasureMappings ** マルチメジャーレコードのソースからターゲットへのマッピング。型: [MultiMeasureMappings](API_MultiMeasureMappings.md) オブジェクト必須: いいえ ** TimeColumn ** 時間にマッピングされるソース列。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** TimeUnit ** タイムスタンプ単位の詳細度。時間値が秒単位、ミリ秒単位、ナノ秒単位、またはその他のサポートされている値であるかどうかを示します。デフォルトは `MILLISECONDS` です。型: 文字列有効な値：`MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModel) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModel) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModel) # DataModelConfiguration ## 内容 ** DataModel ** 型: [DataModel](API_DataModel.md) オブジェクト必須: いいえ ** DataModelS3Configuration ** 型: [DataModelS3Configuration](API_DataModelS3Configuration.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelConfiguration) # DataModelS3Configuration ## 内容 ** BucketName ** タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 63 です。パターン: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必須: いいえ ** ObjectKey ** タイプ: 文字列長さの制限: 最小長は 1 です。最大長は 1,024 です。パターン: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataModelS3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataModelS3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataModelS3Configuration) # DataSourceConfiguration データソースに関する設定の詳細を定義します。 ## 内容 ** DataFormat ** 現在は CSV です。型: 文字列有効な値：`CSV` 必須: はい ** DataSourceS3Configuration ** ロード対象データを含むファイルが保存された S3 ロケーションの設定。型: [DataSourceS3Configuration](API_DataSourceS3Configuration.md) オブジェクト必須: はい ** CsvConfiguration ** 列区切り文字がカンマで、レコード区切り文字が改行文字である、区切りデータ形式。型: [CsvConfiguration](API_CsvConfiguration.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceConfiguration) # DataSourceS3Configuration ## 内容 ** BucketName ** S3 バケットカスタマーのバケット名。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 63 です。パターン: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必須: はい ** ObjectKeyPrefix ** タイプ: 文字列長さの制限: 最小長は 1 です。最大長は 1,024 です。パターン: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DataSourceS3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DataSourceS3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DataSourceS3Configuration) # Dimension 時系列のメタデータ属性を表します。例えば、EC2 インスタンスの名前とアベイラビリティーゾーン、または風力タービンの製造元の名前はディメンションです。 ## 内容 ** Name ** ディメンションは、時系列のメタデータ属性を表します。例えば、EC2 インスタンスの名前とアベイラビリティーゾーン、または風力タービンの製造元の名前はディメンションです。ディメンション名の制約については、「[命名に関する制約](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 60 です。必須: はい ** Value ** ディメンションの値。タイプ: 文字列必須: はい ** DimensionValueType ** 時系列データポイントのディメンションのデータ型。型: 文字列有効な値：`VARCHAR` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Dimension) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Dimension) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Dimension) # DimensionMapping ## 内容 ** DestinationColumn ** タイプ: 文字列長さの制限: 最小長は 1 です。必須: いいえ ** SourceColumn ** タイプ: 文字列長さの制限: 最小長は 1 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/DimensionMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/DimensionMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/DimensionMapping) # Endpoint API コールの対象となる利用可能なエンドポイントと、そのエンドポイントの TTL を表します。 ## 内容 ** Address ** エンドポイントアドレス。タイプ: 文字列必須: はい ** CachePeriodInMinutes ** エンドポイントの TTL (分)。タイプ: Long 必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Endpoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Endpoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Endpoint) # MagneticStoreRejectedDataLocation 磁気ストアの書き込み中に拒否されたレコードのエラーレポートを非同期に書き込む場所。 ## 内容 ** S3Configuration ** 磁気ストアの書き込み中に拒否されたレコードのエラーレポートを非同期に書き込む S3 ロケーションの設定。型: [S3Configuration](API_S3Configuration.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreRejectedDataLocation) # MagneticStoreWriteProperties マグネティックストアの書き込みを設定するためのテーブル上のプロパティセット。 ## 内容 ** EnableMagneticStoreWrites ** マグネティックストアの書き込みを有効にするフラグ。型: ブール値必須: はい ** MagneticStoreRejectedDataLocation ** マグネティックストアの書き込み中に拒否されたレコードのエラーレポートを非同期に書き込む場所。型: [MagneticStoreRejectedDataLocation](API_MagneticStoreRejectedDataLocation.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MagneticStoreWriteProperties) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MagneticStoreWriteProperties) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MagneticStoreWriteProperties) # MeasureValue 時系列のデータ属性を表します。例えば、EC2 インスタンスの CPU 使用率や風力タービンの RPM がメジャーです。MeasureValue には名前と値の両方があります。 MeasureValue は `MULTI` 型でのみ許可されます。`MULTI` 型を使用すると、同じ時系列に関連付けられた複数のデータ属性を単一のレコードで渡すことができます。 ## 内容 ** Name ** MeasureValue の名前。 MeasureValue 名の制約については、「Amazon Timestream デベロッパーガイド」の「[命名に関する制約](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.naming)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。必須: はい ** Type ** 時系列データポイントの MeasureValue のデータ型が含まれます。型: 文字列有効な値：`DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` 必須: はい ** Value ** MeasureValue の値。詳細については、「[データ型](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types)」を参照してください。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MeasureValue) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MeasureValue) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MeasureValue) # MixedMeasureMapping ## 内容 ** MeasureValueType ** 型: 文字列有効な値：`DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` Required: Yes ** MeasureName ** タイプ: 文字列長さの制限: 最小長は 1 です。必須: いいえ ** MultiMeasureAttributeMappings ** 型: [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。必須: いいえ ** SourceColumn ** タイプ: 文字列長さの制限: 最小長は 1 です。必須: いいえ ** TargetMeasureName ** タイプ: 文字列長さの制限: 最小長は 1 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MixedMeasureMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MixedMeasureMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MixedMeasureMapping) # MultiMeasureAttributeMapping ## 内容 ** SourceColumn ** タイプ: 文字列長さの制約: 最小長は 1 です。 Required: Yes ** MeasureValueType ** 型: 文字列有効な値：`DOUBLE | BIGINT | BOOLEAN | VARCHAR | TIMESTAMP` 必須：いいえ ** TargetMultiMeasureAttributeName ** タイプ: 文字列長さの制限: 最小長は 1 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureAttributeMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureAttributeMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureAttributeMapping) # MultiMeasureMappings ## 内容 ** MultiMeasureAttributeMappings ** 型: [MultiMeasureAttributeMapping](API_MultiMeasureAttributeMapping.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。 Required: Yes ** TargetMultiMeasureName ** タイプ: 文字列長さの制限: 最小長は 1 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/MultiMeasureMappings) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/MultiMeasureMappings) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/MultiMeasureMappings) # PartitionKey テーブル内のデータのパーティション化に使用される属性。ディメンションキーは、dimension-name で指定されたディメンションの値をパーティションキーとして使用してデータをパーティション化します。メジャーキーは、メジャー名 (「measure\$1name」列の値) を使用してデータをパーティション化します。 ## 内容 ** Type ** パーティションキーのタイプ。オプションは、DIMENSION (ディメンションキー) と MEASURE (メジャーキー) です。型: 文字列有効な値：`DIMENSION | MEASURE` 必須: はい ** EnforcementInRecord ** 取り込まれたレコードにおけるディメンションキーの指定の適用レベル。オプションは REQUIRED (ディメンションキーの指定が必須) と OPTIONAL (ディメンションキーの指定が必須ではない) です。型: 文字列有効な値：`REQUIRED | OPTIONAL` 必須：いいえ ** Name ** ディメンションキーに使用される属性の名前。タイプ: 文字列長さの制限: 最小長は 1 です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/PartitionKey) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/PartitionKey) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/PartitionKey) # Record Timestream に書き込まれる時系列データポイントを表します。各レコードにはディメンションの配列が含まれています。ディメンションは、EC2 インスタンスのインスタンス名やアベイラビリティーゾーンなど、時系列データポイントのメタデータ属性を表します。レコードには、収集されるメジャーの名前であるメジャー名 (EC2 インスタンスの CPU 使用率など) も含まれます。さらに、レコードにはメジャー値と、メジャー値のデータ型である値型が含まれます。また、レコードには、メジャーが収集された時刻のタイムスタンプと、タイムスタンプの詳細度を表すタイムスタンプ単位が含まれます。レコードには `Version` フィールドがあり、このフィールドはデータポイントの更新に使用できる 64 ビットの `long` です。ディメンション、タイムスタンプ、メジャー名が同じであるが、メジャー値が異なる重複レコードの書き込みは、書き込みリクエスト内のレコードの `Version` 属性が既存のレコードの属性よりも新しい場合にのみ成功します。Timestream は、`Version` フィールドのないレコードの場合、デフォルトで `1` の `Version` になります。 ## 内容 ** Dimensions ** 時系列データポイントのディメンションのリストが含まれます。型: [Dimension](API_Dimension.md) オブジェクトの配列配列メンバー: 最大数は 128 項目です。必須: いいえ ** MeasureName ** メジャーは、時系列のデータ属性を表します。例えば、EC2 インスタンスの CPU 使用率や風力タービンの RPM がメジャーです。型: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** MeasureValue ** 時系列データポイントのメジャー値が含まれます。型: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** MeasureValues ** 時系列データポイントの MeasureValue のリストが含まれます。これは `MULTI` 型でのみ許可されます。スカラー値の場合は、レコードの `MeasureValue` 属性を直接使用します。型: [MeasureValue](API_MeasureValue.md) オブジェクトの配列必須: いいえ ** MeasureValueType ** 時系列データポイントのメジャー値のデータ型が含まれます。デフォルトの型は `DOUBLE` です。詳細については、「[データ型](https://docs.aws.amazon.com/timestream/latest/developerguide/writes.html#writes.data-types)」を参照してください。型: 文字列有効な値：`DOUBLE | BIGINT | VARCHAR | BOOLEAN | TIMESTAMP | MULTI` 必須: いいえ ** Time ** データポイントのメジャー値が収集された時刻が含まれます。時間値と単位は、エポックからの経過時間を示します。例えば、時間値が `12345` で、単位が `ms` の場合、エポックから `12345 ms` が経過しています。型: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: いいえ ** TimeUnit ** タイムスタンプ単位の詳細度。時間値が秒単位、ミリ秒単位、ナノ秒単位、またはその他のサポートされている値であるかどうかを示します。デフォルトは `MILLISECONDS` です。型: 文字列有効な値：`MILLISECONDS | SECONDS | MICROSECONDS | NANOSECONDS` 必須: いいえ ** Version ** レコードの更新に使用される 64 ビット属性。より大きなバージョン番号の重複データの書き込みリクエストは、既存のメジャー値とバージョンを更新します。メジャー値が同じ場合でも `Version` は更新されます。デフォルト値は `1` です。 `Version` は `1` 以降である必要があります。そうでない場合は `ValidationException` エラーが発生します。型: 長整数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Record) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Record) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Record) # RecordsIngested このリクエストによって取り込まれたレコードに関する情報。 ## 内容 ** MagneticStore ** マグネティックストアに取り込まれたレコードの数。タイプ: 整数必須: いいえ ** MemoryStore ** メモリストアに取り込まれたレコードの数。タイプ: 整数必須: いいえ ** Total ** 正常に取り込まれたレコードの合計数。タイプ: 整数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RecordsIngested) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RecordsIngested) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RecordsIngested) # RejectedRecord 時系列データをシステムに再挿入する前に解決する必要があるデータ検証に関する問題が原因で Timestream に正常に挿入されなかったレコードを表します。 ## 内容 ** ExistingVersion ** レコードの既存のバージョン。この値は、書き込みリクエストのバージョンよりもバージョンが新しい同一のレコードが存在するシナリオで入力されます。型: 長整数必須: いいえ ** Reason ** Timestream にレコードが正常に挿入されなかった理由。次のようなエラーの原因が考えられます。 + ディメンション、タイムスタンプ、メジャー名が同じであるレコードが複数あるが、以下に該当する重複データを含むレコード。 + メジャー値が異なる + バージョンがリクエストに存在しない、*または*新しいレコードのバージョンの値が既存の値以下である Timestream がこのケースのデータを拒否した場合、`RejectedRecords` レスポンスの `ExistingVersion` フィールドには現在のレコードのバージョンが表示されます。強制的に更新するには、レコードのバージョンを `ExistingVersion` より大きい値に設定してリクエストを再送信します。 + タイムスタンプがメモリストアの保持期間外であるレコード。 **注記** 保持期間が更新された場合、新しい期間内にすぐにデータを取り込もうとすると、`RejectedRecords` の例外が発生します。`RejectedRecords` の例外を回避するには、新しい時間枠の期間内に新しいデータが取り込まれるまで待機します。詳細については、[Timestream の設定に関するベストプラクティス](https://docs.aws.amazon.com/timestream/latest/developerguide/best-practices.html#configuration)と [Timestream のストレージの仕組みに関する説明](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html)を参照してください。 + ディメンションまたはメジャーが Timestream で定義された制限を超えるレコード。詳細については、Timestream 開発者ガイドの「[アクセス管理](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html)」を参照してください。型: 文字列必須: いいえ ** RecordIndex ** WriteRecords の入力リクエスト内にあるレコードのインデックス。インデックスは 0 で始まります。タイプ: 整数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RejectedRecord) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RejectedRecord) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RejectedRecord) # ReportConfiguration バッチロードタスクのレポート設定。これには、エラーレポートの保存先に関する詳細が含まれます。 ## 内容 ** ReportS3Configuration ** バッチロードのエラーレポートとイベントを書き込む S3 ロケーションの設定。型: [ReportS3Configuration](API_ReportS3Configuration.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportConfiguration) # ReportS3Configuration ## 内容 ** BucketName ** 型: 文字列長さの制約: 最小長は 3 です。最大長は 63 です。パターン: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必須: はい ** EncryptionOption ** 型: 文字列有効な値：`SSE_S3 | SSE_KMS` 必須: いいえ ** KmsKeyId ** 型: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** ObjectKeyPrefix ** 型: 文字列長さの制約: 最小長は 1 です。最大長は 928 です。パターン: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/ReportS3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/ReportS3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/ReportS3Configuration) # RetentionProperties 保存プロパティには、時系列データをマグネティックストアとメモリストアに保存する必要がある期間が含まれます。 ## 内容 ** MagneticStoreRetentionPeriodInDays ** データをマグネティックストアに保存しなければならない期間。型: 長整数有効範囲: 最小値は 1 です。最大値は 73000 です。必須: はい ** MemoryStoreRetentionPeriodInHours ** データをメモリーストアに保存しなければならない期間。型: 長整数有効範囲: 最小値は 1 です。最大値は 8766 です。必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/RetentionProperties) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/RetentionProperties) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/RetentionProperties) # S3Configuration S3 の場所を指定する設定。 ## 内容 ** BucketName ** S3 バケットカスタマーのバケット名。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 63 です。パターン: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必須: いいえ ** EncryptionOption ** S3 ロケーションカスタマーの暗号化オプション。オプションは、S3 マネージドキーまたは AWS マネージドキーを備えた S3 サーバー側暗号化です。型: 文字列有効な値：`SSE_S3 | SSE_KMS` 必須：いいえ ** KmsKeyId ** AWS マネージドキーで暗号化する場合の、カスタマー S3 ロケーションの AWS KMS キー ID。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** ObjectKeyPrefix ** カスタマー S3 ロケーションのオブジェクトキープレビュー。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 928 です。パターン: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/S3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/S3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/S3Configuration) # Schema スキーマは、テーブルの予想されるデータモデルを指定します。 ## 内容 ** CompositePartitionKey ** テーブルデータのパーティション化に使用される属性を定義するパーティションキーの空でないリスト。リストの順序によってパーティション階層が決まります。各パーティションキーの名前と型、およびパーティションキーの順序は、テーブルの作成後に変更することはできません。ただし、各パーティションキーの適用レベルは変更できます。型: [PartitionKey](API_PartitionKey.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Schema) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Schema) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Schema) # Table Timestream のデータベーステーブルを表します。テーブルには、関連する時系列が 1 つ以上含まれています。テーブルのメモリストアとマグネティックストアの保持期間は変更できます。 ## 内容 ** Arn ** このテーブルを一意に識別する Amazon リソースネーム。型: 文字列必須: いいえ ** CreationTime ** Timestream テーブルが作成された時刻。型: タイムスタンプ必須: いいえ ** DatabaseName ** このテーブルを含む Timestream データベースの名前。型: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: いいえ ** LastUpdatedTime ** Timestream テーブルが最後に更新された時刻。型: タイムスタンプ必須: いいえ ** MagneticStoreWriteProperties ** 磁気ストアの書き込みを有効にするときに表に設定するプロパティが含まれます。型: [MagneticStoreWriteProperties](API_MagneticStoreWriteProperties.md) オブジェクト必須: いいえ ** RetentionProperties ** メモリストアと磁気ストアの保持期間。型: [RetentionProperties](API_RetentionProperties.md) オブジェクト必須: いいえ ** Schema ** テーブルのスキーマ。型: [Schema](API_Schema.md) オブジェクト必須: いいえ ** TableName ** Timestream テーブルの名前。型: 文字列長さの制約: 最小長は 3 です。最大長は 256 です。必須: いいえ ** TableStatus ** テーブルの現在の状態は以下のように示されます。 + `DELETING` – テーブルは削除中です。 + `ACTIVE` – テーブルはすぐに使用できます。型: 文字列有効な値：`ACTIVE | DELETING | RESTORING` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Table) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Table) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Table) # Tag タグは、Timestream データベースやテーブルに割り当てるラベルのことです。各タグはキーとオプションの値で構成され、どちらもお客様が定義します。タグを使用すると、データベースやテーブルを目的、所有者、環境などで分類できます。 ## 内容 ** Key ** タグのキー。タグキーでは、大文字と小文字が区別されます。型: 文字列長さの制限: 最小長は 1 です。最大長は 128 です。必須: はい ** Value ** タグの値。タグ値は大文字と小文字が区別され、null にすることができます。型: 文字列長さの制約: 最小長は 0 です。最大長は 256 です。必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-write-2018-11-01/Tag) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-write-2018-11-01/Tag) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-write-2018-11-01/Tag) # Amazon Timestream Query Amazon Timestream Query では次のデータ型がサポートされています。 + [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) + [ColumnInfo](API_query_ColumnInfo.md) + [Datum](API_query_Datum.md) + [DimensionMapping](API_query_DimensionMapping.md) + [Endpoint](API_query_Endpoint.md) + [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) + [ErrorReportLocation](API_query_ErrorReportLocation.md) + [ExecutionStats](API_query_ExecutionStats.md) + [LastUpdate](API_query_LastUpdate.md) + [MixedMeasureMapping](API_query_MixedMeasureMapping.md) + [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) + [MultiMeasureMappings](API_query_MultiMeasureMappings.md) + [NotificationConfiguration](API_query_NotificationConfiguration.md) + [ParameterMapping](API_query_ParameterMapping.md) + [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) + [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) + [QueryComputeRequest](API_query_QueryComputeRequest.md) + [QueryComputeResponse](API_query_QueryComputeResponse.md) + [QueryInsights](API_query_QueryInsights.md) + [QueryInsightsResponse](API_query_QueryInsightsResponse.md) + [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) + [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) + [QueryStatus](API_query_QueryStatus.md) + [QueryTemporalRange](API_query_QueryTemporalRange.md) + [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) + [Row](API_query_Row.md) + [S3Configuration](API_query_S3Configuration.md) + [S3ReportLocation](API_query_S3ReportLocation.md) + [ScheduleConfiguration](API_query_ScheduleConfiguration.md) + [ScheduledQuery](API_query_ScheduledQuery.md) + [ScheduledQueryDescription](API_query_ScheduledQueryDescription.md) + [ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) + [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) + [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) + [SelectColumn](API_query_SelectColumn.md) + [SnsConfiguration](API_query_SnsConfiguration.md) + [Tag](API_query_Tag.md) + [TargetConfiguration](API_query_TargetConfiguration.md) + [TargetDestination](API_query_TargetDestination.md) + [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) + [TimestreamConfiguration](API_query_TimestreamConfiguration.md) + [TimestreamDestination](API_query_TimestreamDestination.md) + [Type](API_query_Type.md) # AccountSettingsNotificationConfiguration アカウント設定に関連する通知の設定。 ## 内容 ** RoleArn ** 通知を発行するアクセス許可を Timestream に付与する Amazon リソースネーム (ARN)。このフィールドは、アカウント設定の更新時に SNS トピックが指定されている場合にのみ表示されます。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ** SnsConfiguration ** 通知の送信に必要な SNS の詳細。型: [SnsConfiguration](API_query_SnsConfiguration.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/AccountSettingsNotificationConfiguration) # ColumnInfo 列名やデータ型などの属性といったクエリ結果のメタデータが含まれます。 ## 内容 ** Type ** 結果セット列のデータ型。データ型はスカラーでも複雑でもかまいません。スカラーデータ型は、整数、文字列、倍精度浮動小数点数、ブール値などです。複雑なデータ型は、配列、行などの型です。型: [Type](API_query_Type.md) オブジェクト必須: はい ** Name ** 結果セット列の名前。結果セットの名前は、配列を除くすべてのデータ型の列で使用できます。タイプ: 文字列必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ColumnInfo) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ColumnInfo) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ColumnInfo) # Datum Datum は、クエリ結果の単一のデータポイントを表します。 ## 内容 ** ArrayValue ** データポイントが配列かどうかを示します。タイプ: [Datum](#API_query_Datum) オブジェクトの配列必須: いいえ ** NullValue ** データポイントが null かどうかを示します。型: ブール値必須: いいえ ** RowValue ** データポイントが行かどうかを示します。型: [Row](API_query_Row.md) オブジェクト必須: いいえ ** ScalarValue ** データポイントが整数、文字列、倍精度浮動小数点数、ブール値などのスカラー値かどうかを示します。タイプ: 文字列必須: いいえ ** TimeSeriesValue ** データポイントが時系列データ型かどうかを示します。タイプ: [TimeSeriesDataPoint](API_query_TimeSeriesDataPoint.md) オブジェクトの配列必須：いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Datum) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Datum) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Datum) # DimensionMapping このタイプは、クエリ結果の列を宛先テーブルのディメンションにマッピングするために使用されます。 ## 内容 ** DimensionValueType ** ディメンションのタイプ。型: 文字列有効な値：`VARCHAR` 必須: はい ** Name ** クエリ結果の列名。タイプ: 文字列必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DimensionMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DimensionMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DimensionMapping) # Endpoint API コールの対象となる利用可能なエンドポイントと、そのエンドポイントの TTL を表します。 ## 内容 ** Address ** エンドポイントアドレス。タイプ: 文字列必須: はい ** CachePeriodInMinutes ** エンドポイントの TTL (分)。タイプ: Long 必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Endpoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Endpoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Endpoint) # ErrorReportConfiguration エラーレポートに必要な構成。 ## 内容 ** S3Configuration ** エラーレポートの S3 構成。型: [S3Configuration](API_query_S3Configuration.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportConfiguration) # ErrorReportLocation 1 回のスケジュールされたクエリ呼び出しのエラーレポートの場所が含まれます。 ## 内容 ** S3ReportLocation ** エラーレポートが書き込まれる S3 ロケーション。型: [S3ReportLocation](API_query_S3ReportLocation.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ErrorReportLocation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ErrorReportLocation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ErrorReportLocation) # ExecutionStats スケジュールされたクエリの 1 回の実行に関する統計。 ## 内容 ** BytesMetered ** スケジュールされたクエリの 1 回の実行で計測されたバイト数。型: Long 必須: いいえ ** CumulativeBytesScanned ** スケジュールされたクエリの 1 回の実行でスキャンされたバイト数。型: Long 必須: いいえ ** DataWrites ** スケジュールされたクエリの 1 回の実行で取り込まれたレコードに対して計測されたデータ書き込み回数。型: Long 必須: いいえ ** ExecutionTimeInMillis ** スケジュールされたクエリの実行完了に要した合計時間 (ミリ秒)。型: Long 必須: いいえ ** QueryResultRows ** クエリの実行から送信先データソースへの取り込みまでの出力の行数。型: Long 必須: いいえ ** RecordsIngested ** スケジュールされたクエリの 1 回の実行で取り込まれたレコードの数。型: Long 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecutionStats) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecutionStats) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecutionStats) # LastUpdate 最新のアカウント設定の更新を含む設定オブジェクト。設定が事前に更新されている場合にのみ表示されます。 ## 内容 ** Status ** 最終更新のステータス。`PENDING`、`FAILED`、`SUCCEEDED` のいずれかになります。型: 文字列有効な値：`PENDING | FAILED | SUCCEEDED` 必須：いいえ ** StatusMessage ** 前回のアカウント設定更新のステータスを説明するエラーメッセージ。エラーが発生した場合にのみ表示されます。タイプ: 文字列必須: いいえ ** TargetQueryTCU ** 前回のアカウント設定更新でリクエストされた Timestream コンピューティングユニット (TCU) の数。タイプ: 整数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/LastUpdate) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/LastUpdate) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/LastUpdate) # MixedMeasureMapping MixedMeasureMappings は、派生テーブルにデータを細長いメジャーと複数メジャーの混合として取り込むために使用できるマッピングです。 ## 内容 ** MeasureValueType ** sourceColumn から読み取られる値のタイプ。マッピングが MULTI の場合は、MeasureValueType.MULTI を使用します。型: 文字列有効な値：`BIGINT | BOOLEAN | DOUBLE | VARCHAR | MULTI` 必須: はい ** MeasureName ** 結果行の measure\$1name の値を参照します。このフィールドは、MeasureNameColumn が指定されている場合に必須です。タイプ: 文字列必須: いいえ ** MultiMeasureAttributeMappings ** measureValueType が MULTI である場合に必須です。MULTI 値メジャーの属性マッピング。型: [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。必須: いいえ ** SourceColumn ** このフィールドは、結果をマテリアライズするためにメジャー値を読み取るソース列を参照します。タイプ: 文字列必須: いいえ ** TargetMeasureName ** 使用するターゲットメジャー名。指定しない場合で、デフォルトのターゲットメジャー名が指定されている場合は measure-name になります。それ以外の場合は、sourceColumn になります。タイプ: 文字列必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MixedMeasureMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MixedMeasureMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MixedMeasureMapping) # MultiMeasureAttributeMapping MULTI 値メジャーの属性マッピング。 ## 内容 ** MeasureValueType ** ソース列から読み取られる属性のタイプ。型: 文字列有効な値：`BIGINT | BOOLEAN | DOUBLE | VARCHAR | TIMESTAMP` 必須: はい ** SourceColumn ** 属性値が読み取られるソース列。タイプ: 文字列必須: はい ** TargetMultiMeasureAttributeName ** 派生テーブルの属性名に使用するカスタム名。指定しない場合は、ソース列名が使用されます。タイプ: 文字列必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureAttributeMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureAttributeMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureAttributeMapping) # MultiMeasureMappings MixedMeasureMappings または MultiMeasureMappings のどちらか 1 つのみを指定します。MultiMeasureMappings は、派生テーブルにデータを複数メジャーとして取り込むために使用できます。 ## 内容 ** MultiMeasureAttributeMappings ** 必須。クエリ結果をマッピングして複数メジャー属性のデータを取り込むために使用される属性マッピング。型: [MultiMeasureAttributeMapping](API_query_MultiMeasureAttributeMapping.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。必須: はい ** TargetMultiMeasureName ** 派生テーブル内のターゲット複数メジャー名の名前。この入力は、measureNameColumn が指定されていない場合に必須です。MeasureNameColumn が指定されている場合、その列の値が複数メジャー名として使用されます。タイプ: 文字列必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/MultiMeasureMappings) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/MultiMeasureMappings) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/MultiMeasureMappings) # NotificationConfiguration スケジュールされたクエリの通知構成。Timestream は、スケジュールされたクエリが作成されたとき、状態が更新されたとき、または削除されたときに通知を送信します。 ## 内容 ** SnsConfiguration ** Amazon Simple Notification Service (SNS) の設定に関する詳細。このフィールドは、アカウント設定の更新時に SNS トピックが指定されている場合にのみ表示されます。型: [SnsConfiguration](API_query_SnsConfiguration.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/NotificationConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/NotificationConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/NotificationConfiguration) # ParameterMapping 名前付きパラメータのマッピング。 ## 内容 ** Name ** パラメータ名。タイプ: 文字列必須: はい ** Type ** クエリ結果セット内の列のデータ型が含まれます。データ型はスカラーでも複雑でもかまいません。サポートされているスカラーデータ型は、整数、ブール値、文字列、倍精度浮動小数点数、タイムスタンプ、日付、時刻、間隔です。サポートされている複雑なデータ型は、配列、行、時系列です。型: [Type](API_query_Type.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ParameterMapping) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ParameterMapping) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ParameterMapping) # ProvisionedCapacityRequest データのクエリ用にプロビジョニングされた容量設定の更新リクエスト。 ## 内容 ** TargetQueryTCU ** Timestream コンピューティングユニット (TCU) で指定される、データのクエリのターゲットコンピューティング容量。タイプ: 整数必須: はい ** NotificationConfiguration ** プロビジョニングされた容量の更新に関連する通知の設定。型: [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityRequest) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityRequest) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityRequest) # ProvisionedCapacityResponse データのクエリ用にプロビジョニングされた容量設定の更新リクエストへのレスポンス。 ## 内容 ** ActiveQueryTCU ** アカウントでプロビジョニングされた Timestream コンピューティングユニット (TCU) の数。このフィールドは、コンピューティングモードが `PROVISIONED` の場合にのみ表示されます。タイプ: 整数必須: いいえ ** LastUpdate ** プロビジョニングされた容量設定の最終更新に関する情報。型: [LastUpdate](API_query_LastUpdate.md) オブジェクト必須: いいえ ** NotificationConfiguration ** プロビジョニングされた容量設定が変更されるたびに送信される通知の設定を含むオブジェクト。このフィールドは、コンピューティングモードが `PROVISIONED` の場合にのみ表示されます。型: [AccountSettingsNotificationConfiguration](API_query_AccountSettingsNotificationConfiguration.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ProvisionedCapacityResponse) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ProvisionedCapacityResponse) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ProvisionedCapacityResponse) # QueryComputeRequest データクエリのコンピューティング容量設定の取得または更新リクエスト。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。 ## 内容 ** ComputeMode ** アカウント内での Timestream コンピューティングユニット (TCU) の割り当てと使用のモード。アジアパシフィック (ムンバイ) リージョンでは、API オペレーションで値 `PROVISIONED` のみが認識されることに注意してください。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。型: 文字列有効な値：`ON_DEMAND | PROVISIONED` 必須：いいえ ** ProvisionedCapacity ** アカウントのプロビジョンド Timestream コンピューティングユニット (TCU) の設定を含む設定オブジェクト。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。型: [ProvisionedCapacityRequest](API_query_ProvisionedCapacityRequest.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeRequest) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeRequest) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeRequest) # QueryComputeResponse データクエリのコンピューティング容量設定の取得または更新リクエストへのレスポンス。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。 ## 内容 ** ComputeMode ** アカウント内での Timestream コンピューティングユニット (TCU) の割り当てと使用のモード。アジアパシフィック (ムンバイ) リージョンでは、API オペレーションで値 `PROVISIONED` のみが認識されることに注意してください。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。型: 文字列有効な値：`ON_DEMAND | PROVISIONED` 必須：いいえ ** ProvisionedCapacity ** アカウントのプロビジョンド Timestream コンピューティングユニット (TCU) の設定を含む設定オブジェクト。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。型: [ProvisionedCapacityResponse](API_query_ProvisionedCapacityResponse.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryComputeResponse) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryComputeResponse) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryComputeResponse) # QueryInsights `QueryInsights` は、クエリの最適化、コストの削減、パフォーマンスの向上に役立つパフォーマンスチューニング機能です。`QueryInsights` を使用することで、クエリのプルーニング効率を評価し、クエリのパフォーマンスを向上させるために改善すべき領域を特定できます。また、`QueryInsights` を使用して、時間的および空間的なプルーニングの観点からクエリの有効性を分析し、パフォーマンス向上の機会を特定することもできます。具体的には、データ取得を最適化するため、クエリで時間ベースおよびパーティションキーベースのインデックス作成戦略がどの程度有効に使用されているかを評価できます。クエリのパフォーマンスを最適化するには、クエリの実行を管理する時間パラメータと空間パラメータの両方のファインチューニングが重要です。 `QueryInsights` で提供される主要なメトリクスは `QuerySpatialCoverage` と `QueryTemporalRange` です。`QuerySpatialCoverage` はクエリがスキャンする空間軸の量を示し、値が低いほど効率的です。`QueryTemporalRange` はスキャンされた時間範囲を示し、範囲が狭いほど高パフォーマンスです。 **QueryInsights の利点** `QueryInsights` を使用する主な利点は次のとおりです。 + **非効率的なクエリの特定** – `QueryInsights` は、クエリによってアクセスされるテーブルの時間ベースおよび属性ベースのプルーニングに関する情報を提供します。この情報は、アクセスが最適化されてないテーブルの特定に役立ちます。 + **データモデルとパーティショニングの最適化** – `QueryInsights` の情報を使用して、データモデルとパーティショニング戦略にアクセスし、ファインチューニングできます。 + **クエリのチューニング** – `QueryInsights` は、インデックスをより効果的に使用するための機会をハイライトします。 **注記** `QueryInsights` が有効な状態で実行できる `Query` API リクエストの最大数は、1 クエリ/秒 (QPS) です。このクエリレートを超えると、スロットリングが発生する可能性があります。 ## 内容 ** Mode ** `QueryInsights` を有効にする次のモードを提供します。 + `ENABLED_WITH_RATE_CONTROL` – 処理中のクエリに対して `QueryInsights` を有効にします。このモードには、`QueryInsights` 機能を 1 クエリ/秒 (QPS) に制限するレート制御メカニズムも含まれています。 + `DISABLED` – `QueryInsights` を無効にします。型: 文字列有効な値：`ENABLED_WITH_RATE_CONTROL | DISABLED` 必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsights) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsights) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsights) # QueryInsightsResponse 実行したクエリに関連するさまざまなインサイトとメトリクスを提供します。 ## 内容 ** OutputBytes ** クエリの結果セットのサイズをバイト単位で示します。このデータを使用して、結果セットがクエリの調整作業の一環として変更されたかどうかを検証できます。型: 長整数必須: いいえ ** OutputRows ** クエリの結果セットの一部として返される行の合計数を示します。このデータを使用して、結果セットの行数がクエリの調整作業の一環として変更されたかどうかを検証できます。型: 長整数必須: いいえ ** QuerySpatialCoverage ** 最適でない (最大) 空間プルーニングを持つテーブルなど、クエリの空間カバレッジに関するインサイトを提供します。この情報は、空間プルーニングを強化するために、パーティション化戦略の改善が必要な領域を特定するのに役立ちます。型: [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) オブジェクト必須: いいえ ** QueryTableCount ** クエリ内のテーブルの数を示します。型: 長整数必須: いいえ ** QueryTemporalRange ** 最長 (最大) の時間範囲のテーブルなど、クエリの時間範囲に関するインサイトを提供します。以下は、時間ベースのプルーニングを最適化するために考えられる選択肢の一部です。 + 不足している時間の述語を追加する。 + 時間の述語に関する関数を削除する。 + すべてのサブクエリに時間の述語を追加する。型: [QueryTemporalRange](API_query_QueryTemporalRange.md) オブジェクト必須: いいえ ** UnloadPartitionCount ** `Unload` オペレーションによって作成されたパーティションを示します。型: 長整数必須: いいえ ** UnloadWrittenBytes ** `Unload` オペレーションによって書き込まれたバイト単位のサイズを示します。型: 長整数必須: いいえ ** UnloadWrittenRows ** `Unload` クエリによって書き込まれた行を示します。型: 長整数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryInsightsResponse) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryInsightsResponse) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryInsightsResponse) # QuerySpatialCoverage 最適でない (最大) 空間プルーニングを持つテーブルなど、クエリの空間カバレッジに関するインサイトを提供します。この情報は、空間プルーニングを強化するために、パーティション化戦略の改善が必要な領域を特定するのに役立ちます。例えば、`QuerySpatialCoverage` の情報を使用して以下を行えます。 + measure\$1name を追加するか、[ユーザー定義のパーティションキー](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html) (CDPK) の述語を使用する。 + 上記のアクションを既に行っている場合は、それらに関する関数や句 (`LIKE` など) を削除する。 ## 内容 ** Max ** 最も非効率的な空間プルーニングを使用して実行されたクエリとテーブルの空間カバレッジに関するインサイトを提供します。 + `Value` – 空間カバレッジの最大比率。 + `TableArn` – 空間プルーニングが最適でないテーブルの Amazon リソースネーム (ARN)。 + `PartitionKey` – パーティション化に使用されるパーティションキー。デフォルトの `measure_name` または CDPK です。型: [QuerySpatialCoverageMax](API_query_QuerySpatialCoverageMax.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverage) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverage) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverage) # QuerySpatialCoverageMax クエリによってスキャンされた最適でない空間範囲のあるテーブルに関するインサイトを提供します。 ## 内容 ** PartitionKey ** パーティション化に使用されるパーティションキー。デフォルトの `measure_name` または[ユーザー定義のパーティションキー](https://docs.aws.amazon.com/timestream/latest/developerguide/customer-defined-partition-keys.html)です。型: 文字列の配列必須: いいえ ** TableArn ** 空間プルーニングが最適でないテーブルの Amazon リソースネーム (ARN)。型: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** Value ** 空間カバレッジの最大比率。型: 倍精度浮動小数点数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QuerySpatialCoverageMax) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QuerySpatialCoverageMax) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QuerySpatialCoverageMax) # QueryStatus 進行状況やスキャンされたバイト数など、クエリのステータスに関する情報。 ## 内容 ** CumulativeBytesMetered ** クエリによってスキャンされた請求されるデータ量 (バイト単位)。これは累積合計であり、クエリが開始されてから請求されるデータの合計量を表します。請求が適用されるのは 1 回のみで、そのタイミングはクエリの実行が完了したとき、またはクエリがキャンセルされたときです。型: 長整数必須: いいえ ** CumulativeBytesScanned ** クエリによってスキャンされたデータ量 (バイト単位)。これは累積合計であり、クエリが開始されてからスキャンされた合計バイト数を表します。型: 長整数必須: いいえ ** ProgressPercentage ** クエリの進行状況。パーセンテージで表されます。型: 倍精度浮動小数点数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryStatus) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryStatus) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryStatus) # QueryTemporalRange 最長 (最大) の時間範囲のテーブルなど、クエリの時間範囲に関するインサイトを提供します。 ## 内容 ** Max ** 時間軸でパフォーマンスが最適でないテーブルに関するインサイトを提供する次のプロパティをカプセル化します。 + `Value` – クエリの開始から終了までのナノ秒単位の最大時間。 + `TableArn` – 最大時間範囲でクエリされるテーブルの Amazon リソースネーム (ARN)。型: [QueryTemporalRangeMax](API_query_QueryTemporalRangeMax.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRange) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRange) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRange) # QueryTemporalRangeMax クエリによってスキャンされた時間プルーニングが最適でないテーブルに関するインサイトを提供します。 ## 内容 ** TableArn ** 最大時間範囲でクエリされるテーブルの Amazon リソースネーム (ARN)。型: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** Value ** クエリの開始から終了までのナノ秒単位の最大時間。型: 長整数必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/QueryTemporalRangeMax) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/QueryTemporalRangeMax) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/QueryTemporalRangeMax) # Row クエリ結果の単一の行を表します。 ## 内容 ** Data ** 結果セットの単一の行にあるデータポイントのリスト。型: [Datum](API_query_Datum.md) オブジェクトの配列必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Row) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Row) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Row) # S3Configuration クエリの実行に起因するエラーレポートの S3 ロケーションの詳細。 ## 内容 ** BucketName ** エラーレポートが作成される S3 バケットの名前。タイプ: 文字列長さの制約: 最小長は 3 です。最大長は 63 です。パターン: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必須: はい ** EncryptionOption ** エラーレポートの保管時の暗号化オプション。暗号化オプションが指定されていない場合、Timestream はデフォルトとして SSE\$1S3 を選択します。型: 文字列有効な値：`SSE_S3 | SSE_KMS` 必須：いいえ ** ObjectKeyPrefix ** エラーレポートキーのプレフィックス。Timestream は、デフォルトで、エラーレポートのパスに次のプレフィックスを追加します。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 896 です。パターン: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3Configuration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3Configuration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3Configuration) # S3ReportLocation スケジュールされたクエリ実行の S3 レポートの場所。 ## 内容 ** BucketName ** S3 バケット名です。型: 文字列長さの制約: 最小長は 3 です。最大長は 63 です。パターン: `[a-z0-9][\.\-a-z0-9]{1,61}[a-z0-9]` 必須: いいえ ** ObjectKey ** S3 キー。型: 文字列必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/S3ReportLocation) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/S3ReportLocation) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/S3ReportLocation) # ScheduleConfiguration クエリのスケジュールの構成。 ## 内容 ** ScheduleExpression ** スケジュールされたクエリの実行をトリガーするタイミングを示す式。これは Cron 式でも間隔の式でも構いません。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 256 です。必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduleConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduleConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduleConfiguration) # ScheduledQuery スケジュールされたクエリ ## 内容 ** Arn ** Amazon リソースネーム。型: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ** Name ** スケジュールされたクエリの名前。型: 文字列長さの制約: 最小長は 1 です。最大長 64 パターン: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必須: はい ** State ** スケジュールされたクエリの状態。型: 文字列有効な値: `ENABLED | DISABLED` 必須: はい ** CreationTime ** スケジュールされたクエリの作成時刻。型: タイムスタンプ必須: いいえ ** ErrorReportConfiguration ** スケジュールされたクエリのエラーレポートの構成。型: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) オブジェクト必須: いいえ ** LastRunStatus ** 前回のスケジュールされたクエリ実行のステータス。型: 文字列有効な値：`AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE` 必須: いいえ ** NextInvocationTime ** スケジュールされたクエリが次に実行される時刻。型: タイムスタンプ必須: いいえ ** PreviousInvocationTime ** スケジュールされたクエリが最後に実行された時刻。型: タイムスタンプ必須: いいえ ** TargetDestination ** スケジュールされたクエリの最終的な結果が書き込まれるターゲットデータソース。型: [TargetDestination](API_query_TargetDestination.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQuery) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQuery) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQuery) # ScheduledQueryDescription スケジュールされたクエリを記述する構造。 ## 内容 ** Arn ** スケジュールされたクエリの ARN。型: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ** Name ** スケジュールされたクエリの名前。型: 文字列長さの制約: 最小長は 1 です。最大長 64 パターン: `[a-zA-Z0-9|!\-_*']([a-zA-Z0-9]|[!\-_*'\/.])+` 必須: はい ** NotificationConfiguration ** 通知設定。型: [NotificationConfiguration](API_query_NotificationConfiguration.md) オブジェクト必須: はい ** QueryString ** 実行するクエリ。型: 文字列長さの制約: 最小長は 1 です。最大長は 262,144 です。必須: はい ** ScheduleConfiguration ** スケジュールの構成。型: [ScheduleConfiguration](API_query_ScheduleConfiguration.md) オブジェクト必須: はい ** State ** スケジュールされたクエリの状態。型: 文字列有効な値: `ENABLED | DISABLED` 必須: はい ** CreationTime ** スケジュールされたクエリの作成時刻。型: タイムスタンプ必須: いいえ ** ErrorReportConfiguration ** スケジュールされたクエリのエラーレポートの構成。型: [ErrorReportConfiguration](API_query_ErrorReportConfiguration.md) オブジェクト必須: いいえ ** KmsKeyId ** スケジュールされたクエリリソースの暗号化に使用される、ユーザーが指定した KMS キー。型: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** LastRunSummary ** 前回スケジュールされたクエリ実行のランタイムの概要。型: [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) オブジェクト必須: いいえ ** NextInvocationTime ** スケジュールされたクエリの次回の実行が予定されている時刻。型: タイムスタンプ必須: いいえ ** PreviousInvocationTime ** クエリの前回の実行時刻。型: タイムスタンプ必須: いいえ ** RecentlyFailedRuns ** スケジュールされたクエリ実行の過去 5 回の失敗に関するランタイムの概要。型: [ScheduledQueryRunSummary](API_query_ScheduledQueryRunSummary.md) オブジェクトの配列必須: いいえ ** ScheduledQueryExecutionRoleArn ** Timestream がスケジュールクエリの実行に使用する IAM ロール。型: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: いいえ ** TargetConfiguration ** スケジュールされたクエリターゲットストア構成。型: [TargetConfiguration](API_query_TargetConfiguration.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryDescription) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryDescription) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryDescription) # ScheduledQueryInsights `ExecuteScheduledQueryRequest` で `QueryInsights` を有効にするための設定をカプセル化します。 ## 内容 ** Mode ** `ScheduledQueryInsights` を有効にする次のモードを提供します。 + `ENABLED_WITH_RATE_CONTROL` – 処理中のクエリに対して `ScheduledQueryInsights` を有効にします。このモードには、`QueryInsights` 機能を 1 クエリ/秒 (QPS) に制限するレート制御メカニズムも含まれています。 + `DISABLED` – `ScheduledQueryInsights` を無効にします。型: 文字列有効な値: `ENABLED_WITH_RATE_CONTROL | DISABLED` 必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsights) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsights) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsights) # ScheduledQueryInsightsResponse 実行された `ExecuteScheduledQueryRequest` に関連するさまざまなインサイトとメトリクスを提供します。 ## 内容 ** OutputBytes ** クエリの結果セットのサイズをバイト単位で示します。このデータを使用して、結果セットがクエリの調整作業の一環として変更されたかどうかを検証できます。型: 長整数必須: いいえ ** OutputRows ** クエリの結果セットの一部として返される行の合計数を示します。このデータを使用して、結果セットの行数がクエリの調整作業の一環として変更されたかどうかを検証できます。型: 長整数必須: いいえ ** QuerySpatialCoverage ** 最適でない (最大) 空間プルーニングを持つテーブルなど、クエリの空間カバレッジに関するインサイトを提供します。この情報は、空間プルーニングを強化するために、パーティション化戦略の改善が必要な領域を特定するのに役立ちます。型: [QuerySpatialCoverage](API_query_QuerySpatialCoverage.md) オブジェクト必須: いいえ ** QueryTableCount ** クエリ内のテーブルの数を示します。型: 長整数必須: いいえ ** QueryTemporalRange ** 最長 (最大) の時間範囲のテーブルなど、クエリの時間範囲に関するインサイトを提供します。以下は、時間ベースのプルーニングを最適化するために考えられる選択肢の一部です。 + 不足している時間の述語を追加する。 + 時間の述語に関する関数を削除する。 + すべてのサブクエリに時間の述語を追加する。型: [QueryTemporalRange](API_query_QueryTemporalRange.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryInsightsResponse) # ScheduledQueryRunSummary スケジュールされたクエリの実行の概要 ## 内容 ** ErrorReportLocation ** エラーレポートの S3 ロケーション。型: [ErrorReportLocation](API_query_ErrorReportLocation.md) オブジェクト必須: いいえ ** ExecutionStats ** スケジュールされた実行のランタイム統計。型: [ExecutionStats](API_query_ExecutionStats.md) オブジェクト必須: いいえ ** FailureReason ** 失敗した場合のスケジュールされたクエリのエラーメッセージ。場合によっては、より詳細なエラーの理由を取得するために、エラーレポートを参照する必要があります。型: 文字列必須: いいえ ** InvocationTime ** この実行の InvocationTime。クエリの実行がスケジュールされている時刻のことです。値を取得するために、クエリでパラメータ `@scheduled_runtime` を使用できます。型: タイムスタンプ必須: いいえ ** QueryInsightsResponse ** スケジュールされたクエリの実行概要に関連するさまざまなインサイトとメトリクスを提供します。型: [ScheduledQueryInsightsResponse](API_query_ScheduledQueryInsightsResponse.md) オブジェクト必須: いいえ ** RunStatus ** スケジュールされたクエリ実行のステータス。型: 文字列有効な値：`AUTO_TRIGGER_SUCCESS | AUTO_TRIGGER_FAILURE | MANUAL_TRIGGER_SUCCESS | MANUAL_TRIGGER_FAILURE` 必須: いいえ ** TriggerTime ** クエリが実行された実際の時刻。型: タイムスタンプ必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ScheduledQueryRunSummary) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ScheduledQueryRunSummary) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ScheduledQueryRunSummary) # SelectColumn クエリによって返される列の詳細。 ## 内容 ** Aliased ** 列名がクエリによってエイリアスされている場合は true です。それ以外の場合は、false を返します。型: ブール値必須: いいえ ** DatabaseName ** この列を持つデータベース。型: 文字列必須: いいえ ** Name ** 列の名前。型: 文字列必須: いいえ ** TableName ** この列を持つデータベース内のテーブル。型: 文字列必須: いいえ ** Type ** クエリ結果セット内の列のデータ型が含まれます。データ型はスカラーでも複雑でもかまいません。サポートされているスカラーデータ型は、整数、ブール値、文字列、倍精度浮動小数点数、タイムスタンプ、日付、時刻、間隔です。サポートされている複雑なデータ型は、配列、行、時系列です。型: [Type](API_query_Type.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SelectColumn) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SelectColumn) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SelectColumn) # SnsConfiguration 通知の送信に必要な SNS の詳細。 ## 内容 ** TopicArn ** スケジュールされたクエリのステータス通知が送信される SNS トピック ARN。タイプ: 文字列長さの制約: 最小長は 1 です。最大長は 2,048 です。必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/SnsConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/SnsConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/SnsConfiguration) # Tag タグは、Timestream データベースやテーブルに割り当てるラベルのことです。各タグはキーとオプションの値で構成され、どちらもお客様が定義します。タグを使用すると、データベースやテーブルを目的、所有者、環境などで分類できます。 ## 内容 ** Key ** タグのキー。タグキーでは、大文字と小文字が区別されます。型: 文字列長さの制限: 最小長は 1 です。最大長は 128 です。必須: はい ** Value ** タグの値。タグ値は大文字と小文字が区別され、null にすることができます。型: 文字列長さの制約: 最小長は 0 です。最大長は 256 です。必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Tag) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Tag) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Tag) # TargetConfiguration クエリの出力を書き込むために使用される構成。 ## 内容 ** TimestreamConfiguration ** Timestream データベースとテーブルにデータを書き込むために必要な構成。型: [TimestreamConfiguration](API_query_TimestreamConfiguration.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetConfiguration) # TargetDestination ターゲットデータソースのデータを書き込む送信先の詳細。現在サポートされているデータソースは Timestream です。 ## 内容 ** TimestreamDestination ** Timestream データソースのクエリ結果送信先の詳細。型: [TimestreamDestination](API_query_TimestreamDestination.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TargetDestination) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TargetDestination) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TargetDestination) # TimeSeriesDataPoint 時系列データ型は、時間の経過に伴うメジャー値を表します。時系列は、タイムスタンプとメジャー値の行の配列で、行は昇順にソートされます。TimeSeriesDataPoint は、時系列内の単一のデータポイントです。時系列の (時間、メジャー値) のタプルを表しています。 ## 内容 ** Time ** メジャー値が収集されたときのタイムスタンプ。型: 文字列必須: はい ** Value ** データポイントのメジャー値。型: [Datum](API_query_Datum.md) オブジェクト必須: はい ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimeSeriesDataPoint) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimeSeriesDataPoint) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimeSeriesDataPoint) # TimestreamConfiguration Timestream データベースとテーブルにデータを書き込むための構成。この構成により、ユーザーはクエリ結果の選択した列を送信先テーブルの列にマッピングできます。 ## 内容 ** DatabaseName ** クエリ結果が書き込まれる Timestream データベースの名前。タイプ: 文字列必須: はい ** DimensionMappings ** これにより、クエリ結果の列を宛先テーブルのディメンションにマッピングできます。型: [DimensionMapping](API_query_DimensionMapping.md) オブジェクトの配列必須: はい ** TableName ** クエリ結果が書き込まれる Timestream テーブルの名前。テーブルは、Timestream の構成で指定されるのと同じデータベース内にある必要があります。タイプ: 文字列必須: はい ** TimeColumn ** 宛先テーブルの時間列として使用する必要があるクエリ結果の列。この列タイプは TIMESTAMP である必要があります。タイプ: 文字列必須: はい ** MeasureNameColumn ** メジャー列の名前。タイプ: 文字列必須: いいえ ** MixedMeasureMappings ** メジャーを複数メジャーレコードにマッピングする方法を指定します。型: [MixedMeasureMapping](API_query_MixedMeasureMapping.md) オブジェクトの配列配列メンバー: 最小数は 1 項目です。必須: いいえ ** MultiMeasureMappings ** 複数メジャーマッピング。型: [MultiMeasureMappings](API_query_MultiMeasureMappings.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamConfiguration) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamConfiguration) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamConfiguration) # TimestreamDestination スケジュールされたクエリの送信先。 ## 内容 ** DatabaseName ** Timestream データベース名。型: 文字列必須: いいえ ** TableName ** Timestream テーブル名。型: 文字列必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TimestreamDestination) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TimestreamDestination) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TimestreamDestination) # Type クエリ結果セット内の列のデータ型が含まれます。データ型はスカラーでも複雑でもかまいません。サポートされているスカラーデータ型は、整数、ブール値、文字列、倍精度浮動小数点数、タイムスタンプ、日付、時刻、間隔です。サポートされている複雑なデータ型は、配列、行、時系列です。 ## 内容 ** ArrayColumnInfo ** 列が配列であるかどうかを示します。型: [ColumnInfo](API_query_ColumnInfo.md) オブジェクト必須: いいえ ** RowColumnInfo ** 列が行かどうかを示します。型: [ColumnInfo](API_query_ColumnInfo.md) オブジェクトの配列必須: いいえ ** ScalarType ** 列の型が文字列、整数、ブール値、倍精度浮動小数点数、タイムスタンプ、日付、時刻であるかどうかを示します。詳しくは「[サポートされているデータ型](https://docs.aws.amazon.com/timestream/latest/developerguide/supported-data-types.html)」を参照してください。型: 文字列有効な値：`VARCHAR | BOOLEAN | BIGINT | DOUBLE | TIMESTAMP | DATE | TIME | INTERVAL_DAY_TO_SECOND | INTERVAL_YEAR_TO_MONTH | UNKNOWN | INTEGER` 必須: いいえ ** TimeSeriesMeasureValueColumnInfo ** 列が時系列データ型であるかどうかを示します。型: [ColumnInfo](API_query_ColumnInfo.md) オブジェクト必須: いいえ ## 以下の資料も参照してください。言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。 + [AWS SDK for C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Type) + [AWS SDK for Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Type) + [AWS SDK for Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/Type) # 共通エラーこのセクションでは、AWS のすべてのサービスの API アクションに共通のエラーを一覧表示しています。このサービスの API アクションに固有のエラーについては、その API アクションのトピックを参照してください。 **AccessDeniedException** このアクションを実行する十分なアクセス権限がありません。 HTTP ステータスコード: 400 **IncompleteSignature** リクエストの署名が AWS 基準に適合しません。 HTTP ステータスコード: 400 **InternalFailure** リクエストの処理が、不明なエラー、例外、または障害により実行できませんでした。 HTTP ステータスコード: 500 **InvalidAction** リクエストされたアクション、またはオペレーションは無効です。アクションが正しく入力されていることを確認してください。 HTTP ステータスコード: 400 **InvalidClientTokenId** 指定された X.509 証明書または AWS アクセスキー ID がレコード内に見つかりません。 HTTP ステータスコード: 403 **NotAuthorized** このアクションを実行するためのアクセス許可がありません。 HTTP ステータスコード: 400 **OptInRequired** サービスを利用するためには、AWS アクセスキー ID を取得する必要があります。 HTTP ステータスコード: 403 **RequestExpired** リクエストの日付スタンプの 15 分以上後またはリクエストの有効期限 (署名付き URL の場合など) の 15 分以上後に、リクエストが到着しました。または、リクエストの日付スタンプが現在より 15 分以上先です。 HTTP ステータスコード: 400 **ServiceUnavailable** サーバーの一時的な障害により、リクエストは失敗しました。 HTTP ステータスコード: 503 **ThrottlingException** リクエストのスロットリングにより、リクエストが拒否されました。 HTTP ステータスコード: 400 **ValidationError** 入力が、AWS サービスで指定された制約を満たしていません。 HTTP ステータスコード: 400 # 共通パラメータ次のリストには、すべてのアクションが署名バージョン 4 リクエストにクエリ文字列で署名するために使用するパラメータを示します。アクション固有のパラメータは、アクションのトピックに示されています。Signature Version 4 の詳細については、「IAM ユーザーガイド」の「[AWS API リクエストの署名](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-signing.html)」を参照してください。 **Action** 実行するアクション。型: 文字列必須: はい **Version** リクエストが想定している API バージョンである、YYYY-MM-DD 形式で表示されます。型: 文字列必須: はい **X-Amz-Algorithm** リクエストの署名を作成するのに使用したハッシュアルゴリズム。条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。型: 文字列有効な値：`AWS4-HMAC-SHA256` 必須: 条件による **X-Amz-Credential** 認証情報スコープの値で、アクセスキー、日付、対象とするリージョン、リクエストしているサービス、および終了文字列 ("aws4\$1request") を含む文字列です。値は次の形式で表現されます。*access\$1key*/*YYYYYYYYMMDD*/*region*/*service*/aws4\$1request 詳細については、「IAM ユーザーガイド」の「[署名付きAWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。型: 文字列必須: 条件による **X-Amz-Date** 署名を作成するときに使用する日付です。形式は ISO 8601 基本形式の YYYYMMDD'T'HHMMSS'Z' でなければなりません。例えば、日付 `20120325T120000Z` は、有効な X-Amz-Date の値です。条件: X-Amz-Date はすべてのリクエストに対してオプションです。署名リクエストで使用する日付よりも優先される日付として使用できます。ISO 8601 ベーシック形式で日付ヘッダーが指定されている場合、X-Amz-Date は必要ありません。X-Amz-Date を使用すると、常に Date ヘッダーの値よりも優先されます。詳細については、「IAM ユーザーガイド」の「[AWS API リクエスト署名の要素](https://docs.aws.amazon.com/IAM/latest/UserGuide/signing-elements.html)」を参照してください。タイプ: 文字列必須: 条件による **X-Amz-Security-Token** AWS Security Token Service (AWS STS) へのを呼び出しで取得された一時的なセキュリティトークン。AWS STS の一時的なセキュリティ認証情報をサポートするサービスのリストについては、「IAM ユーザーガイド」の「[IAM と連携するAWS のサービス](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html)」を参照してください。条件:AWS STS の一時的なセキュリティ認証情報を使用する場合、セキュリティトークンを含める必要があります。タイプ: 文字列必須: 条件による **X-Amz-Signature** 署名する文字列と派生署名キーから計算された 16 進符号化署名を指定します。条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。型: 文字列必須: 条件による **X-Amz-SignedHeaders** 正規リクエストの一部として含まれていたすべての HTTP ヘッダーを指定します。署名付きヘッダーの指定に関する詳細については、「IAM ユーザーガイド」の「[署名付き AWS API リクエストの作成](https://docs.aws.amazon.com/IAM/latest/UserGuide/create-signed-request.html)」を参照してください。条件: HTTP 認可ヘッダーではなくクエリ文字列に認証情報を含める場合は、このパラメータを指定します。型: 文字列必須: 条件による