跳转到主要内容
PATCH
更新服务自动扩缩容设置

授权

Authorization
string
header
必填

使用在 ClickHouse Cloud 控制台中获取的 key ID 和 key secret:https://clickhouse.com/docs/cloud/manage/openapi

路径参数

organizationId
string<uuid>
必填

拥有该服务的组织 ID。

serviceId
string<uuid>
必填

要更新扩缩容参数的服务 ID。

请求体

application/json
idleScaling
boolean

设置为 true 时,服务在空闲时允许缩容到零。默认为 True。

idleTimeoutMinutes
number

设置最小空闲超时时间(分钟)。必须 >= 5 分钟。

maxReplicaMemoryGb
number

单个副本的最大自动扩缩容内存(Gb)。仅适用于 'production' 服务。对于非付费服务,必须是 4 的倍数且小于或等于 120;对于付费服务,则必须小于或等于 356。

必填范围: 8 <= x <= 356必须是以下数值的倍数 4
示例:

120

minReplicaMemoryGb
number

单个副本的最小自动扩缩容内存(Gb)。仅适用于 'production' 服务。必须是 4 的倍数,且大于或等于 8。

必填范围: 8 <= x <= 356必须是以下数值的倍数 4
示例:

16

numReplicas
number

服务的副本数。对于仓库中的第一个服务,副本数必须在 2 到 20 之间。在现有仓库中创建的服务,副本数最低可为 1。根据你所属 organizations 的层级,可能还会有其他限制。默认情况下,BASIC 层级为 1,SCALE 和 ENTERPRISE 层级为 3。

必填范围: 1 <= x <= 20
示例:

3

响应

成功响应

requestId
string<uuid>

为每个请求分配的唯一 ID。UUIDv4

result
object
status
number

HTTP 状态码。

示例:

200

最后修改于 2026年6月12日