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
            • 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. private-subnet
  6. update

yc baremetal v2 private-subnet update

Written by
Yandex Cloud
Updated at June 18, 2026

Updates the specified private subnet.

Command UsageCommand Usage

Syntax:

yc baremetal v2 private-subnet update <PRIVATE-SUBNET-ID>

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

--id

string

ID of the private subnet.

--private-subnet

shorthand/json

The PrivateSubnet object to be updated.

Description
  • name (string)
    Name of the public subnet. The name is unique within the folder.
  • description (string)
    Optional description of the private subnet.
  • hardware-pool-id (string)
    ID of the hardware pool that the private subnet belongs to.
  • vrf-options (structure)
    Optional VRF options for the private subnet. If missing, the private subnet will be unrouted, i.e. it will lack a DHCP server and routing capabilities between this subnet and other private subnets.
  • vrf-id (string)
    ID of the VRF.
  • cidr (string)
    CIDR block for the subnet.
  • dhcp-options (structure)
    DHCP options for the subnet.
  • start-ip (string)
    Start IP address of the DHCP range (inclusive).
  • end-ip (string)
    End IP address of the DHCP range (inclusive).
  • gateway-ip (string)
    Gateway IP address for the subnet.
  • annotations (map[string,string])
    Resource annotations as 'key:value' pairs.
Shorthand Syntax
{
  annotations = {key=string, key=...},
  description = string,
  hardware-pool-id = string,
  name = string,
  vrf-options = {
    cidr = string,
    dhcp-options = {
      end-ip = string,
      start-ip = string
    },
    gateway-ip = string,
    vrf-id = string
  }
}
JSON Syntax
{
  "annotations": {
    "<key>": "string", ...
  },
  "description": "string",
  "hardware-pool-id": "string",
  "name": "string",
  "vrf-options": {
    "cidr": "string",
    "dhcp-options": {
      "end-ip": "string",
      "start-ip": "string"
    },
    "gateway-ip": "string",
    "vrf-id": "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 private-subnet update --example-json > request.json
    or
    yc baremetal v2 private-subnet update --example-yaml > request.yaml

  2. Edit the template file

  3. Run with template:
    yc baremetal v2 private-subnet update -r request.json
    or
    yc baremetal v2 private-subnet 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.