要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击[此处](https://docs.aws.amazon.com//timestream/latest/developerguide/timestream-for-influxdb.html)了解更多信息。本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # Amazon Timestream 查询 Amazon Timestream 查询支持以下操作： + [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) ** 当针对 `QueryId` 指定的查询已发出 `CancelQuery` 请求时，返回 `CancellationMessage`。类型：字符串 ## 错误有关所有操作的常见错误的信息，请参阅[常见错误](CommonErrors.md)。 ** AccessDeniedException ** 您没有访问账户设置所需的权限。 HTTP 状态代码：400 ** InternalServerException ** 处理请求时发生的内部服务器错误。 HTTP 状态代码：400 ** InvalidEndpointException ** 请求的端点无效。 HTTP 状态代码：400 ** ThrottlingException ** 该请求因请求过多而受到限制。 HTTP 状态代码：400 ** ValidationException ** 请求无效或格式错误。 HTTP 状态代码：400 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CancelQuery) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CancelQuery) + [AWS 适用于 Java 的 SDK 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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CancelQuery) + [AWS Python 软件开发工具包](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" } } } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](CommonParameters.md)。请求接受采用 JSON 格式的以下数据。 ** [ClientToken](#API_query_CreateScheduledQuery_RequestSyntax) ** 使用 a ClientToken 会调用 CreateScheduledQuery idempotent，换句话说，重复发出相同的请求将产生相同的结果。发出多个相同的 CreateScheduledQuery 请求与发出单个请求的效果相同。 + 如果 CreateScheduledQuery 调用时不带有`ClientToken`，则 Query 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/*前缀如果`SSE_KMS`用作加密类型，则 ErrorReportConfiguration 使用相同的 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 参数计算的时间戳将是每次查询运行的 p `@scheduled_runtime` aramater 的值。例如，考虑在 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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/CreateScheduledQuery) + [AWS Python 软件开发工具包](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" } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DeleteScheduledQuery) + [AWS Python 软件开发工具包](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。可将 TCU 的最大数量设置为 4 的倍数，例如 4、8、16、32 等。此配置仅适用于 (TCUs) 的按需使用。类型：整数 ** [QueryCompute](#API_query_DescribeAccountSettings_ResponseSyntax) ** 一个对象，其中包含您的账户中查询工作负载的 Timestream 计算单位 (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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeAccountSettings) + [AWS Python 软件开发工具包](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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/DescribeEndpoints) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeEndpoints) + [AWS Python 软件开发工具包](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" } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/DescribeScheduledQuery) + [AWS Python 软件开发工具包](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" } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](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。最大长度为 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" } } ``` ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS 适用于 Java 的 SDK 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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ExecuteScheduledQuery) + [AWS Python 软件开发工具包](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" } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/ListScheduledQueries) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListScheduledQueries) + [AWS Python 软件开发工具包](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" } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](CommonParameters.md)。请求接受采用 JSON 格式的以下数据。 ** [MaxResults](#API_query_ListTagsForResource_RequestSyntax) ** 要返回标签的最大数。类型：整数有效范围：最小值为 1。最大值为 200。必需：否 ** [NextToken](#API_query_ListTagsForResource_RequestSyntax) ** 用于恢复分页的分页令牌。类型：字符串必需：否 ** [ResourceARN](#API_query_ListTagsForResource_RequestSyntax) ** 带有待列出标签的 Timestream 资源。此值是 Amazon 资源名称（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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/ListTagsForResource) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/ListTagsForResource) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/ListTagsForResource) + [AWS Python 软件开发工具包](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 } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/PrepareQuery) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/PrepareQuery) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/PrepareQuery) + [AWS Python 软件开发工具包](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` 请求。 + 如果在 5 分钟的幂等性时段内使用相同的客户端令牌提交 `Query` 请求，但更改其他参数。 + 如果行的大小（包括查询元数据）超过 1MB，则查询将失败并显示以下错误消息： `Query aborted as max page response size has been exceeded by the output result row` + 如果查询发起者和结果读取器的 IAM 委托人不相同 and/or ，查询发起者和结果读取器在查询请求中没有相同的查询字符串，则查询将失败并出现错误。`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` 请求与发出单个请求具有相同的效果。在查询中使用 `ClientToken` 时，请注意以下事项： + 如果在没有 `ClientToken` 的情况下实例化查询 API，则查询 SDK 将为您自动生成 `ClientToken`。 + 如果 `Query` 调用仅包含 `ClientToken` 但不包含 `NextToken`，则对 `Query` 的调用视作新运行的查询。 + 如果调用包含 `NextToken`，则该特定调用视作对查询 API 先前调用的后续调用，并返回结果集。 + 4 小时后，任何具有相同请求的请求`ClientToken`都将被视为新请求。类型：字符串长度限制：最小长度为 32。最大长度为 128。必需：否 ** [MaxRows](#API_query_Query_RequestSyntax) ** `Query` 输出中要返回的行总数。使用指定的 `MaxRows` 值初始运行 `Query` 将返回查询结果集，具体分为两种情况： + 结果的大小小于 `1MB`。 + 结果集中的行数小于 `maxRows` 的值。否则，对 `Query` 的初始调用仅返回 `NextToken`，随后可用于后续调用以获取结果集。要恢复分页，请在后续命令中提供 `NextToken` 值。如果行大小较大（例如，行包含许多列），Timestream 可能会返回较少行数，以防响应大小超过 1MB 的限制。如果未提供 `MaxRows`，Timestream 将发送必要的行数，以满足 1MB 的限制。类型：整数有效范围：最小值为 1。最大值为 1000。必需：否 ** [NextToken](#API_query_Query_RequestSyntax) ** 用于检索结果集的分页令牌。当使用 `Query` 调用 `NextToken` API 时，该特定调用视作对 `Query` 先前调用的后续调用，并返回结果集。然而，如果 `Query` 调用仅包含 `ClientToken`，则对 `Query` 的调用视作新运行的查询。在查询 NextToken 中使用时，请注意以下几点： + 分页令牌最多可用于五次 `Query` 调用，或持续使用长达 1 小时（以先到者为准）。 + 使用相同的 `NextToken` 将返回相同的记录集。要继续对结果集进行分页，则必须使用最新的 `nextToken`。 + 假设 `Query` 调用返回两个 `NextToken` 值，`TokenA` 和 `TokenB`。如果在后续 `Query` 调用中使用 `TokenB`，则 `TokenA` 会失效且无法重复使用。 + 在分页开始后，如需请求查询的先前结果集，则必须重新调用查询 API。 + 应使用最新的 `NextToken` 进行分页，直至返回 `null`，此时应使用新的 `NextToken`。 + 如果查询发起者和结果读取器的 IAM 委托人不相同 and/or ，查询发起者和结果读取器在查询请求中没有相同的查询字符串，则查询将失败并出现错误。`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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/Query) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/Query) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/Query) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/Query) + [AWS Python 软件开发工具包](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 资源关联。然后，您可以激活这些用户定义的标签，以便在账单和成本管理控制台上显示这些标签，从而进行成本分配跟踪。 ## 请求语法 ``` { "ResourceARN": "string", "Tags": [ { "Key": "string", "Value": "string" } ] } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](CommonParameters.md)。请求接受采用 JSON 格式的以下数据。 ** [ResourceARN](#API_query_TagResource_RequestSyntax) ** 标识应向其添加标签的 Timestream 资源。此值是 Amazon 资源名称（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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/TagResource) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/TagResource) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/TagResource) + [AWS Python 软件开发工具包](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" ] } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](CommonParameters.md)。请求接受采用 JSON 格式的以下数据。 ** [ResourceARN](#API_query_UntagResource_RequestSyntax) ** 将从其中移除标签的 Timestream 资源。此值是 Amazon 资源名称（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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UntagResource) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UntagResource) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UntagResource) + [AWS Python 软件开发工具包](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" } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](CommonParameters.md)。请求接受采用 JSON 格式的以下数据。 ** [MaxQueryTCU](#API_query_UpdateAccountSettings_RequestSyntax) ** 该服务在任何时间点为处理查询所使用的最大计算单位数量。要运行查询，必须将最小容量设置为 4 TCU。可将 TCU 的最大数量设置为 4 的倍数，例如 4、8、16、32 等。`MaxQueryTCU` 支持的最大值为 1000。要申请提高此软限制，请联系 Su AWS pport。有关 maxQueryTCU 默认限额的信息，请参阅默认限额。此配置仅适用于 Timestream 计算单元 (TCUs) 的按需使用。 `MaxQueryTCU` 支持的最大值为 1000。要申请提高此软限制，请联系 Su AWS pport。有关 `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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS 适用于 Java 的 SDK V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS JavaScript V3 版软件开发工具包](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateAccountSettings) + [AWS Python 软件开发工具包](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" } ``` ## 请求参数有关所有操作的通用参数的信息，请参阅[常用参数](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 ## 另请参阅有关以特定语言之一使用此 API 的更多信息 AWS SDKs，请参阅以下内容： + [AWS 命令行界面 V2](https://docs.aws.amazon.com/goto/cli2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 适用于.NET 的 SDK V4](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 v2 的 SDK](https://docs.aws.amazon.com/goto/SdkForGoV2/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS 适用于 Java 的 SDK V2](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 的 SDK V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/timestream-query-2018-11-01/UpdateScheduledQuery) + [AWS Python 软件开发工具包](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)