Configure vertical and horizontal autoscaling (memory bounds, replica counts, idle scaling) for a ClickHouse Cloud service via the Cloud API

Documented steps

1. Authenticate with HTTP Basic auth (key ID as username, key secret as password) against https://api.clickhouse.cloud/v1.
2. Resolve IDs: GET /v1/organizations, then GET /v1/organizations/{organizationId}/services to find the target serviceId.
3. Use the per-replica endpoint: PATCH /v1/organizations/{organizationId}/services/{serviceId}/replicaScaling. The legacy PATCH .../scaling with minTotalMemoryGb/maxTotalMemoryGb is deprecated in the spec as 'inaccurate for services with non-default numbers of replicas'.
4. Vertical autoscaling (fixed replica count, memory scales): PATCH replicaScaling with {"autoscalingMode":"vertical","minReplicaMemoryGb":16,"maxReplicaMemoryGb":120,"numReplicas":3,"idleScaling":true,"idleTimeoutMinutes":10}. Memory values must be multiples of 4 between 8 and 356, and apply only to production-class (non-development) services.
5. Horizontal autoscaling (replica count scales, memory fixed): PATCH replicaScaling with {"autoscalingMode":"horizontal","minReplicas":2,"maxReplicas":6,"minReplicaMemoryGb":16,"maxReplicaMemoryGb":16}. In horizontal mode minReplicaMemoryGb must equal maxReplicaMemoryGb, and minReplicas/maxReplicas must be sent together.
6. curl -u "$KEY_ID:$KEY_SECRET" -X PATCH https://api.clickhouse.cloud/v1/organizations/$ORG_ID/services/$SERVICE_ID/replicaScaling -H 'Content-Type: application/json' -d '{"minReplicaMemoryGb":16,"maxReplicaMemoryGb":120,"idleScaling":true,"idleTimeoutMinutes":10}'
7. numReplicas accepts 1-20 and is mutually exclusive with minReplicas/maxReplicas. Omit autoscalingMode to leave the service on its current mode.
8. idleScaling defaults to true (scale to zero when idle); idleTimeoutMinutes must be at least 5.
9. Verify with GET /v1/organizations/{organizationId}/services/{serviceId} and confirm the returned scaling fields match what you sent - the change is applied asynchronously and can lag.
10. Reference: https://clickhouse.com/docs/cloud/manage/jan-2025-faq/scaling and the live spec at https://clickhouse.com/docs/cloud/manage/api/swagger