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

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

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

Если вы обращаетесь к ресурсу по имени, поиск будет выполнен в каталоге по умолчанию. Если вы обращаетесь к ресурсу по идентификатору, поиск будет выполнен глобально — во всех каталогах с учетом прав доступа.

1. Посмотрите описание команды для изменения сервера:

   yc baremetal v2 server update --help
   

2. Измените сервер:

   yc baremetal v2 server update \
     --id <идентификатор_сервера> \
     --update-mask name,description,network-interfaces,annotations \
     --server '{
       name="<новое_имя_сервера>",
       description="<новое_описание_сервера>",
       network-interfaces=[
         {
           network-interface-id="<идентификатор_приватного_интерфейса>",
           interface=private-interface={native-subnet-id="<идентификатор_новой_приватной_подсети>"}
         },
         {
           network-interface-id="<идентификатор_публичного_интерфейса>",
           interface=public-interface={native-subnet-config=native-subnet={subnet-id="<идентификатор_новой_публичной_подсети>"}}
         }
       ],
       annotations={<ключ_метки>="<значение_метки>"}
     }'
   

   Где:

   • --id — идентификатор сервера. Чтобы узнать его и значения network_interface_id, получите информацию о сервере.

   • --update-mask — список изменяемых полей. Если вы исключили необязательное поле из объекта, удалите его и из маски.

   • --server — параметры сервера в объектном синтаксисе:

     • name — новое имя сервера. Необязательное поле.
     • description — новое описание сервера. Необязательное поле.
     • network-interfaces — полный список сетевых интерфейсов и их настроек. Необязательное поле. Для каждого интерфейса укажите network-interface-id и нужный вариант interface: private-interface с полем native-subnet-id или public-interface с полем native-subnet-config.
     • annotations — полный набор меток сервера. Необязательное поле.

   При изменении network-interfaces передайте также настройки интерфейсов, которые нужно сохранить, включая дополнительные приватные подсети (vlan-subinterfaces) и пакет трафика (internet-traffic-plan), если они заданы.

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

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.