Yandex Cloud
Search
Discuss with expertTry it for free
  • Customer Stories
  • Documentation
  • Blog
  • All Services
  • System Status
  • Marketplace
    • Featured
    • Infrastructure & Network
    • Data Platform
    • AI for business
    • Security
    • DevOps tools
    • Serverless
    • Monitoring & Resources
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Start testing with double trial credits
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Center for Technologies and Society
    • Yandex Cloud Partner program
    • Price calculator
    • Pricing plans
  • Customer Stories
  • Documentation
  • Blog
© 2026 Direct Cursus Technology L.L.C.
Yandex BareMetal
    • All guides
    • Overview
      • Overview
      • Stock server configurations
      • Custom server configuration
      • On-request server configuration
      • Overview
      • Public network
      • Private network
      • DHCP
      • MC-LAG
      • Restrictions in BareMetal networks
      • Overview
      • Images
      • Access management
      • Additional server settings
      • Management console
        • Overview
          • Overview
          • configuration
            • Overview
              • Overview
              • create
              • delete
              • get
              • list
              • update
      • Monitoring metrics
    • Quotas and limits
  • Pricing policy
  • FAQ
  1. Concepts
  2. Setup and management
  3. CLI reference
  4. v2
  5. extend
  6. stackland-cluster
  7. update

yc baremetal v2 extend stackland-cluster update

Written by
Yandex Cloud
Updated at June 18, 2026

Updates the specified Stackland cluster.

Command UsageCommand Usage

Syntax:

yc baremetal v2 extend stackland-cluster update

FlagsFlags

Flag

Description

--update-mask

[]string

Field paths for FieldMask: each segment may be proto snake_case or CLI kebab-case (e.g. name, labels, network-interface). Repeat the flag or use comma-separated values. When set and non-empty, takes precedence over update_mask in the request body/file and over mask inferred from -r. If omitted or empty, the mask is built from the fields you pass (changed flags, JSON/shorthand, and request file when update_mask is absent there).

--cluster

shorthand/json

The cluster object to be updated

Description
  • cloud-id (string)
    ID of the cloud that the cluster belongs to.
  • folder-id (string)
    ID of the folder that the cluster belongs to.
  • name (string)
    Name of the cluster. The display name is unique within the folder.
  • description (string)
    Description of the server.
  • annotations (map[string,string])
    Resource labels as 'key:value' pairs.
  • hardware-pool-id (string)
    ID of the hardware pool that the cluster belongs to.
  • preset (structure)
    Preset of the cluster.
  • host-roles (structure)
    Which node types are to be used for cluster roles.
  • controlplane ([]structure)
    Node types used as controlplane nodes.
  • configuration-id (string)
    ID of the configuration.
  • count (integer)
    Number of nodes in the group.
  • combined ([]structure)
    Node types used as combined nodes.
  • configuration-id (string)
    ID of the configuration.
  • count (integer)
    Number of nodes in the group.
  • worker ([]structure)
    Node types used as workder nodes.
  • configuration-id (string)
    ID of the configuration.
  • count (integer)
    Number of nodes in the group.
  • bastion (structure)
    Bastion node.
  • configuration-id (string)
    ID of the configuration.
  • management-ip-address (string)
    IP address of the node in the management network.
  • subnet-id (string)
    ID of the subnet that the cluster belongs to.
  • cidr (string)
    Optional CIDR to preselect in subnet.
  • version (string)
    Version of Stackland to be used.
  • licence (string)
    Licence to activate Stackland.
Shorthand Syntax
{
  annotations = {key=string, key=...},
  bastion = {
    configuration-id = string,
    management-ip-address = string
  },
  cidr = string,
  cloud-id = string,
  description = string,
  folder-id = string,
  hardware-pool-id = string,
  host-roles = {
    combined = [
      {
        configuration-id = string,
        count = integer
      }, ...
    ],
    controlplane = [
      {
        configuration-id = string,
        count = integer
      }, ...
    ],
    worker = [
      {
        configuration-id = string,
        count = integer
      }, ...
    ]
  },
  licence = string,
  name = string,
  preset = MINIMAL|FULL,
  subnet-id = string,
  version = string
}
JSON Syntax
{
  "annotations": {
    "<key>": "string", ...
  },
  "bastion": {
    "configuration-id": "string",
    "management-ip-address": "string"
  },
  "cidr": "string",
  "cloud-id": "string",
  "description": "string",
  "folder-id": "string",
  "hardware-pool-id": "string",
  "host-roles": {
    "combined": [
      {
        "configuration-id": "string",
        "count": "integer"
      }, ...
    ],
    "controlplane": [
      {
        "configuration-id": "string",
        "count": "integer"
      }, ...
    ],
    "worker": [
      {
        "configuration-id": "string",
        "count": "integer"
      }, ...
    ]
  },
  "licence": "string",
  "name": "string",
  "preset": "MINIMAL|FULL",
  "subnet-id": "string",
  "version": "string"
}

--async

Display information about the operation in progress, without waiting for the operation to complete.

-r, --request-file

string

Path to a request file.

--example-json

Generates a JSON template of the request.

-e, --example-yaml

Generates a YAML template of the request.

The template can be customized and used as input for the command.

Usage example:

  1. Generate template:
    yc baremetal v2 extend stackland-cluster update --example-json > request.json
    or
    yc baremetal v2 extend stackland-cluster update --example-yaml > request.yaml

  2. Edit the template file

  3. Run with template:
    yc baremetal v2 extend stackland-cluster update -r request.json
    or
    yc baremetal v2 extend stackland-cluster update -r request.yaml

Global FlagsGlobal Flags

Flag

Description

--profile

string

Set the custom profile.

--region

string

Set the region.

--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.

--pager

string

Set the custom pager.

--no-pager

Do not pipe help output through a pager.

--format

string

Set the output format: text, yaml, json, table, summary || summary[name, instance.id, instance.disks[0].size].

--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.

--timeout

string

Set the timeout.

--token

string

Set the IAM token to use.

--impersonate-service-account-id

string

Set the ID of the service account to impersonate.

--no-browser

Disable opening browser for authentication.

--query

string

Query to select values from the response using jq syntax

--print-metadata

Print operation metadata along with result.

--syntax

string

Choose syntax option.

--cli-auto-prompt

string[="on"]

Enable interactive auto-prompt mode. Values: on, partial, off. Bare --cli-auto-prompt is equivalent to --cli-auto-prompt=on.

--no-cli-auto-prompt

Disable interactive auto-prompt mode (overrides --cli-auto-prompt, env and profile).

-h, --help

Display help for the command.

Was the article helpful?

Previous
list
Next
Overview
© 2026 Direct Cursus Technology L.L.C.