Amazon Timestream for LiveAnalytics に類似した機能をご希望の場合は Amazon Timestream for InfluxDB をご検討ください。リアルタイム分析に適した、シンプルなデータインジェストと 1 桁ミリ秒のクエリ応答時間を特徴としています。詳細については、こちらを参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
UpdateAccountSettings
クエリ料金に TCU を使用するようにアカウントを移行し、設定した最大クエリコンピューティングユニット数を変更します。MaxQueryTCU の値を希望の設定まで減らした場合、新しい値が有効になるまでに最大 24 時間かかります。
注記
クエリ料金に TCU を使用するようにアカウントを移行した後は、クエリ料金にスキャン済みバイト数を使用するように移行できません。
リクエストの構文
{
"MaxQueryTCU": number,
"QueryCompute": {
"ComputeMode": "string",
"ProvisionedCapacity": {
"NotificationConfiguration": {
"RoleArn": "string",
"SnsConfiguration": {
"TopicArn": "string"
}
},
"TargetQueryTCU": number
}
},
"QueryPricingModel": "string"
}
リクエストパラメータ
すべてのアクションに共通のパラメータの詳細については、「共通パラメータ」を参照してください。
リクエストは以下のデータを JSON 形式で受け入れます。
- MaxQueryTCU
-
サービスがクエリを処理するために任意の時点で使用するコンピューティングユニットの最大数。クエリを実行するには、最小数を 4 TCU に設定する必要があります。TCU の最大数は、4 の倍数 (4、8、16、32 など) に設定できます。
MaxQueryTCUに対してサポートされる最大値は 1000 です。このソフト制限の増加をリクエストするには、AWS サポートにお問い合わせください。maxQueryTCU のデフォルトクォータの詳細については、「デフォルトのクォータ」を参照してください。この設定は、Timestream コンピューティングユニット (TCU) のオンデマンド使用にのみ適用されます。MaxQueryTCUに対してサポートされる最大値は 1000 です。このソフト制限の増加をリクエストするには、AWS サポートにお問い合わせください。maxQueryTCUのデフォルトクォータの詳細については、「デフォルトのクォータ」を参照してください。タイプ: 整数
必須: いいえ
- QueryCompute
-
アカウントのクエリコンピューティング設定を変更します。これには、アカウントのクエリ料金モデルやプロビジョンド Timestream コンピューティングユニット (TCU) 数が含まれます。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。
注記
この API はべき等です。つまり、同じリクエストを複数回行っても、1 回行う場合と効果は同じです。
型: QueryComputeRequest オブジェクト
必須: いいえ
- QueryPricingModel
-
アカウントにおけるクエリの料金モデル。
注記
QueryPricingModelパラメータは複数の Timestream オペレーションで使用されますが、UpdateAccountSettingsAPI オペレーションは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
-
サービスがクエリを処理するために任意の時点で使用するコンピューティングユニットの設定済みの最大数。
タイプ: 整数
- QueryCompute
-
アカウントのデータのクエリに関する更新されたアカウント設定を確認します。QueryCompute は、アジアパシフィック (ムンバイ) リージョンでのみ使用できます。
型: QueryComputeResponse オブジェクト
- QueryPricingModel
-
アカウントの料金モデル。
型: 文字列
有効な値:
BYTES_SCANNED | COMPUTE_UNITS
エラー
すべてのアクションに共通のエラーについては、「共通エラー」を参照してください。
- AccessDeniedException
-
アカウント設定にアクセスするために必要なアクセス許可がありません。
HTTP ステータスコード: 400
- InternalServerException
-
リクエストの処理中に内部サーバーエラーが発生しました。
HTTP ステータスコード: 400
- InvalidEndpointException
-
リクエストされたエンドポイントが無効です。
HTTP ステータスコード: 400
- ThrottlingException
-
リクエストが多すぎるため、リクエストがスロットリングされました。
HTTP ステータスコード: 400
- ValidationException
-
リクエストが無効であるか、形式が正しくありません。
HTTP ステータスコード: 400
以下の資料も参照してください。
言語固有の AWS SDK のいずれかでこの API を使用する方法の詳細については、以下を参照してください。