Арендовать сервер в готовой конфигурации

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

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

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

   yc baremetal server create --help
   

2. Получите список конфигураций:

   yc baremetal configuration list
   

3. Арендуйте сервер:

   yc baremetal server create \
     --hardware-pool-id <пул> \
     --configuration-id <идентификатор_конфигурация> \
     --storage "partition={type=<файловая_система>,size-gib=<размер_раздела>,mount-point=<точка_монтирования>},raid-type=<уровень RAID-массива>,disk={id=<номер_диска>,size-gib=<размер_диска>,type=<тип_диска>}" \
     --os-settings "image-id=<идентификатор_образа>,image-name=<имя_образа>,ssh-key-public=<содержимое_открытого_SSH-ключа>,ssh-key-user-id=<идентификатор_пользователя_SSH-ключа>,password-plain-text=<пароль_пользователя>,password-lockbox-secret={secret-id=<идентификатор_секрета>,version-id=<версия_секрета>,key=<ключ_секрета>}" \
     --rental-period-id <период_аренды> \
     --network-interfaces private-subnet-id=<идентификатор_приватной_подсети> \
     --network-interfaces public-subnet-id=<идентификатор_публичной_подсети> \
     --name <имя_сервера> \
     --description "<описание_сервера>" \
     --labels <ключ_метки>=<значение_метки>
   

   Где:

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

   • --configuration-id — идентификатор конфигурации сервера.

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

     • partition — раздел диска:

       • type — файловая система. Возможные значения: Ext3, Ext4, Swap, Xfs.
       • size-gib — размер раздела в гигабайтах.
       • mount-point — точка монтирования.

     • disk — диск:

       • id — номер диска.
       • size-gib — размер диска в гигабайтах.
       • type — тип диска

     • raid-type — уровень RAID-массива.

   • --os-settings — настройки операционной системы. Чтобы арендовать сервер без операционной системы, пропустите этот параметр. Возможные настройки:

     • image-id — идентификатор одного из доступных публичных образов ОС в Yandex Cloud Marketplace.

     • image-name — имя одного из доступных публичных образов ОС в Yandex Cloud Marketplace.

     • ssh-key-public — содержимое открытого SSH-ключа. Пару SSH-ключей для подключения к серверу по SSH необходимо создать самостоятельно.

     • ssh-key-user-id — идентификатор пользователя SSH-ключа.

     • password-plain-text — пароль root-пользователя.

       Важно

       Этот вариант предусматривает ответственность пользователя за безопасность пароля. Сохраните сгенерированный пароль в надежном месте: он не сохраняется в Yandex Cloud, и после заказа сервера вы не сможете посмотреть его.

     • password-lockbox-secret — секрет Yandex Lockbox:

       • secret-id — идентификатор секрета.
       • version-id — версия секрета.
       • key — ключ секрета.

     Установить операционную систему из собственного ISO-образа вы сможете позднее.

   • --rental-period-id — период аренды сервера. Возможные значения: 1 day, 1 month, 3 months, 6 months или 1 year.

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

   • --network-interfaces — сетевые настройки:

     • private-subnet-id — идентификатор приватной подсети.
     • public-subnet-id — идентификатор выделенной публичной подсети. Необязательный параметр.

     Важно

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

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

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

curl -X POST \
 -H "Content-Type: application/json" \
 -H "Authorization: Bearer <IAM-токен>" \
 -d '{
   "folderId": "b1g07hj5r6i4********",
   "name": "bm-test-server",
   "description": "New Test Baremetal Server",
   "hardwarePoolId": "ru-central1-m3",
   "configurationId": "ly5fcdnlzp7j********",
   "rentalPeriodId": "1-day",
   "networkInterfaces": [
     {
       "privateSubnet": {
         "privateSubnetId": "ly52xefxa2hi********"
       }
     },
     {
       "publicSubnet": {
         "publicSubnetId": "ly52yjugkj57********"
       }
     }
   ],
   "osSettingsSpec": {
     "imageId": "ly5vyzcggvci********",
     "storages": [
       {
         "partitions": [
           {
             "type": "EXT3",
             "sizeGib": "9",
             "mountPoint": "/boot"
           },
           {
             "type": "SWAP",
             "sizeGib": "4"
           },
           {
             "type": "EXT4",
             "mountPoint": "/"
           }
         ],
         "raid": {
           "type": "RAID10",
           "disks": [
             {
               "id": "1",
               "type": "HDD",
               "sizeGib": "1862"
             },
             {
               "id": "2",
               "type": "HDD",
               "sizeGib": "1862"
             },
             {
               "id": "3",
               "type": "HDD",
               "sizeGib": "1862"
             },
             {
               "id": "4",
               "type": "HDD",
               "sizeGib": "1862"
             }
           ]
         }
       }
     ],
     "sshPublicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMYMj0PbB7ObhwL0********",
     "passwordLockboxSecret": {
       "secretId": "e6q44i0gmlrh********",
       "versionId": "e6q3ba84ur0a********",
       "key": "password"
     }
   },
   "labels": {
     "key": "bms"
   }
 }' \
 "POST https://baremetal.api.cloud.yandex.net/baremetal/v1alpha/servers/<идентификатор_сервера>"

