如需與 Amazon Timestream for LiveAnalytics 類似的功能，請考慮使用 Amazon Timestream for InfluxDB。它提供簡化的資料擷取和單一位數毫秒查詢回應時間，以進行即時分析。[在這裡](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)進一步了解。本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # Amazon Timestream 查詢 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" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](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) ** 當指定的查詢`CancelQuery`請求`QueryId`已發出時，`CancellationMessage`會傳回。類型：字串 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CancelQuery) + [AWS 適用於 Ruby V3 的 SDK](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" } } } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) ** 使用 ClientToken 呼叫 CreateScheduledQuery 等冪，換句話說，重複提出相同的請求將產生相同的結果。提出多個相同的 CreateScheduledQuery 請求與提出單一請求具有相同的效果。 + 如果在沒有 `ClientToken` 的情況下呼叫 CreateScheduledQuery，則查詢 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。長度上限為 2048。必要：否 ** [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。長度上限為 262144。必要：是 ** [ScheduleConfiguration](#API_query_CreateScheduledQuery_RequestSyntax) ** 查詢的排程組態。類型：[ScheduleConfiguration](API_query_ScheduleConfiguration.md) 物件必要：是 ** [ScheduledQueryExecutionRoleArn](#API_query_CreateScheduledQuery_RequestSyntax) ** 執行排程查詢時，Timestream 將擔任之 IAM 角色的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [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。長度上限為 2048。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/CreateScheduledQuery) # DeleteScheduledQuery 刪除指定的排程查詢。這是不可復原的操作。 ## 請求語法 ``` { "ScheduledQueryArn": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ScheduledQueryArn](#API_query_DeleteScheduledQuery_RequestSyntax) ** 排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DeleteScheduledQuery) # DescribeAccountSettings 描述您帳戶的設定，其中包含查詢定價模型，以及服務可用於查詢工作負載的已設定最大 TCUs。您只需支付工作負載所使用的運算單位持續時間的費用。 ## 回應語法 ``` { "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) (TCUs) 數目上限。若要執行查詢，您必須將最小容量設定為 4 TCU。您可以在 4 的倍數中設定 TCU 數量上限，例如 4、8、16、32 等。此組態僅適用於 (TCUs的隨需用量。類型：整數 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) ** 包含查詢工作負載之帳戶中 Timestream Compute Units (TCUs) 用量設定的物件。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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeAccountSettings) # DescribeEndpoints DescribeEndpoints 會傳回可用的端點清單，以進行 Timestream API 呼叫。此 API 可透過寫入和查詢取得。由於 Timestream SDKs旨在透明地使用服務的架構，包括服務端點的管理和映射，*因此不建議您使用此 API，除非*： + 您使用 [VPC 端點 (AWS PrivateLink) 搭配 Timestream ](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) ** 發出`DescribeEndpoints`請求時，會傳回`Endpoints`物件。類型：[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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/DescribeEndpoints) # DescribeScheduledQuery 提供排程查詢的詳細資訊。 ## 請求語法 ``` { "ScheduledQueryArn": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ScheduledQueryArn](#API_query_DescribeScheduledQuery_RequestSyntax) ** 排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應語法 ``` { "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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](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" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 未使用。類型：字串長度限制：長度下限為 32。長度上限為 128。必要：否 ** [InvocationTime](#API_query_ExecuteScheduledQuery_RequestSyntax) ** UTC 的時間戳記。查詢將如同在此時間戳記叫用一樣執行。類型：Timestamp 必要：是 ** [QueryInsights](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 封裝啟用的設定`QueryInsights`。啟用會`QueryInsights`傳回洞見和指標，做為您執行之查詢的 Amazon SNS 通知的一部分。您可以使用 `QueryInsights`來調整查詢效能和成本。類型：[ScheduledQueryInsights](API_query_ScheduledQueryInsights.md) 物件必要：否 ** [ScheduledQueryArn](#API_query_ExecuteScheduledQuery_RequestSyntax) ** 排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應元素如果動作成功，則服務會傳回具空 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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Java V2 的開發套件](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ExecuteScheduledQuery) # ListScheduledQueries 取得發起人 Amazon 帳戶和區域中所有排程查詢的清單。 `ListScheduledQueries` 最終一致。 ## 請求語法 ``` { "MaxResults": number, "NextToken": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_query_ListScheduledQueries_RequestSyntax) ** 要在輸出中傳回的項目數量上限。如果可用的項目總數超過指定的值，`NextToken`則會在輸出中提供。若要繼續分頁，請提供 `NextToken`值做為後續呼叫的引數`ListScheduledQueriesRequest`。類型：整數有效範圍：最小值為 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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListScheduledQueries) # ListTagsForResource 列出 Timestream 查詢資源上的所有標籤。 ## 請求語法 ``` { "MaxResults": number, "NextToken": "string", "ResourceARN": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) ** 要傳回的標籤數目上限。類型：整數有效範圍：最小值為 1。最大值為 200。必要：否 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) ** 用於恢復分頁的分頁字符。類型：字串必要：否 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) ** 要列出標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ## 回應語法 ``` { "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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/ListTagsForResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/ListTagsForResource) # PrepareQuery 同步操作，可讓您提交查詢，其中包含由 Timestream 存放以供稍後執行的參數。Timestream 僅支援將 `ValidateOnly` 設定為的此操作`true`。 ## 請求語法 ``` { "QueryString": "string", "ValidateOnly": boolean } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [QueryString](#API_query_PrepareQuery_RequestSyntax) ** 您想要用作預備陳述式的 Timestream 查詢字串。參數名稱可以在後跟一個識別碼的查詢字串 `@` 字元中指定。類型：字串長度限制：長度下限為 1。長度上限為 262144。必要：是 ** [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。長度上限為 262144。 ## 錯誤如需所有動作常見錯誤的資訊，請參閱[常見錯誤](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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/PrepareQuery) + [AWS 適用於 Ruby V3 的 SDK](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 秒後逾時。您必須更新 SDK 中的預設逾時，以支援 60 秒的逾時。如需詳細資訊，請參閱[程式碼範例](https://docs.aws.amazon.com/timestream/latest/developerguide/code-samples.run-query.html)。在下列情況下，您的查詢請求將會失敗： + 如果您在 5 分鐘等冪時段之外使用相同的用戶端字符提交`Query`請求。 + 如果您使用相同的用戶端字符提交`Query`請求，但在 5 分鐘等冪時段內變更其他參數。 + 如果資料列的大小（包括查詢中繼資料）超過 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" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ClientToken](#API_query_Query_RequestSyntax) ** 提出`Query`請求時，最多指定 64 個 ASCII 字元的唯一區分大小寫字串。提供 `ClientToken`會呼叫`Query`*等*冪。這表示重複執行相同的查詢會產生相同的結果。換句話說，提出多個相同的`Query`請求與提出單一請求的效果相同。在查詢`ClientToken`中使用時，請注意下列事項： + 如果在沒有的情況下執行個體化查詢 API`ClientToken`，則查詢 SDK `ClientToken`會代表您產生。 + 如果`Query`調用僅包含 `ClientToken`但不包含 `NextToken`，則的調用`Query`會假設為新的查詢執行。 + 如果調用包含 `NextToken`，則會假設該特定調用是先前呼叫查詢 API 的後續調用，並傳回結果集。 + 4 小時後，任何具有相同的請求`ClientToken`都會視為新的請求。類型：字串長度限制：長度下限為 32。長度上限為 128。必要：否 ** [MaxRows](#API_query_Query_RequestSyntax) ** 要在`Query`輸出中傳回的資料列總數。`Query` 具有指定`MaxRows`值的初始執行會在兩種情況下傳回查詢的結果集： + 結果的大小小於 `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 時，請注意下列事項： + 分頁字符最多可用於五個`Query`叫用，或長達 1 小時，以先發生者為準。 + 使用相同的 `NextToken`會傳回相同的記錄集。若要繼續分頁結果集，您必須使用最新的 `nextToken`。 + 假設`Query`調用會傳回兩個`NextToken`值 `TokenA`和 `TokenB`。如果 `TokenB` 在後續`Query`調用中使用，則 `TokenA` 會失效且無法重複使用。 + 若要在分頁開始後從查詢請求先前的結果集，您必須重新叫用查詢 API。 + `NextToken` 應該使用最新的進行分頁，直到傳回`null`為止，此時`NextToken`應使用新的。 + 如果查詢啟動器和結果讀取器的 IAM 主體不同和/或查詢啟動器，且結果讀取器在查詢請求中沒有相同的查詢字串，則查詢會失敗並顯示`Invalid pagination token`錯誤。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：否 ** [QueryInsights](#API_query_Query_RequestSyntax) ** 封裝啟用的設定`QueryInsights`。啟用會`QueryInsights`傳回洞見和指標，以及您所執行查詢的查詢結果。您可以使用 `QueryInsights`來調整查詢效能。類型：[QueryInsights](API_query_QueryInsights.md) 物件必要：否 ** [QueryString](#API_query_Query_RequestSyntax) ** Timestream 要執行的查詢。類型：字串長度限制：長度下限為 1。長度上限為 262144。必要：是 ## 回應語法 ``` { "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。長度上限為 2048。 ** [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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/Query) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/Query) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/Query) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/Query) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/Query) + [AWS 適用於 Ruby V3 的 SDK](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" } ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_query_TagResource_RequestSyntax) ** 識別應新增標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/TagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/TagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/TagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/TagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/TagResource) # UntagResource 從 Timestream 查詢資源移除標籤的關聯。 ## 請求語法 ``` { "ResourceARN": "string", "TagKeys": [ "string" ] } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) ** 要從中移除標籤的 Timestream 資源。這個值是 Amazon Resource Name (ARN)。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UntagResource) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UntagResource) # UpdateAccountSettings 轉換您的帳戶以使用 TCUs進行查詢定價，並修改您設定的最大查詢運算單位。如果您將的值減少`MaxQueryTCU`為所需的組態，則新值最多可能需要 24 小時才會生效。 **注意** 將帳戶轉換為使用 TCUs進行查詢定價之後，您就無法轉換為使用掃描的位元組進行查詢定價。 ## 請求語法 ``` { "MaxQueryTCU": number, "QueryCompute": { "ComputeMode": "string", "ProvisionedCapacity": { "NotificationConfiguration": { "RoleArn": "string", "SnsConfiguration": { "TopicArn": "string" } }, "TargetQueryTCU": number } }, "QueryPricingModel": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) ** 服務在任何時間點將用於服務查詢的運算單位數量上限。若要執行查詢，您必須將最小容量設定為 4 TCU。您可以在 4 的倍數中設定 TCU 數量上限，例如 4、8、16、32 等。支援的最大值`MaxQueryTCU`為 1000。若要請求提高此軟性限制，請聯絡 AWS Support。如需 maxQueryTCU 預設配額的相關資訊，請參閱預設配額。此組態僅適用於 Timestream Compute Units (TCUs 的隨需用量。支援的最大值`MaxQueryTCU`為 1000。若要請求提高此軟性限制，請聯絡 AWS Support。如需的預設配額的相關資訊`maxQueryTCU`，請參閱[預設配額](https://docs.aws.amazon.com/timestream/latest/developerguide/ts-limits.html#limits.default)。類型：整數必要：否 ** [QueryCompute](#API_query_UpdateAccountSettings_RequestSyntax) ** 修改帳戶中設定的查詢運算設定，包括查詢定價模型和帳戶中佈建的 Timestream 運算單位 TCUs)。QueryCompute 僅適用於亞太區域（孟買）區域。此 API 是等冪的，這表示多次提出相同的請求會與提出一次請求具有相同的效果。類型：[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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateAccountSettings) # UpdateScheduledQuery 更新排程查詢。 ## 請求語法 ``` { "ScheduledQueryArn": "string", "State": "string" } ``` ## 請求參數如需所有動作的一般參數資訊，請參閱《[Common Parameters](CommonParameters.md)》。請求接受採用 JSON 格式的下列資料。 ** [ScheduledQueryArn](#API_query_UpdateScheduledQuery_RequestSyntax) ** 排程查詢的 ARN。類型：字串長度限制：長度下限為 1。長度上限為 2048。必要：是 ** [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 適用於 .NET V4 的 SDK](https://docs.aws.amazon.com/goto/DotNetSDKV4/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 C\$1\$1 的 SDK](https://docs.aws.amazon.com/goto/SdkForCpp/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Go 的 SDK v2](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Java V2 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 JavaScript V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Kotlin 的 SDK](https://docs.aws.amazon.com/goto/SdkForKotlin/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 PHP V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Python 的 SDK](https://docs.aws.amazon.com/goto/boto3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 適用於 Ruby V3 的 SDK](https://docs.aws.amazon.com/goto/SdkForRubyV3/timestream-query-2018-11-01/UpdateScheduledQuery)