Изменить тип сети, подключенной к сетевому интерфейсу

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

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

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

   yc baremetal server update --help
   

2. Получите список серверов BareMetal в каталоге по умолчанию:

   yc baremetal server list
   

   Результат:

   +----------------------+---------------+---------+-------+---------------------+
   |          ID          |      NAME     | STATUS  | DISKS |     CREATED AT      |
   +----------------------+---------------+---------+-------+---------------------+
   | ly5zeaqeklpg******** | sample-server | RUNNING |       | 2026-05-15 11:46:38 |
   +----------------------+---------------+---------+-------+---------------------+
   

3. Определите интерфейс сервера, который поддерживает подключение как к приватной, так и к публичной сети. Алгоритм действий будет зависеть от типа конфигурации сервера (готовая или своя):

   Готовая конфигурация

   Своя конфигурация

   1. Получите подробную информацию о сервере, указав его имя или идентификатор:

      yc baremetal server get sample-server
      

      Результат:

      id: ly5zeaqeklpg********
      ...
      network_interfaces:
        - private_subnet:
            private_subnet_id: ly5lpb2vydo7********
          private_interface:
            native_subnet_id: ly5lpb2vydo7********
            mac_limit: "5"
          id: ly5zjjc2vfpi********
          mac_address: b4:2e:99:58:2b:a6
          configuration_network_interface_id: ly5oc5p4u6vg********
        - private_subnet:
            private_subnet_id: ly5lpb2vydo7********
          private_interface:
            native_subnet_id: ly5lpb2vydo7********
            mac_limit: "5"
          id: ly5mzklkjpa5********
          mac_address: b4:2e:99:58:2b:a8
          configuration_network_interface_id: ly5dmh2u3qwe********
      configuration_id: ly5tdlrmwezt********
      created_at: "2026-05-15T11:46:38.842525Z"
      

      Как видно из результата, на сервере установлены два сетевых интерфейса, оба из которых подключены к приватной сети (приватная подсеть ly5lpb2vydo7********):

      • интерфейс с идентификатором ly5zjjc2vfpi********, которому соответствует конфигурация сетевого интерфейса с идентификатором ly5oc5p4u6vg********;
      • интерфейс с идентификатором ly5mzklkjpa5********, которому соответствует конфигурация сетевого интерфейса с идентификатором ly5dmh2u3qwe********;

      Идентификатор конфигурации сервера (configuration_id) — ly5tdlrmwezt********. Сохраните это значение, оно понадобится при выполнении следующей команды.

   2. Получите подробную информацию о конфигурации сервера, чтобы выяснить, какой из двух сетевых интерфейсов поддерживает подключение к разным типам сетей (PRIVATE,PUBLIC). Для этого выполните команду, указав сохраненный ранее идентификатор конфигурации сервера:

      yc baremetal configuration get ly5tdlrmwezt********
      

      Результат:

      id: ly5tdlrmwezt********
      name: LA-i107-S-1/10G
      memory_gib: "16"
      cpu:
        name: Xeon D-1521
        vendor: Intel
        cores: "8"
        physical_cores: "4"
        frequency_mhz: "2400"
      disk_drives:
        - type: SSD
          disk_count: "2"
          disk_size_gib: "838"
      network_capacity_gbps: "10"
      cpu_num: "1"
      network_interfaces:
      - id: ly5oc5p4u6vg********
        name: iface0
        configuration_id: ly5tdlrmwezt********
        link_speed_gbps: '1'
        available_modes:
        - PRIVATE
      - id: ly5dmh2u3qwe********
        name: iface1
        configuration_id: ly5tdlrmwezt********
        link_speed_gbps: '1'
        available_modes:
        - PUBLIC
        - PRIVATE
      

      Как видно из результата, для указанной конфигурации сервера подключение к приватной и публичной сети (PRIVATE,PUBLIC) поддерживает интерфейс с идентификатором конфигурации сетевого интерфейса ly5dmh2u3qwe********.

      Как видно из результата команды yc baremetal server get, полученного ранее, идентификатору конфигурации сетевого интерфейса ly5dmh2u3qwe******** соответствует сетевой интерфейс сервера с идентификатором ly5mzklkjpa5********. Следовательно, изменить тип привязанной сети можно только для этого интерфейса.

   1. Получите подробную информацию о сервере, указав его имя или идентификатор:

      yc baremetal server get sample-server
      

      Результат:

      id: ly5zeaqeklpg********
      ...
      network_interfaces:
        - private_subnet:
            private_subnet_id: ly5lpb2vydo7********
          private_interface:
            native_subnet_id: ly5lpb2vydo7********
            mac_limit: "5"
          id: ly5zjjc2vfpi********
          mac_address: b4:2e:99:58:2b:a6
          configuration_network_interface_id: ly5oc5p4u6vg********
        - private_subnet:
            private_subnet_id: ly5lpb2vydo7********
          private_interface:
            native_subnet_id: ly5lpb2vydo7********
            mac_limit: "5"
          id: ly5mzklkjpa5********
          mac_address: b4:2e:99:58:2b:a8
          configuration_network_interface_id: ly5dmh2u3qwe********
      configuration:
        custom_configuration:
          cpu:
            cores: "8"
            frequency_mhz: "2600"
            name: Xeon E5-2650V2
            physical_cores: "8"
            vendor: Intel
          cpu_num: "2"
          disk_drives:
            - disk_count: "2"
              disk_size_gib: "3725"
              type: HDD
          id: ly5x6w3htlgx********
          memory_gib: "128"
          mounting_availability: UNAVAILABLE
          name: custom-ly5x6w3htlgx********
          network_capacity_gbps: "1"
          network_interfaces:
            - id: ly5oc5p4u6vg********
              name: iface0
              configuration_id: ly5x6w3htlgx********
              link_speed_gbps: '1'
              available_modes:
                - PRIVATE
            - id: ly5dmh2u3qwe********
              name: iface1
              configuration_id: ly5x6w3htlgx********
              link_speed_gbps: '1'
              available_modes:
                - PRIVATE
                - PUBLIC
      created_at: "2026-05-18T07:42:32.835148Z"
      

      Как видно из результата:

      • На сервере установлены (раздел network_interfaces) два сетевых интерфейса, оба из которых подключены к приватной сети (приватная подсеть ly5lpb2vydo7********):

        • интерфейс с идентификатором ly5zjjc2vfpi********, которому соответствует конфигурация сетевого интерфейса с идентификатором ly5oc5p4u6vg********;
        • интерфейс с идентификатором ly5mzklkjpa5********, которому соответствует конфигурация сетевого интерфейса с идентификатором ly5dmh2u3qwe********;

      • Конфигурация сетевого интерфейса (раздел configuration.custom_configuration.network_interfaces), позволяющая подключаться к разным типам сетей (PRIVATE,PUBLIC), имеет идентификатор (значение поля id) ly5dmh2u3qwe********.

      • В разделе network_interfaces идентификатору конфигурации сетевого интерфейса ly5dmh2u3qwe******** по значению поля configuration_network_interface_id соответствует сетевой интерфейс сервера с идентификатором ly5mzklkjpa5********. Следовательно, изменить тип привязанной сети можно только для этого интерфейса.

