Изменить сервер

Статья создана

Yandex Cloud

Улучшена

Обновлена 9 февраля 2026 г.

Консоль управления

CLI

API

В консоли управления выберите каталог, которому принадлежит сервер.
Перейдите в сервис BareMetal.
В строке с нужным сервером нажмите значок и выберите Редактировать.
Внесите изменения в конфигурацию сервера:
- (Опционально) В поле Имя измените имя сервера. Требования к имени:
  - длина — от 3 до 63 символов;
  - может содержать строчные буквы латинского алфавита, цифры и дефисы;
  - первый символ — буква, последний — не дефис.
- (Опционально) В поле Описание добавьте или измените описание сервера.
- (Опционально) В поле Метки добавьте или измените метки сервера.
- (Опционально) В блоке Условия аренды измените продолжительность периода аренды сервера.
  
  Примечание
  
  Изменения в настройке продолжительности периода аренды вступят в силу только по истечении текущего периода, на который был арендован сервер.
- (Опционально) В полях Приватная подсеть и Публичный адрес измените сетевые настройки сервера.
- (Опционально) В поле Объём данных измените пакет потребления трафика сервера. Доступные пакеты потребления трафика:
  - 10 ТБ в сутки, ёмкость подключения — 1 Гбит/с;
  - 100 ТБ в сутки, ёмкость подключения — 10 Гбит/с.
  Примечание
  
  Возможность выбора пакетов трафика доступна только для конфигураций с публичным IP-адресом и сетевыми картами со скоростью соединения 10 Гбит/с и выше.
  
  После увеличения емкости подключения уменьшить ее можно будет не раньше, чем через 24 часа.
Нажмите кнопку Сохранить изменения.

Если у вас еще нет интерфейса командной строки Yandex Cloud (CLI), установите и инициализируйте его.

По умолчанию используется каталог, указанный при создании профиля CLI. Чтобы изменить каталог по умолчанию, используйте команду yc config set folder-id <идентификатор_каталога>. Также для любой команды вы можете указать другой каталог с помощью параметров --folder-name или --folder-id.

По умолчанию секреты создаются в том же каталоге, что и подключения. Чтобы создать секрет в другом каталоге, в параметре --secret-folder-id укажите идентификатор этого каталога (для этого вам потребуется роль resource-manager.user на целевой каталог). Каталоги для подключения и секрета должны находиться в одном облаке. После создания подключения вы не сможете изменить этот параметр.

Посмотрите описание команды для изменения сервера:
```
yc baremetal server update --help
```
Измените сервер:
```
yc baremetal server update \
  --name <имя_сервера> \
  --new-name <новое_имя_сервера> \
  --description <новое_описание_сервера> \
  --network-interfaces private-subnet-id=<идентификатор_новой_приватной_подсети> \
  --network-interfaces public-subnet-id=<идентификатор_новой_публичной_подсети> \
  --labels <ключ_метки>=<значение_метки>
```
Где:
- --name — имя сервера.
- --new-name — новое имя сервера. Необязательный параметр.
- --description — новое описание сервера. Необязательный параметр.
- --network-interfaces — новые сетевые настройки. Необязательный параметр. Возможные значения:
  - private-subnet-id — идентификатор новой приватной подсети.
  - public-subnet-id — идентификатор новой выделенной публичной подсети.
- --labels — новые метки сервера. Необязательный параметр.

Чтобы изменить сервер, воспользуйтесь методом REST API update для ресурса Server или вызовом gRPC API ServerService/Update.

Пример

Измените имя, описание и сетевые настройки сервера:

CLI

API

  yc baremetal server update \
    --name demo-baremetal-server  \
    --new-name new-demo-baremetal-server  \
    --description "Updated BareMetal server" \
    --network-interfaces private-subnet-id=ly5rljahs3re******** \
    --network-interfaces public-subnet-id=ly5vr6tugxk7********

Результат:

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: ly5lymxdltk3********
created_at: "2025-07-06T21:53:46.186130Z"
labels:
  env: test

curl -X PATCH \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <IAM-токен>" \
  -d '{
    "updateMask": "name,description,networkInterfaces",
    "name": "new-bm-server-test",
    "description": "Updated BareMetal server",
    "networkInterfaces": [
      {
        "privateSubnet": {
          "privateSubnetId": "ly55shvlzvy4********"
        },
        "id": "ly5j33j44gtc********",
        "macAddress": "00:25:90:e9:49:98"
      },
      {
        "publicSubnet": {
          "publicSubnetId": "ly52yjugkj57********"
        },
        "id": "ly5rmqqchyep********",
        "macAddress": "00:25:90:e9:49:99"
      }
    ]
  }' \
  "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/servers/<идентификатор_сервера>"

Где:

<IAM-токен> — IAM-токен для аутентификации.
<идентификатор_сервера> — идентификатор сервера, который нужно изменить. Чтобы узнать идентификатор, воспользуйтесь инструкцией.
updateMask — список полей для обновления, разделенный запятыми. Будут изменены только указанные поля. Если поле указано в updateMask, но значение не передано в запросе, поле будет сброшено к значению по умолчанию.
name — новое имя сервера. Имя должно быть уникальным в рамках каталога.
- длина — от 3 до 63 символов;
- может содержать строчные буквы латинского алфавита, цифры и дефисы;
- первый символ — буква, последний — не дефис.
description — новое описание сервера.
networkInterfaces[] — новые сетевые настройки. Необязательный параметр. Возможные значения:
- privateSubnetId — идентификатор новой приватной подсети.
- publicSubnetId — идентификатор новой выделенной публичной подсети.

Результат:

{
  "done": false,
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.UpdateServerMetadata",
    "serverId": "ly56xpblirh4********"
  },
  "id": "ly5k7jdyevbh********",
  "description": "Server update",
  "createdAt": "2025-12-07T20:03:43.637004Z",
  "createdBy": "ajeb9l33h6mu********",
  "modifiedAt": "2025-12-07T20:03:43.637004Z"
}

Отслеживайте статус операции по полю done.

Изменить сервер

ПримерПример

Была ли статья полезна?

Пример