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

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

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

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

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

   yc baremetal v2 server create --help
   

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

   yc baremetal configuration list \
     --folder-id <идентификатор_каталога>
   

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

   +----------------------+---------------------+-----------+--------------------------------+--------------------------------+-------------------------+---------+
   |          ID          |        NAME         | MEMORYGIB |              CPU               |          DISK DRIVES           | NETWORK BМANDWIDTH GBPS | CPU NUM |
   +----------------------+---------------------+-----------+--------------------------------+--------------------------------+-------------------------+---------+
   | ly577w5sepew******** | LA-i108-S-1/10G     |        32 | physical cores: 4, mhz: 2400,  | [ type: SSD count: 2 size_gib: |                      10 |       1 |
   |                      |                     |           | name: Xeon D-1521, vendor:     | 838 ]                          |                         |         |
   |                      |                     |           | Intel                          |                                |                         |         |
   | ly5tdlrmwezt******** | LA-i107-S-1/10G     |        16 | physical cores: 4, mhz: 2400,  | [ type: SSD count: 2 size_gib: |                      10 |       1 |
   |                      |                     |           | name: Xeon D-1521, vendor:     | 838 ]                          |                         |         |
   |                      |                     |           | Intel                          |                                |                         |         |
   | ly527jeaz2nb******** | BA-i202-S           |       128 | physical cores: 8, mhz: 2600,  | [ type: SSD count: 2 size_gib: |                       1 |       2 |
   |                      |                     |           | name: Xeon E5-2650V2, vendor:  | 838 ]                          |                         |         |
   |                      |                     |           | Intel                          |                                |                         |         |
   ...
   ...
   | ly52arjxxbl3******** | LA-i114-S           |        64 | physical cores: 8, mhz: 2200,  | [ type: SSD count: 2 size_gib: |                       1 |       2 |
   |                      |                     |           | name: Xeon E5-2660, vendor:    | 838 ]                          |                         |         |
   |                      |                     |           | Intel                          |                                |                         |         |
   +----------------------+---------------------+-----------+--------------------------------+--------------------------------+-------------------------+---------+
   

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

   yc baremetal configuration get <идентификатор_конфигурации>
   

   Результат:

   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
   

4. Получите список периодов аренды:

   yc baremetal v2 rental-period list
   

5. Получите список публичных образов ОС, доступных в Marketplace:

   yc baremetal v2 image list \
     --folder-id baremetal-standard-images
   

6. Получите список приватных подсетей в каталоге:

   yc baremetal v2 private-subnet list \
     --folder-id <идентификатор_каталога>
   

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

   yc baremetal v2 server create \
     --folder-id <идентификатор_каталога> \
     --server '{
       name="<имя_сервера>",
       description="<описание_сервера>",
       hardware-pool-id="<пул>",
       configuration=stock-configuration-id="<идентификатор_конфигурации>",
       next-rental-period-id="<период_аренды>",
       os-settings={
         image-id="<идентификатор_образа>",
         ssh-key=ssh-public-key-text="<содержимое_открытого_SSH-ключа>",
         password=password-plain-text="<пароль_пользователя>",
         storages=[{
           partitions=[{
             type=<файловая_система>,
             size-bytes=<размер_раздела_в_байтах>,
             mount-point="<точка_монтирования>"
           }],
           storage-type=raid={
             type=<уровень_RAID-массива>,
             disks=[{id="<номер_диска>",size-bytes=<размер_диска_в_байтах>,type=<тип_диска>}]
           }
         }]
       },
       network-interfaces=[
         {interface=private-interface={native-subnet-id="<идентификатор_приватной_подсети>"}},
         {interface=public-interface={native-subnet-config=native-subnet={subnet-id="<идентификатор_публичной_подсети>"}}}
       ],
       annotations={<ключ_метки>="<значение_метки>"}
     }'
   

   Где:

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

   • configuration — конфигурация сервера в объекте --server. Для готовой конфигурации укажите ее идентификатор в поле stock-configuration-id.

   • os-settings — настройки операционной системы. При аренде сервера укажите их в объекте --server, при переустановке ОС — в параметре --os-settings. Чтобы арендовать сервер без операционной системы, не передавайте поле os-settings. Возможные настройки:

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

     • ssh-key — SSH-ключ для подключения к серверу:

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

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

       • password-plain-text — пароль в открытом виде.

         Важно

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

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

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

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

   • storages — настройки разметки дисков в объекте os-settings. Необязательная настройка: если ее не передать, будет использована разметка по умолчанию для выбранной конфигурации. Возможные значения:

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

       • type — файловая система. Возможные значения: EXT3, EXT4, SWAP, XFS.
       • size-bytes — размер раздела в байтах.
       • mount-point — точка монтирования.

     • storage-type — тип хранилища:

       • disk — отдельный диск:

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

       • raid — RAID-массив:

         • type — уровень RAID-массива.
         • disks — список дисков в RAID-массиве.

   • next-rental-period-id — идентификатор периода аренды сервера в объекте --server. Получить доступные значения можно командой yc baremetal v2 rental-period list.

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

   • network-interfaces — список сетевых интерфейсов в объекте --server. В поле interface каждого элемента укажите один из вариантов:

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

     Важно

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

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

   • --server — параметры создаваемого сервера в объектном синтаксисе. Кроме перечисленных выше полей, в объекте можно указать:

     • name — имя сервера.
     • description — описание сервера. Необязательное поле.
     • annotations — метки сервера в формате {ключ="значение"}. Необязательное поле.

Чтобы арендовать сервер, воспользуйтесь методом 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.