4. Получите список подсетей, к которым можно привязать сетевой интерфейс сервера в каталоге по умолчанию:

   Важно

   Сервер и подключаемые к нему приватные подсети должны относиться к одному пулу серверов.

   Подключить публичную сеть

   Подключить приватную сеть

   Если сетевой интерфейс нужно подключить к публичной сети, получите список публичных подсетей, выполнив команду:

   yc baremetal public-subnet list
   

   Результат:

   +----------------------+------+---------------+-------------------+
   |          ID          | NAME |    ZONE-ID    | HARDWARE-POOL-IDS |
   +----------------------+------+---------------+-------------------+
   | ly57sgipg23b******** |      | ru-central1-m | ru-central1-m4    |
   +----------------------+------+---------------+-------------------+
   

   Если сетевой интерфейс нужно подключить к приватной сети, получите список приватных подсетей, выполнив команду:

   yc baremetal private-subnet list
   

   Результат:

   +----------------------+----------------------+--------+--------------------------------+
   |          ID          |         NAME         | STATUS |          VRF-OPTIONS           |
   +----------------------+----------------------+--------+--------------------------------+
   | ly5lpb2vydo7******** | m4-subnet            | READY  | vrf_id: ly5xox6z2fyn********,  |
   |                      |                      |        | cidr: 192.168.20.0/24,         |
   |                      |                      |        | gateway_ip: 192.168.20.1       |
   | ly5v3mfr4bm5******** | m3-subnet            | READY  | vrf_id: ly5xox6z2fyn********,  |
   |                      |                      |        | cidr: 192.168.21.0/24,         |
   |                      |                      |        | gateway_ip: 192.168.21.1,      |
   |                      |                      |        | start_ip: 192.168.21.1,        |
   |                      |                      |        | end_ip: 192.168.21.254         |
   +----------------------+----------------------+--------+--------------------------------+
   

