Yandex Cloud
КейсыДокументация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»
Yandex BareMetal
    • Все инструкции
      • Арендовать сервер в стандартной конфигурации
      • Арендовать сервер в своей конфигурации
      • Получить информацию о сервере
      • Изменить сервер
      • Подключиться к KVM-консоли
      • Остановить и запустить сервер
      • Отказаться от аренды сервера
      • Восстановить сервер из карантина
      • Создать загрузочный образ
      • Подключить существующий сервер BareMetal к Cloud Backup
      • Воспользоваться Rescue-CD
      • Настроить дополнительную приватную подсеть
      • Изменить тип сети, подключенной к сетевому интерфейсу
      • Настроить группу агрегирования MC-LAG
      • Сбросить пароль на сервере
      • Заменить диск в RAID-массиве
      • Добавить новый SSH-ключ пользователя
      • Восстановить загрузчик ОС
      • Проанализировать состояние сервера с помощью HWCheck
    • Обзор сервиса
    • Интеграции с другими сервисами Yandex Cloud
      • Обзор
      • Готовые конфигурации серверов
      • Своя конфигурация сервера
      • Конфигурация сервера по запросу
      • Обзор
      • Extend: Virtualization
      • Extend: Yandex Cloud Stackland
      • Extend: Managed Service for Kubernetes®
      • Обзор
      • Публичная сеть
      • Приватная сеть
      • DHCP
      • DNS в приватной сети
      • MC-LAG
      • Ограничения в сетях BareMetal
      • Обзор
      • Образы в Yandex BareMetal
      • Управление доступом
      • Дополнительные настройки серверов
      • Консоль управления
      • Метрики Monitoring
    • Квоты и лимиты
  • Правила тарификации
  • История изменений
  • Вопросы и ответы
  1. Пошаговые инструкции
  2. Серверы
  3. Изменить тип сети, подключенной к сетевому интерфейсу

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

Статья создана
Yandex Cloud
Улучшена
mmerihsesh
Обновлена 10 ноября 2026 г.
Открыть в Markdown

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

Внимание

При изменении типа сети, к которой подключен сетевой интерфейс, физически этот интерфейс остается подключенным к тому же коммутатору уровня Leaf, к которому он был подключен ранее. Это означает, что при замене для интерфейса публичной сети на приватную доступ к приватной сети с использованием этого интерфейса будет осуществляться через коммутатор, к которому подключены публичные сетевые интерфейсы других серверов в данной стойке дата-центра.

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

Данное ограничение не относится к серверам с резервированием сетевого подключения MC-LAG.

Чтобы изменить тип сети, к которой подключен сетевой интерфейс:

