Изменение пула резервов виртуальных машин

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

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

По умолчанию секреты создаются в том же каталоге, что и подключения. Чтобы создать секрет в другом каталоге, в параметре --secret-folder-id укажите идентификатор этого каталога (для этого вам потребуется роль resource-manager.user на целевой каталог). Каталоги для подключения и секрета должны находиться в одном облаке. После создания подключения вы не сможете изменить этот параметр.

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

   yc compute reserved-instance-pool update --help
   

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

   yc compute reserved-instance-pool list
   

   Результат:

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

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

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

   Результат:

   id: fv4vnl1ncbja********
   zone_id: kz1-a
   cloud_id: b1gia87mbaom********
   folder_id: b1gt6g8ht345********
   name: test-pool
   description: sample description
   created_at: "2025-08-12T07:58:57Z"
   platform_id: standard-v2
   resources_spec:
     memory: "2147483648"
     cores: "2"
     core_fraction: "100"
   gpu_settings: {}
   network_settings:
     type: STANDARD
   size: "2"
   committed_size: "2"
   slot_stats:
     total: "2"
     used: "1"
     available: "1"
   instance_stats:
     total: "1"
   

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

   yc compute reserved-instance-pool update <имя_или_идентификатор_пула> \
     --new-name <новое_имя_пула> \
     --description <описание_пула> \
     --size <размер_пула> \
     --allow-oversubscription \
     --allow-pending-slots
   

   Где:

   • --new-name — новое имя пула. Необязательный параметр. Требования к имени:

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

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

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

   • --allow-oversubscription — параметр, включающий и выключающий для пула режим переподписки, при котором к пулу можно привязывать ВМ в количестве, превышающем размер пула. Необязательный параметр.

     Чтобы включить режим переподписки, передайте в команде параметр --allow-oversubscription.

     Чтобы выключить включенный ранее режим переподписки, передайте в команде параметр --allow-oversubscription=false.

   • --allow-pending-slots — параметр, включающий опцию ожидания ресурсов при изменении размера пула. Необязательный параметр. По умолчанию опция ожидания ресурсов для операции изменения размера пула выключена.

   Результат:

   done (8s)
   id: fv4vnl1ncbja********
   zone_id: kz1-a
   cloud_id: b1gia87mbaom********
   folder_id: b1gt6g8ht345********
   name: new-pool
   description: the new description
   created_at: "2025-08-12T07:58:57Z"
   platform_id: standard-v2
   resources_spec:
     memory: "2147483648"
     cores: "2"
     core_fraction: "100"
   gpu_settings: {}
   network_settings:
     type: STANDARD
   size: "3"
   committed_size: "3"
   slot_stats:
     total: "3"
     used: "1"
     available: "2"
   instance_stats:
     total: "1"
   

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

Воспользуйтесь методом REST API update для ресурса ReservedInstancePool или вызовом gRPC API ReservedInstancePoolService/Update.