yc managed-clickhouse shards update

Written by

Updated at July 10, 2025

Modify configuration or attributes of a ClickHouse shard.

Command Usage

Syntax:

yc managed-clickhouse shards update <SHARD-NAME> [Flags...] [Global Flags...]

Flags

Flag	Description
`--cluster-id`	`string` ID of the ClickHouse cluster.
`--cluster-name`	`string` Name of the ClickHouse cluster.
`--async`	Display information about the operation in progress, without waiting for the operation to complete.
`--name`	`string` Shard name.
`--clickhouse-resource-preset`	`string` New resource preset for computational resources (CPU, RAM etc.) available to a ClickHouse host in the shard.
`--clickhouse-disk-size`	`byteSize` Volume of the storage available to ClickHouse hosts in the shard in GB.
`--clickhouse-disk-type`	`string` Storage type for ClickHouse hosts in the shard.
`--disk-size-limit`	`byteSize` Disk size limit of the shard in the cluster (GB).
`--planned-usage-threshold`	`int` Planned usage threshold of the shard in the cluster.
`--emergency-usage-threshold`	`int` Emergency usage threshold of the shard in the cluster.
`--weight`	`int` New weight of a ClickHouse host in the shard.

Global Flags

Flag	Description
`--profile`	`string` Set the custom configuration file.
`--debug`	Debug logging.
`--debug-grpc`	Debug gRPC logging. Very verbose, used for debugging connection problems.
`--no-user-output`	Disable printing user intended output to stderr.
`--retry`	`int` Enable gRPC retries. By default, retries are enabled with maximum 5 attempts. Pass 0 to disable retries. Pass any negative value for infinite retries. Even infinite retries are capped with 2 minutes timeout.
`--cloud-id`	`string` Set the ID of the cloud to use.
`--folder-id`	`string` Set the ID of the folder to use.
`--folder-name`	`string` Set the name of the folder to use (will be resolved to id).
`--endpoint`	`string` Set the Cloud API endpoint (host:port).
`--token`	`string` Set the OAuth token to use.
`--impersonate-service-account-id`	`string` Set the ID of the service account to impersonate.
`--no-browser`	Disable opening browser for authentication.
`--format`	`string` Set the output format: text (default), yaml, json, json-rest.
`--jq`	`string` Query to select values from the response using jq syntax
`-h`,`--help`	Display help for the command.

Examples

Updating a shard

Was the article helpful?

Previous

Next