Связаться с намиПодключиться

Управление виртуальными машинами пула резервов ВМ

Статья создана
Улучшена
Обновлена 22 августа 2025 г.

Важно

Пулы резервов ВМ тарифицируются: взимается плата за весь свободный объем зарезервированных вычислительных ресурсов ВМ, кластеров GPU и программно-ускоренных сетей согласно правилам тарификации Yandex Compute Cloud. Подробнее см. в разделе Использование пулов резервов ВМ.

Функциональность пулов резервов ВМ находится на стадии Preview.

Вы можете привязывать к пулам резервов ВМ как вновь создаваемые, так и существующие виртуальные машины. Подробнее см. в разделе Пулы резервов виртуальных машин.

Посмотреть список ВМ, привязанных к пулу

Чтобы посмотреть список виртуальных машин, привязанных к пулу резервов ВМ:

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

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

  1. Посмотрите описание команды Yandex Cloud CLI для создания ВМ:

    yc compute reserved-instance-pool list --help

  2. Получите список пулов резервов ВМ в каталоге по умолчанию:

    yc compute reserved-instance-pool list

    Результат:

    +----------------------+------------+---------------+------+
|          ID          |    NAME    |    ZONE ID    | SIZE |
+----------------------+------------+---------------+------+
| fv48qa9iiq19******** | test-pool1 | ru-central1-a |    1 |
| fv42fbsrso94******** | test-pool2 | ru-central1-a |    1 |
+----------------------+------------+---------------+------+

  3. Посмотрите список ВМ, привязанных к пулу, указав его имя или идентификатор:

    yc compute reserved-instance-pool list-instances <имя_или_идентификатор_пула>

    Результат:

    +----------------------+-------------------+---------------+---------+----------------+-------------+
|          ID          |       NAME        |    ZONE ID    | STATUS  |  EXTERNAL IP   | INTERNAL IP |
+----------------------+-------------------+---------------+---------+----------------+-------------+
| fv4mkphl5q09******** | my-sample-pool-vm | ru-central1-a | RUNNING | 158.160.***.** | 192.168.3.8 |
| fv4mfp4fj6f0******** | my-second-pool-vm | ru-central1-a | RUNNING | 158.165.***.** | 192.168.3.12 |
+----------------------+-------------------+---------------+---------+----------------+-------------+

Воспользуйтесь методом REST API ListInstances для ресурса ReservedInstancePool или вызовом gRPC API ReservedInstancePoolService/ListInstances, передав в поле reservedInstancePoolId (reserved_instance_pool_id для gRPC API) идентификатор нужного пула.

Создать новую ВМ с привязкой к пулу

Чтобы создать новую виртуальную машину в пуле резервов ВМ:

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

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

  1. Посмотрите описание команды Yandex Cloud CLI для создания ВМ:

    yc compute instance create --help

  2. Получите список пулов резервов ВМ в каталоге по умолчанию:

    yc compute reserved-instance-pool list

    Результат:

    +----------------------+------------+---------------+------+
|          ID          |    NAME    |    ZONE ID    | SIZE |
+----------------------+------------+---------------+------+
| fv48qa9iiq19******** | test-pool1 | ru-central1-a |    1 |
| fv42fbsrso94******** | test-pool2 | ru-central1-a |    1 |
+----------------------+------------+---------------+------+

  3. Создайте виртуальную машину в пуле резервов ВМ:

    yc compute instance create \
  --name <имя_ВМ> \
  --zone <идентификатор_зоны_доступности> \
  --reserved-instance-pool-id <идентификатор_пула> \
  --network-interface subnet-name=<имя_подсети>,nat-ip-version=ipv4 \
  --create-boot-disk image-folder-id=standard-images,image-id=<идентификатор_образа> \
  --ssh-key <путь_к_SSH-ключу>

    Где:

    • --name — имя создаваемой ВМ. Требования к имени:

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

    • --zone — идентификатор зоны доступности создаваемой ВМ. Зона доступности ВМ должна совпадать с зоной доступности пула.

    • --reserved-instance-pool-id — идентификатор пула, в котором создается виртуальная машина.

      Вместо идентификатора вы можете передать имя пула в параметре --reserved-instance-pool-name.

    • --network-interface — настройки сетевого интерфейса ВМ:

      • subnet-name — имя подсети в зоне доступности, совпадающей с зоной доступности ВМ и пула.
      • nat-ip-version=ipv4 — публичный IP-адрес. Чтобы создать ВМ без публичного IP-адреса, исключите параметр.

    • --create-boot-disk — настройки загрузочного диска ВМ:

      • image-id — идентификатор образа загрузочного диска ВМ. Например: идентификатор образа Ubuntu 24.04 LTS.

    • --ssh-key — путь к файлу с публичным SSH-ключом, например: ~/.ssh/id_ed25519.pub. Для этого ключа на ВМ будет автоматически создан пользователь yc-user.

      При создании ВМ из публичного образа Yandex Cloud Marketplace обязательно передавайте в ВМ SSH-ключ, поскольку доступ по протоколу SSH с использованием логина и пароля для таких образов по умолчанию отключен.

    Результат:
    done (34s)
