Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、[こちら](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# 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)