CLI
API

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

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

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

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

    yc baremetal v2 server update --help
    
  2. Получите список серверов BareMetal в каталоге по умолчанию и сохраните идентификатор нужного сервера (server_id):

    yc baremetal v2 server list
    
  3. Получите подробную информацию о сервере, указав его идентификатор:

    yc baremetal v2 server get ly5zeaqeklpg******** --format yaml
    

    Пример результата:

    server_id: ly5zeaqeklpg********
    network_interfaces:
      - network_interface_id: ly5zjjc2vfpi********
        private_interface:
          native_subnet_id: ly5lpb2vydo7********
          mac_limit: "5"
        configuration_network_interface_id: ly5oc5p4u6vg********
      - network_interface_id: ly5mzklkjpa5********
        private_interface:
          native_subnet_id: ly5lpb2vydo7********
          mac_limit: "5"
        configuration_network_interface_id: ly5dmh2u3qwe********
    stock_configuration_id: ly5tdlrmwezt********
    

    В этом примере оба интерфейса подключены к приватной подсети ly5lpb2vydo7********. Сохраните значения network_interface_id и соответствующие им configuration_network_interface_id.

  4. Определите, какой интерфейс поддерживает подключение как к приватной, так и к публичной сети. Действия зависят от конфигурации сервера:

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

    Получите информацию о конфигурации, указав значение stock_configuration_id из предыдущего шага:

    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
    

    В списке network_interfaces найдите конфигурацию интерфейса, для которой available_modes содержит PRIVATE и PUBLIC. В примере это ly5dmh2u3qwe********.

    В результате команды yc baremetal v2 server get найдите список custom_configuration.network_interfaces:

    custom_configuration:
      configuration_id: ly5x6w3htlgx********
      network_interfaces:
        - id: ly5oc5p4u6vg********
          name: iface0
          available_modes:
            - PRIVATE
        - id: ly5dmh2u3qwe********
          name: iface1
          available_modes:
            - PRIVATE
            - PUBLIC
    

    Найдите конфигурацию интерфейса, для которой available_modes содержит PRIVATE и PUBLIC. В примере это ly5dmh2u3qwe********.

    Сопоставьте найденный идентификатор с полем configuration_network_interface_id в списке интерфейсов сервера. В примере ему соответствует интерфейс ly5mzklkjpa5********, для которого можно изменить тип сети.

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

    Важно

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

    Подключить публичную сеть
    Подключить приватную сеть
    yc baremetal v2 public-subnet list
    

    Сохраните идентификатор нужной подсети (public_subnet_id).

    yc baremetal v2 private-subnet list
    

    Сохраните идентификатор нужной подсети (private_subnet_id).

  6. Измените тип сети, указав идентификатор сервера и полный список его сетевых интерфейсов:

    Примечание

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

    В примерах первый интерфейс сохраняет подключение к приватной сети, а для второго меняется тип сети. Если у интерфейсов настроены дополнительные приватные подсети (vlan-subinterfaces) или пакет трафика (internet-traffic-plan), передайте и эти настройки, чтобы сохранить их.

    Подключить публичную сеть
    Подключить приватную сеть
    yc baremetal v2 server update \
      --id ly5zeaqeklpg******** \
      --update-mask network-interfaces \
      --server '{
        network-interfaces=[
          {
            network-interface-id="ly5zjjc2vfpi********",
            interface=private-interface={native-subnet-id="ly5lpb2vydo7********"}
          },
          {
            network-interface-id="ly5mzklkjpa5********",
            interface=public-interface={native-subnet-config=native-subnet={subnet-id="ly57sgipg23b********"}}
          }
        ]
      }' \
      --async
    
    yc baremetal v2 server update \
      --id ly5zeaqeklpg******** \
      --update-mask network-interfaces \
      --server '{
        network-interfaces=[
          {
            network-interface-id="ly5zjjc2vfpi********",
            interface=private-interface={native-subnet-id="ly5lpb2vydo7********"}
          },
          {
            network-interface-id="ly5mzklkjpa5********",
            interface=private-interface={native-subnet-id="ly5lpb2vydo7********"}
          }
        ]
      }' \
      --async
    

    Маска --update-mask network-interfaces ограничивает изменение сетевыми интерфейсами.

  7. Дождитесь завершения операции и повторно получите информацию о сервере:

    yc baremetal v2 server get ly5zeaqeklpg******** --format yaml
    

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

    network_interfaces:
      - network_interface_id: ly5zjjc2vfpi********
        private_interface:
          native_subnet_id: ly5lpb2vydo7********
      - network_interface_id: ly5mzklkjpa5********
        public_interface:
          native_subnet_id: ly57sgipg23b********
          ip_address: 185.184.***.***
    

Чтобы воспользоваться примерами, установите утилиту cURL и получите IAM-токен, необходимый для аутентификации в API Yandex Cloud.

Совет

