Updating a server
-
In the management console, select the folder the server belongs to.
-
Go to BareMetal.
-
Find the server you need in the list, click in its row, and select Edit.
-
Push your changes to the server configuration:
-
Optionally, change the server's name in the Name field. Follow these naming requirements:
- It must be from 2 to 63 characters long.
- It can only contain lowercase Latin letters, numbers, and hyphens.
- It must start with a letter and cannot end with a hyphen.
-
Optionally, add or update the server's description in the Description field.
-
Optionally, add or update the server's labels in the Labels field.
-
Optionally, update server lease duration under Lease conditions.
Note
The lease duration setting changes will apply only after the current server lease period expires.
-
Optionally, change the server's network settings in the Private subnet and Public address fields.
-
Optionally, in the Bandwidth field, change the server's bandwidth package. Available bandwidth packages:
10 TB per day, connection capacity, 1 Gbit/s100 TB per day, connection capacity, 10 Gbit/s
Note
You can select a bandwidth package only for configurations with a public IP address and network cards of 10 Gbps or higher.
After you increase bandwidth, it can be reduced only after 24 hours.
-
-
Click Save changes.
If you do not have the Yandex Cloud CLI installed yet, install and initialize it.
By default, the CLI uses the folder specified when creating the profile. To change the default folder, use the yc config set folder-id <folder_ID> command. You can also set a different folder for any specific command using the --folder-name or --folder-id parameter.
-
View the description of the server update command:
yc baremetal server update --help -
Update server:
yc baremetal server update \ --name <server_name> \ --new-name <new_server_name> \ --description <new_server_description> \ --network-interfaces private-subnet-id=<new_private_subnet_ID> \ --network-interfaces public-subnet-id=<new_public_subnet_ID> \ --labels <label_key>=<label_value>Where:
-
--name: Server name. -
--new-name: New server name. This is an optional setting. -
--description: New server description. This is an optional setting. -
--network-interfaces: New network settings. This is an optional setting. The possible values are:private-subnet-id: ID of the new private subnet.public-subnet-id: ID of the new dedicated public subnet.
-
--labels: New server labels. This is an optional setting.
-
Example
Update server name, description, and network settings:
yc baremetal server update \
--name demo-baremetal-server \
--new-name new-demo-baremetal-server \
--description "Updated BareMetal server" \
--network-interfaces private-subnet-id=ly5rljahs3re4gw7bf6l \
--network-interfaces public-subnet-id=ly5vr6tugxk75fynutzt
Result:
id: ly52dtzdi55r********
cloud_id: b1gia87mbaom********
folder_id: b1g0ijbfaqsn********
name: new-demo-baremetal-server
description: Updated BareMetal server
zone_id: ru-central1-m
hardware_pool_id: ru-central1-m4
status: PROVISIONING
os_settings:
image_id: ly5vhn4lapev********
ssh_public_key: ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIGcM4tRfRHJGrlLMT+YJFr+aOdSQYnYYjAoj********
storages:
- partitions:
- type: EXT3
size_gib: "999"
mount_point: /
- type: EXT4
size_gib: "499"
mount_point: /root
raid:
type: RAID0
disks:
- id: ly5ual3jbnhr********
type: HDD
size_gib: "1862"
- id: ly54qfjw55d4********
type: HDD
size_gib: "1862"
- partitions:
- type: EXT3
size_gib: "999"
mount_point: /boot
- type: SWAP
size_gib: "9"
disk:
id: ly5ojffpngul********
type: HDD
size_gib: "1862"
network_interfaces:
- id: ly5wbsiklrtd********
mac_address: 00:25:90:92:fa:48
private_subnet:
private_subnet_id: ly5ztavbezrf********
- id: ly5ygl4loyy6********
mac_address: 00:25:90:92:fa:49
public_subnet:
public_subnet_id: ly5o6l7pxmk2********
configuration_id: ly5lymxdltk3xitpkrmi
created_at: "2025-07-06T21:53:46.186130Z"
labels:
env: test