id: fv4fjf9qbt57********
folder_id: b1gt6g8ht345********
created_at: "2025-05-07T07:46:34Z"
name: the-first-pool-vm
zone_id: ru-central1-a
platform_id: standard-v2
resources:
  memory: "2147483648"
  cores: "2"
  core_fraction: "100"
status: RUNNING
metadata_options:
  gce_http_endpoint: ENABLED
  aws_v1_http_endpoint: ENABLED
  gce_http_token: ENABLED
  aws_v1_http_token: DISABLED
boot_disk:
  mode: READ_WRITE
  device_name: fv4v5k7u3g3n********
  auto_delete: true
  disk_id: fv4v5k7u3g3n********
network_interfaces:
  - index: "0"
    mac_address: d0:0d:f9:bd:3a:5f
    subnet_id: fl8dmq91iruu********
    primary_v4_address:
      address: 192.168.7.7
      one_to_one_nat:
        address: 158.160.***.**
        ip_version: IPV4
serial_port_settings:
  ssh_authorization: OS_LOGIN
gpu_settings: {}
fqdn: fv4fjf9qbt57********.auto.internal
scheduling_policy: {}
network_settings:
  type: STANDARD
placement_policy: {}
hardware_generation:
  legacy_features:
    pci_topology: PCI_TOPOLOGY_V1
reserved_instance_pool_id: fv4k96kv52t7********

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

Подробнее о команде yc compute instance create читайте в справочнике Yandex Cloud CLI.

Воспользуйтесь методом REST API create для ресурса Instance или вызовом gRPC API InstanceService/Create, передав в поле reservedInstancePoolId (reserved_instance_pool_id для gRPC API) идентификатор нужного пула.

Привязать существующую ВМ к пулу

Чтобы привязать существующую ВМ к пулу резервов ВМ:

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

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

  1. Посмотрите описание команды Yandex Cloud CLI для изменения ВМ:

    yc compute instance update --help

  2. Получите список пулов резервов ВМ в каталоге по умолчанию:

    yc compute reserved-instance-pool list

    Результат:

    +----------------------+------------+---------------+------+
|          ID          |    NAME    |    ZONE ID    | SIZE |
+----------------------+------------+---------------+------+
| fv48qa9iiq19******** | test-pool1 | ru-central1-a |    1 |
| fv42fbsrso94******** | test-pool2 | ru-central1-a |    1 |
+----------------------+------------+---------------+------+

  3. Получите список ВМ в каталоге по умолчанию:

    yc compute instance list

    Результат:

    +----------------------+-----------------+---------------+---------+----------------------+
|          ID          |       NAME      |    ZONE ID    | STATUS  |     DESCRIPTION      |
+----------------------+-----------------+---------------+---------+----------------------+
| fhm0b28lgfp4******** | first-instance  | ru-central1-a | RUNNING | my first vm via CLI  |
| fhm9gk85nj7g******** | second-instance | ru-central1-a | RUNNING | my second vm via CLI |
+----------------------+-----------------+---------------+---------+----------------------+

  4. Привяжите нужную виртуальную машину к нужному пулу резервов ВМ:

    Примечание

    К пулу резервов ВМ нельзя привязать виртуальную машину с аппаратной конфигурацией (платформа, vCPU, RAM), отличной от конфигурации, которая задана в настройках пула.

    yc compute instance update \
  --id <идентификатор_ВМ> \
  --reserved-instance-pool-id <идентификатор_пула>

    Где:

    • --id — идентификатор привязываемой ВМ.

      Вместо идентификатора вы можете указать имя ВМ в параметре --name.

    • --reserved-instance-pool-id — идентификатор пула, к которому привязывается виртуальная машина.

      Вместо идентификатора вы можете передать имя пула в параметре --reserved-instance-pool-name.

    Результат:
    done (2s)
id: fhm0b28lgfp4********
folder_id: b1gt6g8ht345********
created_at: "2025-05-07T09:46:04Z"
name: first-instance
zone_id: ru-central1-a
platform_id: standard-v2
resources:
  memory: "2147483648"
  cores: "2"
  core_fraction: "100"
status: RUNNING
metadata_options:
  gce_http_endpoint: ENABLED
  aws_v1_http_endpoint: ENABLED
  gce_http_token: ENABLED
  aws_v1_http_token: DISABLED