Перед выполнением запросов из примеров удобнее сохранить IAM-токен в переменную окружения.

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

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

    curl \
      --request GET \
      --header "Authorization: Bearer <IAM-токен>" \
      "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/servers/<идентификатор_сервера>"
    

    Результат:

    {
      ...
      "networkInterfaces": [
        {
          "privateSubnet": {
            "privateSubnetId": "ly5lpb2vydo7********"
          },
          "privateInterface": {
            "nativeSubnetId": "ly5lpb2vydo7********",
            "macLimit": "5"
          },
          "id": "ly5zjjc2vfpi********",
          "macAddress": "b4:2e:99:58:2b:a6",
          "configurationNetworkInterfaceId": "ly5oc5p4u6vg********"
        },
        {
          "privateSubnet": {
            "privateSubnetId": "ly5lpb2vydo7********"
          },
          "privateInterface": {
            "nativeSubnetId": "ly5lpb2vydo7********",
            "macLimit": "5"
          },
          "id": "ly5mzklkjpa5********",
          "macAddress": "b4:2e:99:58:2b:a8",
          "configurationNetworkInterfaceId": "ly5dmh2u3qwe********"
        }
      ],
        "id": "ly5zeaqeklpg********",
        "cloudId": "b1gia87mbaom********",
        "folderId": "b1gt6g8ht345********",
        "name": "sample-server",
        "zoneId": "ru-central1-m",
        "hardwarePoolId": "ru-central1-m4",
        "status": "RUNNING",
        "configurationId": "ly5tdlrmwezt********",
        "createdAt": "2026-05-15T11:46:38.842525Z"
    }
    

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

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

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

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

    curl \
      --request GET \
      --header "Authorization: Bearer <IAM-токен>" \
      "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/configurations/ly5tdlrmwezt********"
    

    Результат:

    {
      "cpu": {
        "name": "Xeon D-1521",
        "vendor": "Intel",
        "cores": "8",
        "physicalCores": "4",
        "frequencyMhz": "2400"
      },
      "diskDrives": [
        {
          "type": "SSD",
          "diskCount": "2",
          "diskSizeGib": "838"
        }
      ],
      "id": "ly5tdlrmwezt********",
      "name": "LA-i107-S-1/10G",
      "memoryGib": "16",
      "networkCapacityGbps": "10",
      "cpuNum": "1",
      "networkInterfaces": [
        {
          "id": "ly5oc5p4u6vg********",
          "name": "iface0",
          "configurationId": "ly5tdlrmwezt********",
          "linkSpeedGbps": "1",
          "availableModes": [
            "PRIVATE"
          ]
        },
        {
          "id": "ly5dmh2u3qwe********",
          "name": "iface1",
          "configurationId": "ly5tdlrmwezt********",
          "linkSpeedGbps": "1",
          "availableModes": [
            "PRIVATE",
            "PUBLIC"
          ]
        }
      ],
      "mountingAvailability": "UNAVAILABLE"
    }
    

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

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

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

    curl \
      --request GET \
      --header "Authorization: Bearer <IAM-токен>" \
      "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/servers/<идентификатор_сервера>"
    

    Результат:

    {
      ...
      "networkInterfaces": [
        {
          "privateSubnet": {
            "privateSubnetId": "ly5lpb2vydo7********"
          },
          "privateInterface": {
            "nativeSubnetId": "ly5lpb2vydo7********",
            "macLimit": "5"
          },
          "id": "ly5zjjc2vfpi********",
          "macAddress": "b4:2e:99:58:2b:a6",
          "configurationNetworkInterfaceId": "ly5oc5p4u6vg********"
        },
        {
          "privateSubnet": {
            "privateSubnetId": "ly5lpb2vydo7********"
          },
          "privateInterface": {
            "nativeSubnetId": "ly5lpb2vydo7********",
            "macLimit": "5"
          },
          "id": "ly5mzklkjpa5********",
          "macAddress": "b4:2e:99:58:2b:a8",
          "configurationNetworkInterfaceId": "ly5dmh2u3qwe********"
        }
      ],
      "customConfiguration": {
        "id": "ly5vpv5ktwut********",
        "name": "custom-ly5vpv5ktwut********",
        "memoryGib": "128",
        "cpu": {
          "name": "Xeon E5-2650V2",
          "vendor": "Intel",
          "cores": "8",
          "physicalCores": "8",
          "frequencyMhz": "2600"
        },
        "diskDrives": [
          {
            "type": "HDD",
            "diskCount": "2",
            "diskSizeGib": "3725"
          }
        ],
        "cpuNum": "2",
        "networkInterfaces": [
          {
            "id": "ly5oc5p4u6vg********",
            "name": "iface0",
            "configurationId": "ly5vpv5ktwut********",
            "linkSpeedGbps": "1",
            "availableModes": [
              "PRIVATE"
            ]
          },
          {
            "id": "ly5dmh2u3qwe********",
            "name": "iface1",
            "configurationId": "ly5vpv5ktwut********",
            "linkSpeedGbps": "1",
            "availableModes": [
              "PRIVATE",
              "PUBLIC"
            ]
          }
        ],
        "mountingAvailability": "UNAVAILABLE"
      },
      "id": "ly5zeaqeklpg********",
      "cloudId": "b1gia87mbaom********",
      "folderId": "b1gt6g8ht345********",
      "name": "sample-server",
      "zoneId": "ru-central1-m",
      "hardwarePoolId": "ru-central1-m4",
      "status": "RUNNING",
      "createdAt": "2026-05-15T11:46:38.842525Z"
    }
    

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

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

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

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

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

    Примечание

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

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

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

    Выполните запрос, указав идентификаторы сервера, его сетевых интерфейсов и подсетей:

    Важно

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

    curl \
      --request PATCH \
      --header "Authorization: Bearer <IAM-токен>" \
      "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/servers/<идентификатор_сервера>" \
      --data \
              '''
              {
                "updateMask": {
                  "paths": [
                    "network_interfaces"
                  ]
                },
                "networkInterfaces": [
                  {
                    "id": "ly5zjjc2vfpi********",
                    "privateInterface": {
                      "nativeSubnetId": "ly5lpb2vydo7********"
                    }
                  },
                  {
                    "id": "ly5mzklkjpa5********",
                    "publicInterface": {
                      "nativeSubnet": {
                        "subnetId": "ly57sgipg23b********"
                      }
                    }
                  }
                ]
              }
              '''
    

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

    Выполните запрос, указав идентификаторы сервера, его сетевых интерфейсов и подсетей:

    Важно

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

    curl \
      --request PATCH \
      --header "Authorization: Bearer <IAM-токен>" \
      "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/servers/<идентификатор_сервера>" \
      --data \
              '''
              {
                "updateMask": {
                  "paths": [
                    "network_interfaces"
                  ]
                },
                "networkInterfaces": [
                  {
                    "id": "ly5zjjc2vfpi********",
                    "privateInterface": {
                      "nativeSubnetId": "ly5lpb2vydo7********"
                    }
                  },
                  {
                    "id": "ly5mzklkjpa55xikrktd",
                    "privateInterface": {
                      "nativeSubnetId": "ly5lpb2vydo7********"
                    }
                  }
                ]
              }
              '''
    

    Результат:

    {
      "done": false,
      "metadata": {
        "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.UpdateServerMetadata",
        "serverId": "ly5zeaqeklpg********"
      },
      "id": "ly56w27i7ehd********",
      "description": "Server update",
      "createdAt": "2026-05-18T18:28:52.058175Z",
      "createdBy": "ajeol2afu1js********",
      "modifiedAt": "2026-05-18T18:28:52.058175Z"
    }
    
  2. Дождитесь завершения операции (обычно занимает около пяти минут) и повторно получите информацию о сервере, чтобы убедиться, что сеть, к которой подключен интерфейс, была изменена.

Получить идентификатор сервера можно в консоли управления или с помощью команды Yandex Cloud CLI yc baremetal v2 server list.

  • Получить идентификаторы приватных подсетей можно в консоли управления или с помощью команды Yandex Cloud CLI yc baremetal v2 private-subnet list.
  • Получить идентификаторы публичных подсетей можно в консоли управления или с помощью команды Yandex Cloud CLI yc baremetal v2 public-subnet list.

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

Предыдущая
Настроить дополнительную приватную подсеть
Следующая
Настроить группу агрегирования MC-LAG
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Сделано на Gravity UI
Проект Яндекса
© 2026 ООО «Яндекс.Облако»