Создать приватную подсеть

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

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

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

   yc baremetal private-subnet create --help
   

2. Создайте подсеть:

   yc baremetal private-subnet create \
     --hardware-pool-id <пул> \
     --name <имя_приватной_подсети> \
     --description "<описание_приватной_подсети>" \
     --labels <ключ>=<значение> \
     --vrf-options "vrf-id=<идентификатор_VRF>,vrf-name=<имя_VRF>,cidr=<CIDR>,gateway-ip=<IP-адрес_шлюза>,dhcp=[start-ip=<начало_диапазона_IP-адресов>,end-ip=<конец_диапазона_IP-адресов>]"
   

   Где:

   • --hardware-pool-id — пул, из которого будет арендован сервер.

   • --name — имя подсети. Требования к имени:

     • длина — от 3 до 63 символов;
     • может содержать строчные буквы латинского алфавита, цифры и дефисы;
     • первый символ — буква, последний — не дефис.

   • --description — описание подсети. Необязательный параметр.

   • --labels — метки подсети. Необязательный параметр.

   • --vrf-options — настройки маршрутизации для взаимодействия с серверами из других пулов. Необязательный параметр. Возможные настройки:

     • vrf-id — идентификатор виртуального сегмента сети (VRF).

     • vrf-name — имя VRF.

     • cidr — CIDR подсети.

     • gateway-ip — IP-адрес шлюза, через который трафик из подсети будет идти в другие подсети, подключенные к VRF. Необязательный параметр.

       По умолчанию — это первый адрес из заданного CIDR диапазона подсети.

     • dhcp — диапазон адресов, из которого сетевым интерфейсам серверов могут назначаться IP-адреса по DHCP. Необязательный параметр.

       По умолчанию соответствует диапазону, заданному CIDR подсети.

Чтобы создать приватную подсеть, воспользуйтесь методом REST API create для ресурса PrivateSubnet или вызовом gRPC API PrivateSubnetService/Create.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <IAM-токен>" \
  -d '{
    "folderId": "b1g07hj5r6i4********",
    "hardwarePoolId": "ru-central1-m3",
    "name": "demo-private-subnet",
    "description": "My first private subnet",
    "labels": {
      "env": "test"
    },
    "vrfOptionsSpec": {
      "vrfId": "ly5uyq2gbxu2********",
      "cidr": "10.0.*.*/8",
      "dhcpOptions": {
        "startIp": "10.0.*.*",
        "endIp": "10.0.*.*"
      },
      "gatewayIp": "10.0.*.*"
    }
  }' \
  "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/privateSubnets"

Где:

• <IAM-токен> — IAM-токен для аутентификации.

• folderId — идентификатор каталога.

• hardwarePoolId — идентификатор пула, из которого будет арендован сервер.

• name — имя подсети. Требования к имени:

  • длина — от 3 до 63 символов;
  • может содержать строчные буквы латинского алфавита, цифры и дефисы;
  • первый символ — буква, последний — не дефис.

• description — описание подсети. Необязательный параметр.

• labels — метки подсети. Необязательный параметр.

• vrfId — идентификатор виртуального сегмента сети (VRF).

• cidr — CIDR подсети.

• gatewayIp — IP-адрес шлюза. Необязательный параметр.

• startIp, endIp — диапазон адресов для DHCP. Необязательный параметр.

Результат:

{
  "done": true,
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.CreatePrivateSubnetMetadata",
    "privateSubnetId": "ly52xefxa2hi********"
  },
  "response": {
    "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.PrivateSubnet",
    "vrfOptions": {
      "dhcpOptions":
      {
        "startIp": "10.0.*.*",
        "endIp": "10.0.*.*"
      },
      "vrfId": "ly5licxve4z3********",
      "cidr": "10.0.*.*/8",
      "gatewayIp": "10.0.*.*"
    },
    "labels": {
      "env": "test"
    },
    "id": "ly52xefxa2hi********",
    "cloudId": "b1gia87mbaom********",
    "folderId": "b1g07hj5r6i4********",
    "name": "demo-private-subnet",
    "description": "My first private subnet",
    "status": "READY",
    "zoneId": "ru-central1-m",
    "hardwarePoolId": "ru-central1-m3",
    "createdAt": "2025-12-14T14:42:58.372557Z"
  },
  "id": "ly5hcnsbx3l4********",
  "description": "Private subnet create",
  "createdAt": "2025-12-14T14:42:58.375290Z",
  "createdBy": "ajeb9l33h6mu********",
  "modifiedAt": "2025-12-14T14:42:58.375290Z"
}

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