Заказать выделенную публичную подсеть

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

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

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

   yc baremetal public-subnet create --help
   

2. Арендуйте подсеть:

   yc baremetal public-subnet create \
     --hardware-pool-id <пул> \
     --prefix-length 29 \
     --name <имя_публичной_подсети> \
     --description "<описание_публичной_подсети>" \
     --labels <ключ>=<значение>
   

   Где:

   • --hardware-pool-id — пулы, в которых будет доступна подсеть.

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

   • --prefix-length — размер заказываемой подсети.

     Можно заказать только подсети размером /29 (шесть доступных IP-адресов) и /28 (четырнадцать доступных IP-адресов).

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

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

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

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

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

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

   yc baremetal public-subnet update --help
   

2. Преобразуйте подсеть:

   yc baremetal public-subnet update \
     --id <идентификатор_публичной_эфимерной_подсети> \
     --type dedicated \
     --hardware-pool-id <пул> \
     --name <имя_публичной_подсети> \
     --description "<описание_публичной_подсети>" \
     --labels <ключ>=<значение>
   

   Где:

   • --id — идентификатор эфимерной публичной подсети.

   • --type — тип, в который преобразуется подсеть.

   • --hardware-pool-id — пулы, в которых будет доступна подсеть.

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

   • --name — имя подсети.

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

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

Чтобы преобразовать эфемерную публичную подсеть в выделенную, воспользуйтесь методом REST API update для ресурса PublicSubnet или вызовом gRPC API PublicSubnetService/Update.

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <IAM-токен>" \
  -d '{
    "folderId": "b1g07hj5r6i4********",
    "name": "new-public-subnet",
    "description": "New public subnet",
    "hardwarePoolIds": [
      "ru-central1-m3"
    ],
    "prefixLength": "29",
    "labels": {
      "key": "public-subnet"
    }
  }' \
  "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/publicSubnets"

Где:

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

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

• hardwarePoolIds — идентификаторы пулов.

• prefixLength — размер заказываемой подсети.

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

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

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

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

Результат:

{
  "done": true,
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.CreatePublicSubnetMetadata",
    "publicSubnetId": "ly52xefxa2hi********"
  },
  "response": {
    "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.PublicSubnet",
    "id": "ly52xefxa2hi********",
    "cloudId": "b1gia87mbaom********",
    "folderId": "b1g07hj5r6i4********",
    "name": "new-public-subnet",
    "description": "New public subnet",
    "zoneId": "ru-central1-m",
    "hardwarePoolId": "ru-central1-m3",
    "type": "EPHEMERAL",
    "prefixLength": "29",
    "cidr": "10.0.*.*/29",
    "dhcpOptions": {
        "startIp": "10.0.*.*",
        "endIp": "10.0.*.*"
      },
    "gatewayIp": "10.0.*.*"
    "createdAt": "2025-12-14T14:42:58.372557Z"
    "labels": {
      "env": "test"
    },
  "id": "ly5hcnsbx3l4********",
  "description": "Public subnet create",
  "createdAt": "2025-12-14T14:42:58.375290Z",
  "createdBy": "ajeb9l33h6mu********",
  "modifiedAt": "2025-12-14T14:42:58.375290Z"
}

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

curl -X PATCH \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer <IAM-токен>" \
  -d '{
    "updateMask": "type,hardwarePoolIds,name,description",
    "type": "DEDICATED",
    "hardwarePoolIds": ["ru-central1-m3"],
    "name": "transformed-public-subnet",
    "description": "Transformed dedicated public subnet"
  }' \
  "https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/publicSubnets/<идентификатор_подсети>"

Где:

• updateMask — список параметров для обновления, разделенный запятыми.

• type — новый тип подсети. Значение DEDICATED для преобразования в выделенную подсеть.

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

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

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

Результат:

{
  "done": true,
  "metadata": {
    "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.CreatePublicSubnetMetadata",
    "publicSubnetId": "ly52xefxa2hi********"
  },
  "response": {
    "@type": "type.googleapis.com/yandex.cloud.baremetal.v1alpha.PublicSubnet",
    "id": "ly52xefxa2hi********",
    "cloudId": "b1gia87mbaom********",
    "folderId": "b1g07hj5r6i4********",
    "name": "new-public-subnet",
    "description": "New public subnet",
    "zoneId": "ru-central1-m",
    "hardwarePoolId": "ru-central1-m3",
    "type": "DEDICATED",
    "prefixLength": "29",
    "cidr": "10.0.*.*/29",
    "dhcpOptions": {
        "startIp": "10.0.*.*",
        "endIp": "10.0.*.*"
      },
    "gatewayIp": "10.0.*.*"
    "createdAt": "2025-12-14T14:42:58.372557Z"
    "labels": {
      "env": "test"
    },
  "id": "ly5hcnsbx3l4********",
  "description": "Public subnet create",
  "createdAt": "2025-12-14T14:42:58.375290Z",
  "createdBy": "ajeb9l33h6mu********",
  "modifiedAt": "2025-12-14T14:42:58.375290Z"
}

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