5. Измените тип сети, подключенной к сетевому интерфейсу сервера, указав идентификатор сервера, идентификаторы обоих сетевых интерфейсов и подсетей, которые должны быть к ним привязаны:

   Примечание

   Чтобы изменить тип сети, подключенной к сетевому интерфейсу сервера BareMetal, необходима роль baremetal.editor или выше.

   Подключить публичную сеть

   Подключить приватную сеть

   В приведенном примере сетевой интерфейс, поддерживающий подключение к разным типам сетей, подключается к публичной сети, а настройки другого интерфейса остаются без изменений:

   yc baremetal server update \
     --id=ly5zeaqeklpg******** \
     --network-interfaces='id=ly5zjjc2vfpi********,private-subnet-id=ly5lpb2vydo7********' \
     --network-interfaces='id=ly5mzklkjpa5********,public-subnet-id=ly57sgipg23b********' \
     --async
   

   В приведенном примере сетевой интерфейс, поддерживающий подключение к разным типам сетей, подключается к приватной сети, а настройки другого интерфейса остаются без изменений:

   yc baremetal server update \
     --id=ly5zeaqeklpg******** \
     --network-interfaces='id=ly5zjjc2vfpi********,private-subnet-id=ly5lpb2vydo7********' \
     --network-interfaces='id=ly5mzklkjpa5********,private-subnet-id=ly5lpb2vydo7********' \
     --async
   

   Результат:

   id: ly5mroq72gok********
   description: Server update
   created_at: "2026-05-18T05:44:28.751844Z"
   created_by: ajeol2afu1js********
   modified_at: "2026-05-18T05:44:28.751844Z"
   metadata:
     '@type': type.googleapis.com/yandex.cloud.baremetal.v1alpha.UpdateServerMetadata
     server_id: ly5zeaqeklpg********
   

6. Дождитесь завершения операции (обычно занимает около пяти минут) и повторно получите информацию о сервере, чтобы убедиться, что сеть, к которой подключен интерфейс, была изменена:

   yc baremetal server get sample-server
   

   Результат:

   id: ly5zeaqeklpg********
   ...
   network_interfaces:
     - private_subnet:
         private_subnet_id: ly5lpb2vydo7********
       private_interface:
         native_subnet_id: ly5lpb2vydo7********
         mac_limit: "5"
       id: ly5zjjc2vfpi********
       mac_address: b4:2e:99:58:2b:a6
       configuration_network_interface_id: ly5oc5p4u6vg********
     - public_subnet:
         public_subnet_id: ly57sgipg23b********
       public_interface:
         ip_address: 185.184.***.***
         native_subnet_id: ly57sgipg23b********
         mac_limit: "5"
       id: ly5mzklkjpa5********
       mac_address: b4:2e:99:58:2b:a8
       ip_address: 185.184.***.***
       configuration_network_interface_id: ly5dmh2u3qwe********
   ...