boot_disk:
  mode: READ_WRITE
  device_name: fv45psom2l6o********
  auto_delete: true
  disk_id: fv45psom2l6o********
network_interfaces:
  - index: "0"
    mac_address: d0:0d:cb:b5:9e:bf
    subnet_id: fl8dmq91iruu********
    primary_v4_address:
      address: 192.168.7.5
      one_to_one_nat:
        address: 158.160.***.**
        ip_version: IPV4
serial_port_settings:
  ssh_authorization: OS_LOGIN
gpu_settings: {}
fqdn: fv4cndcunukt********.auto.internal
scheduling_policy: {}
network_settings:
  type: STANDARD
placement_policy: {}
hardware_generation:
  legacy_features:
    pci_topology: PCI_TOPOLOGY_V1
reserved_instance_pool_id: fv48qa9iiq19********

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

Подробнее о команде yc compute instance update читайте в справочнике Yandex Cloud CLI.

Воспользуйтесь методом REST API update для ресурса Instance или вызовом gRPC API InstanceService/Update, передав в поле reservedInstancePoolId (reserved_instance_pool_id для gRPC API) идентификатор нужного пула.

Отвязать ВМ от пула

Чтобы отвязать ВМ от пула резервов ВМ:

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

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

  1. Посмотрите описание команды Yandex Cloud CLI для изменения ВМ:

    yc compute instance update --help

  2. Получите список пулов резервов ВМ в каталоге по умолчанию:

    yc compute reserved-instance-pool list

    Результат:

    +----------------------+------------+---------------+------+
|          ID          |    NAME    |    ZONE ID    | SIZE |
+----------------------+------------+---------------+------+
| fv48qa9iiq19******** | test-pool1 | ru-central1-a |    1 |
| fv42fbsrso94******** | test-pool2 | ru-central1-a |    1 |
+----------------------+------------+---------------+------+

  3. Получите список ВМ в нужном пуле, указав его имя или идентификатор:

    yc compute reserved-instance-pool list-instances <имя_или_идентификатор_пула>

    Результат:

    +----------------------+-------------------+---------------+---------+----------------+-------------+
|          ID          |       NAME        |    ZONE ID    | STATUS  |  EXTERNAL IP   | INTERNAL IP |
+----------------------+-------------------+---------------+---------+----------------+-------------+
| fv4mkphl5q09******** | my-sample-pool-vm | ru-central1-a | RUNNING | 158.160.***.** | 192.168.3.8 |
| fv4mfp4fj6f0******** | my-second-pool-vm | ru-central1-a | RUNNING | 158.165.***.** | 192.168.3.12 |
+----------------------+-------------------+---------------+---------+----------------+-------------+

  4. Отвяжите нужную виртуальную машину от заданного пула резервов ВМ:

    yc compute instance update \
  --id <идентификатор_ВМ> \
  --reserved-instance-pool-id ""

    Где:

    • --id — идентификатор отвязываемой ВМ.

      Вместо идентификатора вы можете указать имя ВМ в параметре --name.

    Результат:
    done (5s)
id: fv4fjf9qbt57********
folder_id: b1gt6g8ht345********
created_at: "2025-05-07T07:46:34Z"
name: first-instance
zone_id: ru-central1-a
platform_id: standard-v2
resources:
  memory: "2147483648"
  cores: "2"
  core_fraction: "100"
status: RUNNING
metadata_options:
  gce_http_endpoint: ENABLED
  aws_v1_http_endpoint: ENABLED
  gce_http_token: ENABLED
  aws_v1_http_token: DISABLED
boot_disk:
  mode: READ_WRITE
  device_name: fv4v5k7u3g3n********
  auto_delete: true
  disk_id: fv4v5k7u3g3n********
network_interfaces:
  - index: "0"
    mac_address: d0:0d:f9:bd:3a:5f
    subnet_id: fl8dmq91iruu********
    primary_v4_address:
      address: 192.168.7.7
      one_to_one_nat:
        address: 158.160.***.**
        ip_version: IPV4
serial_port_settings:
  ssh_authorization: OS_LOGIN
gpu_settings: {}
fqdn: fv4fjf9qbt57********.auto.internal
scheduling_policy: {}
network_settings:
  type: STANDARD
placement_policy: {}
hardware_generation:
  legacy_features:
    pci_topology: PCI_TOPOLOGY_V1

  5. Убедитесь, что виртуальная машина была отвязана от пула.

Подробнее о команде yc compute instance update читайте в справочнике Yandex Cloud CLI.

Воспользуйтесь методом REST API update для ресурса Instance или вызовом gRPC API InstanceService/Update, передав в поле reservedInstancePoolId (reserved_instance_pool_id для gRPC API) пустую строку.

См. также

Предыдущая
Удалить пул резервов ВМ
Следующая
Создать кластер GPU