UpdateAccountSettings - Amazon Timestream

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 オペレーションで使用されますが、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

サービスがクエリを処理するために任意の時点で使用するコンピューティングユニットの設定済みの最大数。

タイプ: 整数

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 を使用する方法の詳細については、以下を参照してください。