Где:

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

• name — имя сервера. Имя должно быть уникальным в рамках каталога.

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

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

• labels — метки ресурса в формате ключ:значение. Необязательный параметр.

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

• configurationId — идентификатор конфигурации сервера.

• rentalPeriodId — период аренды сервера. Возможные значения: 1-day, 1-month, 3-months, 6-months или 1-year.

• networkInterfaces[] — сетевые интерфейсы:

  • id — идентификатор сетевого интерфейса. Не указывается при создании сервера.

  • privateSubnetId — идентификатор приватной подсети.

  • publicSubnetId — идентификатор выделенной публичной подсети. Необязательный параметр.

    Важно

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

• osSettingsSpec — настройки операционной системы. Чтобы арендовать сервер без операционной системы, пропустите этот параметр.
  Возможные настройки:

  • imageId — идентификатор одного из доступных публичных образов ОС в Yandex Cloud Marketplace.

  • storages[] — настройки разметки дисков. Необязательный параметр. Возможные настройки:

    • partitions[] — раздел диска:
      • type — файловая система. Возможные значения: EXT4, EXT3, SWAP, XFS.
      • sizeGib — размер раздела в гигабайтах.
      • mountPoint — точка монтирования.
    • disk — настройки диска:
      • id — идентификатор диска.
      • type — тип диска. Возможные значения: HDD, SSD, NVME.
      • sizeGib — размер диска в гигабайтах.
    • raid — настройки RAID-массива:
      • type — тип RAID. Возможные значения: RAID0, RAID1, RAID10.
      • disks[] — массив дисков в RAID-конфигурации. Каждый диск содержит поля id, type и sizeGib.

  • sshPublicKey — содержимое открытого SSH-ключа. Пару SSH-ключей для подключения к серверу по SSH необходимо создать самостоятельно.

  • userSshId — идентификатор пользователя SSH-ключа. Необязательный параметр.

  • passwordPlainText — пароль root-пользователя. Необязательный параметр.

    Важно

    Этот вариант предусматривает ответственность пользователя за безопасность пароля. Сохраните сгенерированный пароль в надежном месте: он не сохраняется в Yandex Cloud, и после заказа сервера вы не сможете посмотреть его.

  • passwordLockboxSecret — секрет Yandex Lockbox:

    • secretId — идентификатор секрета.
    • versionId — версия секрета.
    • key — ключ секрета.

Результат:

{
  "id": "e0q5abc123def4********",
  "description": "Server create",
  "createdAt": "2025-12-14T18:03:38.240Z",
  "createdBy": "ajeb9l33h6mu********",
  "modifiedAt": "2025-12-14T18:03:38.240Z",
  "done": true,
  "metadata": {
    "serverId": "ly56xpblirh4********"
  },
  "response": {
    "id": "ly56xpblirh4********",
    "cloudId": "b1g07hj5r6i4********",
    "folderId": "b1g07hj5r6i4********",
    "name": "bm-test-server",
    "description": "New Test Baremetal Server",
    "zoneId": "ru-central1",
    "hardwarePoolId": "ru-central1-m3",
    "status": "PROVISIONING",
    "osSettings": {
      "imageId": "ly5vyzcggvci********",
      "sshPublicKey": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIMYMj0PbB7ObhwL0z3********",
      "storages": [
        {
          "partitions": [
            {
              "type": "EXT3",
              "sizeGib": "9",
              "mountPoint": "/boot"
            },
            {
              "type": "SWAP",
              "sizeGib": "4"
            },
            {
              "type": "EXT4",
              "mountPoint": "/"
            }
          ],
          "raid": {
            "type": "RAID10",
            "disks": [
              {
                "id": "1",
                "type": "HDD",
                "sizeGib": "1862"
              },
              {
                "id": "2",
                "type": "HDD",
                "sizeGib": "1862"
              },
              {
                "id": "3",
                "type": "HDD",
                "sizeGib": "1862"
              },
              {
                "id": "4",
                "type": "HDD",
                "sizeGib": "1862"
              }
            ]
          }
        }
      ]
    },
    "networkInterfaces": [
      {
        "id": "e0q5abc123def4********",
        "macAddress": "00:1a:4b:23:*:*",
        "ipAddress": "192.168.*.*",
        "privateSubnet": {
          "privateSubnetId": "ly52xefxa2hi********"
        }
      },
      {
        "id": "e0q5abc123def4********",
        "macAddress": "00:1a:4b:23:*:*",
        "ipAddress": "93.158.*.*",
        "publicSubnet": {
          "publicSubnetId": "ly52yjugkj57********"
        }
      }
    ],
    "configurationId": "ly5fcdnlzp7j********",
    "disks": [
      {
        "id": "1",
        "type": "HDD",
        "sizeGib": "1862"
      },
      {
        "id": "2",
        "type": "HDD",
        "sizeGib": "1862"
      },
      {
        "id": "3",
        "type": "HDD",
        "sizeGib": "1862"
      },
      {
        "id": "4",
        "type": "HDD",
        "sizeGib": "1862"
      }
    ],
    "createdAt": "2025-12-14T18:03:38.240Z",
    "labels": {
      "key": "bms"
    }
  }
}

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