UpdateAccountSettings - Amazon Timestream
请求语法请求参数响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

要获得与亚马逊 Timestream 类似的功能 LiveAnalytics，可以考虑适用于 InfluxDB 的亚马逊 Timestream。适用于 InfluxDB 的 Amazon Timestream 提供简化的数据摄取和个位数毫秒级的查询响应时间，以实现实时分析。点击此处了解更多信息。

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

UpdateAccountSettings

将您的账户转换为使用 TCU 进行查询定价，并修改已配置的最大查询计算单位数。如果将 MaxQueryTCU 的值减少至所需配置，则新值可能需要长达 24 小时才能生效。

注意

在您的账户转换为使用 TCU 进行查询定价后，您无法转换为使用已扫描字节数进行查询定价。

请求语法

{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         },
         "TargetQueryTCU": number
      }
   },
   "QueryPricingModel": "string"
}

请求参数

有关所有操作的通用参数的信息，请参阅常用参数。

请求接受采用 JSON 格式的以下数据。

MaxQueryTCU

该服务在任何时间点为处理查询所使用的最大计算单位数量。要运行查询，必须将最小容量设置为 4 TCU。可将 TCU 的最大数量设置为 4 的倍数，例如 4、8、16、32 等。MaxQueryTCU 支持的最大值为 1000。要请求增加此软限制，请联系 Amazon Support。有关 maxQueryTCU 默认限额的信息，请参阅默认限额。此配置仅适用于 Timestream 计算单位（TCU）的按需使用。

MaxQueryTCU 支持的最大值为 1000。要请求增加此软限制，请联系 Amazon Support。有关 maxQueryTCU 默认限额的信息，请参阅默认限额。

类型：整数

必需：否

QueryCompute

修改账户中已配置的查询计算设置，包括查询定价模型和账户中预置的 Timestream 计算单位（TCU）。QueryCompute 仅在亚太地区（孟买）区域提供。

注意

此 API 具有幂等性，这意味着多次发出相同请求的效果与发出一次请求的效果相同。

类型：QueryComputeRequest 对象

必需：否

QueryPricingModel

账户中查询的定价模式。

注意

QueryPricingModel 参数由多个 Timestream 操作使用；然而，UpdateAccountSettings API 操作无法识别除 COMPUTE_UNITS 之外的任何值。

类型：字符串

有效值：BYTES_SCANNED | COMPUTE_UNITS

必需：否

响应语法

{
   "MaxQueryTCU": number,
   "QueryCompute": { 
      "ComputeMode": "string",
      "ProvisionedCapacity": { 
         "ActiveQueryTCU": number,
         "LastUpdate": { 
            "Status": "string",
            "StatusMessage": "string",
            "TargetQueryTCU": number
         },
         "NotificationConfiguration": { 
            "RoleArn": "string",
            "SnsConfiguration": { 
               "TopicArn": "string"
            }
         }
      }
   },
   "QueryPricingModel": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

MaxQueryTCU

该服务在任何时间点为处理查询所使用的最大已配置计算单位数量。

类型：整数

QueryCompute

确认更新后的账户设置，用于查询账户中的数据。QueryCompute 仅在亚太地区（孟买）区域提供。

类型：QueryComputeResponse 对象

QueryPricingModel

账户的定价模式。

类型：字符串

有效值：BYTES_SCANNED | COMPUTE_UNITS

错误

有关所有操作的常见错误的信息，请参阅常见错误。

AccessDeniedException

您没有访问账户设置所需的权限。

HTTP 状态代码：400

InternalServerException

处理请求时发生的内部服务器错误。

HTTP 状态代码：400

InvalidEndpointException

请求的端点无效。

HTTP 状态代码：400

ThrottlingException

该请求因请求过多而受到限制。

HTTP 状态代码：400

ValidationException

请求无效或格式错误。

HTTP 状态代码：400

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：